En esta página

QSGMaterialShader::GraphicsPipelineState Struct

struct QSGMaterialShader::GraphicsPipelineState

Describe 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

ConstanteValor
QSGMaterialShader::GraphicsPipelineState::Zero0
QSGMaterialShader::GraphicsPipelineState::One1
QSGMaterialShader::GraphicsPipelineState::SrcColor2
QSGMaterialShader::GraphicsPipelineState::OneMinusSrcColor3
QSGMaterialShader::GraphicsPipelineState::DstColor4
QSGMaterialShader::GraphicsPipelineState::OneMinusDstColor5
QSGMaterialShader::GraphicsPipelineState::SrcAlpha6
QSGMaterialShader::GraphicsPipelineState::OneMinusSrcAlpha7
QSGMaterialShader::GraphicsPipelineState::DstAlpha8
QSGMaterialShader::GraphicsPipelineState::OneMinusDstAlpha9
QSGMaterialShader::GraphicsPipelineState::ConstantColor10
QSGMaterialShader::GraphicsPipelineState::OneMinusConstantColor11
QSGMaterialShader::GraphicsPipelineState::ConstantAlpha12
QSGMaterialShader::GraphicsPipelineState::OneMinusConstantAlpha13
QSGMaterialShader::GraphicsPipelineState::SrcAlphaSaturate14
QSGMaterialShader::GraphicsPipelineState::Src1Color15
QSGMaterialShader::GraphicsPipelineState::OneMinusSrc1Color16
QSGMaterialShader::GraphicsPipelineState::Src1Alpha17
QSGMaterialShader::GraphicsPipelineState::OneMinusSrc1Alpha18

[since 6.8] enum class GraphicsPipelineState::BlendOp

ConstanteValor
QSGMaterialShader::GraphicsPipelineState::BlendOp::Add0
QSGMaterialShader::GraphicsPipelineState::BlendOp::Subtract1
QSGMaterialShader::GraphicsPipelineState::BlendOp::ReverseSubtract2
QSGMaterialShader::GraphicsPipelineState::BlendOp::Min3
QSGMaterialShader::GraphicsPipelineState::BlendOp::Max4

Esta enumeración se introdujo en Qt 6.8.

enum GraphicsPipelineState::ColorMaskComponent
flags GraphicsPipelineState::ColorMask

ConstanteValor
QSGMaterialShader::GraphicsPipelineState::R1 << 0
QSGMaterialShader::GraphicsPipelineState::G1 << 1
QSGMaterialShader::GraphicsPipelineState::B1 << 2
QSGMaterialShader::GraphicsPipelineState::A1 << 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

ConstanteValor
QSGMaterialShader::GraphicsPipelineState::CullNone0
QSGMaterialShader::GraphicsPipelineState::CullFront1
QSGMaterialShader::GraphicsPipelineState::CullBack2

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

ConstanteValorDescripción
QSGMaterialShader::GraphicsPipelineState::Fill0El interior del polígono se rellena (por defecto)
QSGMaterialShader::GraphicsPipelineState::Line1Los 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.