HeightFieldShape QML Type
Forme de collision dont l'élévation est définie par une carte d'altitude. Plus d'informations...
| Import Statement: | import QtQuick3D.Physics |
| Since: | Qt 6.4 |
| Inherits: |
Propriétés
Description détaillée
Le type HeightFieldShape définit une surface physique dont la hauteur est déterminée par l'adresse value des pixels de l'image source. L'axe x de l'image est mappé sur l'axe x positif de la scène, et l'axe y de l'image est mappé sur l'axe z négatif de la scène. Un cas d'utilisation typique est la représentation d'un terrain naturel.
Les objets contrôlés par la simulation physique ne peuvent pas utiliser HeightFieldShape : Il ne peut être utilisé qu'avec StaticRigidBody et kinematic bodies.
QtQuick3D.Helpers.HeightFieldGeometry est compatible avec l'API du type HeightFieldShape et peut être utilisé pour afficher visuellement le champ de hauteur. Pour améliorer les performances, utilisez une version à faible résolution de la carte des hauteurs pour le HeightFieldShape : Tant que le site extents et le rapport d'aspect de l'image sont identiques, le corps physique et l'élément visuel se chevauchent.
Voir également la documentation générale sur les formes et les corps.
Documentation sur les propriétés
extents : vector3d
Cette propriété définit l'étendue du champ de hauteur. La valeur par défaut est (100, 100, 100) lorsque la heightMap est carrée. Si la heightMap n'est pas carrée, la valeur par défaut est réduite le long de l'axe x ou z, de sorte que le champ de hauteur conserve le rapport hauteur/largeur de l'image.
image : Image [since 6.7]
Cette propriété définit l'image contenant la heightMap.
En interne, HeightFieldShape convertit l'image de la carte des hauteurs en une structure de données optimisée. Cette conversion peut être effectuée à l'avance. Voir la documentation sur la cuisson pour plus de détails.
Remarque : si les propriétés image et source sont toutes deux définies, seule l'image sera utilisée.
Cette propriété a été introduite dans Qt 6.7.
Voir aussi HeightFieldShape::source.
source : url
Cette propriété définit l'emplacement du fichier heightMap.
En interne, HeightFieldShape convertit l'image de la carte des hauteurs en une structure de données optimisée. Cette conversion peut être effectuée à l'avance. Voir la documentation sur la cuisson pour plus de détails.
Voir aussi 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.
