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: | |
| Inherited By: | CharacterController, DynamicRigidBody, PhysicsBody, StaticRigidBody, and TriggerBody |
Propiedades
- collisionShapes : list<CollisionShape>
- filterGroup : int
- filterIgnoreGroups : int
- receiveContactReports : bool
- receiveTriggerReports : bool
- sendContactReports : bool
- sendTriggerReports : bool
Señales
- bodyContact(PhysicsNode *body, list<vector3D> positions, list<vector3D> impulses, list<vector3D> normals)
- enteredTriggerBody(TriggerBody *body)
- exitedTriggerBody(TriggerBody *body)
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.