renderTargetBlend QML Value Type

렌더 패스의 단일 색상 어태치먼트에 대한 블렌딩 매개변수를 정의합니다. 더 보기...

Import Statement:	`import QtQuick3D`
Since:	Qt 6.11

속성

blendEnabled : bool
colorWrite : enumeration
dstAlpha : enumeration
dstColor : enumeration
opAlpha : enumeration
opColor : enumeration
srcAlpha : enumeration
srcColor : enumeration

상세 설명

renderTargetBlend 유형은 RenderPass 의 단일 색상 어태치먼트에 대한 블렌딩 매개변수를 지정하는 데 사용됩니다. renderTargetBlend 인스턴스는 PipelineStateOverride targetBlend0 에서 targetBlend7 속성 중 하나에 할당될 수 있으며, 여기서 인덱스는 색상 어태치먼트 슬롯에 해당합니다.

색상 혼합 방정식은 다음과 같습니다:

result.rgb = srcColor * src.rgb  opColor  dstColor * dst.rgb
result.a   = srcAlpha * src.a   opAlpha  dstAlpha * dst.a

속성 설명서

blendEnabled : bool

true 로 설정하면 색상 첨부 파일에 대한 블렌딩이 활성화됩니다. false 로 설정하면 블렌딩이 비활성화되고 출력 색상이 첨부 파일에 직접 기록됩니다. 기본값은 false 입니다.

colorWrite : enumeration

색상 첨부 파일에 어떤 색상 채널을 기록할지 제어하는 비트 마스크입니다. 여러 값을 ‘ | ’ 연산자로 결합할 수 있습니다. 기본값은 R | G | B | A 입니다.

상수	설명
`RenderTargetBlend.R`	빨간색 채널에 기록합니다.
`RenderTargetBlend.G`	녹색 채널에 기록합니다.
`RenderTargetBlend.B`	파란색 채널에 쓰기.
`RenderTargetBlend.A`	알파 채널에 쓰기.

dstAlpha : enumeration

대상 알파 블렌드 계수를 설정합니다. 이 값은 블렌드 연산이 수행되기 전에 색상 어태치먼트의 현재 값에 포함된 알파 성분의 크기를 조정합니다. 기본값은 OneMinusSrcAlpha 입니다. 사용 가능한 값 목록은 srcColor 을 참조하십시오.

dstColor : enumeration

대상 색상 혼합 계수를 설정합니다. 이 값은 혼합 연산이 수행되기 전에 색상 첨부 파일의 현재 값에 포함된 RGB 성분의 크기를 조정합니다. 기본값은 OneMinusSrcAlpha 입니다. 사용 가능한 값 목록은 srcColor 을 참조하십시오.

opAlpha : enumeration

스케일링된 소스 및 대상 알파 구성 요소를 결합하는 데 사용되는 산술 연산을 설정합니다. 기본값은 ‘ Add ’입니다. 사용 가능한 값 목록은 opColor 을 참조하십시오.

opColor : enumeration

스케일링된 소스 및 대상 색상 구성 요소를 결합하는 데 사용되는 산술 연산을 설정합니다. 기본값은 Add 입니다.

상수	설명
`RenderTargetBlend.Add`	결과 = src + dst.
`RenderTargetBlend.Subtract`	결과 = src - dst.
`RenderTargetBlend.ReverseSubtract`	결과 = dst - src.
`RenderTargetBlend.Min`	결과 = min(src, dst).
`RenderTargetBlend.Max`	결과 = max(src, dst).

srcAlpha : enumeration

소스 알파 블렌드 계수를 설정합니다. 이 값은 블렌드 연산이 수행되기 전에 프래그먼트 셰이더 출력의 알파 성분을 조정합니다. 기본값은 One 입니다. 사용 가능한 값 목록은 srcColor 를 참조하십시오.

srcColor : enumeration

소스 색상 블렌드 계수를 설정합니다. 이 값은 블렌드 연산이 수행되기 전에 프래그먼트 셰이더 출력의 RGB 성분을 조정합니다. 기본값은 One 입니다.

상수	설명
`RenderTargetBlend.Zero`	계수는 (0, 0, 0)입니다.
`RenderTargetBlend.One`	계수는 (0, 0, 0)입니다. 계수는 (1, 1, 1)입니다.
`RenderTargetBlend.SrcColor`	계수는 소스 색상(r, g, b)입니다.
`RenderTargetBlend.OneMinusSrcColor`	계수는 소스의 (1-r, 1-g, 1-b)입니다.
`RenderTargetBlend.DstColor`	계수는 대상 색상(r, g, b)입니다.
`RenderTargetBlend.OneMinusDstColor`	계수는 대상의 (1-r, 1-g, 1-b)입니다.
`RenderTargetBlend.SrcAlpha`	계수는 소스의 알파(a, a, a)입니다.
`RenderTargetBlend.OneMinusSrcAlpha`	Factor는 소스의 (1-a, 1-a, 1-a)입니다.
`RenderTargetBlend.DstAlpha`	계수는 대상의 알파(a, a, a)입니다.
`RenderTargetBlend.OneMinusDstAlpha`	요인은 대상의 (1-a, 1-a, 1-a)입니다.
`RenderTargetBlend.ConstantColor`	계수는 파이프라인에 설정된 상수 색상입니다.
`RenderTargetBlend.OneMinusConstantColor`	계수는 상수 색상에서 1을 뺀 값입니다.
`RenderTargetBlend.ConstantAlpha`	계수는 상수 알파입니다.
`RenderTargetBlend.OneMinusConstantAlpha`	계수는 상수 알파에서 1을 뺀 값입니다.
`RenderTargetBlend.SrcAlphaSaturate`	계수는 RGB의 경우 min(src.a, 1-dst.a)이고, A의 경우 1입니다.
`RenderTargetBlend.Src1Color`	Factor는 프래그먼트 셰이더의 두 번째 색상 출력에서 가져옵니다.
`RenderTargetBlend.OneMinusSrc1Color`	계수는 두 번째 색상 출력값에서 1을 뺀 값입니다.
`RenderTargetBlend.Src1Alpha`	계수는 두 번째 색상 출력의 알파 값입니다.
`RenderTargetBlend.OneMinusSrc1Alpha`	계수는 두 번째 출력의 알파 값을 뺀 1입니다.

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