HeightFieldShape QML Type
Eine Kollisionsform, bei der die Höhe durch eine Höhenkarte definiert wird. Mehr...
| Import Statement: | import QtQuick3D.Physics |
| Since: | Qt 6.4 |
| Inherits: |
Eigenschaften
Ausführliche Beschreibung
Der Typ „HeightFieldShape“ definiert eine physikalische Oberfläche, deren Höhe durch die „ value “ der Pixel des Bildes „ source “ bestimmt wird. Die x-Achse des Bildes wird auf die positive x-Achse der Szene abgebildet, und die y-Achse des Bildes wird auf die negative z-Achse der Szene abgebildet. Ein typischer Anwendungsfall ist die Darstellung von natürlichem Gelände.
Objekte, die von der Physiksimulation gesteuert werden, können „HeightFieldShape“ nicht verwenden: Es kann nur mit „ StaticRigidBody “ und „ kinematic bodies “ verwendet werden.
QtQuick3D.Helpers.HeightFieldGeometry ist API-kompatibel mit dem Typ „HeightFieldShape“ und kann verwendet werden, um das Höhenfeld visuell darzustellen. Um die Leistung zu verbessern, verwenden Sie für „HeightFieldShape“ eine Version der Höhenkarte mit niedrigerer Auflösung: Solange „ extents “ und das Seitenverhältnis des Bildes identisch sind, überlappen sich der Physikkörper und das visuelle Element.
Siehe auch „Qt Quick 3D “ unter„Physikformen, Körper und Gelenke“.
Dokumentation zu den Eigenschaften
extents : vector3d
Diese Eigenschaft legt den Umfang des Höhenfelds fest. Der Standardwert beträgt „ (100, 100, 100) “, wenn die „heightMap“ quadratisch ist. Ist die „heightMap“ nicht quadratisch, wird der Standardwert entlang der x- oder z-Achse reduziert, sodass das Höhenfeld das Seitenverhältnis des Bildes beibehält.
image : Image [since 6.7]
Diese Eigenschaft definiert das Bild, das die „heightMap“ enthält.
Intern wandelt „ HeightFieldShape “ das Height-Map-Bild in eine optimierte Datenstruktur um. Diese Umwandlung kann im Voraus erfolgen. Weitere Informationen finden Sie in der Dokumentation zur „Cooking“-Übersicht.
Hinweis: Wenn sowohl die Eigenschaft „image“ als auch die Eigenschaft „ source “ festgelegt sind, wird ausschließlich „image“ verwendet.
Diese Eigenschaft wurde in Qt 6.7 eingeführt.
Siehe auch „ HeightFieldShape::source “.
source : url
Diese Eigenschaft legt den Speicherort der „heightMap“-Datei fest.
Intern wandelt „ HeightFieldShape “ das Height-Map-Bild in eine optimierte Datenstruktur um. Diese Umwandlung kann im Voraus erfolgen. Weitere Informationen finden Sie in der Dokumentation zur „Cooking“-Übersicht.
Hinweis: Wenn sowohl die Eigenschaft „ image “ als auch die Eigenschaft „source“ festgelegt sind, wird ausschließlich „ image “ verwendet.
Siehe auch „ 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.
