Qt3DRender::QTextureLoader Class
class Qt3DRender::QTextureLoader处理纹理加载和纹理属性设置。更多
| 头文件： | #include <Qt3DRender/QTexture> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake： | QT += 3drender |
| 在 QML 中： | TextureLoader |
| 继承： | Qt3DRender::QAbstractTexture |
| 状态： | 已废弃 |
属性
公共功能
| QTextureLoader(Qt3DCore::QNode *parent = nullptr) | |
| bool | isMirrored() const |
| QUrl | source() const |
公共插槽
| void | setMirrored(bool mirrored) |
| void | setSource(const QUrl &source) |
信号
| void | mirroredChanged(bool mirrored) |
| void | sourceChanged(const QUrl &source) |
属性文档
mirrored : bool
此属性用于指定纹理在加载时是否应被镜像。这是为了避免处理图像以匹配渲染 API 使用的纹理坐标的原点。默认情况下，该属性设置为 true。在使用 GPU 压缩纹理格式时，此属性没有任何作用。
警告 在加载未压缩或 CPU 压缩的图像格式（如 PNG）时，此属性会导致在运行时付出性能代价。为避免这种性能代价，最好将此属性设置为 false，并加载已预先镜像的纹理资产。
注： OpenGL 从左下角指定纹理坐标的原点，而 DirectX 则使用左上角。
注： 在使用立方体贴图纹理时，您可能需要禁用镜像功能，因为立方体贴图采样器获取的是一个方向，而不是常规纹理坐标。
访问功能
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
通知信号
| void | mirroredChanged(bool mirrored) |
source : QUrl
此属性保存当前纹理源。
访问功能：
| QUrl | source() const |
| void | setSource(const QUrl &source) |
Notifier 信号：
| void | sourceChanged(const QUrl &source) |
成员函数 文档
[explicit] QTextureLoader::QTextureLoader(Qt3DCore::QNode *parent = nullptr)
构建一个以parent 为父对象的新Qt3DRender::QTextureLoader 实例。
请注意，如果与文件元数据不矛盾，默认情况下加载的纹理将设置以下属性：- wrapMode 设置为 Repeat - minificationFilter 设置为 LinearMipMapLinear - magnificationFilter 设置为 Linear - generateMipMaps 设置为 true - maximumAnisotropy 设置为 16.0f - target 设置为 TargetAutomatic
[slot] void QTextureLoader::setMirrored(bool mirrored)
将镜像设置为mirrored 。
注： 这会在内部触发更新数据生成器的调用。
注： 属性mirrored 的设置函数。
另请参阅 isMirrored() 。
[slot] void QTextureLoader::setSource(const QUrl &source)
将纹理加载器源代码设置为source.source。
注： 属性source 的设置函数。
另请参阅 source().
© 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.
