QAbstractTextureImage Class
(Qt3DRender::QAbstractTextureImage)Encapsulates 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.
© 2020 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.