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

상세 설명

렌더패스를 사용하면 렌더링 파이프라인에서 커스텀 렌더링 단계를 정의할 수 있습니다. 투명 색상, 재질 모드, 재정의 재질과 같은 다양한 속성을 지정할 수 있습니다. 또한 렌더링 수행 방법을 지정하는 렌더링 명령 목록을 정의할 수도 있습니다.

셰이더에 데이터 노출

효과 및 커스텀 머티리얼과 마찬가지로 렌더패스는 사용자 정의 프로퍼티를 셰이더에 자동으로 노출하고 업데이트합니다.

프로퍼티 문서

augmentShader : url

이 프로퍼티는 materialMode 가 AugmentMaterial 로 설정된 경우 렌더 패스에 대한 증강 셰이더 URL을 보유합니다.

셰이더 파일에는 다음 서명을 가진 함수가 포함되어야 합니다:

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

이 함수는 이 렌더 패스에서 렌더링되는 오브젝트가 사용 중인 머티리얼의 기존 조각 셰이더와 결합됩니다. 사용자가 커스텀 코드로 기존 머티리얼 셰이더를 보강할 수 있습니다.

clearColor : color [default: Qt.black]

이 프로퍼티에는 렌더링 패스의 투명 색상이 저장됩니다.

commands : list<RenderCommand>

이 프로퍼티에는 렌더 패스에 대한 렌더링 명령 목록이 저장됩니다.

목록에 있는 명령은 목록에 표시된 순서대로 실행됩니다.

renderTargetBlend, PipelineStateOverride, RenderablesFilter, RenderPassTexture, ColorAttachment, DepthTextureAttachment, DepthStencilAttachment, AddDefine도 참조하세요 .

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.RenderTargetFlags.None]

이 프로퍼티에는 렌더 패스에 대한 렌더 타깃 플래그가 저장됩니다.

가능한 값은 다음과 같습니다:

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

stencilClearValue : int [default: 0]

이 프로퍼티에는 렌더 패스에 대한 스텐실 클리어 값이 저장됩니다.