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 de 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 al interactuar con otros cuerpos.

Véase también «Qt Quick: Formas, cuerpos y articulaciones en la física 3D».

filterGroup : int

Esta propiedad determina a qué grupo de filtros pertenece este cuerpo.

El valor por defecto es « 0 ».

Rango: [0, 31]

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 se activa el bit i, se filtrarán las colisiones con el número filterGroup i . Por ejemplo, para filtrar los grupos 1, 3 y 4, establezca el valor en 0b11010.

Véase también PhysicsNode::filterGroup.

receiveContactReports : bool

Esta propiedad determina si este cuerpo recibirá informes de contacto al chocar con otros cuerpos. Si está activada, significa que se emitirá la señal « bodyContact » al producirse una colisión con un cuerpo que tenga la propiedad « sendContactReports » establecida en «true».

Valor por defecto: false

receiveTriggerReports : bool

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

Valor por defecto: false

sendContactReports : bool

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

Valor por defecto: false

sendTriggerReports : bool

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

Valor predeterminado: false

Documentación sobre señales

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. Es necesario establecer en «true» los parámetros « receiveContactReports » de este cuerpo y « sendContactReports » del cuerpo con el que colisiona. 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 controlador correspondiente es onBodyContact.

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

enteredTriggerBody(TriggerBody *body)

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

Nota: Solo se emite cuando receiveTriggerReports es true

Nota: El controlador correspondiente es onEnteredTriggerBody.

Véase también receiveTriggerReports y exitedTriggerBody.

exitedTriggerBody(TriggerBody *body)

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

Nota: Solo se emite cuando receiveTriggerReports está true

Nota: El controlador 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.