En esta página

DynamicRigidBody QML Type

Un cuerpo físico que puede moverse o ser movido. Más...

Import Statement: import QtQuick3D.Physics
Since: Qt 6.4
Inherits:

PhysicsBody

Propiedades

Métodos

Descripción detallada

Este tipo define un cuerpo rígido dinámico: un objeto que forma parte de la escena física y se comporta como un objeto físico con masa y velocidad.

Nota: Las formas geométricas« triangle mesh» , « height field » y « plane » no están permitidas como formas de colisión cuando « isKinematic » es « false ».

Documentación de propiedades

angularAxisLock : AxisLock

Esta propiedad bloquea la velocidad angular del cuerpo a lo largo de los ejes definidos por la enumeración ` DynamicRigidBody.AxisLock`. Para bloquear varios ejes, basta con realizar una operación «OR» bit a bit entre sus valores de enumeración.

Opciones disponibles:

ConstanteDescripción
DynamicRigidBody.NoneSin bloqueo de ejes.
DynamicRigidBody.LockXBloquea el eje X.
DynamicRigidBody.LockYBloqueo del eje Y.
DynamicRigidBody.LockZBloquear el eje Z.

Valor por defecto: DynamicRigidBody.None

centerOfMassPosition : vector3d

Define la posición del centro de masa con respecto al cuerpo. Ten en cuenta que esto solo se utiliza cuando « massMode » está configurado en « DynamicRigidBody.MassAndInertiaTensor ».

Valor por defecto: (0, 0, 0)

Véase también « massMode » y « inertiaTensor ».

centerOfMassRotation : quaternion

Define la rotación de la posición del centro de masa; es decir, especifica la orientación de los ejes principales de inercia del cuerpo con respecto al propio cuerpo. Ten en cuenta que esto solo se utiliza cuando « massMode » está configurado en « DynamicRigidBody.MassAndInertiaTensor ».

Valor por defecto: (1, 0, 0, 0)

Véase también « massMode » y « inertiaTensor ».

density : real

Esta propiedad define la densidad del cuerpo. Solo se utiliza cuando la opción « massMode » está configurada en « DynamicRigidBody.CustomDensity ».

Valor por defecto: 0.001

Rango: (0, inf]

Véase también « massMode ».

gravityEnabled : bool

Esta propiedad define si el objeto se verá afectado por la gravedad o no.

Valor por defecto: true

inertiaMatrix : list<real>

Define la matriz del tensor de inercia. Se trata de una matriz de 3x3 en orden de columnas. Ten en cuenta que se espera que esta matriz sea diagonalizable. Ten en cuenta que solo se utiliza cuando « massMode » está establecido en « DynamicRigidBody.MassAndInertiaMatrix ».

Valor por defecto: una matriz identidad de 3x3

Véase también massMode y inertiaTensor.

inertiaTensor : vector3d

Define el vector del tensor de inercia, utilizando un parámetro especificado en coordenadas del espacio de masas.

Se trata del vector diagonal de una matriz diagonal de 3x3; si dispones de un tensor de inercia del espacio mundial/del actor que no sea diagonal, debes utilizar en su lugar inertiaMatrix.

Los componentes del tensor de inercia deben ser positivos; un valor de 0 en cualquier componente se interpreta como una inercia infinita a lo largo de ese eje. Ten en cuenta que esto solo se utiliza cuando massMode está establecido en DynamicRigidBody.MassAndInertiaTensor.

Valor por defecto: (1, 1, 1)

Véase también « massMode » y « inertiaMatrix ».

isKinematic : bool

Esta propiedad define si el objeto es cinemático o no. Un objeto cinemático no se ve afectado por fuerzas externas y puede considerarse como un objeto de masa infinita. Si se activa esta propiedad, en cada fotograma de la simulación el objeto físico se desplazará a su posición de destino, independientemente de las fuerzas externas. Ten en cuenta que, para mover y rotar el objeto cinemático, debes utilizar las propiedades « kinematicPosition », « kinematicRotation », « kinematicEulerRotation » y « kinematicPivot ».

Valor por defecto: false

Véase también kinematicPosition, kinematicRotation, kinematicEulerRotation y kinematicPivot.

isSleeping : bool [since 6.9]

Se establece en « true » si el cuerpo está en reposo. Aunque técnicamente es posible establecer esta propiedad, debe considerarse una propiedad de solo lectura que se establece en cada fotograma en el que se ejecuta la simulación física.

Esta propiedad se introdujo en Qt 6.9.

kinematicEulerRotation : vector3d [since 6.5]

Define la rotación de Euler del objeto cuando este se encuentra en modo cinemático, es decir, cuando la opción « isKinematic » está establecida en « true ». En cada iteración de la simulación, el objeto físico se actualizará según este valor.

Valor por defecto: (0, 0, 0)

Esta propiedad se introdujo en Qt 6.5.

Véase también « isKinematic », « kinematicPosition », «kinematicEulerRotation» y « kinematicPivot ».

kinematicPivot : vector3d [since 6.5]

Define el pivote del objeto cuando este es cinemático, es decir, cuando la opción « isKinematic » está configurada en « true ». En cada iteración de la simulación, el objeto físico se actualizará según este valor.

Valor por defecto: (0, 0, 0)

Esta propiedad se introdujo en Qt 6.5.

Véase también « isKinematic », « kinematicPosition », « kinematicEulerRotation » y « kinematicRotation ».

kinematicPosition : vector3d [since 6.5]

Define la posición del objeto cuando es cinemático, es decir, cuando la opción « isKinematic » está configurada en « true ». En cada iteración de la simulación, el objeto físico se actualizará según este valor.

Valor por defecto: (0, 0, 0)

Esta propiedad se introdujo en Qt 6.5.

Véase también « isKinematic », « kinematicRotation », « kinematicEulerRotation » y « kinematicPivot ».

kinematicRotation : quaternion [since 6.5]

Define la rotación del objeto cuando este es cinemático, es decir, cuando la opción « isKinematic » está configurada en « true ». En cada iteración de la simulación, el objeto físico se actualizará según este valor.

Valor por defecto: (1, 0, 0, 0)

Esta propiedad se introdujo en Qt 6.5.

Véase también « isKinematic », « kinematicPosition », « kinematicEulerRotation » y « kinematicPivot ».

linearAxisLock : AxisLock

Esta propiedad bloquea la velocidad lineal del cuerpo a lo largo de los ejes definidos por la enumeración ` DynamicRigidBody.AxisLock`. Para bloquear varios ejes, basta con realizar una operación OR bit a bit entre sus valores de enumeración.

Opciones disponibles:

ConstanteDescripción
DynamicRigidBody.NoneSin bloqueo de ejes.
DynamicRigidBody.LockXBloqueo del eje X.
DynamicRigidBody.LockYBloqueo del eje Y.
DynamicRigidBody.LockZBloquear el eje Z.

Valor por defecto: DynamicRigidBody.None

mass : real

Esta propiedad define la masa del cuerpo. Ten en cuenta que solo se utiliza cuando « massMode » no es « DynamicRigidBody.CustomDensity » ni « DynamicRigidBody.DefaultDensity ». Ten en cuenta también que un valor de 0 se interpreta como masa infinita y que no se admiten números negativos.

Valor por defecto: 1

Rango: [0, inf]

Véase también massMode.

massMode : MassMode

Esta propiedad contiene la enumeración que describe cómo se calculan la masa y la inercia de este cuerpo.

Opciones disponibles:

ConstanteDescripción
DynamicRigidBody.DefaultDensityUtiliza la densidad especificada en la propiedad « defaultDensity » de « PhysicsWorld » para calcular la masa y la inercia suponiendo una densidad uniforme.
DynamicRigidBody.CustomDensityUtiliza la densidad especificada en la propiedad « density » para calcular la masa y la inercia, suponiendo una densidad uniforme.
DynamicRigidBody.MassUtiliza la masa especificada para calcular la inercia suponiendo una densidad uniforme.
DynamicRigidBody.MassAndInertiaTensorUtiliza el valor de masa especificado y el tensor de inercia.
DynamicRigidBody.MassAndInertiaMatrixUtiliza el valor de masa especificado y calcula la inercia a partir de la matriz de inercia especificada.

Valor por defecto: DynamicRigidBody.DefaultDensity

Documentación del método

void applyCentralForce(vector3d force)

Aplica un « force » en el centro del cuerpo.

void applyCentralImpulse(vector3d impulse)

Aplica un « impulse » en el centro del cuerpo.

void applyForce(vector3d force, vector3d position)

Aplica un « force » en un « position » del cuerpo.

void applyImpulse(vector3d impulse, vector3d position)

Aplica un « impulse » en una « position » del cuerpo.

void applyTorque(vector3d torque)

Aplica un « torque » en el cuerpo.

void applyTorqueImpulse(vector3d impulse)

Aplica un par de torsión impulse sobre la carrocería.

void reset(vector3d position, vector3d eulerRotation)

Restablece los valores de position y eulerRotation del organismo.

void setAngularVelocity(vector3d angularVelocity)

Establece el valor de « angularVelocity » del cuerpo.

void setLinearVelocity(vector3d linearVelocity)

Establece el valor de « linearVelocity » del cuerpo.

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