QSGOpaqueTextureMaterial Class
La classe QSGOpaqueTextureMaterial fournit un moyen pratique de rendre la géométrie texturée dans le graphe de scène. Plus d'informations...
| En-tête : | #include <QSGOpaqueTextureMaterial> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake : | QT += quick |
| Hérite : | QSGMaterial |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QSGOpaqueTextureMaterial fait partie de Qt Quick Scene Graph Material Classes.
Fonctions publiques
| 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 |
Description détaillée
Avertissement : Cette classe utilitaire n'est fonctionnelle que lorsqu'elle est exécutée avec le backend par défaut du graphe de scène Qt Quick.
Le matériau texturé opaque remplit chaque pixel d'une géométrie avec la texture fournie. Le matériau ne respecte pas l'opacité de QSGMaterialShader::RenderState, de sorte que les nœuds d'opacité dans la chaîne parentale des nœuds utilisant ce matériau n'ont aucun effet.
La géométrie à rendre avec un matériau de texture opaque nécessite des sommets à l'emplacement d'attribut 0 et des coordonnées de texture à l'emplacement d'attribut 1. La coordonnée de texture est un tuple bidimensionnel à virgule flottante. La page QSGGeometry::defaultAttributes_TexturedPoint2D renvoie un jeu d'attributs compatible avec ce matériau.
La texture à rendre peut être définie à l'aide de setTexture(). La manière dont la texture doit être rendue peut être spécifiée à l'aide de setMipmapFiltering(), setFiltering(), setHorizontalWrapMode() et setVerticalWrapMode(). L'état de rendu est défini sur l'instance de texture juste avant qu'elle ne soit liée.
Le matériau texturé opaque respecte la matrice actuelle et le canal alpha de la texture. Il ne tient pas compte de l'opacité accumulée dans le graphe de scène.
Un matériau de texture doit avoir une texture définie avant d'être utilisé comme matériau dans le graphe de scène.
Documentation des fonctions membres
QSGOpaqueTextureMaterial::QSGOpaqueTextureMaterial()
Crée un nouveau matériau QSGOpaqueTextureMaterial.
Le mode de filtrage mipmap et de filtrage par défaut est défini sur QSGTexture::Nearest. Le mode d'enveloppement par défaut est défini sur QSGTexture::ClampToEdge.
QSGTexture::AnisotropyLevel QSGOpaqueTextureMaterial::anisotropyLevel() const
Renvoie le niveau d'anistropie de ce matériau.
Voir également setAnisotropyLevel().
QSGTexture::Filtering QSGOpaqueTextureMaterial::filtering() const
Renvoie le mode de filtrage de ce matériau.
Le mode de filtrage par défaut est QSGTexture::Nearest.
Voir aussi setFiltering().
QSGTexture::WrapMode QSGOpaqueTextureMaterial::horizontalWrapMode() const
Renvoie le mode d'habillage horizontal de ce matériau.
Le mode d'habillage horizontal par défaut est QSGTexture::ClampToEdge.
Voir également setHorizontalWrapMode().
QSGTexture::Filtering QSGOpaqueTextureMaterial::mipmapFiltering() const
Renvoie le mode de filtrage mipmap de ce matériau.
Le mode mipmap par défaut est QSGTexture::Nearest.
Voir également setMipmapFiltering().
void QSGOpaqueTextureMaterial::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)
Fixe le niveau d'anistropie de ce matériau à level.
Voir aussi anisotropyLevel().
void QSGOpaqueTextureMaterial::setFiltering(QSGTexture::Filtering filtering)
Définit le filtrage sur filtering.
Le mode de filtrage est défini sur l'instance de texture juste avant que la texture ne soit liée pour le rendu.
Voir aussi filtering().
void QSGOpaqueTextureMaterial::setHorizontalWrapMode(QSGTexture::WrapMode mode)
Définit le mode d'habillage horizontal à mode.
Le mode d'habillage horizontal est défini sur l'instance de texture juste avant que la texture ne soit liée pour le rendu.
Voir également horizontalWrapMode().
void QSGOpaqueTextureMaterial::setMipmapFiltering(QSGTexture::Filtering filtering)
Définit le mode mipmap sur filtering.
Le mode de filtrage mipmap est défini sur l'instance de texture juste avant que la texture ne soit liée pour le rendu.
Si la texture ne supporte pas le mipmapping, l'activation du mipmapping n'a aucun effet.
Voir également mipmapFiltering().
void QSGOpaqueTextureMaterial::setTexture(QSGTexture *texture)
Définit la texture de ce matériau à texture.
Le matériau n'est pas propriétaire de la texture.
Voir aussi texture().
void QSGOpaqueTextureMaterial::setVerticalWrapMode(QSGTexture::WrapMode mode)
Définit le mode d'habillage vertical à mode.
Le mode d'habillage vertical est défini sur l'instance de texture juste avant que la texture ne soit liée pour le rendu.
Voir également verticalWrapMode().
QSGTexture *QSGOpaqueTextureMaterial::texture() const
Renvoie la texture de ce matériau.
Voir aussi setTexture().
QSGTexture::WrapMode QSGOpaqueTextureMaterial::verticalWrapMode() const
Renvoie le mode d'habillage vertical de ce matériau.
Le mode d'habillage vertical par défaut est QSGTexture::ClampToEdge.
Voir également 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.
