Qt Quick 3D - 레이어 예제

QtQuick3D 에서 레이어 사용을 보여줍니다.

레이어 토글 체크박스가 있는 빨강, 초록, 파랑의 세 가지 스택형 Qt 로고 레이어

이 예에서는 서로 다른 색상의 로고 모델이 서로 다른 레이어에 배치되어 있습니다. 설정 패널에서 사용자는 확인란을 토글하여 각 레이어의 표시 여부를 제어할 수 있습니다.

씬 레이어 준비하기

레이어

편의를 위해 Layer 열거형 유형을 식별하기 쉬운 이름으로 별칭을 지정합니다.

readonly property int redModels: ContentLayer.Layer1
readonly property int greenModels: ContentLayer.Layer2
readonly property int blueModels: ContentLayer.Layer3

Camera

레이어를 기반으로 카메라 뷰를 필터링하려면 카메라가 렌더링할 레이어를 설정해야 합니다. 카메라의 layers 속성을 하나 이상의 레이어로 설정하여 이를 수행합니다. 그러면 카메라는 지정된 layers 에 있는 오브젝트만 렌더링합니다. 기본적으로 카메라는 모든 layers 의 노드를 렌더링합니다.

활성 레이어를 선택할 수 있도록 cameraFilter 프로퍼티를 생성하고 카메라의 layers 프로퍼티에 바인딩합니다.

property int cameraFilter: ContentLayer.LayerAll

camera: PerspectiveCamera {
    layers: v3d.cameraFilter
    position: Qt.vector3d(0, 400, 500)
    eulerRotation.x: -30
    clipFar: 2000
}

설정 패널의 체크박스를 토글하면 cameraFilter 프로퍼티가 업데이트되어 각 레이어를 포함하거나 제외합니다. 이렇게 하면 카메라는 cameraFilter 에 지정된 레이어에 있는 오브젝트만 렌더링합니다.

CheckBox {
    id: checkBoxRedLayer
    text: qsTr("Red Layer")
    checked: true
    onCheckedChanged: {
        v3d.cameraFilter = checked ? v3d.cameraFilter | v3d.redModels : v3d.cameraFilter & ~v3d.redModels;
    }
}

모델

이제 세 가지 색상의 모델을 각각의 레이어에 할당해야 합니다. 카메라와 마찬가지로 모델의 layers 속성을 사용하여 레이어에 할당할 수 있습니다. 빨간색 로고 모델은 redLayer, 녹색은 greenLayer, 파란색은 blueLayer 에 할당됩니다.

Node {
    position: Qt.vector3d(0, 200, 0)
    Model {
        source: "qtlogo.mesh"
        layers: v3d.redModels
        scale: Qt.vector3d(5000, 5000, 5000)
        materials:[ PrincipledMaterial {
            baseColor: "red"
            roughness: 0.5
        } ]

        NumberAnimation on eulerRotation.y {
            from: 0
            to: 360
            duration: 15000
            loops: Animation.Infinite
        }
    }

    Model {
        position: Qt.vector3d(0, -50, 0)
        source: "#Cylinder"
        materials:[ PrincipledMaterial {
            baseColor: "red"
            roughness: 0.5
        } ]
    }
}

Node {
    position: Qt.vector3d(0, 100, 0)
    Model {
        source: "qtlogo.mesh"
        layers: v3d.greenModels
        scale: Qt.vector3d(5000, 5000, 5000)
        materials:[ PrincipledMaterial {
            baseColor: "green"
            roughness: 0.5
        } ]

        NumberAnimation on eulerRotation.y {
            from: 0
            to: 360
            duration: 20000
            loops: Animation.Infinite
        }
    }
    Model {
        position: Qt.vector3d(0, -50, 0)
        source: "#Cylinder"
        materials:[ PrincipledMaterial {
            baseColor: "green"
            roughness: 0.5
        } ]
    }
}
Node {
    Model {
        source: "qtlogo.mesh"
        layers: v3d.blueModels
        scale: Qt.vector3d(5000, 5000, 5000)
        materials:[ PrincipledMaterial {
            baseColor: "blue"
            roughness: 0.5
        } ]

        NumberAnimation on eulerRotation.y {
            from: 0
            to: 360
            duration: 12500
            loops: Animation.Infinite
        }
    }
    Model {
        position: Qt.vector3d(0, -50, 0)
        source: "#Cylinder"
        materials:[ PrincipledMaterial {
            baseColor: "blue"
            roughness: 0.5
        } ]
    }
}

레이어가 설정되면 이제 카메라는 cameraFilter 에 지정된 레이어에 있는 모델만 렌더링합니다. 사용자는 설정 패널에서 확인란을 선택하거나 선택 취소하여 각 레이어의 표시 여부를 전환할 수 있습니다.

예제 프로젝트 @ code.qt.io

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