En esta página

QSGTextureMaterial Class

La clase QSGTextureMaterial ofrece una forma práctica de renderizar geometría texturizada en el grafo de escena. Más información...

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

Descripción detallada

Advertencia: Esta clase de utilidad solo funciona cuando se ejecuta con el backend predeterminado del grafo de escena de Qt Quick.

El material texturizado rellenará cada píxel de una geometría con la textura proporcionada.

La geometría que se va a renderizar con un material texturizado requiere vértices en la ubicación de atributo 0 y coordenadas de textura en la ubicación de atributo 1. La coordenada de textura es una tupla bidimensional de punto flotante. El QSGGeometry::defaultAttributes_TexturedPoint2D devuelve un conjunto de atributos compatible con este material.

La textura que se va a renderizar se puede establecer mediante ` setTexture()`. La forma en que se debe renderizar la textura se puede especificar mediante ` setMipmapFiltering()`, ` setFiltering()`, ` setHorizontalWrapMode()` y ` setVerticalWrapMode()`. El estado de renderizado se establece en la instancia de textura justo antes de que se vincule.

El material texturizado respeta la matriz actual y el canal alfa de la textura. También respetará la opacidad acumulada en el grafo de escena.

Un material con textura debe tener una textura asignada antes de poder utilizarse como material en el grafo de escena.

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