QSGOpaqueTextureMaterial Class
Die Klasse „QSGOpaqueTextureMaterial“ bietet eine bequeme Möglichkeit, texturierte Geometrie im Szenengraphen darzustellen. Mehr...
| Header: | #include <QSGOpaqueTextureMaterial> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Erbt von: | QSGMaterial |
| Vererbt an: |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QSGOpaqueTextureMaterial ist Teil der „Qt Quick “-Szenengraph-Materialklassen.
Ö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 |
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 Material mit undurchsichtiger Textur füllt jedes Pixel einer Geometrie mit der bereitgestellten Textur aus. Das Material berücksichtigt die Deckkraft des „ QSGMaterialShader::RenderState “ nicht, sodass Deckkraft-Knoten in der übergeordneten Knotenkette, die dieses Material verwenden, keine Wirkung haben.
Die Geometrie, die mit einem undurchsichtigen Texturmaterial gerendert werden soll, benötigt Scheitelpunkte an Attributposition 0 und Texturkoordinaten an Attributposition 1. Die Texturkoordinate ist ein zweidimensionales Gleitkomma-Tupel. Das „ 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-Status wird für die Texturinstanz festgelegt, unmittelbar bevor diese gebunden wird.
Das undurchsichtige, texturierte Material berücksichtigt die aktuelle Matrix und den Alphakanal der Textur. Die im Szenengraphen akkumulierte Deckkraft wird dabei ignoriert.
Ein Texturmaterial muss über eine Textur verfügen, bevor es als Material im Szenenbaum verwendet werden kann.
Dokumentation der Member-Funktionen
QSGOpaqueTextureMaterial::QSGOpaqueTextureMaterial()
Erstellt ein neues QSGOpaqueTextureMaterial.
Die Standard-Mipmap-Filterung und der Standard-Filtermodus sind auf „ QSGTexture::Nearest “ eingestellt. Der Standard-Wrap-Modus ist auf „ QSGTexture::ClampToEdge “ eingestellt.
QSGTexture::AnisotropyLevel QSGOpaqueTextureMaterial::anisotropyLevel() const
Gibt den Anisotropiegrad dieses Materials zurück.
Siehe auch „ setAnisotropyLevel()“.
QSGTexture::Filtering QSGOpaqueTextureMaterial::filtering() const
Gibt den Filtermodus dieses Materials zurück.
Die Standardfilterung ist „ QSGTexture::Nearest “.
Siehe auch ` setFiltering()`
QSGTexture::WrapMode QSGOpaqueTextureMaterial::horizontalWrapMode() const
Gibt den horizontalen Zeilenumbruchmodus dieses Materials zurück.
Der Standardmodus für den horizontalen Zeilenumbruch 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 Anisotropiegrad dieses Materials auf „ level “.
Siehe auch anisotropyLevel().
void QSGOpaqueTextureMaterial::setFiltering(QSGTexture::Filtering filtering)
Stellt die Filterung auf „ filtering “ ein.
Der Filtermodus wird für die Texturinstanz festgelegt, unmittelbar bevor die Textur für die Darstellung gebunden wird.
Siehe auch „ filtering()“.
void QSGOpaqueTextureMaterial::setHorizontalWrapMode(QSGTexture::WrapMode mode)
Stellt den horizontalen Wrap-Modus auf „ mode “ ein.
Der horizontale Umbruchmodus wird für die Texturinstanz festgelegt, unmittelbar bevor die Textur für die Darstellung gebunden wird.
Siehe auch ` horizontalWrapMode()`.
void QSGOpaqueTextureMaterial::setMipmapFiltering(QSGTexture::Filtering filtering)
Stellt den Mipmap-Modus auf „ filtering “ ein.
Der Mipmap-Filtermodus wird für die Texturinstanz festgelegt, unmittelbar bevor die Textur für die Darstellung gebunden wird.
Wenn die Textur kein Mipmapping unterstützt, hat das Aktivieren von Mipmapping keine Auswirkung.
Siehe auch „ mipmapFiltering()“.
void QSGOpaqueTextureMaterial::setTexture(QSGTexture *texture)
Legt die Textur dieses Materials auf „ texture “ fest.
Das Material übernimmt keine Eigentumsrechte an der Textur.
Siehe auch „ texture()“.
void QSGOpaqueTextureMaterial::setVerticalWrapMode(QSGTexture::WrapMode mode)
Stellt den vertikalen Wrap-Modus auf „ mode “ ein.
Der vertikale Wrap-Modus wird für die Texturinstanz festgelegt, unmittelbar bevor die Textur für die Darstellung 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 Zeilenumbruchmodus dieses Materials zurück.
Der Standardmodus für den vertikalen Zeilenumbruch ist „ QSGTexture::ClampToEdge “.
Siehe auch „ setVerticalWrapMode()“.
© 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.
