QAbstractTexture Class

class Qt3DRender::QAbstractTexture

A base class to be used to provide textures. More...

Header: #include <QAbstractTexture>
CMake: find_package(Qt6 COMPONENTS 3drender REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
Since: Qt 5.5
Instantiated By: AbstractTexture
Inherits: Qt3DCore::QNode
Inherited By:

Qt3DRender::QSharedGLTexture, Qt3DRender::QTexture1D, Qt3DRender::QTexture1DArray, Qt3DRender::QTexture2D, Qt3DRender::QTexture2DArray, Qt3DRender::QTexture2DMultisample, Qt3DRender::QTexture2DMultisampleArray, Qt3DRender::QTexture3D, Qt3DRender::QTextureBuffer, Qt3DRender::QTextureCubeMap, Qt3DRender::QTextureCubeMapArray, Qt3DRender::QTextureLoader, and Qt3DRender::QTextureRectangle

Public Types

enum CubeMapFace { CubeMapPositiveX, CubeMapNegativeX, CubeMapPositiveY, CubeMapNegativeY, CubeMapPositiveZ, …, AllFaces }
enum Filter { Nearest, Linear, NearestMipMapNearest, NearestMipMapLinear, LinearMipMapNearest, LinearMipMapLinear }
enum Status { None, Loading, Ready, Error }
enum Target { TargetAutomatic, Target1D, Target1DArray, Target2D, Target2DArray, …, TargetBuffer }
enum TextureFormat { NoFormat, Automatic, R8_UNorm, RG8_UNorm, RGB8_UNorm, …, LuminanceAlphaFormat }

Properties

Public Functions

void addTextureImage(Qt3DRender::QAbstractTextureImage *textureImage)
Qt3DRender::QAbstractTexture::ComparisonFunction comparisonFunction() const
Qt3DRender::QAbstractTexture::ComparisonMode comparisonMode() const
int depth() const
Qt3DRender::QAbstractTexture::TextureFormat format() const
bool generateMipMaps() const
QVariant handle() const
Qt3DRender::QAbstractTexture::HandleType handleType() const
int height() const
int layers() const
Qt3DRender::QAbstractTexture::Filter magnificationFilter() const
float maximumAnisotropy() const
Qt3DRender::QAbstractTexture::Filter minificationFilter() const
int mipLevels() const
void removeTextureImage(Qt3DRender::QAbstractTextureImage *textureImage)
int samples() const
void setSize(int w, int h = 1, int d = 1)
void setWrapMode(const Qt3DRender::QTextureWrapMode &wrapMode)
Qt3DRender::QAbstractTexture::Status status() const
Qt3DRender::QAbstractTexture::Target target() const
QList<Qt3DRender::QAbstractTextureImage *> textureImages() const
void updateData(const Qt3DRender::QTextureDataUpdate &update)
int width() const
Qt3DRender::QTextureWrapMode * wrapMode()

Public Slots

void setComparisonFunction(Qt3DRender::QAbstractTexture::ComparisonFunction function)
void setComparisonMode(Qt3DRender::QAbstractTexture::ComparisonMode mode)
void setDepth(int depth)
void setFormat(Qt3DRender::QAbstractTexture::TextureFormat format)
void setGenerateMipMaps(bool gen)
void setHeight(int height)
void setLayers(int layers)
void setMagnificationFilter(Qt3DRender::QAbstractTexture::Filter f)
void setMaximumAnisotropy(float anisotropy)
void setMinificationFilter(Qt3DRender::QAbstractTexture::Filter f)
void setMipLevels(int mipLevels)
void setSamples(int samples)
void setWidth(int width)

Signals

void comparisonFunctionChanged(Qt3DRender::QAbstractTexture::ComparisonFunction comparisonFunction)
void comparisonModeChanged(Qt3DRender::QAbstractTexture::ComparisonMode comparisonMode)
void depthChanged(int depth)
void formatChanged(Qt3DRender::QAbstractTexture::TextureFormat format)
void generateMipMapsChanged(bool generateMipMaps)
void handleChanged(QVariant handle)
void handleTypeChanged(Qt3DRender::QAbstractTexture::HandleType handleType)
void heightChanged(int height)
void layersChanged(int layers)
void magnificationFilterChanged(Qt3DRender::QAbstractTexture::Filter magnificationFilter)
void maximumAnisotropyChanged(float maximumAnisotropy)
void minificationFilterChanged(Qt3DRender::QAbstractTexture::Filter minificationFilter)
void mipLevelsChanged(int mipLevels)
void samplesChanged(int samples)
void statusChanged(Qt3DRender::QAbstractTexture::Status status)
void widthChanged(int width)

Protected Functions

QAbstractTexture(Qt3DRender::QAbstractTexture::Target target, Qt3DCore::QNode *parent = nullptr)
QAbstractTexture(Qt3DCore::QNode *parent = nullptr)
void setStatus(Qt3DRender::QAbstractTexture::Status status)

Detailed Description

The QAbstractTexture class shouldn't be used directly but rather through one of its subclasses. Each subclass implements a given texture target (2D, 2DArray, 3D, CubeMap ...) Each subclass provides a set of functors for each layer, cube map face and mipmap level. In turn the backend uses those functor to properly fill a corresponding OpenGL texture with data. It is expected the functor does as minimal processing as possible so as not to slow down textures generation and upload. If the content of a texture is the result of a slow procedural generation process, it is recommended not to implement this directly in a functor.

All textures are unique. If you instantiate twice the same texture this will create 2 identical textures on the GPU, no sharing will take place.

Member Type Documentation

enum QAbstractTexture::CubeMapFace

This enum identifies the faces of a cube map texture

Constant Value Description
Qt3DRender::QAbstractTexture::CubeMapPositiveX 0x8515 Specify the positive X face of a cube map
Qt3DRender::QAbstractTexture::CubeMapNegativeX 0x8516 Specify the negative X face of a cube map
Qt3DRender::QAbstractTexture::CubeMapPositiveY 0x8517 Specify the positive Y face of a cube map
Qt3DRender::QAbstractTexture::CubeMapNegativeY 0x8518 Specify the negative Y face of a cube map
Qt3DRender::QAbstractTexture::CubeMapPositiveZ 0x8519 Specify the positive Z face of a cube map
Qt3DRender::QAbstractTexture::CubeMapNegativeZ 0x851A Specify the negative Z face of a cube map
Qt3DRender::QAbstractTexture::AllFaces 0x851b Specify all the faces of a cube map

Note: AllFaces should only be used when a behavior needs to be applied to all the faces of a cubemap. This is the case for example when using a cube map as a texture attachment. Using AllFaces in the attachment specfication would result in all faces being bound to the attachment point. On the other hand, if a specific face is specified, the attachment would only be using the specified face.

enum QAbstractTexture::Filter

Holds the filter type of the texture provider.

Constant Value Description
Qt3DRender::QAbstractTexture::Nearest 0x2600 GL_NEAREST
Qt3DRender::QAbstractTexture::Linear 0x2601 GL_LINEAR
Qt3DRender::QAbstractTexture::NearestMipMapNearest 0x2700 GL_NEAREST_MIPMAP_NEAREST
Qt3DRender::QAbstractTexture::NearestMipMapLinear 0x2702 GL_NEAREST_MIPMAP_LINEAR
Qt3DRender::QAbstractTexture::LinearMipMapNearest 0x2701 GL_LINEAR_MIPMAP_NEAREST
Qt3DRender::QAbstractTexture::LinearMipMapLinear 0x2703 GL_LINEAR_MIPMAP_LINEAR

enum QAbstractTexture::Status

Contains the status of the texture provider.

Constant Value
Qt3DRender::QAbstractTexture::None 0
Qt3DRender::QAbstractTexture::Loading 1
Qt3DRender::QAbstractTexture::Ready 2
Qt3DRender::QAbstractTexture::Error 3

enum QAbstractTexture::Target

Constant Value Description
Qt3DRender::QAbstractTexture::TargetAutomatic 0 Target will be determined by the Qt3D engine
Qt3DRender::QAbstractTexture::Target1D 0x0DE0 GL_TEXTURE_1D
Qt3DRender::QAbstractTexture::Target1DArray 0x8C18 GL_TEXTURE_1D_ARRAY
Qt3DRender::QAbstractTexture::Target2D 0x0DE1 GL_TEXTURE_2D
Qt3DRender::QAbstractTexture::Target2DArray 0x8C1A GL_TEXTURE_2D_ARRAY
Qt3DRender::QAbstractTexture::Target3D 0x806F GL_TEXTURE_3D
Qt3DRender::QAbstractTexture::TargetCubeMap 0x8513 GL_TEXTURE_CUBE_MAP
Qt3DRender::QAbstractTexture::TargetCubeMapArray 0x9009 GL_TEXTURE_CUBE_MAP_ARRAY
Qt3DRender::QAbstractTexture::Target2DMultisample 0x9100 GL_TEXTURE_2D_MULTISAMPLE
Qt3DRender::QAbstractTexture::Target2DMultisampleArray 0x9102 GL_TEXTURE_2D_MULTISAMPLE_ARRAY
Qt3DRender::QAbstractTexture::TargetRectangle 0x84F5 GL_TEXTURE_RECTANGLE
Qt3DRender::QAbstractTexture::TargetBuffer 0x8C2A GL_TEXTURE_BUFFER

enum QAbstractTexture::TextureFormat

This list describes all possible texture formats

Constant Value Description
Qt3DRender::QAbstractTexture::NoFormat 0 GL_NONE
Qt3DRender::QAbstractTexture::Automatic 1 automatically_determines_format
Qt3DRender::QAbstractTexture::R8_UNorm 0x8229 GL_R8
Qt3DRender::QAbstractTexture::RG8_UNorm 0x822B GL_RG8
Qt3DRender::QAbstractTexture::RGB8_UNorm 0x8051 GL_RGB8
Qt3DRender::QAbstractTexture::RGBA8_UNorm 0x8058 GL_RGBA8
Qt3DRender::QAbstractTexture::R16_UNorm 0x822A GL_R16
Qt3DRender::QAbstractTexture::RG16_UNorm 0x822C GL_RG16
Qt3DRender::QAbstractTexture::RGB16_UNorm 0x8054 GL_RGB16
Qt3DRender::QAbstractTexture::RGBA16_UNorm 0x805B GL_RGBA16
Qt3DRender::QAbstractTexture::R8_SNorm 0x8F94 GL_R8_SNORM
Qt3DRender::QAbstractTexture::RG8_SNorm 0x8F95 GL_RG8_SNORM
Qt3DRender::QAbstractTexture::RGB8_SNorm 0x8F96 GL_RGB8_SNORM
Qt3DRender::QAbstractTexture::RGBA8_SNorm 0x8F97 GL_RGBA8_SNORM
Qt3DRender::QAbstractTexture::R16_SNorm 0x8F98 GL_R16_SNORM
Qt3DRender::QAbstractTexture::RG16_SNorm 0x8F99 GL_RG16_SNORM
Qt3DRender::QAbstractTexture::RGB16_SNorm 0x8F9A GL_RGB16_SNORM
Qt3DRender::QAbstractTexture::RGBA16_SNorm 0x8F9B GL_RGBA16_SNORM
Qt3DRender::QAbstractTexture::R8U 0x8232 GL_R8UI
Qt3DRender::QAbstractTexture::RG8U 0x8238 GL_RG8UI
Qt3DRender::QAbstractTexture::RGB8U 0x8D7D GL_RGB8UI
Qt3DRender::QAbstractTexture::RGBA8U 0x8D7C GL_RGBA8UI
Qt3DRender::QAbstractTexture::R16U 0x8234 GL_R16UI
Qt3DRender::QAbstractTexture::RG16U 0x823A GL_RG16UI
Qt3DRender::QAbstractTexture::RGB16U 0x8D77 GL_RGB16UI
Qt3DRender::QAbstractTexture::RGBA16U 0x8D76 GL_RGBA16UI
Qt3DRender::QAbstractTexture::R32U 0x8236 GL_R32UI
Qt3DRender::QAbstractTexture::RG32U 0x823C GL_RG32UI
Qt3DRender::QAbstractTexture::RGB32U 0x8D71 GL_RGB32UI
Qt3DRender::QAbstractTexture::RGBA32U 0x8D70 GL_RGBA32UI
Qt3DRender::QAbstractTexture::R8I 0x8231 GL_R8I
Qt3DRender::QAbstractTexture::RG8I 0x8237 GL_RG8I
Qt3DRender::QAbstractTexture::RGB8I 0x8D8F GL_RGB8I
Qt3DRender::QAbstractTexture::RGBA8I 0x8D8E GL_RGBA8I
Qt3DRender::QAbstractTexture::R16I 0x8233 GL_R16I
Qt3DRender::QAbstractTexture::RG16I 0x8239 GL_RG16I
Qt3DRender::QAbstractTexture::RGB16I 0x8D89 GL_RGB16I
Qt3DRender::QAbstractTexture::RGBA16I 0x8D88 GL_RGBA16I
Qt3DRender::QAbstractTexture::R32I 0x8235 GL_R32I
Qt3DRender::QAbstractTexture::RG32I 0x823B GL_RG32I
Qt3DRender::QAbstractTexture::RGB32I 0x8D83 GL_RGB32I
Qt3DRender::QAbstractTexture::RGBA32I 0x8D82 GL_RGBA32I
Qt3DRender::QAbstractTexture::R16F 0x822D GL_R16F
Qt3DRender::QAbstractTexture::RG16F 0x822F GL_RG16F
Qt3DRender::QAbstractTexture::RGB16F 0x881B GL_RGB16F
Qt3DRender::QAbstractTexture::RGBA16F 0x881A GL_RGBA16F
Qt3DRender::QAbstractTexture::R32F 0x822E GL_R32F
Qt3DRender::QAbstractTexture::RG32F 0x8230 GL_RG32F
Qt3DRender::QAbstractTexture::RGB32F 0x8815 GL_RGB32F
Qt3DRender::QAbstractTexture::RGBA32F 0x8814 GL_RGBA32F
Qt3DRender::QAbstractTexture::RGB9E5 0x8C3D GL_RGB9_E5
Qt3DRender::QAbstractTexture::RG11B10F 0x8C3A GL_R11F_G11F_B10F
Qt3DRender::QAbstractTexture::RG3B2 0x2A10 GL_R3_G3_B2
Qt3DRender::QAbstractTexture::R5G6B5 0x8D62 GL_RGB565
Qt3DRender::QAbstractTexture::RGB5A1 0x8057 GL_RGB5_A1
Qt3DRender::QAbstractTexture::RGBA4 0x8056 GL_RGBA4
Qt3DRender::QAbstractTexture::RGB10A2 0x8059 GL_RGB10_A2
Qt3DRender::QAbstractTexture::RGB10A2U 0x906F GL_RGB10_A2UI
Qt3DRender::QAbstractTexture::D16 0x81A5 GL_DEPTH_COMPONENT16
Qt3DRender::QAbstractTexture::D24 0x81A6 GL_DEPTH_COMPONENT24
Qt3DRender::QAbstractTexture::D24S8 0x88F0 GL_DEPTH24_STENCIL8
Qt3DRender::QAbstractTexture::D32 0x81A7 GL_DEPTH_COMPONENT32
Qt3DRender::QAbstractTexture::D32F 0x8CAC GL_DEPTH_COMPONENT32F
Qt3DRender::QAbstractTexture::D32FS8X24 0x8CAD GL_DEPTH32F_STENCIL8
Qt3DRender::QAbstractTexture::RGB_DXT1 0x83F0 GL_COMPRESSED_RGB_S3TC_DXT1_EXT
Qt3DRender::QAbstractTexture::RGBA_DXT1 0x83F1 GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
Qt3DRender::QAbstractTexture::RGBA_DXT3 0x83F2 GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
Qt3DRender::QAbstractTexture::RGBA_DXT5 0x83F3 GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
Qt3DRender::QAbstractTexture::R_ATI1N_UNorm 0x8DBB GL_COMPRESSED_RED_RGTC1
Qt3DRender::QAbstractTexture::R_ATI1N_SNorm 0x8DBC GL_COMPRESSED_SIGNED_RED_RGTC1
Qt3DRender::QAbstractTexture::RG_ATI2N_UNorm 0x8DBD GL_COMPRESSED_RG_RGTC2
Qt3DRender::QAbstractTexture::RG_ATI2N_SNorm 0x8DBE GL_COMPRESSED_SIGNED_RG_RGTC2
Qt3DRender::QAbstractTexture::RGB_BP_UNSIGNED_FLOAT 0x8E8F GL_COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT_ARB
Qt3DRender::QAbstractTexture::RGB_BP_SIGNED_FLOAT 0x8E8E GL_COMPRESSED_RGB_BPTC_SIGNED_FLOAT_ARB
Qt3DRender::QAbstractTexture::RGB_BP_UNorm 0x8E8C GL_COMPRESSED_RGBA_BPTC_UNORM_ARB
Qt3DRender::QAbstractTexture::R11_EAC_UNorm 0x9270 GL_COMPRESSED_R11_EAC
Qt3DRender::QAbstractTexture::R11_EAC_SNorm 0x9271 GL_COMPRESSED_SIGNED_R11_EAC
Qt3DRender::QAbstractTexture::RG11_EAC_UNorm 0x9272 GL_COMPRESSED_RG11_EAC
Qt3DRender::QAbstractTexture::RG11_EAC_SNorm 0x9273 GL_COMPRESSED_SIGNED_RG11_EAC
Qt3DRender::QAbstractTexture::RGB8_ETC2 0x9274 GL_COMPRESSED_RGB8_ETC2
Qt3DRender::QAbstractTexture::SRGB8_ETC2 0x9275 GL_COMPRESSED_SRGB8_ETC2
Qt3DRender::QAbstractTexture::RGB8_PunchThrough_Alpha1_ETC2 0x9276 GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
Qt3DRender::QAbstractTexture::SRGB8_PunchThrough_Alpha1_ETC2 0x9277 GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2
Qt3DRender::QAbstractTexture::RGBA8_ETC2_EAC 0x9278 GL_COMPRESSED_RGBA8_ETC2_EAC
Qt3DRender::QAbstractTexture::SRGB8_Alpha8_ETC2_EAC 0x9279 GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC
Qt3DRender::QAbstractTexture::RGB8_ETC1 0x8D64 GL_ETC1_RGB8_OES
Qt3DRender::QAbstractTexture::SRGB8 0x8C41 GL_SRGB8
Qt3DRender::QAbstractTexture::SRGB8_Alpha8 0x8C43 GL_SRGB8_ALPHA8
Qt3DRender::QAbstractTexture::SRGB_DXT1 0x8C4C GL_COMPRESSED_SRGB_S3TC_DXT1_EXT
Qt3DRender::QAbstractTexture::SRGB_Alpha_DXT1 0x8C4D GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
Qt3DRender::QAbstractTexture::SRGB_Alpha_DXT3 0x8C4E GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
Qt3DRender::QAbstractTexture::SRGB_Alpha_DXT5 0x8C4F GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
Qt3DRender::QAbstractTexture::SRGB_BP_UNorm 0x8E8D GL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM_ARB
Qt3DRender::QAbstractTexture::DepthFormat 0x1902 GL_DEPTH_COMPONENT
Qt3DRender::QAbstractTexture::AlphaFormat 0x1906 GL_ALPHA
Qt3DRender::QAbstractTexture::RGBFormat 0x1907 GL_RGB
Qt3DRender::QAbstractTexture::RGBAFormat 0x1908 GL_RGBA
Qt3DRender::QAbstractTexture::LuminanceFormat 0x1909 GL_LUMINANCE
Qt3DRender::QAbstractTexture::LuminanceAlphaFormat 0x190A 0x190A

Property Documentation

comparisonFunction : ComparisonFunction

Holds the comparison function of the texture provider.

Access functions:

Qt3DRender::QAbstractTexture::ComparisonFunction comparisonFunction() const
void setComparisonFunction(Qt3DRender::QAbstractTexture::ComparisonFunction function)

Notifier signal:

void comparisonFunctionChanged(Qt3DRender::QAbstractTexture::ComparisonFunction comparisonFunction)

comparisonMode : ComparisonMode

Holds the comparison mode of the texture provider.

Access functions:

Qt3DRender::QAbstractTexture::ComparisonMode comparisonMode() const
void setComparisonMode(Qt3DRender::QAbstractTexture::ComparisonMode mode)

Notifier signal:

void comparisonModeChanged(Qt3DRender::QAbstractTexture::ComparisonMode comparisonMode)

depth : int

Holds the depth of the texture provider.

Access functions:

int depth() const
void setDepth(int depth)

Notifier signal:

void depthChanged(int depth)

format : TextureFormat

Holds the format of the texture provider.

Access functions:

Qt3DRender::QAbstractTexture::TextureFormat format() const
void setFormat(Qt3DRender::QAbstractTexture::TextureFormat format)

Notifier signal:

void formatChanged(Qt3DRender::QAbstractTexture::TextureFormat format)

generateMipMaps : bool

Holds whether the texture provider should auto generate mipmaps.

Access functions:

bool generateMipMaps() const
void setGenerateMipMaps(bool gen)

Notifier signal:

void generateMipMapsChanged(bool generateMipMaps)

[read-only] handle : const QVariant

Holds the current texture handle, if Qt 3D is using the OpenGL renderer, handle is a texture id integer.

Access functions:

QVariant handle() const

Notifier signal:

void handleChanged(QVariant handle)

[read-only] handleType : const HandleType

Holds the current texture handle type.

Access functions:

Qt3DRender::QAbstractTexture::HandleType handleType() const

Notifier signal:

void handleTypeChanged(Qt3DRender::QAbstractTexture::HandleType handleType)

height : int

Holds the height of the texture provider.

Access functions:

int height() const
void setHeight(int height)

Notifier signal:

void heightChanged(int height)

layers : int

Holds the maximum layer count of the texture provider. By default, the maximum layer count is 1.

Note: this has a meaning only for texture providers that have 3D or array target formats.

Access functions:

int layers() const
void setLayers(int layers)

Notifier signal:

void layersChanged(int layers)

magnificationFilter : Filter

Holds the magnification filter of the texture provider.

Access functions:

Qt3DRender::QAbstractTexture::Filter magnificationFilter() const
void setMagnificationFilter(Qt3DRender::QAbstractTexture::Filter f)

Notifier signal:

void magnificationFilterChanged(Qt3DRender::QAbstractTexture::Filter magnificationFilter)

maximumAnisotropy : float

Holds the maximum anisotropy of the texture provider.

Access functions:

float maximumAnisotropy() const
void setMaximumAnisotropy(float anisotropy)

Notifier signal:

void maximumAnisotropyChanged(float maximumAnisotropy)

minificationFilter : Filter

Holds the minification filter of the texture provider.

Access functions:

Qt3DRender::QAbstractTexture::Filter minificationFilter() const
void setMinificationFilter(Qt3DRender::QAbstractTexture::Filter f)

Notifier signal:

void minificationFilterChanged(Qt3DRender::QAbstractTexture::Filter minificationFilter)

mipLevels : int

Holds the mipmap levels of the texture provider.

Access functions:

int mipLevels() const
void setMipLevels(int mipLevels)

Notifier signal:

void mipLevelsChanged(int mipLevels)

samples : int

Holds the number of samples per texel for the texture provider. By default, the number of samples is 1.

Note: this has a meaning only for texture providers that have multisample formats.

Access functions:

int samples() const
void setSamples(int samples)

Notifier signal:

void samplesChanged(int samples)

[read-only] status : const Status

Holds the current status of the texture provider.

Access functions:

Qt3DRender::QAbstractTexture::Status status() const

Notifier signal:

void statusChanged(Qt3DRender::QAbstractTexture::Status status)

[read-only] target : const Target

Holds the target format of the texture provider.

Note: The target format can only be set once.

Access functions:

Qt3DRender::QAbstractTexture::Target target() const

width : int

Holds the width of the texture provider.

Access functions:

int width() const
void setWidth(int width)

Notifier signal:

void widthChanged(int width)

[read-only] wrapMode : Qt3DRender::QTextureWrapMode* const

Holds the wrap mode of the texture provider.

Access functions:

Qt3DRender::QTextureWrapMode * wrapMode()

Member Function Documentation

[protected] QAbstractTexture::QAbstractTexture(Qt3DRender::QAbstractTexture::Target target, Qt3DCore::QNode *parent = nullptr)

The constructor creates a new QAbstractTexture::QAbstractTexture instance with the specified target and parent.

[protected] QAbstractTexture::QAbstractTexture(Qt3DCore::QNode *parent = nullptr)

The constructor creates a new QAbstractTexture::QAbstractTexture instance with the specified parent.

[slot] void QAbstractTexture::setComparisonFunction(Qt3DRender::QAbstractTexture::ComparisonFunction function)

Set the comparison function to function.

Note: Setter function for property comparisonFunction.

See also comparisonFunction().

[slot] void QAbstractTexture::setComparisonMode(Qt3DRender::QAbstractTexture::ComparisonMode mode)

Set the comparison mode to mode.

Note: Setter function for property comparisonMode.

See also comparisonMode().

[slot] void QAbstractTexture::setDepth(int depth)

Set the depth of the texture to depth.

Note: Setter function for property depth.

See also depth().

[slot] void QAbstractTexture::setFormat(Qt3DRender::QAbstractTexture::TextureFormat format)

Set the texture format to format.

Note: Setter function for property format.

See also format().

[slot] void QAbstractTexture::setGenerateMipMaps(bool gen)

Boolean parameter gen sets a flag indicating whether the texture provider should generate mipmaps or not.

Note: Setter function for property generateMipMaps.

See also generateMipMaps().

[slot] void QAbstractTexture::setHeight(int height)

Set the height to height.

Note: Setter function for property height.

See also height().

[slot] void QAbstractTexture::setLayers(int layers)

Set the maximum layer count to layers.

Note: Setter function for property layers.

See also layers().

[slot] void QAbstractTexture::setMagnificationFilter(Qt3DRender::QAbstractTexture::Filter f)

Set the magnification filter to f.

Note: Setter function for property magnificationFilter.

See also magnificationFilter().

[slot] void QAbstractTexture::setMaximumAnisotropy(float anisotropy)

Sets the maximum anisotropy to anisotropy.

Note: Setter function for property maximumAnisotropy.

See also maximumAnisotropy().

[slot] void QAbstractTexture::setMinificationFilter(Qt3DRender::QAbstractTexture::Filter f)

Set the minification filter to the specified value f.

Note: Setter function for property minificationFilter.

See also minificationFilter().

[slot] void QAbstractTexture::setSamples(int samples)

Set the number of samples per texel to samples.

Note: Setter function for property samples.

See also samples().

[slot] void QAbstractTexture::setWidth(int width)

Set the width of the texture provider to width.

Note: Setter function for property width.

See also width().

void QAbstractTexture::addTextureImage(Qt3DRender::QAbstractTextureImage *textureImage)

Adds a new Qt3DCore::QAbstractTextureImage textureImage to the texture provider.

Note: Qt3DRender::QAbstractTextureImage should never be shared between multiple Qt3DRender::QAbstractTexture instances.

Qt3DRender::QAbstractTexture::ComparisonFunction QAbstractTexture::comparisonFunction() const

Returns the current comparison function.

Note: Getter function for property comparisonFunction.

See also setComparisonFunction().

Qt3DRender::QAbstractTexture::ComparisonMode QAbstractTexture::comparisonMode() const

Returns the current comparison mode.

Note: Getter function for property comparisonMode.

See also setComparisonMode().

int QAbstractTexture::depth() const

Returns the depth of the texture

Note: Getter function for property depth.

See also setDepth().

Qt3DRender::QAbstractTexture::TextureFormat QAbstractTexture::format() const

Returns the texture provider's format.

Note: Getter function for property format.

See also setFormat().

[since 5.13] QVariant QAbstractTexture::handle() const

Returns the current texture handle, if Qt 3D is using the OpenGL renderer, handle is a texture id integer.

Note: Getter function for property handle.

This function was introduced in Qt 5.13.

[since 5.13] Qt3DRender::QAbstractTexture::HandleType QAbstractTexture::handleType() const

Returns the current texture handle type.

Note: Getter function for property handleType.

This function was introduced in Qt 5.13.

int QAbstractTexture::height() const

Returns the height of the texture

Note: Getter function for property height.

See also setHeight().

int QAbstractTexture::layers() const

Returns the maximum number of layers for the texture provider.

Note: this has a meaning only for texture providers that have 3D or array target formats.

Note: Getter function for property layers.

See also setLayers().

float QAbstractTexture::maximumAnisotropy() const

Returns the current maximum anisotropy

Note: Getter function for property maximumAnisotropy.

See also setMaximumAnisotropy().

void QAbstractTexture::removeTextureImage(Qt3DRender::QAbstractTextureImage *textureImage)

Removes a Qt3DCore::QAbstractTextureImage textureImage from the texture provider.

int QAbstractTexture::samples() const

Returns the number of samples per texel for the texture provider.

Note: this has a meaning only for texture providers that have multisample formats.

Note: Getter function for property samples.

See also setSamples().

void QAbstractTexture::setSize(int w, int h = 1, int d = 1)

Sets the size of the texture provider to width w, height h and depth d.

[protected] void QAbstractTexture::setStatus(Qt3DRender::QAbstractTexture::Status status)

Set the status of the texture provider to the specified status.

See also status().

void QAbstractTexture::setWrapMode(const Qt3DRender::QTextureWrapMode &wrapMode)

Set the wrapmode to the value specified in wrapMode.

See also wrapMode().

Qt3DRender::QAbstractTexture::Status QAbstractTexture::status() const

Returns the current status of the texture provider.

Note: Getter function for property status.

See also setStatus().

Qt3DRender::QAbstractTexture::Target QAbstractTexture::target() const

Returns the target format of the texture provider.

Note: Getter function for property target.

QList<Qt3DRender::QAbstractTextureImage *> QAbstractTexture::textureImages() const

Returns a list of pointers to QAbstractTextureImage objects contained in the texture provider.

[since 5.14] void QAbstractTexture::updateData(const Qt3DRender::QTextureDataUpdate &update)

Updates a sub region of the texture, defined by update, without having to change the data generator or rely on adding or removing texture images.

Note: This function can be invoked via the meta-object system and from QML. See Q_INVOKABLE.

This function was introduced in Qt 5.14.

int QAbstractTexture::width() const

Returns the width of the texture

Note: Getter function for property width.

See also setWidth().

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.0/qt3drender-qabstracttexture.html