En esta página

QSGOpaqueTextureMaterial Class

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

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

QSGTextureMaterial

Funciones públicas

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

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 con textura opaca rellenará cada píxel de una geometría con la textura proporcionada. El material no respeta la opacidad de QSGMaterialShader::RenderState, por lo que los nodos de opacidad en la cadena de nodos principal que utilizan este material no tienen ningún efecto.

La geometría que se va a renderizar con un material de textura opaca 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 la textura justo antes de que se vincule.

El material con textura opaca respeta la matriz actual y el canal alfa de la textura. Ignorará la opacidad acumulada en el grafo de escena.

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

Documentación de las funciones miembro

QSGOpaqueTextureMaterial::QSGOpaqueTextureMaterial()

Crea un nuevo QSGOpaqueTextureMaterial.

El filtrado mipmap y el modo de filtrado predeterminados se establecen en « QSGTexture::Nearest ». Los modos de envoltura predeterminados se establecen en « QSGTexture::ClampToEdge ».

QSGTexture::AnisotropyLevel QSGOpaqueTextureMaterial::anisotropyLevel() const

Devuelve el nivel de anisotropía de este material.

Véase también setAnisotropyLevel().

QSGTexture::Filtering QSGOpaqueTextureMaterial::filtering() const

Devuelve el modo de filtrado de este material.

El filtrado predeterminado es QSGTexture::Nearest.

Véase también setFiltering().

QSGTexture::WrapMode QSGOpaqueTextureMaterial::horizontalWrapMode() const

Devuelve el modo de ajuste horizontal de este material.

El modo de ajuste horizontal predeterminado es « QSGTexture::ClampToEdge ».

Véase también setHorizontalWrapMode().

QSGTexture::Filtering QSGOpaqueTextureMaterial::mipmapFiltering() const

Devuelve el modo de filtrado de mipmaps de este material.

El modo de mipmap predeterminado es « QSGTexture::Nearest ».

Véase también setMipmapFiltering().

void QSGOpaqueTextureMaterial::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)

Establece el nivel de anisotropía de este material en « level ».

Véase también anisotropyLevel().

void QSGOpaqueTextureMaterial::setFiltering(QSGTexture::Filtering filtering)

Establece el filtrado en « filtering ».

El modo de filtrado se establece en la instancia de textura justo antes de que la textura se vincule para su renderizado.

Véase también filtering().

void QSGOpaqueTextureMaterial::setHorizontalWrapMode(QSGTexture::WrapMode mode)

Establece el modo de envoltura horizontal en « mode ».

El modo de ajuste horizontal se establece en la instancia de textura justo antes de que la textura se vincule para su renderizado.

Véase también horizontalWrapMode().

void QSGOpaqueTextureMaterial::setMipmapFiltering(QSGTexture::Filtering filtering)

Establece el modo de mipmap en « filtering ».

El modo de filtrado de mipmap se establece en la instancia de textura justo antes de que la textura se vincule para su renderizado.

Si la textura no es compatible con el mipmapping, habilitarlo no tiene ningún efecto.

Véase también mipmapFiltering().

void QSGOpaqueTextureMaterial::setTexture(QSGTexture *texture)

Establece la textura de este material en « texture ».

El material no se hace cargo de la textura.

Véase también texture().

void QSGOpaqueTextureMaterial::setVerticalWrapMode(QSGTexture::WrapMode mode)

Establece el modo de envoltura vertical en « mode ».

El modo de ajuste vertical se establece en la instancia de textura justo antes de que la textura se vincule para su renderizado.

Véase también verticalWrapMode().

QSGTexture *QSGOpaqueTextureMaterial::texture() const

Devuelve la textura de este material de textura.

Véase también ` setTexture()`.

QSGTexture::WrapMode QSGOpaqueTextureMaterial::verticalWrapMode() const

Devuelve el modo de ajuste vertical de este material.

El modo de ajuste vertical predeterminado es « QSGTexture::ClampToEdge ».

Véase también 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.