QAbstractTexture Class

class Qt3DRender::QAbstractTexture

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

Header: #include <QAbstractTexture>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
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(Qt3DCore::QNode *parent = nullptr)
QAbstractTexture(Qt3DRender::QAbstractTexture::Target target, 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

ConstantValueDescription
Qt3DRender::QAbstractTexture::CubeMapPositiveX0x8515Specify the positive X face of a cube map
Qt3DRender::QAbstractTexture::CubeMapNegativeX0x8516Specify the negative X face of a cube map
Qt3DRender::QAbstractTexture::CubeMapPositiveY0x8517Specify the positive Y face of a cube map
Qt3DRender::QAbstractTexture::CubeMapNegativeY0x8518Specify the negative Y face of a cube map
Qt3DRender::QAbstractTexture::CubeMapPositiveZ0x8519Specify the positive Z face of a cube map
Qt3DRender::QAbstractTexture::CubeMapNegativeZ0x851ASpecify the negative Z face of a cube map
Qt3DRender::QAbstractTexture::AllFaces0x851bSpecify 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.

ConstantValueDescription
Qt3DRender::QAbstractTexture::Nearest0x2600GL_NEAREST
Qt3DRender::QAbstractTexture::Linear0x2601GL_LINEAR
Qt3DRender::QAbstractTexture::NearestMipMapNearest0x2700GL_NEAREST_MIPMAP_NEAREST
Qt3DRender::QAbstractTexture::NearestMipMapLinear0x2702GL_NEAREST_MIPMAP_LINEAR
Qt3DRender::QAbstractTexture::LinearMipMapNearest0x2701GL_LINEAR_MIPMAP_NEAREST
Qt3DRender::QAbstractTexture::LinearMipMapLinear0x2703GL_LINEAR_MIPMAP_LINEAR

enum QAbstractTexture::Status

Contains the status of the texture provider.

ConstantValue
Qt3DRender::QAbstractTexture::None0
Qt3DRender::QAbstractTexture::Loading1
Qt3DRender::QAbstractTexture::Ready2
Qt3DRender::QAbstractTexture::Error3

enum QAbstractTexture::Target

ConstantValueDescription
Qt3DRender::QAbstractTexture::TargetAutomatic0Target will be determined by the Qt3D engine
Qt3DRender::QAbstractTexture::Target1D0x0DE0GL_TEXTURE_1D
Qt3DRender::QAbstractTexture::Target1DArray0x8C18GL_TEXTURE_1D_ARRAY
Qt3DRender::QAbstractTexture::Target2D0x0DE1GL_TEXTURE_2D
Qt3DRender::QAbstractTexture::Target2DArray0x8C1AGL_TEXTURE_2D_ARRAY
Qt3DRender::QAbstractTexture::Target3D0x806FGL_TEXTURE_3D
Qt3DRender::QAbstractTexture::TargetCubeMap0x8513GL_TEXTURE_CUBE_MAP
Qt3DRender::QAbstractTexture::TargetCubeMapArray0x9009GL_TEXTURE_CUBE_MAP_ARRAY
Qt3DRender::QAbstractTexture::Target2DMultisample0x9100GL_TEXTURE_2D_MULTISAMPLE
Qt3DRender::QAbstractTexture::Target2DMultisampleArray0x9102GL_TEXTURE_2D_MULTISAMPLE_ARRAY
Qt3DRender::QAbstractTexture::TargetRectangle0x84F5GL_TEXTURE_RECTANGLE
Qt3DRender::QAbstractTexture::TargetBuffer0x8C2AGL_TEXTURE_BUFFER

enum QAbstractTexture::TextureFormat

This list describes all possible texture formats

ConstantValueDescription
Qt3DRender::QAbstractTexture::NoFormat0GL_NONE
Qt3DRender::QAbstractTexture::Automatic1automatically_determines_format
Qt3DRender::QAbstractTexture::R8_UNorm0x8229GL_R8
Qt3DRender::QAbstractTexture::RG8_UNorm0x822BGL_RG8
Qt3DRender::QAbstractTexture::RGB8_UNorm0x8051GL_RGB8
Qt3DRender::QAbstractTexture::RGBA8_UNorm0x8058GL_RGBA8
Qt3DRender::QAbstractTexture::R16_UNorm0x822AGL_R16
Qt3DRender::QAbstractTexture::RG16_UNorm0x822CGL_RG16
Qt3DRender::QAbstractTexture::RGB16_UNorm0x8054GL_RGB16
Qt3DRender::QAbstractTexture::RGBA16_UNorm0x805BGL_RGBA16
Qt3DRender::QAbstractTexture::R8_SNorm0x8F94GL_R8_SNORM
Qt3DRender::QAbstractTexture::RG8_SNorm0x8F95GL_RG8_SNORM
Qt3DRender::QAbstractTexture::RGB8_SNorm0x8F96GL_RGB8_SNORM
Qt3DRender::QAbstractTexture::RGBA8_SNorm0x8F97GL_RGBA8_SNORM
Qt3DRender::QAbstractTexture::R16_SNorm0x8F98GL_R16_SNORM
Qt3DRender::QAbstractTexture::RG16_SNorm0x8F99GL_RG16_SNORM
Qt3DRender::QAbstractTexture::RGB16_SNorm0x8F9AGL_RGB16_SNORM
Qt3DRender::QAbstractTexture::RGBA16_SNorm0x8F9BGL_RGBA16_SNORM
Qt3DRender::QAbstractTexture::R8U0x8232GL_R8UI
Qt3DRender::QAbstractTexture::RG8U0x8238GL_RG8UI
Qt3DRender::QAbstractTexture::RGB8U0x8D7DGL_RGB8UI
Qt3DRender::QAbstractTexture::RGBA8U0x8D7CGL_RGBA8UI
Qt3DRender::QAbstractTexture::R16U0x8234GL_R16UI
Qt3DRender::QAbstractTexture::RG16U0x823AGL_RG16UI
Qt3DRender::QAbstractTexture::RGB16U0x8D77GL_RGB16UI
Qt3DRender::QAbstractTexture::RGBA16U0x8D76GL_RGBA16UI
Qt3DRender::QAbstractTexture::R32U0x8236GL_R32UI
Qt3DRender::QAbstractTexture::RG32U0x823CGL_RG32UI
Qt3DRender::QAbstractTexture::RGB32U0x8D71GL_RGB32UI
Qt3DRender::QAbstractTexture::RGBA32U0x8D70GL_RGBA32UI
Qt3DRender::QAbstractTexture::R8I0x8231GL_R8I
Qt3DRender::QAbstractTexture::RG8I0x8237GL_RG8I
Qt3DRender::QAbstractTexture::RGB8I0x8D8FGL_RGB8I
Qt3DRender::QAbstractTexture::RGBA8I0x8D8EGL_RGBA8I
Qt3DRender::QAbstractTexture::R16I0x8233GL_R16I
Qt3DRender::QAbstractTexture::RG16I0x8239GL_RG16I
Qt3DRender::QAbstractTexture::RGB16I0x8D89GL_RGB16I
Qt3DRender::QAbstractTexture::RGBA16I0x8D88GL_RGBA16I
Qt3DRender::QAbstractTexture::R32I0x8235GL_R32I
Qt3DRender::QAbstractTexture::RG32I0x823BGL_RG32I
Qt3DRender::QAbstractTexture::RGB32I0x8D83GL_RGB32I
Qt3DRender::QAbstractTexture::RGBA32I0x8D82GL_RGBA32I
Qt3DRender::QAbstractTexture::R16F0x822DGL_R16F
Qt3DRender::QAbstractTexture::RG16F0x822FGL_RG16F
Qt3DRender::QAbstractTexture::RGB16F0x881BGL_RGB16F
Qt3DRender::QAbstractTexture::RGBA16F0x881AGL_RGBA16F
Qt3DRender::QAbstractTexture::R32F0x822EGL_R32F
Qt3DRender::QAbstractTexture::RG32F0x8230GL_RG32F
Qt3DRender::QAbstractTexture::RGB32F0x8815GL_RGB32F
Qt3DRender::QAbstractTexture::RGBA32F0x8814GL_RGBA32F
Qt3DRender::QAbstractTexture::RGB9E50x8C3DGL_RGB9_E5
Qt3DRender::QAbstractTexture::RG11B10F0x8C3AGL_R11F_G11F_B10F
Qt3DRender::QAbstractTexture::RG3B20x2A10GL_R3_G3_B2
Qt3DRender::QAbstractTexture::R5G6B50x8D62GL_RGB565
Qt3DRender::QAbstractTexture::RGB5A10x8057GL_RGB5_A1
Qt3DRender::QAbstractTexture::RGBA40x8056GL_RGBA4
Qt3DRender::QAbstractTexture::RGB10A20x8059GL_RGB10_A2
Qt3DRender::QAbstractTexture::RGB10A2U0x906FGL_RGB10_A2UI
Qt3DRender::QAbstractTexture::D160x81A5GL_DEPTH_COMPONENT16
Qt3DRender::QAbstractTexture::D240x81A6GL_DEPTH_COMPONENT24
Qt3DRender::QAbstractTexture::D24S80x88F0GL_DEPTH24_STENCIL8
Qt3DRender::QAbstractTexture::D320x81A7GL_DEPTH_COMPONENT32
Qt3DRender::QAbstractTexture::D32F0x8CACGL_DEPTH_COMPONENT32F
Qt3DRender::QAbstractTexture::D32FS8X240x8CADGL_DEPTH32F_STENCIL8
Qt3DRender::QAbstractTexture::RGB_DXT10x83F0GL_COMPRESSED_RGB_S3TC_DXT1_EXT
Qt3DRender::QAbstractTexture::RGBA_DXT10x83F1GL_COMPRESSED_RGBA_S3TC_DXT1_EXT
Qt3DRender::QAbstractTexture::RGBA_DXT30x83F2GL_COMPRESSED_RGBA_S3TC_DXT3_EXT
Qt3DRender::QAbstractTexture::RGBA_DXT50x83F3GL_COMPRESSED_RGBA_S3TC_DXT5_EXT
Qt3DRender::QAbstractTexture::R_ATI1N_UNorm0x8DBBGL_COMPRESSED_RED_RGTC1
Qt3DRender::QAbstractTexture::R_ATI1N_SNorm0x8DBCGL_COMPRESSED_SIGNED_RED_RGTC1
Qt3DRender::QAbstractTexture::RG_ATI2N_UNorm0x8DBDGL_COMPRESSED_RG_RGTC2
Qt3DRender::QAbstractTexture::RG_ATI2N_SNorm0x8DBEGL_COMPRESSED_SIGNED_RG_RGTC2
Qt3DRender::QAbstractTexture::RGB_BP_UNSIGNED_FLOAT0x8E8FGL_COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT_ARB
Qt3DRender::QAbstractTexture::RGB_BP_SIGNED_FLOAT0x8E8EGL_COMPRESSED_RGB_BPTC_SIGNED_FLOAT_ARB
Qt3DRender::QAbstractTexture::RGB_BP_UNorm0x8E8CGL_COMPRESSED_RGBA_BPTC_UNORM_ARB
Qt3DRender::QAbstractTexture::R11_EAC_UNorm0x9270GL_COMPRESSED_R11_EAC
Qt3DRender::QAbstractTexture::R11_EAC_SNorm0x9271GL_COMPRESSED_SIGNED_R11_EAC
Qt3DRender::QAbstractTexture::RG11_EAC_UNorm0x9272GL_COMPRESSED_RG11_EAC
Qt3DRender::QAbstractTexture::RG11_EAC_SNorm0x9273GL_COMPRESSED_SIGNED_RG11_EAC
Qt3DRender::QAbstractTexture::RGB8_ETC20x9274GL_COMPRESSED_RGB8_ETC2
Qt3DRender::QAbstractTexture::SRGB8_ETC20x9275GL_COMPRESSED_SRGB8_ETC2
Qt3DRender::QAbstractTexture::RGB8_PunchThrough_Alpha1_ETC20x9276GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
Qt3DRender::QAbstractTexture::SRGB8_PunchThrough_Alpha1_ETC20x9277GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2
Qt3DRender::QAbstractTexture::RGBA8_ETC2_EAC0x9278GL_COMPRESSED_RGBA8_ETC2_EAC
Qt3DRender::QAbstractTexture::SRGB8_Alpha8_ETC2_EAC0x9279GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC
Qt3DRender::QAbstractTexture::RGB8_ETC10x8D64GL_ETC1_RGB8_OES
Qt3DRender::QAbstractTexture::SRGB80x8C41GL_SRGB8
Qt3DRender::QAbstractTexture::SRGB8_Alpha80x8C43GL_SRGB8_ALPHA8
Qt3DRender::QAbstractTexture::SRGB_DXT10x8C4CGL_COMPRESSED_SRGB_S3TC_DXT1_EXT
Qt3DRender::QAbstractTexture::SRGB_Alpha_DXT10x8C4DGL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT
Qt3DRender::QAbstractTexture::SRGB_Alpha_DXT30x8C4EGL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT
Qt3DRender::QAbstractTexture::SRGB_Alpha_DXT50x8C4FGL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT
Qt3DRender::QAbstractTexture::SRGB_BP_UNorm0x8E8DGL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM_ARB
Qt3DRender::QAbstractTexture::DepthFormat0x1902GL_DEPTH_COMPONENT
Qt3DRender::QAbstractTexture::AlphaFormat0x1906GL_ALPHA
Qt3DRender::QAbstractTexture::RGBFormat0x1907GL_RGB
Qt3DRender::QAbstractTexture::RGBAFormat0x1908GL_RGBA
Qt3DRender::QAbstractTexture::LuminanceFormat0x1909GL_LUMINANCE
Qt3DRender::QAbstractTexture::LuminanceAlphaFormat0x190A0x190A

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

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

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

[explicit 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.

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().

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.

Qt3DRender::QAbstractTexture::HandleType QAbstractTexture::handleType() const

Returns the current texture handle type.

Note: Getter function for property handleType.

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().

[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().

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().

[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::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.

[invokable] 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.

int QAbstractTexture::width() const

Returns the width of the texture

Note: Getter function for property width.

See also setWidth().

© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.