QSGOpaqueTextureMaterial 类
QSGOpaqueTextureMaterial 类提供了一种方便的方法来在场景图中渲染纹理几何形状。了解更多...
| 头文件 | #include <QSGOpaqueTextureMaterial> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake | QT += quick |
| 继承 | QSGMaterial |
| 继承自 |
- 所有成员列表，包括继承成员
- QSGOpaqueTextureMaterial 是 Qt Quick Scene Graph 材料类的一部分Qt Quick Scene Graph 材料类。
公开函数
| QSGOpaqueTextureMaterial() | |
| QSGTexture::AnisotropyLevel | anisotropyLevel() const |
| QSGTexture::Filtering | filtering() const |
| QSGTexture::WrapMode | horizontalWrapMode() const |
| QSGTexture::Filtering | mipmapFiltering() const |
| void | setAnisotropyLevel(QSGTexture::AnisotropyLevel level) |
| void | setFiltering(QSGTexture::Filtering filtering) |
| void | setHorizontalWrapMode(QSGTexture::WrapMode mode) |
| void | setMipmapFiltering(QSGTexture::Filtering filtering) |
| void | setTexture(QSGTexture *texture) |
| void | setVerticalWrapMode(QSGTexture::WrapMode mode) |
| QSGTexture * | texture() const |
| QSGTexture::WrapMode | verticalWrapMode() const |
详细描述
警告： 此实用工具类仅在运行 Qt Quick 场景图默认后端时功能正常。
不透明纹理材料将填充几何形状中的每个像素以提供的纹理。该材料不遵守 QSGMaterialShader::RenderState 的不透明度，因此使用此材料节点的父链中的不透明度节点没有任何效果。
使用不透明纹理材料进行渲染的几何形状需要包含在属性位置 0 的顶点以及在属性位置 1 的纹理坐标。纹理坐标是一个二维浮点元组。QSGGeometry::defaultAttributes_TexturedPoint2D 返回一个与此材料兼容的属性集。
要渲染的纹理可以通过 setTexture() 设置。纹理的渲染方式可以通过 setMipmapFiltering()，setFiltering()，setHorizontalWrapMode() 和 setVerticalWrapMode() 来指定。渲染状态将在纹理实例绑定之前设置。
不透明的纹理材质会尊重纹理的当前矩阵和 Alpha 通道。它会忽略场景图中累积的透明度。
在场景图中作为材质使用之前，纹理材质必须设置纹理。
成员函数文档
QSGOpaqueTextureMaterial::QSGOpaqueTextureMaterial()
创建一个新的 QSGOpaqueTextureMaterial。
默认的米柏过滤和过滤模式设置为 QSGTexture::Nearest。默认的环绕模式设置为 QSGTexture::ClampToEdge。
QSGTexture::AnisotropyLevel QSGOpaqueTextureMaterial::anisotropyLevel() const
返回此材质的各向异性等级。
QSGTexture::Filtering QSGOpaqueTextureMaterial::filtering() const
返回此材质的过滤模式。
默认的过滤是 QSGTexture::Nearest。
参见setFiltering。
QSGTexture::WrapMode QSGOpaqueTextureMaterial::horizontalWrapMode() const
返回此材质的水平环绕模式。
默认的水平环绕模式是 QSGTexture::ClampToEdge。
QSGTexture::Filtering QSGOpaqueTextureMaterial::mipmapFiltering() const
返回此材质的米柏过滤模式。
默认的米柏模式是 QSGTexture::Nearest。
void QSGOpaqueTextureMaterial::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)
将此材质的各向异性等级设置为 level。
void QSGOpaqueTextureMaterial::setFiltering(QSGTexture::Filtering filtering)
设置过滤模式为 filtering。
过滤模式将在绑定纹理进行渲染之前设置在纹理实例上。
参见filtering。
void QSGOpaqueTextureMaterial::setHorizontalWrapMode(QSGTexture::WrapMode mode)
将水平环绕模式设置为 mode。
水平环绕模式将在绑定纹理进行渲染之前设置在纹理实例上。
void QSGOpaqueTextureMaterial::setMipmapFiltering(QSGTexture::Filtering filtering)
设置米泊（Mipmap）模式为 过滤。
在纹理绑定渲染之前，将对纹理实例设置米泊过滤模式。
如果纹理没有支持米泊，启用米泊不会产生效果。
另请参阅 mipmapFiltering()。
void QSGOpaqueTextureMaterial::setTexture(QSGTexture *texture)
将此材质的纹理设置为 texture。
材质不会获取纹理的所有权。
另请参阅 texture()。
void QSGOpaqueTextureMaterial::setVerticalWrapMode(QSGTexture::WrapMode mode)
将垂直封装模式设置为 mode。
在纹理绑定渲染前，将对纹理实例设置垂直封装模式。
另请参阅 verticalWrapMode()。
QSGTexture *QSGOpaqueTextureMaterial::texture() const
返回此纹理材质的纹理。
另请参阅 setTexture()。
QSGTexture::WrapMode QSGOpaqueTextureMaterial::verticalWrapMode() const
返回此材质的垂直封装模式。
默认的垂直封装模式是 QSGTexture::ClampToEdge。
另请参阅 setVerticalWrapMode()。
© 2024 Qt公司有限公司。此处包含的文档贡献的版权归其所有者所有。此处提供的文档是根据自由软件基金会发布的GNU自由文档许可证版本1.3的条款授权使用的。Qt及其相关商标是芬兰和/或其他地区的Qt公司有限公司的商标。所有其他商标均为其所有者的财产。
