HeightFieldShape QML Type
Eine Kollisionsform, bei der die Höhe durch eine Höhenkarte definiert ist. Mehr...
| Import Statement: | import QtQuick3D.Physics |
| Since: | Qt 6.4 |
| Inherits: |
Eigenschaften
Detaillierte Beschreibung
Der HeightFieldShape-Typ definiert eine physische Oberfläche, deren Höhe durch die value der Pixel des source Bildes 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 eines natürlichen Geländes.
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 HeightFieldShape-Typ und kann verwendet werden, um das Höhenfeld visuell darzustellen. Um die Leistung zu verbessern, verwenden Sie eine Version der Höhenkarte mit geringerer Auflösung für den HeightFieldShape: Solange die extents und das Bildseitenverhältnis gleich sind, überlappen sich der physikalische Körper und das visuelle Element.
Siehe auch die Übersichtsdokumentation zu Shapes und Bodies.
Dokumentation der Eigenschaft
extents : vector3d |
Diese Eigenschaft definiert die Ausmaße des Höhenfeldes. Der Standardwert ist (100, 100, 100), wenn die heightMap quadratisch ist. Wenn die heightMap nicht quadratisch ist, wird der Standardwert entlang der x- oder z-Achse reduziert, so dass das Höhenfeld das Seitenverhältnis des Bildes beibehält.
image : Image |
Diese Eigenschaft definiert das Bild, das die heightMap enthält.
Intern konvertiert HeightFieldShape das HeightMap-Bild in eine optimierte Datenstruktur. Diese Konvertierung kann im Voraus durchgeführt werden. Einzelheiten dazu finden Sie in der Dokumentation zur Kochübersicht.
Hinweis: Wenn sowohl die Eigenschaften image als auch source gesetzt sind, wird nur image verwendet.
Diese Eigenschaft wurde in Qt 6.7 eingeführt.
Siehe auch HeightFieldShape::source.
source : url |
Diese Eigenschaft definiert den Speicherort der heightMap-Datei.
Intern konvertiert HeightFieldShape das HeightMap-Bild in eine optimierte Datenstruktur. Diese Konvertierung kann im Voraus durchgeführt werden. Einzelheiten dazu finden Sie in der Dokumentation zur Kochübersicht.
Hinweis: Wenn sowohl die Eigenschaften image als auch source gesetzt sind, wird nur image verwendet.
Siehe auch 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.
