Back to Qt.io
Contact Us Blog Download Qt

SubtreeEnabler QML Type

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

Import Statement: import Qt3D.Render 2.8
In C++: QSubtreeEnabler
Inherits:

FrameGraphNode

Status: Deprecated

プロパティ

方法

詳細説明

FrameGraphNodesは、enabled プロパティで個別に有効/無効にできますが、パス全体をオン/オフにする必要がある場合、これは面倒になります。SubtreeEnablerは、このユースケースを簡単にする便利なノードで、1つのスイッチですべての子ノードを制御することができます。

例えば、以下の単純化したフレームグラフには、デバッグ時にのみ簡単に有効にできるデバッグレンダリング用のサブツリーが含まれている。

RenderSurfaceSelector {
    ClearBuffers {
        Viewport {
            CameraSelector {}
        }
    }

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

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

プロパティ ドキュメント

enablement : enumeration

サブツリーの有効化が永続的か一時的かを制御します。

定数説明
Persistentenabled の値は永続的である。これはデフォルトである。
SingleShotenabledの値は1フレーム持続し、その後falseにリセットされる。これは、例えば、シーンの関連する部分が変更されたときだけ FBO を更新するために、FBO に描画するサブツリーに使用されるかもしれません。

メソッド ドキュメンテーション

void requestUpdate()

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

SingleShot の有効化と共に使用されることを意図した便利なメソッドです。


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