HeightFieldShape QML Type
높이 맵을 통해 고도가 정의되는 충돌 형상입니다. 더 보기...
| Import Statement: | import QtQuick3D.Physics |
| Since: | Qt 6.4 |
| Inherits: |
속성
상세 설명
HeightFieldShape 유형은 source 이미지의 픽셀에 대한 value 값에 따라 높이가 결정되는 물리적 표면을 정의합니다. 이미지의 x축은 씬의 양의 x축에 매핑되고, 이미지의 y축은 씬의 음의 z축에 매핑됩니다. 대표적인 사용 사례는 자연 지형을 표현하는 것입니다.
물리 시뮬레이션에 의해 제어되는 오브젝트는 HeightFieldShape를 사용할 수 없습니다. 이 타입은 StaticRigidBody 및 kinematic bodies 와 함께만 사용할 수 있습니다.
QtQuick3D.Helpers.HeightFieldGeometry 는 HeightFieldShape 유형과 API 호환되며, 높이 필드를 시각적으로 표시하는 데 사용할 수 있습니다. 성능을 향상시키려면 HeightFieldShape에 대해 해상도가 더 낮은 높이 맵 버전을 사용하십시오. extents 와 이미지의 종횡비가 동일하다면, 물리 바디와 시각적 항목이 겹치게 됩니다.
Qt Quick 3D Physics 의 도형, 바디 및 조인트도 참조하십시오 .
속성 설명서
extents : vector3d
이 속성은 높이 필드의 범위를 정의합니다. heightMap이 정사각형일 때 기본값은 (100, 100, 100) 입니다. heightMap이 정사각형이 아닐 경우, 기본값은 x축 또는 z축을 따라 축소되어 높이 필드가 이미지의 종횡비를 유지하도록 합니다.
image : Image [since 6.7]
이 속성은 heightMap을 포함하는 이미지를 정의합니다.
내부적으로 ` HeightFieldShape `는 높이 맵 이미지를 최적화된 데이터 구조로 변환합니다. 이 변환은 미리 수행할 수 있습니다. 자세한 내용은 'cooking' 개요 문서를 참조하십시오.
참고: image 속성과 source 속성이 모두 설정된경우 , image 속성만 사용됩니다.
이 속성은 Qt 6.7에서 도입되었습니다.
HeightFieldShape::source도 참조하십시오 .
source : url
이 속성은 heightMap 파일의 위치를 정의합니다.
내부적으로 HeightFieldShape 는 높이 맵 이미지를 최적화된 데이터 구조로 변환합니다. 이 변환은 미리 수행할 수 있습니다. 자세한 내용은 'cooking' 개요 문서를 참조하십시오.
HeightFieldShape::image항목도 참조하십시오 .
© 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.