QSGTextureMaterial Class

Die Klasse QSGTextureMaterial bietet eine bequeme Möglichkeit, texturierte Geometrie im Szenegraph darzustellen. Mehr...

Kopfzeile: #include <QSGTextureMaterial>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Vererbt: QSGOpaqueTextureMaterial

Detaillierte Beschreibung

Warnung: Diese Utility-Klasse ist nur funktionsfähig, wenn sie mit dem Standard-Backend des Qt Quick Scenegraphs läuft.

Das texturierte Material füllt jedes Pixel in einer Geometrie mit der angegebenen Textur.

Die Geometrie, die mit einem Texturmaterial gerendert werden soll, benötigt Vertices an Attributposition 0 und Texturkoordinaten an Attributposition 1. Die Texturkoordinate ist ein 2-dimensionales Gleitkomma-Tupel. QSGGeometry::defaultAttributes_TexturedPoint2D gibt einen mit diesem Material kompatiblen Attributsatz zurück.

Die zu rendernde Textur kann mit setTexture() gesetzt werden. Wie die Textur gerendert werden soll, kann mit setMipmapFiltering(), setFiltering(), setHorizontalWrapMode() und setVerticalWrapMode() angegeben werden. Der Rendering-Status wird auf die Texturinstanz gesetzt, kurz bevor sie gebunden wird.

Das texturierte Material respektiert die aktuelle Matrix und den Alphakanal der Textur. Es wird auch die akkumulierte Deckkraft im Szenegraphen berücksichtigen.

Für ein Texturmaterial muss eine Textur gesetzt werden, bevor es als Material im Szenegraphen verwendet wird.

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