QSGMaterialShader::GraphicsPipelineState Struct
struct QSGMaterialShader::GraphicsPipelineStateDescribe los cambios de estado que el material desea aplicar al estado actual del proceso gráfico. Más información...
Tipos públicos
| enum | BlendFactor { Zero, One, SrcColor, OneMinusSrcColor, DstColor, …, OneMinusSrc1Alpha } |
(since 6.8) enum class | BlendOp { Add, Subtract, ReverseSubtract, Min, Max } |
| flags | ColorMask |
| enum | ColorMaskComponent { R, G, B, A } |
| enum | CullMode { CullNone, CullFront, CullBack } |
(since 6.4) enum | PolygonMode { Fill, Line } |
Variables públicas
| QColor | blendConstant |
| bool | blendEnable |
| QSGMaterialShader::GraphicsPipelineState::ColorMask | colorWrite |
| QSGMaterialShader::GraphicsPipelineState::CullMode | cullMode |
(since 6.5) QSGMaterialShader::GraphicsPipelineState::BlendFactor | dstAlpha |
| QSGMaterialShader::GraphicsPipelineState::BlendFactor | dstColor |
(since 6.8) QSGMaterialShader::GraphicsPipelineState::BlendOp | opAlpha |
(since 6.8) QSGMaterialShader::GraphicsPipelineState::BlendOp | opColor |
(since 6.4) QSGMaterialShader::GraphicsPipelineState::PolygonMode | polygonMode |
(since 6.5) bool | separateBlendFactors |
(since 6.5) QSGMaterialShader::GraphicsPipelineState::BlendFactor | srcAlpha |
| QSGMaterialShader::GraphicsPipelineState::BlendFactor | srcColor |
Descripción detallada
A diferencia de ` QSGMaterialShader`, en ` QSGMaterialShader` no es posible emitir directamente comandos de cambio de estado mediante la API gráfica subyacente. Esto se debe principalmente a que el concepto de estados modificables individualmente se considera obsoleto y no es compatible con las API gráficas modernas.
Por lo tanto, corresponde a ` QSGMaterialShader ` exponer una estructura de datos con el conjunto de estados admitidos, que el material puede modificar en su implementación de `updatePipelineState()`, si la hay. A continuación, el grafo de escena aplicará internamente estos cambios al estado activo de la canalización gráfica y, posteriormente, los revertirá según corresponda.
Cuando se llama a ` updateGraphicsPipelineState()`, todos los miembros de la estructura tienen un valor válido que refleja el estado actual del renderizador. No modificar ningún valor (o no reimplementar la función) indica que el material acepta los valores por defecto (que, sin embargo, son dinámicos y dependen, por ejemplo, de los indicadores de ` QSGMaterial `).
Documentación sobre los tipos de los miembros
enum GraphicsPipelineState::BlendFactor
| Constante | Valor |
|---|---|
QSGMaterialShader::GraphicsPipelineState::Zero | 0 |
QSGMaterialShader::GraphicsPipelineState::One | 1 |
QSGMaterialShader::GraphicsPipelineState::SrcColor | 2 |
QSGMaterialShader::GraphicsPipelineState::OneMinusSrcColor | 3 |
QSGMaterialShader::GraphicsPipelineState::DstColor | 4 |
QSGMaterialShader::GraphicsPipelineState::OneMinusDstColor | 5 |
QSGMaterialShader::GraphicsPipelineState::SrcAlpha | 6 |
QSGMaterialShader::GraphicsPipelineState::OneMinusSrcAlpha | 7 |
QSGMaterialShader::GraphicsPipelineState::DstAlpha | 8 |
QSGMaterialShader::GraphicsPipelineState::OneMinusDstAlpha | 9 |
QSGMaterialShader::GraphicsPipelineState::ConstantColor | 10 |
QSGMaterialShader::GraphicsPipelineState::OneMinusConstantColor | 11 |
QSGMaterialShader::GraphicsPipelineState::ConstantAlpha | 12 |
QSGMaterialShader::GraphicsPipelineState::OneMinusConstantAlpha | 13 |
QSGMaterialShader::GraphicsPipelineState::SrcAlphaSaturate | 14 |
QSGMaterialShader::GraphicsPipelineState::Src1Color | 15 |
QSGMaterialShader::GraphicsPipelineState::OneMinusSrc1Color | 16 |
QSGMaterialShader::GraphicsPipelineState::Src1Alpha | 17 |
QSGMaterialShader::GraphicsPipelineState::OneMinusSrc1Alpha | 18 |
[since 6.8] enum class GraphicsPipelineState::BlendOp
| Constante | Valor |
|---|---|
QSGMaterialShader::GraphicsPipelineState::BlendOp::Add | 0 |
QSGMaterialShader::GraphicsPipelineState::BlendOp::Subtract | 1 |
QSGMaterialShader::GraphicsPipelineState::BlendOp::ReverseSubtract | 2 |
QSGMaterialShader::GraphicsPipelineState::BlendOp::Min | 3 |
QSGMaterialShader::GraphicsPipelineState::BlendOp::Max | 4 |
Esta enumeración se introdujo en Qt 6.8.
enum GraphicsPipelineState::ColorMaskComponent
flags GraphicsPipelineState::ColorMask
| Constante | Valor |
|---|---|
QSGMaterialShader::GraphicsPipelineState::R | 1 << 0 |
QSGMaterialShader::GraphicsPipelineState::G | 1 << 1 |
QSGMaterialShader::GraphicsPipelineState::B | 1 << 2 |
QSGMaterialShader::GraphicsPipelineState::A | 1 << 3 |
El tipo ColorMask es una definición de tipo (typedef) para QFlags<ColorMaskComponent>. Almacena una combinación OR de valores de ColorMaskComponent.
enum GraphicsPipelineState::CullMode
| Constante | Valor |
|---|---|
QSGMaterialShader::GraphicsPipelineState::CullNone | 0 |
QSGMaterialShader::GraphicsPipelineState::CullFront | 1 |
QSGMaterialShader::GraphicsPipelineState::CullBack | 2 |
[since 6.4] enum GraphicsPipelineState::PolygonMode
Especifica el modo de rasterización de polígonos
El modo de polígono (modo de relleno de triángulos en Metal, modo de relleno en D3D) especifica el modo de relleno utilizado al rasterizar polígonos. Los polígonos pueden dibujarse como sólidos (Relleno) o como una malla de líneas (Línea).
Advertencia: OpenGL ES no admite el modo de polígono « Line ». OpenGL ES rasterizará todos los polígonos como rellenos, independientemente del modo de polígono que se haya establecido. El uso de « Line » hará que tu aplicación no sea portátil.
| Constante | Valor | Descripción |
|---|---|---|
QSGMaterialShader::GraphicsPipelineState::Fill | 0 | El interior del polígono se rellena (por defecto) |
QSGMaterialShader::GraphicsPipelineState::Line | 1 | Los bordes del polígono se dibujan como segmentos de línea. |
Esta enumeración se introdujo en Qt 6.4.
Documentación de las variables miembro
QColor GraphicsPipelineState::blendConstant
Constante de mezcla aplicable cuando se configura un factor de mezcla para utilizar un valor constante.
bool GraphicsPipelineState::blendEnable
Habilita la mezcla.
Nota: El cambio de este indicador debe realizarse con precaución y, en la medida de lo posible, es mejor evitarlo. En su lugar, los materiales siempre deben utilizar el indicador QSGMaterial::Blend para indicar que desean utilizar la mezcla. Cambiar este valor de «false» a «true» en un material que no haya declarado QSGMaterial::Blend puede dar lugar a resultados visuales inesperados.
QSGMaterialShader::GraphicsPipelineState::ColorMask GraphicsPipelineState::colorWrite
Máscara de escritura de color.
QSGMaterialShader::GraphicsPipelineState::CullMode GraphicsPipelineState::cullMode
Modo de selección.
[since 6.5] QSGMaterialShader::GraphicsPipelineState::BlendFactor GraphicsPipelineState::dstAlpha
Factor de mezcla alfa de destino.
Solo se aplica cuando « separateBlendFactors » está establecido en «true».
Esta variable se introdujo en Qt 6.5.
QSGMaterialShader::GraphicsPipelineState::BlendFactor GraphicsPipelineState::dstColor
Factor de mezcla de destino, ya sea RGB o RGBA, según separateBlendFactors.
[since 6.8] QSGMaterialShader::GraphicsPipelineState::BlendOp GraphicsPipelineState::opAlpha
Operación de mezcla alfa.
Esta variable se introdujo en Qt 6.8.
[since 6.8] QSGMaterialShader::GraphicsPipelineState::BlendOp GraphicsPipelineState::opColor
Operación de mezcla RGB.
Esta variable se introdujo en Qt 6.8.
[since 6.4] QSGMaterialShader::GraphicsPipelineState::PolygonMode GraphicsPipelineState::polygonMode
Modo de rasterización de polígonos.
Esta variable se introdujo en Qt 6.4.
[since 6.5] bool GraphicsPipelineState::separateBlendFactors
Indica que los factores de mezcla alfa se especifican por separado.
Por defecto es «false», lo que significa que tanto los factores de mezcla RGB como los de alfa se definen mediante srcColor y dstColor. Cuando se establece en «true», los factores de mezcla alfa se toman de srcAlpha y dstAlpha, y srcColor y dstColor se aplican únicamente al RGB.
Esta variable se introdujo en Qt 6.5.
[since 6.5] QSGMaterialShader::GraphicsPipelineState::BlendFactor GraphicsPipelineState::srcAlpha
Factor de mezcla alfa de origen.
Solo se aplica cuando « separateBlendFactors » está establecido en «true».
Esta variable se introdujo en Qt 6.5.
QSGMaterialShader::GraphicsPipelineState::BlendFactor GraphicsPipelineState::srcColor
Factor de mezcla de la fuente, ya sea RGB o RGBA, dependiendo de separateBlendFactors.
© 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.