En esta página

PhysicsNode QML Type

Tipo base para todos los objetos de la escena física. Más...

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

Node

Inherited By:

CharacterController, DynamicRigidBody, PhysicsBody, StaticRigidBody, and TriggerBody

Propiedades

Señales

Descripción detallada

PhysicsNode es el tipo base para todos los objetos que participan en la simulación física. Estos objetos tienen una posición en el espacio tridimensional y una forma geométrica.

Documentación de propiedades

collisionShapes : list<CollisionShape>

Esta propiedad contiene la lista de formas de colisión. Estas formas se combinarán y actuarán como un único cuerpo rígido cuando interactúen con otros cuerpos.

Ver también la documentación general de Formas y Cuerpos.

filterGroup : int

Esta propiedad determina de qué grupo de filtros forma parte este cuerpo.

El valor por defecto es 0.

Rango: [0, 32]

Véase también PhysicsNode::filterIgnoreGroups.

filterIgnoreGroups : int

Esta propiedad determina con qué grupos debe filtrar las colisiones este cuerpo.

Nota: Este número se interpreta como una máscara de bits, lo que significa que si el bit i está establecido, se filtrarán las colisiones con filterGroup número i. Por ejemplo, para filtrar los grupos 1, 3 y 4 entonces establece el valor en 0b11010.

Véase también PhysicsNode::filterGroup.

receiveContactReports : bool

Esta propiedad determina si este cuerpo recibirá informes de contacto al colisionar con otros cuerpos. Si está activada, significa que se emitirá la señal bodyContact al colisionar con un cuerpo que tenga sendContactReports establecido en true.

Valor por defecto: false

receiveTriggerReports : bool

Esta propiedad determina si este cuerpo recibirá informes al entrar o salir de un cuerpo de disparo.

Valor por defecto: false

sendContactReports : bool

Esta propiedad determina si este cuerpo enviará informes de contacto al colisionar con otros cuerpos.

Valor por defecto: false

sendTriggerReports : bool

Esta propiedad determina si este cuerpo enviará informes al entrar o salir de un cuerpo de disparo.

Valor por defecto: false

Señal Documentación

bodyContact(PhysicsNode *body, list<vector3D> positions, list<vector3D> impulses, list<vector3D> normals)

Esta señal se emite cuando se produce una colisión entre un cuerpo dinámico y cualquier otro cuerpo. Los parámetros receiveContactReports en este cuerpo y sendContactReports en el cuerpo que colisiona deben tener el valor true. Los parámetros body, positions, impulses y normals contienen el otro cuerpo, la posición, la fuerza de impulso y la normal para cada punto de contacto en el mismo índice.

Nota: El manejador correspondiente es onBodyContact.

Véase también CharacterController::shapeHit, PhysicsWorld::reportKinematicKinematicCollisions, y PhysicsWorld::reportStaticKinematicCollisions.

enteredTriggerBody(TriggerBody *body)

Esta señal se emite cuando este cuerpo entra en el disparador especificado body.

Nota: Sólo se emite cuando receiveTriggerReports es true

Nota: El manejador correspondiente es onEnteredTriggerBody.

Véase también receiveTriggerReports y exitedTriggerBody.

exitedTriggerBody(TriggerBody *body)

Esta señal se emite cuando este cuerpo sale del disparador especificado body.

Nota: Sólo se emite cuando receiveTriggerReports es true

Nota: El manejador correspondiente es onExitedTriggerBody.

Véase también receiveTriggerReports y enteredTriggerBody.

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