ContentLayer QML Type
Singletonは、シーンノードのグループ化やフィルタリングを行うためのレイヤーフラグ定数を提供します。詳細...
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.11 |
詳細な説明
ContentLayerは、LayerFlag 列挙型を公開するシングルトンです。この列挙型は、ノードを名前付きコンテンツレイヤーに割り当てるためのビットフラグ定数を提供します。レイヤーを使用することで、シーンノードをグループ化したり、カメラによってレンダリングされるノードをフィルタリングしたりすることができます。
あらかじめ定義されたレイヤー名は、特定のユースケースにとって必ずしも説明的であるとは限りません。ContentLayer の値にエイリアスを設定することで、独自の意味を持つレイヤー名を定義できます。例えば、建物、道路、車両がある都市のシーンでは：
readonly property int layerBuildings: ContentLayer.Layer1
readonly property int layerStreets: ContentLayer.Layer2
readonly property int layerVehicles: ContentLayer.Layer3 | ContentLayer.Layer4定義が完了したら、Node.layers を使用してこれらのフラグをノードに割り当て、Camera 上で対応するフラグを設定することで、どのレイヤーをレンダリングするかを制御します。
注：一部の レイヤーには特別な意味があります：
| レイヤー | 説明 |
|---|---|
| LayerNone | レイヤーが割り当てられていません。この値を持つノードはどのレイヤーにも属しておらず、レンダリングされません。 |
| Layer0 | デフォルトのメインレイヤーです。ノードはデフォルトでこのレイヤーに割り当てられます。 |
| レイヤー1～レイヤー23 | 目的や機能に応じてノードをグループ化するための、自由に割り当て可能なユーザーレイヤーです。 |
| レイヤー24以降 | Qt Quick 3Dの内部使用のために予約されています。 |
| LayerAll | すべてのレイヤーに一致します。この値を持つノードは、すべてのカメラによってレンダリングされます。 |
注：レイヤーは ビットフラグであり、| 演算子と組み合わせることができます。
注：レイヤーの 割り当ては継承されません。ノードに `Node.layers ` を設定しても、その値は親から子へ伝播されることはありません。各ノードは独自のレイヤー割り当てを持ち、個別に設定する必要があります。
注：ContentLayer はシングルトンであり、直接インスタンス化することは想定されていません。
「レイヤーの例」も参照してください 。
© 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.
