Qt Quick Changements dans l'API 3D Physics depuis Tech Preview

À partir de la version 6.5.0 de Qt, le module 3D Physics de Qt Quick n'est plus en Tech Preview. Suite aux commentaires et au processus de révision de l'API, certains changements incompatibles avec les sources ont été apportés.

La majorité des changements consiste à renommer les types et les propriétés pour des raisons de cohérence avec d'autres API et pour rendre les noms plus descriptifs. Le changement de nom le plus visible est le remplacement de DynamicsWorld par PhysicsWorld, qui affectera toutes les applications.

Le changement de comportement le plus important est la gestion de kinematic bodies. La modification de la position/orientation d'un corps cinématique ne se fait plus en utilisant les propriétés de Node (position, rotation, etc.), mais en utilisant les nouvelles propriétés : kinematicPosition, kinematicEulerRotation, kinematicRotation, et kinematicPivot. La raison de ce changement est de s'assurer que le mouvement visuel des corps cinématiques est synchronisé avec le reste de la simulation, au lieu de se produire un pas de simulation trop tôt.

La propriété DynamicRigidBody.density ne traite plus les valeurs négatives (et le zéro) comme un cas particulier. Au lieu de cela, deux nouvelles valeurs de l'énumération massMode remplacent Density:

La propriété enableTriggerReports a été renommée sendTriggerReports. En outre, les objets physiques peuvent désormais être notifiés lorsqu'ils entrent dans un corps de déclenchement en définissant receiveTriggerReports.

Voici une liste complète de toutes les modifications apportées à l'API :

• CollisionShape:
  • renommé enableDebugView en enableDebugDraw
• Renommé le type de base abstrait CollisionNode en PhysicsNode
  • modifié enableTriggerReports en sendTriggerReports et receiveTriggerReports
• CharacterController
  • renommé speed en movement
• ConvexMeshShape
  • renommé meshSource en source
• HeightFieldShape
  • renommé heightMap en source
• TriangleMeshShape
  • renommé meshSource en source
• PhysicsWorld (renommé à partir de DynamicsWorld)
  • renommé forceDebugView en forceDebugDraw
  • renommé minTimestep/maxTimestep en minimumTimestep/maximumTimestep
  • suppression de sceneNode
  • ajouté scene
  • ajouté viewport
• DynamicRigidBody
  • changement des propriétés axisLockLinearX/Y/Z en une seule propriété linearAxisLock qui prend un champ de bits
  • modification des propriétés axisLockAngularX/Y/Z en une seule propriété angularAxisLock qui prend un champ de bits
  • ajout de nouvelles propriétés kinematicPosition, kinematicEulerRotation, kinematicRotation, et kinematicPivot
  • remplacement de la valeur de l'énumération Density par DefaultDensity/CustomDensity et suppression de la mise en majuscule des valeurs négatives.
  • remplacement de la propriété linearVelocity par la méthode setLinearVelocity.
  • remplacement de la propriété angularVelocity par la méthode setAngularVelocity.