Qt Quick Cambios en la API de física 3D con respecto a la versión Tech Preview
A partir de la versión Qt 6.5.0, el módulo de física 3D de Qt Quick ya no se encuentra en fase de Tech Preview. Como resultado del proceso de revisión y comentarios sobre la API, se han realizado algunos cambios incompatibles con el código fuente.
La mayoría de los cambios consisten en renombrar tipos y propiedades para mantener la coherencia con otras API y para que los nombres sean más descriptivos. El cambio de nombre más notable es el de « DynamicsWorld » a « PhysicsWorld », lo que afectará a todas las aplicaciones.
El cambio de comportamiento más importante es el manejo de « kinematic bodies ». El cambio de posición u orientación de un cuerpo cinemático ya no se realiza mediante las propiedades de « Node » (position, rotation, etc.), sino mediante las nuevas propiedades: kinematicPosition, kinematicEulerRotation, kinematicRotation y kinematicPivot. El motivo de este cambio fue garantizar que el movimiento visual de los cuerpos cinemáticos se sincronizara con el resto de la simulación, en lugar de producirse un paso de simulación antes de lo previsto.
La propiedad ` DynamicRigidBody.density ` ya no trata los valores negativos (ni el cero) como un caso especial. En su lugar, hay dos nuevos valores de enumeración ` massMode ` que sustituyen a ` Density`:
DefaultDensity | La densidad del cuerpo viene definida por PhysicsWorld.defaultDensity. Este es el valor por defecto. |
CustomDensity | La densidad del cuerpo viene definida por la propiedad « density ». |
La propiedad « enableTriggerReports » ha pasado a denominarse « sendTriggerReports ». Además, ahora se puede notificar a los objetos físicos cuando entran en un cuerpo de activación estableciendo « receiveTriggerReports ».
A continuación se incluye una lista completa de todos los cambios en la API:
- CollisionShape:
- Se ha cambiado el nombre de `enableDebugView` a enableDebugDraw
- Se ha cambiado el nombre del tipo base abstracto «
CollisionNode» a PhysicsNode- Se ha cambiado «enableTriggerReports» a « sendTriggerReports » y receiveTriggerReports
- CharacterController
- se ha cambiado el nombre de «
speed» a movement
- se ha cambiado el nombre de «
- ConvexMeshShape
- Se ha cambiado el nombre de «
meshSource» a source
- Se ha cambiado el nombre de «
- HeightFieldShape
- cambiado el nombre de
heightMapa source
- cambiado el nombre de
- TriangleMeshShape
- cambiado el nombre de
meshSourcea source
- cambiado el nombre de
- PhysicsWorld (cambiado de
DynamicsWorld)- Se ha cambiado el nombre de
forceDebugViewa forceDebugDraw - cambiado el nombre de «
minTimestep» / «maxTimestep» a « minimumTimestep » /maximumTimestep - eliminado sceneNode
- añadido scene
- añadido viewport
- Se ha cambiado el nombre de
- DynamicRigidBody
- Se han fusionado las propiedades de «
axisLockLinearX/Y/Z» en una única propiedad, « linearAxisLock », que admite un campo de bits - Se han modificado las propiedades «
axisLockAngularX/Y/Z» para convertirlas en una única propiedad « angularAxisLock » que admite un campo de bits - Se han añadido nuevas propiedades: ` kinematicPosition`, ` kinematicEulerRotation`, ` kinematicRotation` y kinematicPivot
- se ha cambiado el valor de la enumeración «
Density» a « DefaultDensity/CustomDensity » y se ha eliminado el tratamiento especial de los valores negativos. - Se ha sustituido la propiedad «
linearVelocity» por el método « setLinearVelocity ». - Se ha sustituido la propiedad «
angularVelocity» por el método « setAngularVelocity ».
- Se han fusionado las propiedades de «
© 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.