RenderPass QML Type

3D 콘텐츠를 렌더링하기 위한 사용자 정의 렌더 패스를 정의합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• augmentShader : url
• clearColor : color
• commands : list<RenderCommand>
• depthClearValue : real
• materialMode : RenderPass::MaterialModes
• overrideMaterial : Material
• passMode : RenderPass::PassMode
• renderTargetFlags : RenderPass::RenderTargetFlags
• stencilClearValue : int

상세 설명

RenderPass는 렌더링 단계와 해당 단계가 데이터를 기록하는 렌더 타깃을 정의합니다. 이는 다음 세 가지 요소의 조합으로 구성됩니다:

• 렌더링 대상 — commands 에서 ` ColorAttachment ` 또는 ` DepthTextureAttachment ` 명령으로 선언된 하나 이상의 출력 텍스처.
• 무엇을 렌더링할 것인가 — 패스가 그리는 장면 오브젝트로, ` RenderablesFilter ` 명령어로 제어됩니다. 동일한 렌더 타겟 내의 작업 세분화는 ` SubRenderPass ` 명령어를 사용하여 설명됩니다.
• 렌더링 방법 — ` materialMode ` 및 모든 ` PipelineStateOverride ` 명령어.

RenderPass는 View3D 또는 Node 의 자식 노드로 배치될 때 해당 씬에서 활성화됩니다.

다음 예제는 모든 씬 오브젝트를 사용자 정의 텍스처로 렌더링하는 간단한 오프스크린 패스를 설정하는 것으로, 이 텍스처는 이후 머티리얼이나 SimpleQuadRenderer 에서 사용할 수 있습니다:

import QtQuick3D

View3D {
    // Declare the off-screen color buffer
    RenderPassTexture {
        id: myColorTexture
        format: RenderPassTexture.RGBA8
    }

    // The render pass: where + what + how
    RenderPass {
        id: myRenderPass
        commands: [
            // Where: attach the texture as the color output
            ColorAttachment {
                name: "color0"
                target: myColorTexture
            },
            // What: render all objects into it
            RenderablesFilter {
                renderableTypes: RenderablesFilter.Opaque | RenderablesFilter.Transparent
            }
        ]
    }
}

셰이더에 데이터 노출

이펙트(Effects) 및 사용자 정의 머티리얼(Custom Materials)과 마찬가지로, RenderPass는 사용자 정의 속성을 셰이더에 자동으로 노출하고 업데이트합니다. RenderPass 하위 유형에 선언된 모든 QML 속성은 셰이더에서 유니폼(uniforms)으로 사용할 수 있습니다.

SubRenderPass, RenderOutputProvider 및 RenderablesFilter도 참조하십시오 .

속성 문서

augmentShader : url

materialMode 가 AugmentMaterial 로 설정된 경우, 이 속성은 렌더 패스의 증강 셰이더 URL을 저장합니다.

셰이더 파일에는 다음 시그니처를 가진 함수가 포함되어야 합니다.

void MAIN_FRAGMENT_AUGMENT() {
    // Custom shader code here
}

이 함수는 이 렌더 패스에서 렌더링되는 오브젝트가 사용하는 머티리얼의 기존 프래그먼트 셰이더와 결합됩니다. 이를 통해 사용자는 사용자 정의 코드를 사용하여 기존 머티리얼 셰이더를 확장할 수 있습니다.

clearColor : color [default: Qt.black]

이 속성은 렌더 패스의 투명 색상을 지정합니다.

commands : list<RenderCommand>

이 속성은 렌더 패스에 대한 렌더 명령어 목록을 포함합니다.

목록에 포함된 명령들은 목록에 표시된 순서대로 실행됩니다.

SubRenderPass, PipelineStateOverride, RenderablesFilter, RenderPassTexture, ColorAttachment, DepthTextureAttachment, DepthStencilAttachment, AddDefine 및 renderTargetBlend도 참조하십시오 .

depthClearValue : real [default: 1.0]

이 속성은 렌더 패스의 깊이 클리어 값을 저장합니다.

materialMode : RenderPass::MaterialModes [default: RenderPass.OriginalMaterial]

이 패스로 렌더링할 때 오브젝트 머티리얼이 어떻게 처리될지 제어합니다.

overrideMaterial : Material

이 속성은 ‘ materialMode ’가 ‘ OverrideMaterial ’로 설정되었을 때 렌더 패스에 대한 오버라이드 머티리얼을 저장합니다.

passMode : RenderPass::PassMode [default: RenderPass.UserPass]

이 속성은 렌더 패스의 패스 모드를 지정합니다.

Qt Quick 3D 는 표준 사용자 렌더 패스 외에도, 사용자가 스카이박스 및 2D 항목을 렌더링하기 위해 내부 렌더 패스를 수동으로 트리거할 수 있도록 지원합니다.

renderTargetFlags : RenderPass::RenderTargetFlags [default: RenderPass.None]

이 속성은 렌더 패스에 대한 렌더 타겟 플래그를 저장합니다. 이 플래그들은 각 프레임의 시작과 끝에서 렌더 타겟의 내용이 처리되는 방식에 영향을 미칩니다.

QRhiTextureRenderTarget::Flags도 참조하십시오 .

stencilClearValue : int [default: 0]

이 속성은 렌더 패스에 대한 스텐실 투명도 값을 저장합니다.