QSGOpaqueTextureMaterial Class
La classe `QSGOpaqueTextureMaterial` offre un moyen pratique de rendre des géométries texturées dans le graphe de scène. En savoir plus...
| En-tête : | #include <QSGOpaqueTextureMaterial> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake : | QT += quick |
| Hérite de : | QSGMaterial |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- QSGOpaqueTextureMaterial fait partie des classes de matériaux du graphe de scène d'Qt Quick .
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 ne fonctionne que lorsqu’elle est exécutée avec le backend par défaut du graphe de scène d’ Qt Quick.
Le matériau à texture opaque remplira chaque pixel d’une géométrie avec la texture fournie. Ce matériau ne tient pas compte de l’opacité de l’ QSGMaterialShader::RenderState; par conséquent, les nœuds d’opacité situés dans la chaîne de nœuds parent utilisant ce matériau n’ont aucun effet.
La géométrie à rendre avec un matériau à 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 fonction ` QSGGeometry::defaultAttributes_TexturedPoint2D ` renvoie un ensemble d’attributs compatible avec ce matériau.
La texture à rendre peut être définie à l’aide de ` setTexture()`. Le mode de rendu de la texture peut être spécifié à 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 l’arborescence de scène.
Un matériau texturé doit disposer d’une texture définie avant de pouvoir être utilisé en tant que matériau dans le graphe de scène.
Documentation des fonctions membres
QSGOpaqueTextureMaterial::QSGOpaqueTextureMaterial()
Crée un nouvel objet QSGOpaqueTextureMaterial.
Le filtrage mipmap et le mode de filtrage par défaut sont définis sur « QSGTexture::Nearest ». Le mode d'enroulement par défaut est défini sur « QSGTexture::ClampToEdge ».
QSGTexture::AnisotropyLevel QSGOpaqueTextureMaterial::anisotropyLevel() const
Renvoie le niveau d'anisotropie de ce matériau.
Voir aussi setAnisotropyLevel().
QSGTexture::Filtering QSGOpaqueTextureMaterial::filtering() const
Renvoie le mode de filtrage de ce matériel.
Le filtrage par défaut est « QSGTexture::Nearest ».
Voir aussi setFiltering().
QSGTexture::WrapMode QSGOpaqueTextureMaterial::horizontalWrapMode() const
Renvoie le mode de retour à la ligne horizontal de ce matériau.
Le mode de retour à la ligne 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 aussi setMipmapFiltering().
void QSGOpaqueTextureMaterial::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)
Définit le niveau d'anisotropie de ce matériau sur « level ».
Voir également 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 celle-ci ne soit liée pour le rendu.
Voir aussi filtering().
void QSGOpaqueTextureMaterial::setHorizontalWrapMode(QSGTexture::WrapMode mode)
Définit le mode de répétition horizontale sur « mode ».
Le mode de défilement horizontal est défini sur l'instance de texture juste avant que celle-ci 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 par mipmap est défini sur l'instance de texture juste avant que celle-ci ne soit liée pour le rendu.
Si la texture ne prend pas en charge le mipmapping, l'activation de cette fonctionnalité n'a aucun effet.
Voir également mipmapFiltering().
void QSGOpaqueTextureMaterial::setTexture(QSGTexture *texture)
Définit la texture de ce matériau sur « texture ».
Le matériau ne devient pas propriétaire de la texture.
Voir également texture().
void QSGOpaqueTextureMaterial::setVerticalWrapMode(QSGTexture::WrapMode mode)
Définit le mode d'enveloppement vertical sur « mode ».
Le mode de répétition verticale est défini sur l'instance de texture juste avant que celle-ci 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 de retour à la ligne vertical de ce matériau.
Le mode de retour à la ligne 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.
