Qt3DRender::QAbstractTextureImage Class
class Qt3DRender::QAbstractTextureImage封装创建 OpenGL 纹理图像所需的信息。更多
| 头文件： | #include <QAbstractTextureImage> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake： | QT += 3drender |
| 在 QML 中： | AbstractTextureImage |
| 继承： | Qt3DCore::QNode |
| 继承于 | |
| 状态： | 已废弃 |
属性
公共功能
| QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr) | |
| Qt3DRender::QAbstractTexture::CubeMapFace | face() const |
| int | layer() const |
| int | mipLevel() const |
公共插槽
| void | setFace(Qt3DRender::QAbstractTexture::CubeMapFace face) |
| void | setLayer(int layer) |
| void | setMipLevel(int level) |
信号
| void | faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face) |
| void | layerChanged(int layer) |
| void | mipLevelChanged(int mipLevel) |
受保护功能
| virtual Qt3DRender::QTextureImageDataGeneratorPtr | dataGenerator() const = 0 |
| void | notifyDataGeneratorChanged() |
详细说明
QAbstractTextureImage 用于向QAbstractTexture 提供图像数据。它包含必要的信息：mipmap 级别、图层、立方体面加载到 OpenGL 纹理的适当位置数据。
实际数据通过QTextureImageDataGenerator 提供，将由后端 Aspect 作业执行。QAbstractTextureImage 应被子类化，以提供一个函数和函数加载实际数据所需的最终附加属性。
注： ：QAbstractTextureImage 绝不应被共享。如果不遵守这一规则，可能会出现崩溃或未定义的行为。
属性文档
face : Qt3DRender::QAbstractTexture::CubeMapFace
保存纹理图像的立方体贴图面。
注： 立方体贴图面仅对TargetCubeMap 和TargetCubeMapArray 有意义。
访问功能：
| Qt3DRender::QAbstractTexture::CubeMapFace | face() const |
| void | setFace(Qt3DRender::QAbstractTexture::CubeMapFace face) |
通知信号：
| void | faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face) |
layer : int
返回纹理图像的图层。
访问功能：
| int | layer() const |
| void | setLayer(int layer) |
通知信号：
| void | layerChanged(int layer) |
mipLevel : int
保存纹理图像的 mipmap 级别。
访问功能：
| int | mipLevel() const |
| void | setMipLevel(int level) |
通知信号：
| void | mipLevelChanged(int mipLevel) |
成员函数 文档
[explicit] QAbstractTextureImage::QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr)
构造一个新的 QAbstractTextureImage 实例，父实例为parent 。
[pure virtual protected] Qt3DRender::QTextureImageDataGeneratorPtr QAbstractTextureImage::dataGenerator() const
执行此方法可返回 QTextureImageDataGeneratorPtr 实例，该实例将为纹理图像提供数据。
[protected] void QAbstractTextureImage::notifyDataGeneratorChanged()
触发数据生成器的更新，并发送至后台。
[slot] void QAbstractTextureImage::setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)
将纹理图像 face 设置为face.face。
注： 属性face 的设置函数。
另请参阅 face().
[slot] void QAbstractTextureImage::setLayer(int layer)
将纹理的图层设置为layer.
注： 属性layer 的设置函数。
另请参阅 layer()。
[slot] void QAbstractTextureImage::setMipLevel(int level)
将纹理的 mip 级别设置为level.level。
注： 属性mipLevel 的设置函数。
另请参阅 mipLevel().
© 2025 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.
