HeightFieldShape QML Type
Una forma de colisión en la que la elevación viene definida por un mapa de alturas. Más información...
| 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 el valor de « 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 la representación de terreno natural.
Los objetos controlados por la simulación física no pueden utilizar HeightFieldShape: solo se puede utilizar con StaticRigidBody y kinematic bodies.
QtQuick3D.Helpers.HeightFieldGeometry es compatible con la API del tipo «HeightFieldShape» y se puede utilizar para mostrar visualmente el campo de altura. Para mejorar el rendimiento, utiliza una versión de menor resolución del mapa de altura para «HeightFieldShape»: siempre que la « extents » y la relación de aspecto de la imagen sean las mismas, el cuerpo físico y el elemento visual se superpondrán.
Véase también «Qt Quick: Formas, cuerpos y articulaciones de física 3D».
Documentación de propiedades
extents : vector3d
Esta propiedad define los límites del campo de altura. El valor por defecto es « (100, 100, 100) » cuando el mapa de altura es cuadrado. Si el mapa de altura no es cuadrado, el valor por defecto se reduce a lo largo del eje x o z, de modo que el campo de altura mantenga la relación de aspecto de la imagen.
image : Image [since 6.7]
Esta propiedad define la imagen que contiene el mapa de altura.
Internamente, HeightFieldShape convierte la imagen del mapa de alturas en una estructura de datos optimizada. Esta conversión se puede realizar con antelación. Consulta la documentación general sobre «cooking» para obtener más detalles.
Nota: Si se establecen tanto la propiedad «image» como la propiedad « source », solo 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 alturas en una estructura de datos optimizada. Esta conversión se puede realizar con antelación. Consulta la documentación general sobre «cooking» para obtener más detalles.
Nota: Si se establecen tanto la propiedad « image » como la propiedad «source», solo se utilizará « image ».
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.