このページでは

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レンダラブルは一切レンダリングされません。SubRenderPasses のみを含むコンテナパスで有用です。
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.