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 와 이미지 종횡비가 동일하다면 물리 바디와 시각적 항목이 겹치게 됩니다.
셰이프 및 바디 개요 문서를참조하세요 .
속성 문서
extents : vector3d |
이 속성은 높이 필드의 범위를 정의합니다. 높이맵이 정사각형인 경우 기본값은 (100, 100, 100) 입니다. heightMap이 정사각형이 아닌 경우 기본값은 x축 또는 z축을 따라 축소되므로 높이 필드는 이미지의 가로 세로 비율을 유지합니다.
image : Image |
이 속성은 heightMap을 담고 있는 이미지를 정의합니다.
내부적으로 HeightFieldShape 는 높이 맵 이미지를 최적화된 데이터 구조로 변환합니다. 이 변환은 미리 수행할 수 있습니다. 자세한 내용은 쿠킹 개요 문서를 참조하세요.
참고: 이미지와 source 속성이 모두 설정되어 있으면 이미지만 사용됩니다.
이 속성은 Qt 6.7에 도입되었습니다.
HeightFieldShape::source 를참조하세요 .
source : url |
이 속성은 heightMap 파일의 위치를 정의합니다.
내부적으로 HeightFieldShape 은 높이 맵 이미지를 최적화된 데이터 구조로 변환합니다. 이 변환은 미리 수행할 수 있습니다. 자세한 내용은 쿠킹 개요 문서를 참조하세요.
HeightFieldShape::image 를참조하세요 .
© 2025 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.
