En esta página

Qt Quick Física 3D: «Cooking»

Cuando se utiliza una malla como forma de colisión, es necesario procesarla y convertirla a un formato de datos que permita una detección de colisiones eficiente. A este proceso se le denomina «preprocesamiento». Hay tres tipos de formas que deben preprocesarse antes de poder utilizarlas: ConvexMeshShape, TriangleMeshShape y HeightFieldShape. El preprocesamiento se realiza automáticamente en el primer fotograma de la simulación cuando se utiliza cualquiera de estas formas. Este «cooking» puede suponer un coste de rendimiento apreciable, por lo que, para acelerar los tiempos de carga, es posible precalcular las mallas y cargarlas directamente. Hay dos formas de hacerlo: utilizando un directorio de caché o la herramienta «cooker».

Directorio de caché

Para utilizar el directorio de caché, configura la variable de entorno ` QT_PHYSICS_CACHE_PATH ` con el directorio que elijas. Cuando la aplicación se ejecute por primera vez, todas las mallas utilizadas se procesarán y se almacenarán en este directorio. Las siguientes veces que se ejecute la aplicación, las mallas procesadas se leerán del disco en lugar de volver a procesarse.

Advertencia: Los archivosdel directorio de caché no se validan antes de cargarse. Cargar un archivo de caché mal formado o no fiable puede tener implicaciones de seguridad. Los desarrolladores de aplicaciones deben tener esto muy en cuenta antes de apuntar QT_PHYSICS_CACHE_PATH a un directorio en el que otros usuarios o procesos tengan permisos de escritura.

Herramienta «Cooker»

La otra forma es utilizar la herramienta cooker. Compílala y, a continuación, simplemente ejecuta la herramienta con la malla o la imagen del campo de altura como argumento de entrada:

cooker input.mesh

o

cooker input.png

Si la entrada es una malla, generará dos archivos:

  • input.cooked.tri
  • input.cooked.cvx

Un archivo es una malla triangular «cooked» y el otro, una malla convexa «cooked». Estos se pueden utilizar simplemente como fuentes de TriangleMeshShape::source y ConvexMeshShape::source, y las mallas se cargarán sin necesidad de «cooking». Del mismo modo, si la entrada es un archivo de imagen, se genera un campo de altura denominado input.cooked.hf, que luego se puede cargar haciendo referencia a él en la propiedad HeightFieldShape::source.

© 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.