이 페이지에서

GridGeometry QML Type

그리드를 렌더링하기 위한 사용자 정의 지오메트리 프로바이더. 더 보기...

Import Statement: import QtQuick3D.Helpers
Inherits:

Geometry

속성

상세 설명

이 헬퍼는 씬에 그리드를 표시할 수 있게 해주는 그리드 지오메트리를 구현합니다.

예를 들어, 다음 코드 조각은 조명이 하나 있는 씬에 양방향으로 19개의 셀로 구성된 그리드를 표시합니다. 별도의 변환을 적용하지 않으면, 그리드는 기본적으로 카메라를 향하게 됩니다.

19×19 셀 그리드가 있는 전면 카메라와 방향성 조명

View3D {
    anchors.fill: parent
    camera: camera

    PerspectiveCamera {
        id: camera
        position: Qt.vector3d(0, 0, 600)
    }

    DirectionalLight {
        position: Qt.vector3d(-500, 500, -100)
        color: Qt.rgba(0.4, 0.2, 0.6, 1.0)
        ambientColor: Qt.rgba(0.1, 0.1, 0.1, 1.0)
    }

    Model {
        scale: Qt.vector3d(100, 100, 100)
        geometry: GridGeometry {
            horizontalLines: 20
            verticalLines: 20
        }
        materials: [ DefaultMaterial { } ]
    }
}

Qt Quick 3D - 사용자 정의 지오메트리 예제 및 Model도 참조하십시오 .

속성 설명

horizontalLines : int

그리드의 가로 선 수를 지정합니다. 기본값은 1000입니다.

horizontalStep : real

수평선 사이의 간격을 지정합니다. 기본값은 0.1입니다.

verticalLines : int

그리드의 세로선 수를 지정합니다. 기본값은 1000입니다.

verticalStep : real

수직선 사이의 간격을 지정합니다. 기본값은 0.1입니다.

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