Describes state changes that the material wants to apply to the currently active graphics pipeline state. 更多...
| enum | BlendFactor { Zero, One, SrcColor, OneMinusSrcColor, DstColor, …, OneMinusSrc1Alpha } |
| flags | ColorMask |
| enum | ColorMaskComponent { R, G, B, A } |
| enum | CullMode { CullNone, CullFront, CullBack } |
| enum | PolygonMode { Fill, Line } |
| QColor | blendConstant |
| bool | blendEnable |
| QSGMaterialShader::GraphicsPipelineState::ColorMask | colorWrite |
| QSGMaterialShader::GraphicsPipelineState::CullMode | cullMode |
| QSGMaterialShader::GraphicsPipelineState::BlendFactor | dstAlpha |
| QSGMaterialShader::GraphicsPipelineState::BlendFactor | dstColor |
| QSGMaterialShader::GraphicsPipelineState::PolygonMode | polygonMode |
| bool | separateBlendFactors |
| QSGMaterialShader::GraphicsPipelineState::BlendFactor | srcAlpha |
| QSGMaterialShader::GraphicsPipelineState::BlendFactor | srcColor |
不像 QSGMaterialShader , directly issuing state change commands with the underlying graphics API is not possible with QSGMaterialShader . This is mainly because the concept of individually changeable states is considered deprecated and not supported with modern graphics APIs.
Therefore, it is up to QSGMaterialShader to expose a data structure with the set of supported states, which the material can change in its updatePipelineState() implementation, if there is one. The scenegraph will then internally apply these changes to the active graphics pipeline state, then rolling them back as appropriate.
当 updateGraphicsPipelineState () is called, the struct has all members set to a valid value to reflect the renderer's current state. Not changing any values (or not reimplementing the function) indicates that the material is fine with the defaults (which are dynamic however, depending on QSGMaterial flags, for example).
| 常量 | 值 |
|---|---|
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
|
| 常量 | 值 |
|---|---|
QSGMaterialShader::GraphicsPipelineState::R
|
1 << 0
|
QSGMaterialShader::GraphicsPipelineState::G
|
1 << 1
|
QSGMaterialShader::GraphicsPipelineState::B
|
1 << 2
|
QSGMaterialShader::GraphicsPipelineState::A
|
1 << 3
|
The ColorMask type is a typedef for QFlags <ColorMaskComponent>. It stores an OR combination of ColorMaskComponent values.
| 常量 | 值 |
|---|---|
QSGMaterialShader::GraphicsPipelineState::CullNone
|
0
|
QSGMaterialShader::GraphicsPipelineState::CullFront
|
1
|
QSGMaterialShader::GraphicsPipelineState::CullBack
|
2
|
[since 6.4]
enum GraphicsPipelineState::
PolygonMode
Specifies the polygon rasterization mode
Polygon Mode (Triangle Fill Mode in Metal, Fill Mode in D3D) specifies the fill mode used when rasterizing polygons. Polygons may be drawn as solids (Fill), or as a wire mesh (Line).
警告：
OpenGL ES does not support the
Line
polygon mode. OpenGL ES will rasterize all polygons as filled no matter what polygon mode is set. Using
Line
will make your application non-portable.
| 常量 | 值 | 描述 |
|---|---|---|
QSGMaterialShader::GraphicsPipelineState::Fill
|
0
|
The interior of the polygon is filled (default) |
QSGMaterialShader::GraphicsPipelineState::Line
|
1
|
Boundary edges of the polygon are drawn as line segments. |
This enum was introduced or modified in Qt 6.4.
Blend constant applicable when a blending factor is set to use a constant value.
Enables blending.
注意： Changing this flag should be done with care, and is best avoided. Rather, materials should always use the QSGMaterial::Blend flag to indicate that they wish to use blending. Changing this value from false to true for a material that did not declare QSGMaterial::Blend can lead to unexpected visual results.
Color write mask.
Cull mode.
[since 6.5]
QSGMaterialShader::GraphicsPipelineState::BlendFactor
GraphicsPipelineState::
dstAlpha
Destination alpha blending factor.
Applies only when separateBlendFactors is set to true.
This documentation was introduced in Qt 6.5.
Destination blending factor, either RGB or RGBA depending on separateBlendFactors .
[since 6.4]
QSGMaterialShader::GraphicsPipelineState::PolygonMode
GraphicsPipelineState::
polygonMode
Polygon rasterization mode.
This documentation was introduced in Qt 6.4.
[since 6.5]
bool
GraphicsPipelineState::
separateBlendFactors
Indicates that alpha blending factors are specified separately.
False by default, meaning both RGB and alpha blending factors are defined by srcColor and dstColor . When set to true, the alpha blending factors are taken from srcAlpha and dstAlpha instead, and srcColor and dstColor applies only to RGB.
This documentation was introduced in Qt 6.5.
[since 6.5]
QSGMaterialShader::GraphicsPipelineState::BlendFactor
GraphicsPipelineState::
srcAlpha
Source alpha blending factor.
Applies only when separateBlendFactors is set to true.
This documentation was introduced in Qt 6.5.
Source blending factor, either RGB or RGBA depending on separateBlendFactors .