このページでは

HeightFieldShape QML Type

高さマップによって標高が定義される衝突形状。詳細...

Import Statement: import QtQuick3D.Physics
Since: Qt 6.4
Inherits:

CollisionShape

プロパティ

詳細な説明

HeightFieldShape 型は、source 画像のピクセルにおけるvalue によって高さが決定される物理的な表面を定義します。画像の x 軸はシーンの正の x 軸に、画像の y 軸はシーンの負の z 軸にマッピングされます。代表的な使用例としては、自然の地形を表現することが挙げられます。

物理シミュレーションによって制御されるオブジェクトは、HeightFieldShape を使用できません。このタイプは、StaticRigidBody およびkinematic bodies でのみ使用可能です。

QtQuick3D.Helpers.HeightFieldGeometry は HeightFieldShape 型と API 互換性があり、高さフィールドを視覚的に表示するために使用できます。パフォーマンスを向上させるには、HeightFieldShape には解像度の低い高さマップを使用してください。extents と画像のアスペクト比が同じであれば、物理ボディと視覚アイテムは重なり合います。

「Qt Quick 3D 物理形状、ボディ、ジョイント」も参照してください 。

プロパティのドキュメント

extents : vector3d

このプロパティは、高さフィールドの範囲を定義します。heightMap が正方形のとき、デフォルト値は `(100, 100, 100) ` です。heightMap が正方形でない場合、デフォルト値は x 軸または z 軸に沿って縮小されるため、高さフィールドは画像のアスペクト比を維持します。

image : Image [since 6.7]

このプロパティは、heightMap を格納する画像を定義します。

内部的には、HeightFieldShape がheightMap画像を最適化されたデータ構造に変換します。この変換は事前に実行可能です。詳細については、cookingの概要ドキュメントを参照してください。

注: image プロパティとsource プロパティの両方が設定されている場合 、image のみが使用されます。

このプロパティは Qt 6.7 で導入されました。

「HeightFieldShape::source」も参照してください 。

source : url

このプロパティは、heightMap ファイルの保存場所を指定します。

内部的には、HeightFieldShape がハイトマップ画像を最適化されたデータ構造に変換します。この変換は事前に実行することができます。詳細については、Cookingの概要ドキュメントを参照してください。

注: image プロパティと source プロパティの両方が設定されている場合 、image のみが使用されます。

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