HeightFieldShape QML Type
Una forma de colisión en la que la elevación está definida por un mapa de alturas. Más...
| Import Statement: | import QtQuick3D.Physics |
| Since: | Qt 6.4 |
| Inherits: |
Propiedades
Descripción detallada
El tipo HeightFieldShape define una superficie física cuya altura viene determinada por la dirección value de los píxeles de la imagen source. El eje x de la imagen se asigna al eje x positivo de la escena, y el eje y de la imagen se asigna al eje z negativo de la escena. Un caso de uso típico es representar terreno natural.
Los objetos controlados por la simulación física no pueden utilizar HeightFieldShape: Sólo se puede utilizar con StaticRigidBody y kinematic bodies.
QtQuick3D.Helpers.HeightFieldGeometry es compatible con la API del tipo HeightFieldShape, y puede utilizarse para mostrar visualmente el campo de altura. Para mejorar el rendimiento, utiliza una versión de menor resolución del mapa de altura para el HeightFieldShape: Siempre que extents y la relación de aspecto de la imagen sean iguales, el cuerpo físico y el elemento visual se solaparán.
Véase también la documentación general sobre Shapes y Bodies.
Documentación de propiedades
extents : vector3d
Esta propiedad define la extensión del campo de altura. El valor por defecto es (100, 100, 100) cuando el heightMap es cuadrado. Si el heightMap no es cuadrado, el valor por defecto se reduce a lo largo de los ejes x o z, por lo que el campo de altura mantendrá la relación de aspecto de la imagen.
image : Image [since 6.7]
Esta propiedad define la imagen que contiene el heightMap.
Internamente, HeightFieldShape convierte la imagen del mapa de altura en una estructura de datos optimizada. Esta conversión puede realizarse por adelantado. Consulte la documentación general de cocción para más detalles.
Nota: Si se definen las propiedades image y source, sólo se utilizará image.
Esta propiedad se introdujo en Qt 6.7.
Véase también HeightFieldShape::source.
source : url
Esta propiedad define la ubicación del archivo heightMap.
Internamente, HeightFieldShape convierte la imagen del mapa de altura en una estructura de datos optimizada. Esta conversión puede realizarse por adelantado. Consulte la documentación general de cocción para más detalles.
Véase también 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.
