HeightFieldShape QML Type
Une forme de collision dont l'élévation est définie par une carte d'altitude. En savoir plus...
| 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'value des pixels de l'image source. L'axe x de l'image est mis en correspondance avec l'axe x positif de la scène, et l'axe y de l'image est mis en correspondance avec l'axe z négatif de la scène. Un cas d'utilisation typique consiste à représenter un terrain naturel.
Les objets contrôlés par la simulation physique ne peuvent pas utiliser `HeightFieldShape` : celui-ci ne peut être utilisé qu’avec ` StaticRigidBody ` et ` kinematic bodies`.
QtQuick3D.Helpers.HeightFieldGeometry est compatible avec le type `HeightFieldShape` et permet de visualiser le champ de hauteur. Pour améliorer les performances, utilisez une version à plus faible résolution de la carte de hauteur pour le `HeightFieldShape` : tant que le rapport d’aspect de l’ extents et celui de l’image sont identiques, le corps physique et l’élément visuel se superposeront.
Voir également Formes, corps et articulations d’Qt Quick 3D Physics .
Documentation sur les propriétés
extents : vector3d
Cette propriété définit les limites du champ de hauteur. La valeur par défaut est « (100, 100, 100) » lorsque la carte de hauteur est carrée. Si la carte de hauteur n’est pas carrée, la valeur par défaut est réduite le long de l’axe x ou z, afin que le champ de hauteur conserve le rapport d’aspect de l’image.
image : Image [since 6.7]
Cette propriété définit l'image contenant la carte d'altitude.
En interne, HeightFieldShape convertit l'image de la carte d'altitude en une structure de données optimisée. Cette conversion peut être effectuée à l'avance. Consultez la documentation sur la présentation de Cooking pour plus de détails.
Remarque : si les propriétés image et « source » sont toutes deux définies, seule la propriété image sera utilisée.
Cette propriété a été introduite dans Qt 6.7.
Voir également « HeightFieldShape::source ».
source : url
Cette propriété définit l'emplacement du fichier « heightMap ».
En interne, HeightFieldShape convertit l’image de la carte de hauteur en une structure de données optimisée. Cette conversion peut être effectuée à l’avance. Consultez la documentation sur la présentation générale de Cooking pour plus de détails.
Remarque : si les propriétés « image » et « source » sont toutes deux définies, seule la propriété « image » sera utilisée.
Voir également 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.
