En esta página

QSGOpaqueTextureMaterial Class

La clase QSGOpaqueTextureMaterial proporciona una forma conveniente de renderizar geometría texturizada en el gráfico de escena. Más...

Cabecera: #include <QSGOpaqueTextureMaterial>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Hereda: 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 sólo es funcional cuando se ejecuta con el backend por defecto del Qt Quick scenegraph.

El material de textura opaca rellenará cada pixel de una geometría con la textura suministrada. El material no respeta la opacidad de QSGMaterialShader::RenderState, por lo que los nodos de opacidad en la cadena padre de los nodos 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 posición 0 del atributo y coordenadas de textura en la posición 1 del atributo. La coordenada de textura es una tupla bidimensional en coma flotante. QSGGeometry::defaultAttributes_TexturedPoint2D devuelve un conjunto de atributos compatible con este material.

La textura a renderizar puede establecerse utilizando setTexture(). La forma en que debe renderizarse la textura puede especificarse utilizando setMipmapFiltering(), setFiltering(), setHorizontalWrapMode() y setVerticalWrapMode(). El estado de renderizado se establece en la instancia de textura justo antes de que se vincule.

El material de textura opaca respeta la matriz actual y el canal alfa de la textura. No tendrá en cuenta la opacidad acumulada en el scenegraph.

Un material de textura debe tener una textura establecida antes de ser utilizado como material en el gráfico de escena.

Documentación de las funciones miembro

QSGOpaqueTextureMaterial::QSGOpaqueTextureMaterial()

Crea un nuevo QSGOpaqueTextureMaterial.

El filtro mipmap por defecto y el modo de filtrado se establece en QSGTexture::Nearest. Los modos de envoltura por defecto se establece en QSGTexture::ClampToEdge.

QSGTexture::AnisotropyLevel QSGOpaqueTextureMaterial::anisotropyLevel() const

Devuelve el nivel de anistropía de este material.

Véase también setAnisotropyLevel().

QSGTexture::Filtering QSGOpaqueTextureMaterial::filtering() const

Devuelve el modo de filtrado de este material.

El filtrado por defecto 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 por defecto es QSGTexture::ClampToEdge.

Véase también setHorizontalWrapMode().

QSGTexture::Filtering QSGOpaqueTextureMaterial::mipmapFiltering() const

Devuelve el modo de filtrado mipmap de este material.

El modo mipmap por defecto es QSGTexture::Nearest.

Véase también setMipmapFiltering().

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

Establece el nivel de anistropí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 el renderizado.

Véase también filtering().

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

Establece el modo de ajuste horizontal en mode.

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

Véase también horizontalWrapMode().

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

Establece el modo mipmap en filtering.

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

Si la textura no tiene soporte para mipmapping, activarlo 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 apropia de la textura.

Véase también texture().

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

Establece el modo de ajuste vertical en mode.

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

Véase también verticalWrapMode().

QSGTexture *QSGOpaqueTextureMaterial::texture() const

Devuelve la textura de este material.

Ver también setTexture().

QSGTexture::WrapMode QSGOpaqueTextureMaterial::verticalWrapMode() const

Devuelve el modo de ajuste vertical de este material.

El modo de ajuste vertical por defecto 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.