SubtreeEnabler QML Type

フレームグラフノードのサブツリー全体を有効または無効にします。詳細...

この型は非推奨です。新しいコードでの使用は強く推奨しません。

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• enablement : enumeration

方法

• void requestUpdate()

詳細な説明

FrameGraphNodes は `enabled ` プロパティを使用して個別に有効化・無効化できますが、パス全体をオンまたはオフにする必要がある場合、この操作は煩雑になりがちです。SubtreeEnabler は、このユースケースを簡単に行えるようにする便利なノードであり、1つのスイッチですべての子ノードを制御できるようにします。

たとえば、以下の簡略化されたフレームグラフには、デバッグレンダリング用のサブツリーが含まれており、デバッグ時のみ簡単に有効にすることができます。

RenderSurfaceSelector {
    ClearBuffers {
        Viewport {
            CameraSelector {}
        }
    }

    SubtreeEnabler {
        enabled: showDebugView
        Viewport {
            CameraSelector {
                RenderPassFilter {}
            }
        }
    }
}

SubtreeEnablerはデフォルトで有効になっています。

プロパティのドキュメント

enablement : enumeration

サブツリーの有効化を永続的なものにするか、一時的なものにするかを制御します。

メソッドのドキュメント

void requestUpdate()

サブツリーを有効にするよう要求します。

SingleShot による有効化と併用することを想定した利便性向上のためのメソッドです。