QSGTextureMaterial Class
Die Klasse „QSGTextureMaterial“ bietet eine bequeme Möglichkeit, texturierte Geometrie im Szenengraphen darzustellen. Mehr...
| Header: | #include <QSGTextureMaterial> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Erbt von: | QSGOpaqueTextureMaterial |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QSGTextureMaterial ist Teil der „Qt Quick “-Szenenbaum-Materialklassen.
Ausführliche Beschreibung
Warnung: Diese Utility-Klasse ist nur funktionsfähig, wenn sie mit dem Standard-Backend des „ Qt Quick “-Szenengraphen ausgeführt wird.
Das texturierte Material füllt jedes Pixel einer Geometrie mit der bereitgestellten Textur.
Die Geometrie, die mit einem Texturmaterial gerendert werden soll, benötigt Scheitelpunkte an Attributposition 0 und Texturkoordinaten an Attributposition 1. Die Texturkoordinate ist ein zweidimensionales Fließkomma-Tupel. Die QSGGeometry::defaultAttributes_TexturedPoint2D gibt einen mit diesem Material kompatiblen Attributsatz zurück.
Die zu rendernde Textur kann mit ` setTexture()` festgelegt werden. Wie die Textur gerendert werden soll, lässt sich mit ` setMipmapFiltering()`, ` setFiltering()`, ` setHorizontalWrapMode()` und ` setVerticalWrapMode()` festlegen. Der Rendering-Zustand wird auf die Texturinstanz gesetzt, unmittelbar bevor diese gebunden wird.
Das texturierte Material berücksichtigt die aktuelle Matrix und den Alphakanal der Textur. Es berücksichtigt außerdem die im Szenengraphen akkumulierte Deckkraft.
Ein Texturmaterial muss über eine Textur verfügen, bevor es als Material im Szenengraphen verwendet werden kann.
© 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.
