이 페이지에서

RenderablesFilter QML Type

pass 에서 적용할 렌더러블을 선택하기 위한 필터를 정의합니다. 더 보기...

Import Statement: import QtQuick3D
Since: Qt 6.11
Inherits:

Command

속성

상세 설명

RenderablesFilter 유형은 RenderPass 의 영향을 받아야 할 씬 내의 렌더러블을 지정하는 데 사용됩니다. renderableTypes 속성을 설정하여, 이 패스가 불투명 오브젝트, 투명 오브젝트, 또는 어떤 오브젝트에도 영향을 미치지 않도록 제어할 수 있습니다.

renderableTypes 을 None 로 설정하는 것은, RenderPass 가 SubRenderPass 명령의 컨테이너 역할을 하며, 자체적으로는 어떤 장면 오브젝트도 렌더링해서는 안 되는 경우에 유용합니다.

렌더링 가능한 유형별로 필터링하는 것 외에도, ` layerMask `을 사용하여 할당된 ` layers`에 따라 영향을 받는 렌더링 가능한 객체를 더욱 세밀하게 조정할 수 있습니다.

// A pass that renders only opaque scene objects
RenderPass {
    id: opaquePass
    commands: [
        ColorAttachment { name: "color0"; target: opaqueColorTexture },
        DepthTextureAttachment { target: depthTexture },
        RenderablesFilter {
            renderableTypes: RenderablesFilter.Opaque
        }
    ]
}

// A pass that renders only transparent objects on top
RenderPass {
    id: transparentPass
    commands: [
        ColorAttachment { name: "color0"; target: transparentColorTexture },
        RenderablesFilter {
            renderableTypes: RenderablesFilter.Transparent
        }
    ]
}

속성 설명서

layerMask : int

필터의 레이어 마스크를 설정합니다. 지정된 레이어에 있는 렌더링 가능한 객체만 필터의 영향을 받습니다.

Node::layers도 참조하십시오 .

renderableTypes : enumeration [default: RenderablesFilter.Opaque | RenderablesFilter.Transparent]

필터가 적용될 렌더러블의 유형을 설정합니다.

상수설명
RenderablesFilter.None렌더러블이 렌더링되지 않습니다. SubRenderPass만 포함된 컨테이너 패스에 유용합니다.
RenderablesFilter.Opaque불투명한 렌더러블만 렌더링됩니다.
RenderablesFilter.Transparent투명한 렌더러블만 렌더링됩니다.

참고: | 연산자를 사용하여여러 값을 결합할 수 있습니다.

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