Auf dieser Seite

QSGVertexColorMaterial Class

Die Klasse „QSGVertexColorMaterial“ bietet eine bequeme Möglichkeit, im Szenenbaum pro Scheitelpunkt farbige Geometrie darzustellen. Mehr...

Header: #include <QSGVertexColorMaterial>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Erbt von: QSGMaterial

Öffentliche Funktionen

Ausführliche Beschreibung

Warnung: Diese Utility-Klasse funktioniert nur, wenn sie mit dem Standard-Backend des Qt Quick -Szenengraphen ausgeführt wird.

Das Vertex-Farbmaterial weist jedem Scheitelpunkt einer Geometrie eine Farbe zu. Pixel zwischen den Scheitelpunkten werden linear interpoliert. Die Farben können Transparenz enthalten.

Die Geometrie, die mit Vertex-Farbe gerendert werden soll, muss das folgende Layout aufweisen. Die Attributposition 0 muss Scheitelpunkte enthalten. Die Attributposition 1 muss Farben enthalten, ein Tupel aus 4 Werten im RGBA-Layout. Sowohl Floats im Bereich von 0 bis 1 als auch vorzeichenlose Bytes im Bereich von 0 bis 255 sind als Farbwerte zulässig.

Hinweis: Die Render-Pipeline erwartet Pixel mit vorvervielfachtem Alpha.

QSGGeometry::defaultAttributes_ColoredPoint2D() kann verwendet werden, um einen Attributsatz zu erstellen, der mit diesem Material kompatibel ist.

Das Vertex-Farbmaterial berücksichtigt sowohl die aktuelle Deckkraft als auch die aktuelle Matrix bei der Aktualisierung seines Rendering-Zustands.

Dokumentation der Member-Funktionen

QSGVertexColorMaterial::QSGVertexColorMaterial()

Erstellt ein neues Vertex-Farbmaterial.

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