GraphicsPipelineState Struct
struct QSGMaterialShader::GraphicsPipelineState머티리얼이 현재 활성화된 그래픽 파이프라인 상태에 적용하려는 상태 변경 사항을 설명합니다. 더 보기...
공용 유형
| 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 } |
퍼블릭 변수
| 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 |
상세 설명
QSGMaterialShader 와 달리 QSGMaterialShader 에서는 기본 그래픽 API로 상태 변경 명령을 직접 실행할 수 없습니다. 이는 주로 개별적으로 변경 가능한 상태의 개념이 더 이상 사용되지 않는 것으로 간주되어 최신 그래픽 API에서 지원되지 않기 때문입니다.
따라서 지원되는 상태 집합이 있는 데이터 구조를 노출하는 것은 QSGMaterialShader 에 달려 있으며, 머티리얼이 업데이트PipelineState() 구현에서 변경할 수 있습니다(있는 경우). 그러면 시나리오는 내부적으로 이러한 변경 사항을 활성 그래픽스 파이프라인 상태에 적용한 다음 적절하게 롤백합니다.
updateGraphicsPipelineState()가 호출되면 구조체의 모든 멤버가 렌더러의 현재 상태를 반영하는 유효한 값으로 설정됩니다. 값을 변경하지 않거나 함수를 다시 구현하지 않으면 머티리얼이 기본값(예를 들어 QSGMaterial 플래그에 따라 동적이지만)을 사용해도 괜찮다는 것을 나타냅니다.
멤버 유형 문서
enum GraphicsPipelineState::BlendFactor
| 상수 | 값 |
|---|---|
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
| 상수 | Value |
|---|---|
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 |
이 열거형은 Qt 6.8에 도입되었습니다.
enum GraphicsPipelineState::ColorMaskComponent
플래그 그래픽스 파이프라인 스테이트::컬러 마스크
| Constant | 값 |
|---|---|
QSGMaterialShader::GraphicsPipelineState::R | 1 << 0 |
QSGMaterialShader::GraphicsPipelineState::G | 1 << 1 |
QSGMaterialShader::GraphicsPipelineState::B | 1 << 2 |
QSGMaterialShader::GraphicsPipelineState::A | 1 << 3 |
ColorMask 유형은 QFlags<ColorMaskComponent>에 대한 typedef입니다. ColorMaskComponent 값의 OR 조합을 저장합니다.
enum GraphicsPipelineState::CullMode
| 상수 | 값 |
|---|---|
QSGMaterialShader::GraphicsPipelineState::CullNone | 0 |
QSGMaterialShader::GraphicsPipelineState::CullFront | 1 |
QSGMaterialShader::GraphicsPipelineState::CullBack | 2 |
[since 6.4] enum GraphicsPipelineState::PolygonMode
다각형 래스터화 모드를 지정합니다.
다각형 모드(금속의 삼각형 채우기 모드, D3D의 채우기 모드)는 다각형을 래스터화할 때 사용되는 채우기 모드를 지정합니다. 다각형은 솔리드(채우기)로 그리거나 와이어 메쉬(선)로 그릴 수 있습니다.
경고: OpenGL ES는 Line 다각형 모드를 지원하지 않습니다. OpenGL ES는 어떤 다각형 모드를 설정하든 모든 다각형을 채워진 상태로 래스터화합니다. Line 을 사용하면 애플리케이션을 이식할 수 없게 됩니다.
| 상수 | 값 | 설명 |
|---|---|---|
QSGMaterialShader::GraphicsPipelineState::Fill | 0 | 다각형의 내부가 채워집니다(기본값). |
QSGMaterialShader::GraphicsPipelineState::Line | 1 | 다각형의 경계 가장자리가 선분으로 그려집니다. |
이 열거형은 Qt 6.4에 도입되었습니다.
멤버 변수 문서
QColor GraphicsPipelineState::blendConstant
블렌딩 계수가 상수 값을 사용하도록 설정된 경우 블렌딩 상수를 적용할 수 있습니다.
bool GraphicsPipelineState::blendEnable
블렌딩을 활성화합니다.
참고: 이 플래그는 신중하게 변경해야 하며, 변경하지 않는 것이 가장 좋습니다. 그보다는 머티리얼이 블렌딩을 사용하려면 항상 QSGMaterial::Blend 플래그를 사용하여 블렌딩을 사용한다는 것을 표시해야 합니다. QSGMaterial::Blend를 선언하지 않은 머티리얼에 대해 이 값을 false에서 true로 변경하면 예상치 못한 시각적 결과가 발생할 수 있습니다.
QSGMaterialShader::GraphicsPipelineState::ColorMask GraphicsPipelineState::colorWrite
컬러 쓰기 마스크.
QSGMaterialShader::GraphicsPipelineState::CullMode GraphicsPipelineState::cullMode
컬링 모드.
[since 6.5] QSGMaterialShader::GraphicsPipelineState::BlendFactor GraphicsPipelineState::dstAlpha
대상 알파 블렌딩 계수입니다.
separateBlendFactors 이 true로 설정된 경우에만 적용됩니다.
이 문서는 Qt 6.5에 도입되었습니다.
QSGMaterialShader::GraphicsPipelineState::BlendFactor GraphicsPipelineState::dstColor
대상 블렌딩 계수는 separateBlendFactors 에 따라 RGB 또는 RGBA 입니다.
[since 6.8] QSGMaterialShader::GraphicsPipelineState::BlendOp GraphicsPipelineState::opAlpha
알파 블렌딩 연산.
이 문서는 Qt 6.8에 도입되었습니다.
[since 6.8] QSGMaterialShader::GraphicsPipelineState::BlendOp GraphicsPipelineState::opColor
RGB 블렌딩 작업.
이 문서는 Qt 6.8에 도입되었습니다.
[since 6.4] QSGMaterialShader::GraphicsPipelineState::PolygonMode GraphicsPipelineState::polygonMode
다각형 래스터화 모드.
이 문서는 Qt 6.4에 도입되었습니다.
[since 6.5] bool GraphicsPipelineState::separateBlendFactors
알파 블렌딩 계수가 별도로 지정되었음을 나타냅니다.
기본값은 거짓으로, RGB와 알파 블렌딩 계수가 모두 srcColor 및 dstColor 에서 정의됩니다. true로 설정하면 알파 블렌딩 계수는 srcAlpha 및 dstAlpha 에서 가져오고 srcColor 및 dstColor 은 RGB에만 적용됩니다.
이 문서는 Qt 6.5에 도입되었습니다.
[since 6.5] QSGMaterialShader::GraphicsPipelineState::BlendFactor GraphicsPipelineState::srcAlpha
소스 알파 블렌딩 계수입니다.
separateBlendFactors 이 true로 설정된 경우에만 적용됩니다.
이 문서는 Qt 6.5에 도입되었습니다.
QSGMaterialShader::GraphicsPipelineState::BlendFactor GraphicsPipelineState::srcColor
소스 블렌딩 계수는 separateBlendFactors 에 따라 RGB 또는 RGBA 입니다.
© 2025 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.
