- Qt 6.5
- Qt 3D
- QML Types
- Qt3D.Render
- TextureImage
- Qt 6.5.2 Reference Documentation

# TextureImage QML Type

Encapsulates the necessary information to create an OpenGL texture image from an image source. More...

Import Statement: | import Qt3D.Render 2.5
Instantiates: | QTextureImage
Inherits: | AbstractTextureImage

- List of all members, including inherited members

## Properties

- face : enumeration
- layer : int
- mipLevel : int
- mirrored : bool
- source : url
- status : enumeration

## Detailed Description

## Property Documentation

face : enumeration

Holds the cube map face of the texture image.

Constant | Description
--- | ---
`CubeMapPositiveX` | 0x8515 GL_TEXTURE_CUBE_MAP_POSITIVE_X
`CubeMapNegativeX` | 0x8516 GL_TEXTURE_CUBE_MAP_NEGATIVE_X
`CubeMapPositiveY` | 0x8517 GL_TEXTURE_CUBE_MAP_POSITIVE_Y
`CubeMapNegativeY` | 0x8518 GL_TEXTURE_CUBE_MAP_NEGATIVE_Y
`CubeMapPositiveZ` | 0x8519 GL_TEXTURE_CUBE_MAP_POSITIVE_Z
`CubeMapNegativeZ` | 0x851A GL_TEXTURE_CUBE_MAP_NEGATIVE_Z

Note: The cube map face has a meaning only for TargetCubeMap and TargetCubeMapArray.

layer : int

Holds the layer of the texture image.

mipLevel : int

Holds the mipmap level of the texture image.

mirrored : bool

This property specifies whether the image should be mirrored when loaded. This is a convenience to avoid having to manipulate images to match the origin of the texture coordinates used by the rendering API. By default this property is set to true. This has no effect when using GPU compressed texture formats.

Warning: This property results in a performance price payed at runtime when loading uncompressed or CPU compressed image formats such as PNG. To avoid this performance price it is better to set this property to false and load texture assets that have been pre-mirrored.

Note: OpenGL specifies the origin of texture coordinates from the lower left hand corner whereas DirectX uses the the upper left hand corner.

Note: When using cube map texture you'll probably want mirroring disabled as the cube map sampler takes a direction rather than regular texture coordinates.

source : url

This property holds the source url from which data for the texture image will be loaded.

[read-only] status : enumeration

This property holds the status of the texture image loading.

- TextureImage.None
- TextureImage.Loading
- TextureImage.Ready
- TextureImage.Error