QSGOpaqueTextureMaterial Class
QSGOpaqueTextureMaterial クラスは、シーングラフ内でテクスチャが適用されたジオメトリをレンダリングするための便利な手段を提供します。詳細...
| ヘッダー: | #include <QSGOpaqueTextureMaterial> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| 継承元: | QSGMaterial |
| 継承元: |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- QSGOpaqueTextureMaterial は、Qt Quick のシーングラフマテリアルクラスの一部です。
パブリック関数
| 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 にテクスチャ座標が必要です。テクスチャ座標は 2 次元の浮動小数点数タプルです。QSGGeometry::defaultAttributes_TexturedPoint2D は、このマテリアルと互換性のある属性セットを返します。
レンダリングするテクスチャは、setTexture() を使用して設定できます。テクスチャのレンダリング方法は、setMipmapFiltering()、setFiltering()、setHorizontalWrapMode()、およびsetVerticalWrapMode() を使用して指定できます。レンダリング状態は、テクスチャインスタンスがバインドされる直前に設定されます。
不透明テクスチャマテリアルは、テクスチャの現在のマトリクスおよびアルファチャンネルを反映します。シーングラフで蓄積された不透明度は無視されます。
テクスチャマテリアルは、シーングラフ内でマテリアルとして使用される前に、テクスチャが設定されている必要があります。
メンバ関数のドキュメント
QSGOpaqueTextureMaterial::QSGOpaqueTextureMaterial()
新しい QSGOpaqueTextureMaterial を作成します。
デフォルトのミップマップフィルタリングおよびフィルタリングモードは、QSGTexture::Nearest に設定されています。デフォルトのラップモードは、QSGTexture::ClampToEdge に設定されています。
QSGTexture::AnisotropyLevel QSGOpaqueTextureMaterial::anisotropyLevel() const
このマテリアルの異方性レベルを返します。
setAnisotropyLevel()も参照してください 。
QSGTexture::Filtering QSGOpaqueTextureMaterial::filtering() const
このマテリアルのフィルタリングモードを返します。
デフォルトのフィルタリングは「QSGTexture::Nearest 」です。
setFiltering()も参照してください 。
QSGTexture::WrapMode QSGOpaqueTextureMaterial::horizontalWrapMode() const
このマテリアルの水平方向の折り返しモードを返します。
デフォルトの水平方向の折り返しモードは `QSGTexture::ClampToEdge` です。
setHorizontalWrapMode()も参照してください 。
QSGTexture::Filtering QSGOpaqueTextureMaterial::mipmapFiltering() const
このマテリアルのミップマップフィルタリングモードを返します。
デフォルトのミップマップモードは `QSGTexture::Nearest` です。
setMipmapFiltering()も参照してください 。
void QSGOpaqueTextureMaterial::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)
このマテリアルの異方性レベルをlevel に設定します。
anisotropyLevel()も参照してください 。
void QSGOpaqueTextureMaterial::setFiltering(QSGTexture::Filtering filtering)
フィルタリングを「filtering 」に設定します。
フィルタリングモードは、テクスチャがレンダリング用にバインドされる直前に、テクスチャインスタンスに対して設定されます。
filtering()も参照してください 。
void QSGOpaqueTextureMaterial::setHorizontalWrapMode(QSGTexture::WrapMode mode)
水平方向のラップモードをmode に設定します。
水平方向の折り返しモードは、テクスチャがレンダリング用にバインドされる直前に、テクスチャインスタンスに対して設定されます。
horizontalWrapMode()も参照してください 。
void QSGOpaqueTextureMaterial::setMipmapFiltering(QSGTexture::Filtering filtering)
ミップマップモードをfiltering に設定します。
ミップマップフィルタリングモードは、テクスチャがレンダリング用にバインドされる直前に、テクスチャインスタンスに対して設定されます。
テクスチャがミップマッピングに対応していない場合、ミップマッピングを有効にしても何の効果もありません。
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()も参照してください 。
© 2026 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.
