QSGMaterialShader::RenderState Class
class QSGMaterialShader::RenderStateEncapsula 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
| Constante | Valor | Descripción |
|---|---|---|
QSGMaterialShader::RenderState::DirtyMatrix | 0x0001 | Se utiliza para indicar que la matriz ha cambiado y debe actualizarse. |
QSGMaterialShader::RenderState::DirtyOpacity | 0x0002 | Se utiliza para indicar que la opacidad ha cambiado y debe actualizarse. |
QSGMaterialShader::RenderState::DirtyCachedMaterialData | 0x0004 | Se utiliza para indicar que el estado del material almacenado en caché ha cambiado y debe actualizarse. |
QSGMaterialShader::RenderState::DirtyAll | 0xFFFF | Se 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.