HeightFieldShape QML 类型

一种通过高度场定义高度的碰撞形状。更多...

属性

HeightFieldShape 类型定义了一个物理表面，其中高度由源图像的像素值确定。图像的 x 轴映射到场景的正 x 轴，图像的 y 轴映射到场景的负 z 轴。一个典型的用例是表示自然地形。

由物理模拟控制的物体不能使用 HeightFieldShape：它只能与 StaticRigidBody 和运动学体一起使用。

QtQuick3D.Helpers.HeightFieldGeometry 与 HeightFieldShape 类型兼容 API，并可用于可视显示高度场。为了提高性能，使用较低分辨率的 HeightFieldShape 高度图：只要范围和图像宽高比相同，物理体和可视项将重叠。

另请参见 形状和体概述文档.

extents : vector3d

此属性定义了高度场的范围。当高度图是正方形时，默认值是在定为（100，100，100）。如果高度图是非正方形的，则默认值会随之减少 x 轴或 z 轴上的值，这样高度场就可以保持图像的宽高比。

image : Image [since 6.7]

此属性定义了包含高度图图像的图像。

内部，HeightFieldShape 将高度图图像转换为优化的数据结构。这种转换可以预先执行。有关详细信息，请参阅烹饪概述文档。

注意：如果同时设置了图像和 source 属性，则仅使用图像。

此属性是在 Qt 6.7 中引入的。

另请参阅 HeightFieldShape::source。

source : url

此属性定义了高度图文件的存储位置。

内部，HeightFieldShape 将高度图图像转换为优化的数据结构。这种转换可以预先执行。有关详细信息，请参阅烹饪概述文档。

注意： 如果同时设置了image和source属性，那么只会使用image属性。

另请参阅 HeightFieldShape::image。