PhysicsNode QML Type
물리 장면 내 모든 오브젝트의 기본 유형입니다. 더 보기...
| Import Statement: | import QtQuick3D.Physics |
| Since: | Qt 6.4 |
| Inherits: | |
| Inherited By: | CharacterController, DynamicRigidBody, PhysicsBody, StaticRigidBody, and TriggerBody |
속성
- collisionShapes : list<CollisionShape>
- filterGroup : int
- filterIgnoreGroups : int
- receiveContactReports : bool
- receiveTriggerReports : bool
- sendContactReports : bool
- sendTriggerReports : bool
신호
- bodyContact(PhysicsNode *body, list<vector3D> positions, list<vector3D> impulses, list<vector3D> normals)
- enteredTriggerBody(TriggerBody *body)
- exitedTriggerBody(TriggerBody *body)
상세 설명
PhysicsNode는 물리 시뮬레이션에 참여하는 모든 객체의 기본 유형입니다. 이러한 객체들은 3차원 공간 내의 위치와 기하학적 형태를 가지고 있습니다.
속성 설명
collisionShapes : list<CollisionShape>
이 속성에는 충돌 형상 목록이 포함되어 있습니다. 이 형상들은 결합되어 다른 물체와 상호 작용할 때 하나의 강체로 작동합니다.
Qt Quick 3D Physics 의 ‘도형, 리지드 바디 및 조인트’항목도 참조하십시오 .
filterGroup : int
이 속성은 이 본문이 어떤 필터 그룹에 속하는지를 결정합니다.
기본값은 0 입니다.
범위: [0, 31]
참조: PhysicsNode::filterIgnoreGroups.
filterIgnoreGroups : int
이 속성은 이 바디가 어떤 그룹과의 충돌을 걸러내야 하는지를 결정합니다.
참고: 이 숫자는 비트 마스크로 해석됩니다. 즉, 비트 i 가 설정되어 있으면 filterGroup 의 번호 i 와의 충돌이 필터링됩니다. 예를 들어, 그룹 1, 3 및 4 을 필터링하려면 값을 0b11010 로 설정하십시오.
PhysicsNode::filterGroup도 참조하십시오 .
receiveContactReports : bool
이 속성은 이 물체가 다른 물체와 충돌할 때 접촉 보고를 수신할지 여부를 결정합니다. 이 기능이 활성화되면, ‘ sendContactReports ’가 true로 설정된 물체와 충돌할 때 ‘ bodyContact ’ 신호가 발신됩니다.
기본값: false
receiveTriggerReports : bool
이 속성은 트리거 본문을 진입하거나 떠날 때 이 본문이 보고서를 수신할지 여부를 결정합니다.
기본값: false
sendContactReports : bool
이 속성은 이 물체가 다른 물체와 충돌할 때 접촉 보고서를 전송할지 여부를 결정합니다.
기본값: false
sendTriggerReports : bool
이 속성은 트리거 본문에 진입하거나 벗어날 때 이 본문이 보고서를 전송할지 여부를 결정합니다.
기본값: false
신호 문서
bodyContact(PhysicsNode *body, list<vector3D> positions, list<vector3D> impulses, list<vector3D> normals)
이 신호는 동적 물체와 다른 물체 간에 충돌이 발생할 때 발생합니다. 해당 물체의 ` receiveContactReports ` 속성과 충돌하는 물체의 ` sendContactReports ` 속성은 true로 설정되어야 합니다. ` body`, ` positions`, ` impulses `, ` normals ` 매개변수에는 각 접촉점에 대한 상대 물체, 위치, 충격력 및 법선 벡터가 동일한 인덱스 순서대로 포함됩니다.
참고: 해당 핸들러는 onBodyContact 입니다.
CharacterController::shapeHit, PhysicsWorld::reportKinematicKinematicCollisions 및 PhysicsWorld::reportStaticKinematicCollisions도 참조하십시오 .
enteredTriggerBody(TriggerBody *body)
이 바디가 지정된 트리거 body 에 진입하면 이 신호가 발생합니다.
참고: receiveTriggerReports 가 true
참고: onEnteredTriggerBody 인경우 에만 발생합니다.
receiveTriggerReports 및 exitedTriggerBody도 참조하십시오 .
exitedTriggerBody(TriggerBody *body)
이 바디가 지정된 트리거 body 를 벗어나면 이 신호가 발생합니다.
참고: receiveTriggerReports 가 true
참고: 해당 핸들러는 onExitedTriggerBody 입니다.
receiveTriggerReports 및 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.
