QTextureImage 类
class Qt3DRender::QTextureImage封装从图像源创建 OpenGL 纹理图像所需的信息。更多...
| 头文件 | #include <QTextureImage> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake | QT += 3drender |
| 由以下类实例化 | TextureImage |
| 继承自 | Qt3DRender::QAbstractTextureImage |
公共类型
| 枚举 | Status { None, Loading, Ready, Error } |
属性
公共函数
| QTextureImage(Qt3DCore::QNode *parent = nullptr) | |
| bool | isMirrored() const |
| QUrl | source() const |
| Qt3DRender::QTextureImage::Status | status() const |
公共槽
| void | setMirrored(bool mirrored) |
| void | setSource(const QUrl &source) |
信号
| void | mirroredChanged(bool mirrored) |
| void | sourceChanged(const QUrl &source) |
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
受保护的函数
| void | setStatus(Qt3DRender::QTextureImage::Status status) |
成员类型文档
enum QTextureImage::Status
此枚举指定了纹理图像加载的状态值。
| 常量 | 值 | 描述 |
|---|---|---|
Qt3DRender::QTextureImage::None | 0 | 纹理图像加载尚未开始。 |
Qt3DRender::QTextureImage::Loading | 1 | 纹理图像加载已经开始，但尚未完成。 |
Qt3DRender::QTextureImage::Ready | 2 | 纹理图像加载已完成。 |
Qt3DRender::QTextureImage::Error | 3 | 纹理图像加载遇到错误。 |
属性文档
mirrored : bool
此属性指定在加载时是否应对图像进行翻转。这是一个便利功能，以避免不得不操作图像以匹配渲染API使用的纹理坐标的原点。默认情况下，此属性设置为true。当使用GPU压缩纹理格式时，此属性没有任何效果。
警告：当使用未压缩的或CPU压缩的图像格式（如PNG）时，此属性会在运行时以性能代价进行支付。为避免此性能代价，最好将此属性设置为false，并加载预翻转的纹理资产。
注意：OpenGL指定从左下角定义纹理坐标的起点，而DirectX使用的是左上角。
注意：当使用立方体贴图纹理时，您可能希望禁用翻转，因为立方体贴图采样器使用的是方向而不是常规的纹理坐标。
访问函数
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
通知信号
| void | mirroredChanged(bool mirrored) |
source : QUrl
此属性包含从其中加载纹理图像数据的源URL。
访问函数
通知信号
| void | sourceChanged(const QUrl &source) |
[只读] status : const Status
此属性包含纹理图像加载状态。
- TextureImage.None
- TextureImage.Loading
- TextureImage.Ready
- TextureImage.Error
访问函数
| Qt3DRender::QTextureImage::Status | status() const |
通知信号
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
成员函数文档
[显式构造] QTextureImage::QTextureImage(Qt3DCore::QNode *parent = nullptr)
使用指定的parent作为父对象构建一个新的Qt3DRender::QTextureImage实例。
bool QTextureImage::isMirrored() const
返回是否启用了翻转。
注意：属性mirrored的获取器函数。
[槽函数] void QTextureImage::setMirrored(bool mirrored)
将翻转设置为mirrored。
注意：这内部触发了调用数据生成器更新。
注意：属性mirrored的设置器函数。
另请参阅：isMirrored()。
[槽] void QTextureImage::setSource(const QUrl &source)
设置纹理图像的源URL为 source。
注意：这内部触发了调用数据生成器更新。
注意：属性 source 的设置器函数。
另请参阅：source()。
[保护的] void QTextureImage::setStatus(Qt3DRender::QTextureImage::Status status)
设置状态为 status。 status
另请参阅：status()。
QUrl QTextureImage::source() const
返回用于从纹理图像加载数据的源URL。
注意：属性 source 的获取器函数。
另请参阅：setSource()。
Qt3DRender::QTextureImage::Status QTextureImage::status() const
返回当前状态。
注意：属性 status 的获取器函数。
另请参阅：setStatus()。
© 2024 Qt公司。本文档中的贡献文档版权属于其各自的拥有者。本提供的文档是根据自由软件基金会发布的GNU自由文档许可协议版本1.3授予的许可。
