En esta página

PhysicsWorld QML Type

Controla la simulación física. Más...

Import Statement: import QtQuick3D.Physics
Since: Qt 6.4

Propiedades

Señales

Descripción detallada

El tipo PhysicsWorld controla la simulación física. Este nodo se utiliza para crear una instancia del mundo físico, así como para definir sus propiedades. Solo puede haber un mundo físico. Todos los nodos de colisión del QML se añadirán automáticamente al mundo físico.

Documentación de propiedades

defaultDensity : real

Esta propiedad define la densidad por defecto de los objetos dinámicos, medida en kilogramos por unidad cúbica. Equivale al peso de un cubo con un lado de 1.

El valor por defecto es 0.001, que corresponde a 1 g/cm³: la densidad del agua. Si tu unidad de medida es el metro, un buen valor sería 1000. Ten en cuenta que solo se admiten valores positivos.

Intervalo: (0, inf]

enableCCD : bool

Esta propiedad permite la detección continua de colisiones. De este modo se reduce el riesgo de que los cuerpos atraviesen a otros a gran velocidad (lo que también se conoce como «efecto túnel»). El valor por defecto es « false ».

Advertencia: El uso de cuerpos de activación con CCD activado no es compatible y puede dar lugar a informes de activación erróneos o a que falten.

forceDebugDraw : bool

Esta propiedad permite visualizar, con fines de depuración, todas las figuras activas del mundo físico. El valor por defecto es « false ».

gravity : vector3d

Esta propiedad define el vector de gravedad del mundo físico. El valor por defecto es (0, -981, 0). Establece el valor en Qt.vector3d(0, -9.81, 0) si tu unidad de medida es el metro y estás simulando la gravedad terrestre.

maximumTimestep : real

Esta propiedad define el paso de tiempo máximo de la simulación en milisegundos. El valor por defecto es 33.333.

Rango: [0, inf]

Nota: El paso de tiempo de la simulación funciona en sincronización con el renderizado, lo que significa que solo se iniciará un nuevo fotograma de simulación una vez que se haya completado un fotograma renderizado. Esto implica que, como máximo, se ejecutará un fotograma de simulación por cada fotograma renderizado.

minimumTimestep : real

Esta propiedad define el paso de tiempo mínimo de la simulación en milisegundos. El valor por defecto es 1.

Rango: [0, maximumTimestep]

Nota: El paso de tiempo de la simulación funciona en sincronía con el renderizado, lo que significa que solo se iniciará un nuevo fotograma de simulación una vez que se haya completado un fotograma renderizado. Esto implica que, como máximo, se ejecutará un fotograma de simulación por cada fotograma renderizado.

numThreads : int [since 6.7]

Esta propiedad define el número de subprocesos que se utilizan para la simulación física. A continuación se explica cómo se interpreta el rango de valores:

ValorRangoDescripción
Negativo[-inf, -1]Número automático de subprocesos. La aplicación intentará consultar el número de subprocesos del sistema.
Cero{0}Sin multihilo; la simulación se ejecutará de forma secuencial.
Positivo[1, 256]Número específico de subprocesos. Los valores superiores a 256 se limitan.

El valor por defecto es « -1 », lo que significa «número automático de subprocesos».

Nota: Una vez que la escena ha comenzado a ejecutarse, no es posible cambiar el número de subprocesos.

Esta propiedad se introdujo en Qt 6.7.

reportKinematicKinematicCollisions : bool [since 6.7]

Esta propiedad controla si las colisiones entre pares de cuerpos rígidos dinámicos cinemáticos activarán un informe de contacto.

El valor por defecto es « false ».

Nota: Una vez que la escena ha comenzado a ejecutarse, no es posible modificar esta configuración.

Esta propiedad se introdujo en Qt 6.7.

Véase también PhysicsWorld::reportStaticKinematicCollisions, DynamicRigidBody y PhysicsNode::bodyContact.

reportStaticKinematicCollisions : bool [since 6.7]

Esta propiedad controla si las colisiones entre un cuerpo rígido estático y un cuerpo rígido dinámico cinemático activarán un informe de contacto.

El valor por defecto es « false ».

Nota: Una vez que la escena ha comenzado a ejecutarse, no es posible modificar esta configuración.

Esta propiedad se introdujo en Qt 6.7.

Véase también PhysicsWorld::reportKinematicKinematicCollisions, StaticRigidBody, DynamicRigidBody y PhysicsNode::bodyContact.

running : bool

Esta propiedad inicia o detiene la simulación física. El valor por defecto es « true ».

scene : Node

Esta propiedad define el nodo de nivel superior que contiene todos los nodos de la simulación física. Todos los objetos físicos que sean antecesores de este nodo se considerarán parte de este « PhysicsWorld ».

Nota: No se admiteel uso del mismo nodo de escena para varios « PhysicsWorld ».

typicalLength : real

Esta propiedad define el tamaño aproximado de los objetos en la simulación. Se utiliza para estimar determinadas tolerancias relacionadas con la longitud. Es posible que los objetos mucho más pequeños o mucho más grandes que este tamaño no se comporten correctamente. El valor por defecto es 100.

Rango: [0, inf]

typicalSpeed : real

Esta propiedad define la magnitud típica de las velocidades de los objetos en la simulación. Se utiliza para estimar si un contacto debe tratarse como un rebote o como un contacto estático en función de su velocidad de impacto, así como un umbral de energía cinética por debajo del cual la simulación puede poner los objetos en estado de reposo.

Para entornos físicos normales, una buena opción es la velocidad aproximada de un objeto que cae por gravedad durante un segundo. El valor por defecto es 1000.

Rango: [0, inf]

viewport : Node

Esta propiedad define la ventana gráfica en la que se dibujarán los componentes de depuración si se habilita la opción « forceDebugDraw ». Si no se establece, se utilizará el nodo « scene ».

Véase también « forceDebugDraw » y « scene ».

Documentación de señales

[since 6.5] frameDone(float timestep)

Esta señal se emite cuando la simulación física termina de simular un fotograma. El parámetro « timestep » indica la duración, en milisegundos, del paso de tiempo en la simulación.

Nota: El controlador correspondiente es onFrameDone.

Esta señal se introdujo en Qt 6.5.

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