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: |
Propiedades
- angularAxisLock : AxisLock
- centerOfMassPosition : vector3d
- centerOfMassRotation : quaternion
- density : real
- gravityEnabled : bool
- inertiaMatrix : list<real>
- inertiaTensor : vector3d
- isKinematic : bool
- isSleeping : bool
(since 6.9) - kinematicEulerRotation : vector3d
(since 6.5) - kinematicPivot : vector3d
(since 6.5) - kinematicPosition : vector3d
(since 6.5) - kinematicRotation : quaternion
(since 6.5) - linearAxisLock : AxisLock
- mass : real
- massMode : MassMode
Métodos
- void applyCentralForce(vector3d force)
- void applyCentralImpulse(vector3d impulse)
- void applyForce(vector3d force, vector3d position)
- void applyImpulse(vector3d impulse, vector3d position)
- void applyTorque(vector3d torque)
- void applyTorqueImpulse(vector3d impulse)
- void reset(vector3d position, vector3d eulerRotation)
- void setAngularVelocity(vector3d angularVelocity)
- void setLinearVelocity(vector3d linearVelocity)
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:
| Constante | Descripción |
|---|---|
DynamicRigidBody.None | Sin bloqueo de ejes. |
DynamicRigidBody.LockX | Bloquea el eje X. |
DynamicRigidBody.LockY | Bloqueo del eje Y. |
DynamicRigidBody.LockZ | Bloquear 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:
| Constante | Descripción |
|---|---|
DynamicRigidBody.None | Sin bloqueo de ejes. |
DynamicRigidBody.LockX | Bloqueo del eje X. |
DynamicRigidBody.LockY | Bloqueo del eje Y. |
DynamicRigidBody.LockZ | Bloquear 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:
| Constante | Descripción |
|---|---|
DynamicRigidBody.DefaultDensity | Utiliza la densidad especificada en la propiedad « defaultDensity » de « PhysicsWorld » para calcular la masa y la inercia suponiendo una densidad uniforme. |
DynamicRigidBody.CustomDensity | Utiliza la densidad especificada en la propiedad « density » para calcular la masa y la inercia, suponiendo una densidad uniforme. |
DynamicRigidBody.Mass | Utiliza la masa especificada para calcular la inercia suponiendo una densidad uniforme. |
DynamicRigidBody.MassAndInertiaTensor | Utiliza el valor de masa especificado y el tensor de inercia. |
DynamicRigidBody.MassAndInertiaMatrix | Utiliza 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.