ContentLayer QML Type
씬 노드를 그룹화하고 필터링하기 위한 레이어 플래그 상수를 제공하는 싱글톤. 더 보기...
| 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.
