PhysicsNode QML Type
Basistyp für alle Objekte in der Physikszene. Mehr...
| Import Statement: | import QtQuick3D.Physics |
| Since: | Qt 6.4 |
| Inherits: | |
| Inherited By: | CharacterController, DynamicRigidBody, PhysicsBody, StaticRigidBody, and TriggerBody |
Eigenschaften
- collisionShapes : list<CollisionShape>
- filterGroup : int
- filterIgnoreGroups : int
- receiveContactReports : bool
- receiveTriggerReports : bool
- sendContactReports : bool
- sendTriggerReports : bool
Signale
- bodyContact(PhysicsNode *body, list<vector3D> positions, list<vector3D> impulses, list<vector3D> normals)
- enteredTriggerBody(TriggerBody *body)
- exitedTriggerBody(TriggerBody *body)
Ausführliche Beschreibung
PhysicsNode ist der Basistyp für alle Objekte, die an der Physiksimulation beteiligt sind. Diese Objekte haben eine Position im dreidimensionalen Raum und eine geometrische Form.
Dokumentation der Eigenschaften
collisionShapes : list<CollisionShape>
Diese Eigenschaft enthält die Liste der Kollisionsformen. Diese Formen werden kombiniert und verhalten sich bei der Interaktion mit anderen Körpern wie ein einziger starrer Körper.
Siehe auch „Qt Quick 3D: Physikformen, Körper und Gelenke“.
filterGroup : int
Diese Eigenschaft legt fest, zu welcher Filtergruppe dieser Textkörper gehört.
Der Standardwert lautet „ 0 “.
Bereich: [0, 31]
Siehe auch „ PhysicsNode::filterIgnoreGroups “.
filterIgnoreGroups : int
Diese Eigenschaft legt fest, mit welchen Gruppen dieser Körper Kollisionen herausfiltern soll.
Hinweis: Diese Zahl wird als Bitmaske interpretiert. Das bedeutet: Ist das Bit i gesetzt, werden Kollisionen mit der filterGroup -Nummer i gefiltert. Um beispielsweise die Gruppen 1, 3 und 4 zu filtern, setzen Sie den Wert auf 0b11010.
Siehe auch PhysicsNode::filterGroup.
receiveContactReports : bool
Diese Eigenschaft legt fest, ob dieser Körper bei einer Kollision mit anderen Körpern Kontaktmeldungen empfängt. Ist diese Option aktiviert, wird bei einer Kollision mit einem Körper, bei dem „ sendContactReports “ auf „true“ gesetzt ist, das Signal „ bodyContact “ ausgesendet.
Standardwert: false
receiveTriggerReports : bool
Diese Eigenschaft legt fest, ob dieser Körper beim Ein- oder Austritt aus einem Triggerkörper Berichte erhält.
Standardwert: false
sendContactReports : bool
Diese Eigenschaft legt fest, ob dieser Körper bei einer Kollision mit anderen Körpern Kontaktberichte sendet.
Standardwert: false
sendTriggerReports : bool
Diese Eigenschaft legt fest, ob dieser Körper beim Betreten oder Verlassen eines Triggerkörpers Berichte sendet.
Standardwert: false
Signal-Dokumentation
bodyContact(PhysicsNode *body, list<vector3D> positions, list<vector3D> impulses, list<vector3D> normals)
Dieses Signal wird ausgelöst, wenn es zu einer Kollision zwischen einem dynamischen Körper und einem beliebigen anderen Körper kommt. Die Parameter „ receiveContactReports “ in diesem Körper und „ sendContactReports “ im kollidierenden Körper müssen auf „true“ gesetzt sein. Die Parameter „ body “, „ positions “, „ impulses “ und „ normals “ enthalten für jeden Kontaktpunkt mit demselben Index den anderen Körper, die Position, die Impulskraft und die Normale.
Hinweis: Der entsprechende Handler lautet „ onBodyContact “.
Siehe auch CharacterController::shapeHit, PhysicsWorld::reportKinematicKinematicCollisions und PhysicsWorld::reportStaticKinematicCollisions.
enteredTriggerBody(TriggerBody *body)
Dieses Signal wird ausgegeben, wenn dieses Objekt in die angegebene Trigger body eintritt.
Hinweis: Wirdnur ausgegeben, wenn receiveTriggerReports true
Hinweis: Der zugehörige Handler ist „ onEnteredTriggerBody “.
Siehe auch „ receiveTriggerReports “ und „ exitedTriggerBody “.
exitedTriggerBody(TriggerBody *body)
Dieses Signal wird ausgelöst, wenn dieses Objekt den angegebenen Trigger „ body “ verlässt.
Hinweis: Wirdnur ausgegeben, wenn „ receiveTriggerReports “ auf true
Hinweis: Der entsprechende Handler ist onExitedTriggerBody.
Siehe auch „ receiveTriggerReports “ und „ 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.
