QAbstractTextureImage Class
class Qt3DRender::QAbstractTextureImageEncapsulates the necessary information to create an OpenGL texture image. More...
| Header: | #include <QAbstractTextureImage> |
| qmake: | QT += 3drender |
| Since: | Qt 5.5 |
| Instantiated By: | AbstractTextureImage |
| Inherits: | Qt3DCore::QNode |
| Inherited By: | Qt3DRender::QPaintedTextureImage and Qt3DRender::QTextureImage |
This class was introduced in Qt 5.5.
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.