ContentLayer QML Type
QtQuick3D...에서 사용 가능한 콘텐츠 레이어의 열거를 제공합니다... .
| Import Statement: | import QtQuick3D |
| Since: | Qt 6.11 |
상세 설명
이 클래스는 3D 씬에서 콘텐츠 레이어를 나타내는 데 사용됩니다. 배경, 전경 또는 UI 요소와 같은 다양한 콘텐츠 레이어를 관리하는 데 사용할 수 있습니다.
ContentLayer 열거형은 씬 노드를 함께 그룹화하거나 카메라가 렌더링할 노드를 필터링하는 데 사용할 수 있는 사용 가능한 레이어 플래그를 정의합니다(예: 씬 노드를 함께 그룹화하거나 카메라가 렌더링할 노드를 필터링하는 데 사용 가능).
사전 정의된 레이어 이름이 특정 사용 사례를 충분히 설명하지 못하는 경우 ContentLayer 열거형 값에 별칭을 지정하여 자신만의 레이어를 정의할 수 있습니다. 건물, 거리, 차량에 대해 서로 다른 레이어가 있는 도시 씬을 생각해 봅시다. 이러한 각 레이어에 layerBuildings, layerStreets, layerVehicles 와 같은 특정 플래그를 할당하여 ContentLayer 열거형 값에 별칭을 지정할 수 있습니다. 레이어가 정의되면 씬의 노드에 이러한 플래그를 할당하고 Camera 에서 동일한 레이어 프로퍼티를 설정하여 카메라가 렌더링할 레이어를 필터링하도록 할 수 있습니다.
readonly property int layerBuildings: ContentLayer.Layer1 readonly property int layerStreets: ContentLayer.Layer2 readonly property int layerVehicles: ContentLayer.Layer3 | ContentLayer.Layer4
참고: 일부 레이어에는 특별한 의미가 있습니다:
| 레이어 | 설명 |
|---|---|
| LayerNone | 할당된 레이어가 없으며, 노드가 어떤 레이어에도 속하지 않으므로 렌더링하지 않아야 함을 나타내는 데 사용됩니다. |
| Layer0 | 씬의 주요 콘텐츠에 사용되는 기본 레이어입니다. 노드는 기본적으로 이 레이어에 할당됩니다. |
| Layer1-23 | 자유롭게 할당 가능한 레이어로, 노드의 목적이나 기능에 따라 노드를 그룹화하는 데 사용됩니다. |
| 레이어24 이상 | 특별한 목적이나 향후 확장에 사용되는 예약 레이어입니다. |
| LayerAll | 노드가 모든 레이어에 속함을 나타내며, 모든 레이어에서 렌더링되어야 하는 노드에 사용됩니다. |
참고: 레이어는 플래그로 정의되므로 여러 레이어를 결합할 수 있습니다.
참고: 이 클래스는 직접 인스턴스화되지 않습니다. 대신 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.
