QAbstractTextureImage Class

class Qt3DRender::QAbstractTextureImage

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

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

Qt3DRender::QPaintedTextureImage and Qt3DRender::QTextureImage

Properties

Public Functions

QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr)
QAbstractTexture::CubeMapFace face() const
int layer() const
int mipLevel() const

Public Slots

void setFace(QAbstractTexture::CubeMapFace face)
void setLayer(int layer)
void setMipLevel(int level)

Signals

void faceChanged(QAbstractTexture::CubeMapFace face)
void layerChanged(int layer)
void mipLevelChanged(int mipLevel)

Protected Functions

virtual Qt3DRender::QTextureImageDataGeneratorPtr dataGenerator() const = 0
void notifyDataGeneratorChanged()

Detailed Description

QAbstractTextureImage should be used as the means of providing image data to a QAbstractTexture. It contains the necessary information: mipmap level, layer, cube face load at the proper place data into an OpenGL texture.

The actual data is provided through a QTextureImageDataGenerator that will be executed by Aspect jobs in the backend. QAbstractTextureImage should be subclassed to provide a functor and eventual additional properties needed by the functor to load actual data.

Note: : QAbstractTextureImage should never be shared. Expect crashes, undefined behavior at best if this rule is not respected.

Property Documentation

face : Qt3DRender::QAbstractTexture::CubeMapFace

Holds the cube map face of the texture image.

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

Access functions:

QAbstractTexture::CubeMapFace face() const
void setFace(QAbstractTexture::CubeMapFace face)

Notifier signal:

void faceChanged(QAbstractTexture::CubeMapFace face)

layer : int

Returns the layer of the texture image.

Access functions:

int layer() const
void setLayer(int layer)

Notifier signal:

void layerChanged(int layer)

mipLevel : int

Holds the mipmap level of the texture image.

Access functions:

int mipLevel() const
void setMipLevel(int level)

Notifier signal:

void mipLevelChanged(int mipLevel)

Member Function Documentation

QAbstractTextureImage::QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr)

Constructs a new QAbstractTextureImage instance with parent as parent.

[slot] void QAbstractTextureImage::setFace(QAbstractTexture::CubeMapFace face)

Sets the texture image face to face. face

Note: Setter function for property face.

See also face().

[slot] void QAbstractTextureImage::setLayer(int layer)

Sets the layer of a texture to layer. layer

Note: Setter function for property layer.

See also layer().

[slot] void QAbstractTextureImage::setMipLevel(int level)

Sets the mip level of a texture to level. level

Note: Setter function for property mipLevel.

See also mipLevel().

[pure virtual protected] Qt3DRender::QTextureImageDataGeneratorPtr QAbstractTextureImage::dataGenerator() const

Implement this method to return the QTextureImageDataGeneratorPtr instance, which will provide the data for the texture image.

[protected] void QAbstractTextureImage::notifyDataGeneratorChanged()

Triggers an update of the data generator that is sent to the backend.

© 2024 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.