Qt Quick Cambios en la API de Física 3D desde la Tech Preview

A partir de la versión Qt 6.5.0, el módulo Qt Quick 3D Physics ya no está en la Tech Preview. Como resultado del proceso de retroalimentación y revisión de la API, se han realizado algunos cambios incompatibles con el código fuente.

La mayoría de los cambios consisten en cambiar el nombre de los tipos y las propiedades para mantener la coherencia con otras API y para que los nombres sean más descriptivos. El cambio más notable es el de DynamicsWorld por PhysicsWorld, que afectará a todas las aplicaciones.

El cambio de comportamiento más importante es la gestión de kinematic bodies. El cambio de posición/orientación de un cuerpo cinemático ya no se realiza utilizando las propiedades de Node (position, rotation, etc.), sino utilizando las nuevas propiedades: kinematicPosition, kinematicEulerRotation, kinematicRotation, y kinematicPivot. El motivo de este cambio es asegurarse de que el movimiento visual de los cuerpos cinemáticos está sincronizado con el resto de la simulación, en lugar de producirse un paso de simulación antes de tiempo.

La propiedad DynamicRigidBody.density ya no trata los valores negativos (y cero) como un caso especial. En su lugar, hay dos nuevos valores de enumeración massMode que sustituyen a Density:

La propiedad enableTriggerReports ha sido renombrada a sendTriggerReports. Además, los objetos de física pueden ahora ser notificados cuando entran en un cuerpo de disparo estableciendo receiveTriggerReports.

A continuación se incluye una lista completa de todos los cambios de la API:

• CollisionShape:
  • se ha cambiado el nombre de enableDebugView a enableDebugDraw
• renombrado el tipo base abstracto CollisionNode a PhysicsNode
  • cambiado enableTriggerReports a sendTriggerReports y receiveTriggerReports
• CharacterController
  • renombrado speed a movement
• ConvexMeshShape
  • renombrado meshSource a source
• HeightFieldShape
  • renombrado heightMap a source
• TriangleMeshShape
  • renombrado meshSource a source
• PhysicsWorld (renombrado de DynamicsWorld)
  • renombrado forceDebugView a forceDebugDraw
  • renombrado minTimestep/maxTimestep a minimumTimestep/maximumTimestep
  • eliminado sceneNode
  • añadido scene
  • añadido viewport
• DynamicRigidBody
  • cambiado las propiedades axisLockLinearX/Y/Z en una sola propiedad linearAxisLock que toma un bitfield
  • cambiado las propiedades axisLockAngularX/Y/Z en una sola propiedad angularAxisLock que toma un bitfield
  • añadidas nuevas propiedades kinematicPosition, kinematicEulerRotation, kinematicRotation, y kinematicPivot
  • cambiado el valor del enum Density a DefaultDensity/CustomDensity y eliminado el caso especial de los valores negativos.
  • reemplazado la propiedad linearVelocity con el método setLinearVelocity.
  • se sustituye la propiedad angularVelocity por el método setAngularVelocity.