ContentLayer QML Type
QtQuick3D で利用可能なコンテンツレイヤーの列挙を提供する。
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.11 |
詳細説明
このクラスは、3D シーン内のコンテンツのレイヤーを表すために使用されます。背景、前景、UI 要素など、さまざまなコンテンツのレイヤーを管理するために使用できます。
ContentLayer 列挙では、使用可能なレイヤー フラグを定義します。このフラグを使用して、シーン ノードをグループ化したり、カメラによってレンダリングされるノードをフィルタリングしたりできます。
その場合、ContentLayer 列挙値をエイリアス化することで、独自のレイヤーを定義できます。都市シーンで、建物、道路、車のレイヤーがあるとします。ContentLayer の列挙値をエイリアス化することで、layerBuildings 、layerStreets 、layerVehicles のように、各レイヤーに特定のフラグを割り当てることができます。レイヤが定義されたら、これらのフラグをシーン内のノードに割り当て、Camera に同じレイヤ プロパティを設定することで、カメラがレンダリングするレイヤをフィルタリングできます。
readonly property int layerBuildings: ContentLayer.Layer1 readonly property int layerStreets: ContentLayer.Layer2 readonly property int layerVehicles: ContentLayer.Layer3 | ContentLayer.Layer4
注意： レイヤーの中には特別な意味を持つものがあります：
| レイヤー | 説明 |
|---|---|
| レイヤーなし | ノードがどのレイヤーにも属さず、レンダリングされるべきでないことを示すために使用されます。 |
| レイヤー0 | シーンの主要なコンテンツに使用されるメインレイヤー。ノードはデフォルトでこのレイヤーに割り当てられる。 |
| レイヤー1-23 | 自由に割り当てることができるレイヤーで、目的や機能に基づいてノードをグループ化するために使用されます。 |
| レイヤー24以上 | 特別な目的や将来の拡張のために使用されます。 |
| レイヤーオール | ノードがすべてのレイヤーに属することを示します。すべてのレイヤーでレンダリングされるべきノードに使用されます。 |
注： レイヤーはフラグとして定義され、複数のレイヤーを組み合わせることができます。
注： このクラスは直接インスタンス化することを意図していません。代わりに、レイヤーのフラグにアクセスするためにQMLのシングルトンとして使用されます。
レイヤーの例も参照してください 。
© 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.
