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)
상세 설명
피직스노드는 물리 시뮬레이션에 참여하는 모든 오브젝트의 기본 유형입니다. 이러한 오브젝트는 3차원 공간에서의 위치와 기하학적 모양을 갖습니다.
프로퍼티 문서
collisionShapes : list<CollisionShape>
이 프로퍼티에는 콜리전 셰이프 목록이 들어 있습니다. 이러한 셰이프는 다른 바디와 상호작용할 때 결합되어 하나의 리지드 바디처럼 작동합니다.
셰이프 및 바디 개요 문서를참고하세요 .
filterGroup : int
이 속성은 이 본문이 어떤 필터 그룹에 속할지 결정합니다.
기본값은 0 입니다.
범위입니다: [0, 32]
PhysicsNode::filterIgnoreGroups 를참조하세요 .
filterIgnoreGroups : int
이 속성은 이 본문이 어떤 그룹과 충돌을 필터링할지 결정합니다.
참고: 이 숫자는 비트마스크로 해석되므로 비트 i 가 설정되어 있으면 filterGroup 번호 i 와의 충돌이 필터링됩니다. 예를 들어 1, 3 및 4 그룹을 필터링하려면 값을 0b11010 으로 설정합니다.
PhysicsNode::filterGroup도 참조하세요 .
receiveContactReports : bool
이 프로퍼티는 이 바디가 다른 바디와 충돌할 때 접촉 보고를 받을지 여부를 결정합니다. 활성화하면 sendContactReports 이 true로 설정된 바디와 충돌할 때 bodyContact 신호가 전송됩니다.
기본값입니다: false
receiveTriggerReports : bool
이 속성은 트리거 본문으로 들어가거나 나갈 때 이 본문이 보고서를 받을지 여부를 결정합니다.
기본값은 0입니다: false
sendContactReports : bool
이 프로퍼티는 이 바디가 다른 바디와 충돌할 때 접촉 보고서를 전송할지 여부를 결정합니다.
기본값입니다: false
sendTriggerReports : bool
이 속성은 트리거 본문으로 들어가거나 나올 때 이 본문이 보고서를 보낼지 여부를 결정합니다.
기본값입니다: false
신호 문서
bodyContact(PhysicsNode *body, list<vector3D> positions, list<vector3D> impulses, list<vector3D> normals)
이 신호는 동적 바디와 다른 바디 사이에 충돌이 있을 때 발생합니다. 이 바디의 receiveContactReports 와 충돌하는 바디의 sendContactReports 은 참으로 설정해야 합니다. 파라미터 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.
