Sur cette page

QSGTextureMaterial Class

La classe `QSGTextureMaterial` 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 <QSGTextureMaterial>
CMake : find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake : QT += quick
Hérite de : QSGOpaqueTextureMaterial

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 texturé remplira chaque pixel d’une géométrie avec la texture fournie.

La géométrie à rendre avec un matériau texturé nécessite des sommets à l'emplacement d'attribut 0 et des coordonnées de texture à l'emplacement d'attribut 1. Les coordonnées de texture sont 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 sa liaison.

Le matériau texturé respecte la matrice actuelle et le canal alpha de la texture. Il respectera également l’opacité accumulée dans le graphe 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.

© 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.