En esta página

QSGMaterialShader::RenderState Class

class QSGMaterialShader::RenderState

Encapsula el estado actual de representación durante una llamada a ` QSGMaterialShader::updateUniformData()` y al resto de funciones del tipo ` update `. Más...

Tipos públicos

enum DirtyState { DirtyMatrix, DirtyOpacity, DirtyCachedMaterialData, DirtyAll }
flags DirtyStates

Funciones públicas

QMatrix4x4 combinedMatrix() const
float determinant() const
float devicePixelRatio() const
QRect deviceRect() const
QSGMaterialShader::RenderState::DirtyStates dirtyStates() const
bool isMatrixDirty() const
bool isOpacityDirty() const
QMatrix4x4 modelViewMatrix() const
float opacity() const
QMatrix4x4 projectionMatrix() const
QRhiResourceUpdateBatch *resourceUpdateBatch()
QRhi *rhi()
QByteArray *uniformData()
QRect viewportRect() const

Descripción detallada

El estado de renderizado contiene una serie de accesores que el sombreador debe respetar para ajustarse al estado actual del grafo de escena.

Documentación sobre los tipos de miembros

enum RenderState::DirtyState
flags RenderState::DirtyStates

ConstanteValorDescripción
QSGMaterialShader::RenderState::DirtyMatrix0x0001Se utiliza para indicar que la matriz ha cambiado y debe actualizarse.
QSGMaterialShader::RenderState::DirtyOpacity0x0002Se utiliza para indicar que la opacidad ha cambiado y debe actualizarse.
QSGMaterialShader::RenderState::DirtyCachedMaterialData0x0004Se utiliza para indicar que el estado del material almacenado en caché ha cambiado y debe actualizarse.
QSGMaterialShader::RenderState::DirtyAll0xFFFFSe utiliza para indicar que todo debe actualizarse.

El tipo DirtyStates es una definición de tipo (typedef) para QFlags<DirtyState>. Almacena una combinación OR de valores de DirtyState.

Documentación de las funciones miembro

QMatrix4x4 RenderState::combinedMatrix() const

Devuelve la matriz resultante de la combinación de la matriz «modelview» y la matriz del proyecto.

float RenderState::determinant() const

Devuelve el determinante de ModelView que se utilizará para la representación.

float RenderState::devicePixelRatio() const

Devuelve la relación entre los píxeles físicos y los píxeles independientes del dispositivo que se utilizarán para la representación.

QRect RenderState::deviceRect() const

Devuelve el rect del dispositivo de la superficie que se está representando en

QSGMaterialShader::RenderState::DirtyStates RenderState::dirtyStates() const

Devuelve los estados de renderizado que han cambiado y que deben actualizarse para que la geometría renderizada con este material se ajuste al estado de renderizado actual.

bool RenderState::isMatrixDirty() const

Devuelve ` true ` si ` dirtyStates()` contiene el estado de la matriz «dirty»; en caso contrario, devuelve ` false`.

bool RenderState::isOpacityDirty() const

Devuelve ` true ` si ` dirtyStates()` contiene el estado de opacidad «dirty»; en caso contrario, devuelve ` false`.

QMatrix4x4 RenderState::modelViewMatrix() const

Devuelve la matriz de vista del modelo.

Si el material tiene activado el indicador RequiresFullMatrix, se garantiza que esta será la matriz de transformación completa calculada a partir del grafo de escena.

Sin embargo, si este indicador no está activado, el renderizador puede optar por modificar esta matriz. Por ejemplo, puede transformar previamente los vértices en la CPU y establecer esta matriz como la identidad.

En una situación como la anterior, sigue siendo posible recuperar el determinante real de la matriz activando el indicador «RequiresDeterminant» en el material y llamando al accesor ` determinant()`.

float RenderState::opacity() const

Devuelve la opacidad acumulada que se utilizará para el renderizado.

QMatrix4x4 RenderState::projectionMatrix() const

Devuelve la matriz de proyección.

QRhiResourceUpdateBatch *RenderState::resourceUpdateBatch()

Devuelve un lote de actualización de recursos en el que se pueden poner en cola operaciones de carga y copia. Normalmente lo utiliza QSGMaterialShader::updateSampledImage() para poner en cola actualizaciones del contenido de las imágenes de textura.

QRhi *RenderState::rhi()

Devuelve el valor actual de « QRhi ».

QByteArray *RenderState::uniformData()

Devuelve un puntero a los datos del búfer uniforme (constante) del shader. Los datos uniformes solo deben actualizarse desde ` QSGMaterialShader::updateUniformData()`. El valor de retorno es `null` en las demás funciones reimplementables, como ` QSGMaterialShader::updateSampledImage()`.

Nota: Se recomienda encarecidamente declarar el bloque «uniform» con ` std140 ()` en el sombreador y estudiar detenidamente la estructura estándar del bloque «uniform», tal y como se describe en la sección 7.6.2.2 de la especificación de OpenGL. Corresponde a la implementación de ` QSGMaterialShader ` garantizar que los datos se coloquen en la ubicación correcta en este ` QByteArray`, teniendo en cuenta los requisitos de alineación. Se espera que el código de shader traducido a otros lenguajes de sombreado utilice los mismos desplazamientos para los miembros del bloque, incluso cuando el lenguaje de destino utilice por defecto reglas de empaquetado diferentes.

Nota: Evita copiar desde tipos POD de C++, como las estructuras, para actualizar varios miembros a la vez, a menos que se haya verificado que las disposiciones de la estructura de C++ y del bloque «uniform» de GLSL coinciden.

QRect RenderState::viewportRect() const

Devuelve el rectángulo de la ventana gráfica de la superficie en la que se está realizando el renderizado.

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