이 페이지에서

RenderPass QML Type

렌더 패스를 캡슐화합니다. 더 보기...

Import Statement: import Qt3D.Render 2.12
In C++: QRenderPass
Inherits:

Node

Status: Deprecated

이 타입은 더 이상 사용되지 않습니다. 새로운 코드에서는 이 타입을 사용하지 않는 것을 강력히 권장합니다.

속성

상세 설명

RenderPass는 Technique에서 사용되는 단일 렌더링 패스(셰이더 프로그램 실행의 인스턴스)를 지정합니다. 렌더링 패스는 렌더 패스 객체( ShaderProgram )와 렌더 패스 매개변수 객체( FilterKey ) 목록, 렌더 패스 매개변수 객체( RenderState ) 목록, 렌더 패스 매개변수 객체( Parameter ) 목록으로 구성됩니다.

RenderPass는 참조되는 FilterKey 노드 중 적어도 하나가 RenderPassFilter 내의 FilterKey 노드와 일치하거나, FrameGraph에 RenderPassFilter 가 존재하지 않을 때, 주어진 RenderState 및 Parameter 노드를 사용하여 ShaderProgram 를 실행합니다.

RenderPass가 Parameter를 정의한 경우, 런타임 시 해당 패스와 연관된 Technique, Effect, Material, TechniqueFilter, RenderPassFilter 중 어느 곳에든 동일한 이름의 Parameter가 존재하면 해당 Parameter에 의해 재정의됩니다. 이는 여전히 적절한 기본값을 정의하는 데 유용할 수 있습니다.

렌더링 시, FrameGraph의 각 리프 노드에 대해 FrameGraph 분기에 있는 모든 RenderStateSet 노드에 의해 정의된 상태를 누적하여 기본 렌더링 상태가 기록됩니다. 각 RenderPass는 자체 RenderState 노드를 지정하여 이 기본 렌더링 상태를 재정의할 수 있습니다.

Technique {
    filterKeys: [
        FilterKey { name: "renderingStyle"; value: "forward" }
    ]
    graphicsApiFilter: {
        api: GraphicsApiFilter.OpenGL
        profile: GraphicsApiFilter.CoreProfile
        majorVersion: 3
        minorVersion: 1
    }
    renderPasses: [
        RenderPass {
            id: pass
            shaderProgram: ShaderProgram {
                // ...
            }
            parameters: [
                Parameter { name: "color"; value: "red" }
            ]
            renderStates: [
                DepthTest {}
            ]
        }
    ]
}

RenderPassFilter, FilterKey, Parameter, RenderState, Effect 및 Technique도 참조하십시오 .

속성 문서

filterKeys : list<FilterKey>

이 렌더 패스를 사용할 수 있도록 하는 필터 키를 포함합니다.

parameters : list<Parameter>

렌더 패스에서 사용하는 셰이더 매개변수 값을 저장합니다.

renderStates : list<RenderState>

렌더 패스에서 사용하는 렌더링 상태를 보관합니다.

shaderProgram : ShaderProgram

이 렌더 패스에 사용될 셰이더 프로그램을 저장합니다.

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