En esta página

Qt Quick Física 3D: formas, cuerpos y articulaciones

Los objetos de la simulación se representan mediante cualquiera de los cuatro tipos de cuerpos siguientes: StaticRigidBody, DynamicRigidBody, CharacterController y TriggerBody. La forma física de un cuerpo se representa mediante subtipos de CollisionShape.

Formas

Una forma de colisión se utiliza para definir la forma física y la extensión de un objeto a efectos de la simulación física. La forma de colisión suele ser más simple que el aspecto visual del objeto.

Hay algunas formas predefinidas integradas en el motor: BoxShape, CapsuleShape, SphereShape y PlaneShape. El manejo de estas formas está optimizado, por lo que la simulación que las utilice suele ofrecer un mejor rendimiento.

Además, existen formas personalizadas que se definen mediante datos: ConvexMeshShape, HeightFieldShape y TriangleMeshShape. Estas ofrecen mayor flexibilidad, aunque a costa del rendimiento.

Cuerpos

Un body representa un objeto físico en la simulación. Estos cuerpos interactúan y chocan entre sí. Los dos tipos principales son los cuerpos estáticos (StaticRigidBody) y los cuerpos dinámicos (DynamicRigidBody). La forma física de un cuerpo se especifica mediante una lista de formas. La forma efectiva es la unión de estas formas. La posición relativa de las formas es fija: los cuerpos son rígidos.

Cuerpo dinámico

Los cuerpos dinámicos pueden moverse. La propiedad « isKinematic » determina cómo se mueven. Cuando « isKinematic » es « true », el cuerpo se posiciona explícitamente modificando las propiedades « kinematicPosition » y « kinematicRotation ». Cuando « isKinematic » es « false », el objeto es controlado por la simulación: caerá por la gravedad y rebotará contra otros objetos.

Cuando isKinematic es true, se permiten todas las formas. Sin embargo, los cuerpos no cinemáticos están más restringidos: solo se pueden utilizar formas convexas. Estas son las formas predefinidas: BoxShape, CapsuleShape y SphereShape; y la forma personalizada: ConvexMeshShape. Esto no significa que sea imposible tener una geometría física no convexa: se pueden combinar varias formas convexas para formar un único cuerpo. El ejemplo «Formas compuestas» muestra cómo crear cuerpos con forma de anillo a partir de formas convexas.

Cuerpo estático

Los cuerpos estáticos no se mueven. Representan el entorno en el que se mueven los demás cuerpos. Ten en cuenta que, técnicamente, es posible mover un cuerpo estático, pero la simulación física se comportará de forma inesperada. En concreto, un cuerpo dinámico que haya entrado en una posición de reposo sobre un cuerpo estático no se activará si el cuerpo estático se mueve. Esto significa que el cuerpo dinámico permanecerá en la misma posición aunque se mueva el cuerpo estático.

Controlador de personaje

El tipo « CharacterController » es un caso especial. Representa a un personaje que se mueve por el entorno. Un caso de uso típico es una vista en primera persona en la que el « camera » es un hijo del controlador de personaje, y su movimiento se controla mediante el teclado, el ratón o un mando.

Cuerpo de activación

También existe el tipo « TriggerBody », que constituye otro caso especial. A diferencia de los demás cuerpos, no es un cuerpo físico, lo que significa que no interactúa en colisión con otros cuerpos. Como su nombre indica, solo se utiliza para activar acciones cuando otro cuerpo entra o sale de su volumen, tal y como lo definen sus formas de colisión. Si otro cuerpo tiene el parámetro « sendTriggerReports » (Volumen de colisión) establecido en « true » (Volumen de colisión) y su volumen de colisión entra en un « TriggerBody » (Volumen de activación), se emite la señal « bodyEntered ».

La siguiente tabla muestra un resumen de los diferentes tipos de cuerpos, cómo interactúan y cómo se pueden utilizar:

CuerpoInteracciónFormas permitidas
StaticRigidBodyNo se mueveTodas las formas
DynamicRigidBody con isKinematic truePosicionado mediante programación. Influye en los cuerpos dinámicos. Nada lo detiene.Todas las formas
DynamicRigidBody con « isKinematic » falseTotalmente controladas por simulaciónFormas limitadas
CharacterControllerSe mueven mediante programación. Influyen en los cuerpos dinámicos. Se ven detenidos por los cuerpos estáticos.Solo una única CapsuleShape
TriggerBodyNingunaTodas las formas

Física y materiales

El tipo « PhysicsMaterial » especifica cómo se comporta un objeto cuando choca con otro. Las propiedades « dynamicFriction » y « staticFriction » determinan el grado de deslizamiento del objeto, y « restitution » determina su rebote.

Articulaciones

Una articulación restringe el movimiento de dos cuerpos entre sí. Una articulación puede utilizarse, por ejemplo, para emular la bisagra de una puerta, una cuerda o un brazo. Se admiten varios tipos de articulaciones para distintos casos de uso; consulta DistanceJoint, FixedJoint, PrismaticJoint, RevoluteJoint y SphericalJoint. Cada articulación se basa en el tipo QML Joint y cuenta con dos cuerpos a los que se conecta, así como una orientación que describe su ubicación en cada uno de ellos. Cada tipo de articulación tendrá diferentes propiedades que rigen sus restricciones físicas específicas.

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