QSGOpaqueTextureMaterial Class
Die Klasse QSGOpaqueTextureMaterial bietet eine bequeme Möglichkeit, texturierte Geometrie im Szenegraph darzustellen. Mehr...
| Kopfzeile: | #include <QSGOpaqueTextureMaterial> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Vererbt: | QSGMaterial |
| Vererbt von: |
- Liste aller Member, einschließlich geerbter Member
- QSGOpaqueTextureMaterial ist Teil von Qt Quick Scene Graph Material Classes.
Öffentliche Funktionen
| 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 |
Detaillierte Beschreibung
Warnung: Diese Utility-Klasse ist nur funktionsfähig, wenn sie mit dem Standard-Backend des Qt Quick Scenegraphs läuft.
Das opaque texturierte Material füllt jedes Pixel in einer Geometrie mit der gelieferten Textur. Das Material berücksichtigt nicht die Deckkraft der QSGMaterialShader::RenderState, so dass Deckkraftknoten in der übergeordneten Kette von Knoten, die dieses Material verwenden, keine Auswirkungen haben.
Die Geometrie, die mit einem opaken Texturmaterial gerendert werden soll, benötigt Scheitelpunkte 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 opake texturierte Material respektiert die aktuelle Matrix und den Alphakanal der Textur. Es wird die akkumulierte Deckkraft im Scenegraph ignorieren.
Für ein Texturmaterial muss eine Textur gesetzt werden, bevor es als Material im Szenegraphen verwendet wird.
Dokumentation der Mitgliedsfunktionen
QSGOpaqueTextureMaterial::QSGOpaqueTextureMaterial()
Erzeugt ein neues QSGOpaqueTextureMaterial.
Der standardmäßige Mipmap-Filter- und Filtermodus ist auf QSGTexture::Nearest eingestellt. Der standardmäßige Wrap-Modus ist auf QSGTexture::ClampToEdge eingestellt.
QSGTexture::AnisotropyLevel QSGOpaqueTextureMaterial::anisotropyLevel() const
Gibt den Anistropiegrad dieses Materials zurück.
Siehe auch setAnisotropyLevel().
QSGTexture::Filtering QSGOpaqueTextureMaterial::filtering() const
Gibt den Filtermodus für dieses Material zurück.
Die Standardfilterung ist QSGTexture::Nearest.
Siehe auch setFiltering().
QSGTexture::WrapMode QSGOpaqueTextureMaterial::horizontalWrapMode() const
Gibt den horizontalen Umbruchmodus dieses Materials zurück.
Der Standardmodus für den horizontalen Umbruch ist QSGTexture::ClampToEdge.
Siehe auch setHorizontalWrapMode().
QSGTexture::Filtering QSGOpaqueTextureMaterial::mipmapFiltering() const
Gibt den Mipmap-Filtermodus dieses Materials zurück.
Der Standard-Mipmap-Modus ist QSGTexture::Nearest.
Siehe auch setMipmapFiltering().
void QSGOpaqueTextureMaterial::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)
Setzt den Anistropiegrad dieses Materials auf level.
Siehe auch anisotropyLevel().
void QSGOpaqueTextureMaterial::setFiltering(QSGTexture::Filtering filtering)
Setzt die Filterung auf filtering.
Der Filtermodus wird für die Texturinstanz festgelegt, kurz bevor die Textur zum Rendern gebunden wird.
Siehe auch filtering().
void QSGOpaqueTextureMaterial::setHorizontalWrapMode(QSGTexture::WrapMode mode)
Setzt den horizontalen Umbruchmodus auf mode.
Der horizontale Umbruchmodus wird für die Texturinstanz festgelegt, kurz bevor die Textur zum Rendern gebunden wird.
Siehe auch horizontalWrapMode().
void QSGOpaqueTextureMaterial::setMipmapFiltering(QSGTexture::Filtering filtering)
Setzt den Mipmap-Modus auf filtering.
Der Mipmap-Filtermodus wird in der Texturinstanz festgelegt, kurz bevor die Textur zum Rendern gebunden wird.
Wenn die Textur keine Mipmapping-Unterstützung hat, hat die Aktivierung von Mipmapping keinen Effekt.
Siehe auch mipmapFiltering().
void QSGOpaqueTextureMaterial::setTexture(QSGTexture *texture)
Setzt die Textur dieses Materials auf texture.
Das Material übernimmt nicht das Eigentum an der Textur.
Siehe auch texture().
void QSGOpaqueTextureMaterial::setVerticalWrapMode(QSGTexture::WrapMode mode)
Setzt den vertikalen Umbruchmodus auf mode.
Der vertikale Umbruchmodus wird für die Texturinstanz festgelegt, kurz bevor die Textur zum Rendern gebunden wird.
Siehe auch verticalWrapMode().
QSGTexture *QSGOpaqueTextureMaterial::texture() const
Gibt die Textur dieses Texturmaterials zurück.
Siehe auch setTexture().
QSGTexture::WrapMode QSGOpaqueTextureMaterial::verticalWrapMode() const
Gibt den vertikalen Umbruchmodus dieses Materials zurück.
Der Standardmodus für den vertikalen Umbruch ist QSGTexture::ClampToEdge.
Siehe auch setVerticalWrapMode().
© 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.
