기술 자료

Unity 엔진

Unity 엔진

물리 디버그 창 레퍼런스

물리 디버그 창을 사용하여 씬에서 3D 물리 활동의 시각적 표현을 구성하고 생성합니다.
읽는 시간 9분최근 업데이트: 9일 전

물리 디버그 창을 사용하여 씬에서 3D 물리 활동의 시각적 표현을 구성하고 생성합니다. 이러한 시각화는 씬 뷰에 나타납니다.
Unity 에디터에서 물리 디버그 창을 열려면 창 > 분석 > 물리 디버거로 이동합니다.
물리 디버거는 씬 뷰에 물리 디버그 패널을 삽입하고 다음 탭이 포함된 물리 디버그 창을 엽니다.
  • Info: 리지드바디 및 관절 바디 정보를 트래킹합니다. 중앙 질량 및 관성 텐서 시각화도 여기에서 확인할 수 있습니다.
  • 필터링: 표시할 물리 오브젝트를 결정합니다.
  • 렌더링: Unity 물리 시각화를 렌더링하고 표시하는 방식을 정의하는 설정입니다.
  • 연락처 접촉을 시각화할지 여부를 선택합니다.
  • 쿼리 쿼리를 시각화할지 여부를 선택합니다.
물리 디버그 창을 기본 설정으로 되돌리려면 Reset을 선택합니다.
프로젝트의 물리 성능 개선에 대한 자세한 내용은 물리 프로파일러 기술 자료를 참조하십시오.

물리 디버그 패널

Unity Physics Debug 창이 열리면 씬 뷰에 Physics Debug 패널이 나타납니다. 기본적으로 씬 뷰의 오른쪽 하단 모서리에 표시되지만 클릭 수 드래그하여 이동할 수 있습니다.

프로퍼티

설명

충돌 지오메트리씬 뷰에서 충돌 정보를 시각화하려면 충돌 지오메트리(Collision Geometry)를 활성화합니다. 씬 뷰에서 충돌 정보를 숨기려면 충돌 지오메트리(Collision Geometry)를 비활성화합니다.
마우스 선택마우스 오버 하이라이트 및 마우스 선택을 활성화하려면 마우스 선택을 활성화합니다. 이는 시각화에서 서로를 방해하는 큰 GameObjects 오브젝트가 있는 경우에 유용합니다.

Info

정보 탭에는 선택한 Rigidbody 또는 ArticulationBody 게임 오브젝트에 대한 데이터가 포함되어 있습니다. 이 데이터를 사용하여 물리 바디의 동작을 모니터링할 수 있습니다. 이 탭에서 프로퍼티 값은 편집할 수 없습니다. 스크립트를 통해 수정할 수 있지만 권장하지 않습니다. 대부분의 경우 물리 시스템을 통해 힘을 가하여 값을 변경해야 합니다.
특정 게임 오브젝트를 정보 탭에 영구적으로 도킹하려면 해당 게임 오브젝트에 대해 잠금을 활성화합니다. 무한한 수의 GameObjects 오브젝트를 잠글 수 있습니다. 행당 항목 수 속성을 사용하여 가장 쉽게 탐색할 수 있는 방법으로 정보 탭을 정렬합니다.
Info 탭에는 항상 다음 프로퍼티가 표시됩니다.

프로퍼티

설명

행당 항목 수정보 탭의 상단 행에 수평으로 표시할 선택된 GameObjects 수를 정의합니다.

기본적으로 여러 개의 GameObjects 오브젝트를 선택하거나 잠그면 Unity 모든 오브젝트를 수직으로 표시합니다. 하지만 대신 수평으로 배열할 수 있습니다. 한 수평 행에서 나란히 표시할 게임 오브젝트 수를 정의하려면 행당 항목 수를 사용합니다(최대 10개).

선택하거나 잠긴 GameObjects 수가 이 수를 초과하면 가장 최근에 선택된 GameObjects 첫 번째 게임 오브젝트 아래에 새 행에 나타납니다.

GameObjects는 항상 선택 순서대로 정보 탭에 표시됩니다. 이 프로퍼티의 기본값은 1입니다.
추적된 객체현재 정보 탭에 표시되는 고유 GameObjects의 총 수를 표시합니다. 여기에는 선택된 GameObjects 잠긴 GameObjects 포함됩니다. 복제본은 포함되지 않습니다.
잠긴 객체 지우기모든 GameObjects에 대해 Lock을 비활성화하려면 Clear locked objects를 선택합니다. 계층 창에서 아직 선택되지 않은 모든 GameObjects가 정보 탭에서 제거됩니다.
정보 탭에는 물리 바디(즉, 리지드바디 또는 관절 바디)가 있는 계층 구조에서 게임 오브젝트를 선택할 때 다음 프로퍼티가 표시됩니다.

프로퍼티

설명

GameObject다음 프로퍼티가 참조하는 선택 또는 잠긴 게임 오브젝트의 이름을 표시합니다.
그리우기 기즈모물리 디버그가 기즈모 표시할 물리 프로퍼티를 선택합니다.
- Center of Mass물리 바디의 글로벌 질량 중심 위치를 나타내는 기즈모를 표시합니다(월드 질량 센터 참조).
- Inertia Tensor물리 바디의 관성 텐서의 회전과 스케일을 나타내는 기즈모를 표시합니다(관성 텐서 참조).
lock계층 창에서 게임 오브젝트를 선택하지 않은 경우에도 게임 오브젝트를 정보 탭에 유지하려면 잠금을 활성화합니다.
속도물리 바디가 움직이는 속도이며, 초당 미터(m/s) 단위로 측정됩니다.
속도각 벡터를 따라 물리 바디의 속도이며, 초당 미터(m/s)로 측정됩니다.
각속도각 벡터를 따라 물리 바디의 속도이며, 초당 도 단위로 측정됩니다.
Inertia Tensor이 물리 바디의 관성 텐서입니다. 질량과 마찬가지로 관성 텐서는 물리 바디가 움직이기 위해 필요한 힘 또는 토크의 양을 정의합니다. 하지만 질량은 선형 움직임에 영향을 주지만 관성 텐서는 회전 움직임에 영향을 줍니다. Inertia Tensor 값이 높을수록 물리 바디가 축에서 회전하려면 더 많은 토크가 필요합니다.
역력 텐서 회전관성 텐서의 회전입니다. 기본적으로 Unity 물리 바디에 연결된 모든 콜라이더를 기반으로 관성 텐서 회전을 자동으로 계산합니다.
현지 대중 센터각 벡터를 따라 물리 바디의 질량 중심의 로컬 위치입니다. 스크립트를 통해 질량 중심을 변경하려면
centerOfMass
를 사용합니다. Unity 콜라이더 배치에 따라 이를 변경할 수도 있습니다.
세계 질량 센터각 벡터를 따라 물리 바디의 질량 중심의 전역 위치입니다. 스크립트를 통해 질량 중심을 변경하려면
worldCenterOfMass
를 사용합니다. Unity 콜라이더 배치에 따라 이를 변경할 수도 있습니다.
휴면 상태물리 바디의 잠자기 상태입니다. 물리 바디가 깨어있고 물리 계산에 포함된 경우 Awake을 표시합니다. 물리 바디가 휴면 상태인 경우 **휴면(Asleep)**을 표시하고 물리 계산에 포함되지 않습니다.
휴면 임계값물리 바디의 에너지 임계값으로, 물리 엔진 물리 업데이트에 바디를 포함시키는 것을 멈춥니다. 기본적으로 이 값은 전역 물리 설정에 정의된 휴면 임계값입니다.
최대 선형 속도물리 바디가 도달할 수 있는 최대 선형 속도이며,
maxLinearVelocity
로 정의됩니다.
최대 각속도물리 바디가 도달할 수 있는 최대 회전 속도이며,
maxAngularVelocity
로 정의됩니다.
솔버의 반복 횟수물리 시스템 솔버가 이 물리 바디에서 수행해야 하는 반복 횟수입니다.
솔버 속도 반복물리 시스템 솔버가 이 물리 바디에서 수행해야 하는 속도 반복 횟수입니다. 겹치는 GameObjects 종료 속도를 접촉 바운스(bounciness)를 고려하여 올바른 값에 가깝게 만듭니다.
Body Index트리의 관절 바디 인덱스입니다. 이 프로퍼티는 Articulation Bodies에만 표시됩니다.

필터링:

필터링 탭에는 물리 디버그 시각화에 표시되는 물리 요소를 구성하는 프로퍼티가 포함되어 있습니다.

프로퍼티

설명

물리 씬 표시한 번에 로드된 여러 물리 씬이 있는 경우 시각화에 포함할 물리 씬을 선택합니다.
Unity 씬 표시한 번에 로드된 여러 씬이 있는 경우 시각화에 포함할 Unity 씬을 선택합니다.
레이어 표시시각화에 표시할 레이어를 선택합니다.
정적 콜라이더 표시Rigidbody 컴포넌트가 없는 콜라이더에 대한 시각화를 표시하려면 Show Static Colliders를 활성화합니다. Rigidbody 컴포넌트가 없는 콜라이더에 대한 시각화를 제거하려면 Show Static Colliders를 비활성화합니다.
트리거 표시트리거인 콜라이더에 대한 시각화를 표시하려면 Show Triggers를 활성화합니다. 트리거인 콜라이더에 대한 시각화를 제거하려면 Show Triggers를 비활성화합니다.
리지드바디 표시Rigidbody 컴포넌트에 대한 시각화를 표시하려면 Show Rigidbodies를 활성화합니다. Rigidbody 컴포넌트에 대한 시각화를 제거하려면 Show Rigidbodies를 비활성화합니다.
키네마틱 바디 표시키네마틱 리지드바디 컴포넌트가 있는 콜라이더에 대한 시각화를 표시하려면 Show Kinematic Bodies를 활성화합니다. 키네마틱 리지드바디 컴포넌트가 있는 콜라이더에 대한 시각화를 제거하려면 Show Kinematic Bodies를 비활성화합니다.
관절 바디 표시Show Articulation Bodies를 활성화하여 ArticulationBody 컴포넌트에 대한 시각화를 표시합니다. ArticulationBody 컴포넌트에 대한 시각화를 제거하려면 Show Articulation Bodies를 비활성화합니다.
휴면 바디 표시Sleeping Rigidbody 컴포넌트가 있는 콜라이더에 대한 시각화를 표시하려면 Show Sleeping Bodies를 활성화합니다. Sleeping Rigidbody 컴포넌트가 있는 콜라이더에 대한 시각화를 제거하려면 Show Sleeping Bodies를 비활성화합니다.
콜라이더 유형다음 옵션을 사용하여 특정 콜라이더 타입을 물리 시각화에 표시합니다.
- BoxColliders 표시박스 콜라이더에 대한 시각화를 표시하려면 Show BoxColliders를 활성화합니다. 박스 콜라이더에 대한 시각화를 제거하려면 Show BoxColliders를 비활성화합니다.
- SphereColliders 표시스피어 콜라이더에 대한 시각화를 표시하려면 SphereColliders 표시를 활성화합니다. 구체 콜라이더에 대한 시각화를 제거하려면 Show SphereColliders를 비활성화합니다.
- CapsuleColliders 표시캡슐 콜라이더에 대한 시각화를 표시하려면 Show CapsuleColliders를 활성화합니다. 캡슐 콜라이더에 대한 시각화를 제거하려면 Show CapsuleColliders를 비활성화합니다.
- MeshColliders 표시(볼록)Is Convex 프로퍼티가 활성화된 메시 콜라이더에 대한 시각화를 표시하려면 **Show MeshColliders (convex)**를 활성화합니다. **Show MeshColliders (convex)**를 비활성화하여 Is Convex 프로퍼티가 활성화된 메시 콜라이더에 대한 시각화를 제거합니다.
- MeshColliders 표시(원뿔)Is Convex 프로퍼티가 비활성화된 메시 콜라이더에 대한 시각화를 표시하려면 **Show MeshColliders (concave)**를 활성화합니다. **Show MeshColliders (concave)**를 비활성화하여 Is Convex 프로퍼티가 비활성화된 메시 콜라이더에 대한 시각화를 제거합니다.
- TerrainColliders 표시터레인 콜라이더에 대한 시각화를 표시하려면 Show TerrainColliders를 활성화합니다. 터레인 콜라이더에 대한 시각화를 제거하려면 Show TerrainColliders를 비활성화합니다.
- 표시 없음모든 필터링 기준을 지우고 시각화에서 모든 콜라이더를 제거하려면 Show None을 선택합니다.
- 모두 표시모든 필터를 활성화하고 모든 콜라이더에 대한 시각화를 표시하려면 Show All을 선택합니다.

렌더링

렌더링 탭에는 Unity가 물리 시각화를 렌더링하고 표시하는 방식을 구성하는 프로퍼티가 포함되어 있습니다.

프로퍼티

설명

정적 콜라이더시각화에서 정적 콜라이더(Rigidbody 컴포넌트가 없는 콜라이더)를 나타내는 컬러를 선택합니다.
Triggers시각화에서 트리거이기도 하는 콜라이더를 나타내는 컬러를 선택합니다.
리지드바디시각화에서 Rigidbody 컴포넌트를 나타내는 컬러를 선택합니다.
키네마틱 바디시각화에서 키네마틱 리지드바디 컴포넌트를 나타내는 컬러를 선택합니다. 물리 시스템은 키네마틱 리지드바디 컴포넌트를 제어하지 않습니다.
관절 바디시각화에서 Articulation Body 컴포넌트를 나타내는 컬러를 선택합니다.
휴면 몸체시각화에서 (현재 물리 엔진 상호작용하지 않는) Sleeping Rigidbody 컴포넌트를 나타내는 컬러를 선택합니다.
배리에이션선택한 컬러가 무작위 컬러와 블렌딩되는 정도를 정의합니다. 이를 사용하여 컬러별로 콜라이더를 시각적으로 구분하고 GameObjects 오브젝트의 구조를 확인합니다. 값은 0과 1 사이이며, 기본값은 0.15입니다.
투명성시각화에서 그려진 충돌 지오메트리의 투명성 설정합니다. 값은 0과 1 사이이며 기본값은 0.5입니다.
포스 오버드로우시각화에서 렌더 지오메트리 위에 콜라이더 지오메트리를 표시하려면 Force Overdraw를 활성화합니다. 이는 렌더 지오메트리가 콜라이더 시각화를 가리는 경우에 유용합니다. 카메라에 대한 콜라이더 지오메트리를 표시하려면 Force Overdraw를 비활성화합니다.
거리 보기시각화의 뷰 거리를 설정합니다. 기본값은 1000입니다. 값은 단위로 측정되며, Unity 기본적으로 1m이라고 간주됩니다.
터레인 타일 최대시각화에서 최대 터레인 타일 수를 설정합니다. 기본값은 60입니다.
기즈모 설정정보 탭이 제어하는 물리 디버그 기즈모를 구성합니다.
- 일정 화면 크기물리 디버그 기즈모가 카메라로부터의 모든 거리에서 화면에 동일한 크기로 표시되도록 하려면 Constant screen size를 활성화합니다. 기즈모의 크기를 원근에 맞게 확대/축소하려면 Constant screen size를 비활성화합니다.
- Inertia Tensor 스케일관성 텐서 벡터 3에 곱할 값을 정의합니다. 이는 관성 텐서가 특히 크면 유용합니다. 예를 들어 벡터 컴포넌트의 비율을 시각화하고 관찰해야 하는 경우가 있습니다.

접촉

Contacts 탭에는 물리 디버그 시각화에 표시되는 컨택트 데이터와 다양한 컨택트 유형에 사용되는 컬러를 구성하는 프로퍼티가 포함되어 있습니다.

프로퍼티

설명

문의 표시접촉 시각화를 표시하려면 Show Contacts를 활성화합니다.
- 모든 연락처 표시물리 디버그 시각화에서 모든 충돌 접촉 데이터에 대한 시각화를 표시하려면 Show All Contacts를 활성화합니다. 물리 디버그 시각화에 표시되는 연락처 데이터를 제한하려면 모든 연락처 표시를 비활성화합니다.
모든 컨택트 표시가 비활성화되면 다음 컨택트만 시각화에 나타납니다.
-
OnCollisionEnter
,
OnCollisionSay
또는
OnCollisionExit
에서 메시지를 수신하는
MonoBehaviour
스크립트가 있는 콜라이더
-
providesContact
프로퍼티가 true로 설정된 콜라이더
- 임펄스 표시접점 임펄스를 나타내는 화살표를 시각화에 표시하려면 Show Impulse를 활성화합니다. 임펄스 시각화를 제거하려면 Show Impulse를 비활성화합니다.
- 분리 표시접점 분리를 나타내는 시각화에서 세그먼트와 디스크를 표시하려면 Show Separation을 활성화합니다. 분리 시각화를 제거하려면 Show Separation을 비활성화합니다.
- 필터링 설정 사용Filtering 탭의 설정을 사용하여 수신되는 컨택트 시각화를 필터링하려면 Use Filtering settings를 활성화합니다. Contacts 탭의 설정만 사용하려면 Use filtering settings를 비활성화합니다.
컨택트 색상Unity 시각화에서 충돌 접촉 데이터를 나타내기 위해 사용할 컬러를 선택합니다.
다양한 색상 사용각 접촉하는 콜라이더 페어에 무작위 컬러를 사용하려면 다양한 컬러 사용을 활성화합니다. 다음 프로퍼티(컨택트 컬러, 컨택트 분리 컬러, 컨택트 임펄스 컬러)에 정의된 세 가지 컬러를 사용하려면 다양한 컬러 사용을 비활성화합니다.
연락처 색상접촉을 나타내는 컬러를 선택합니다. 이는 시각화에서 접점에서 시작하여 접점 노멀을 향하는 화살표로 표시됩니다.
컨택트 분리 색상컨택트 분리를 나타내는 컬러를 선택합니다. 시각화에서 세그먼트와 디스크로 표시됩니다.
컨택트 임펄스 색상컨택트 임펄스를 나타내는 컬러를 선택합니다. 이는 시각화에서 노멀 방향을 가리키는 화살표로 표시되며, 길이는 임펄스의 길이와 같습니다.

쿼리

쿼리 탭에는 물리 디버그 시각화에 표시되는 쿼리 타입과 표시 방법을 구성하는 프로퍼티가 포함되어 있습니다. PhysX 쿼리에 대한 자세한 내용은 씬 쿼리 및 지오메트리 쿼리에 대한 NVIDIA PhysX 기술 자료를 참조하십시오.

프로퍼티

설명

쿼리 표시물리 쿼리에 대한 시각화를 표시하려면 Show queries를 활성화합니다.
쿼리 컬러Unity 물리 쿼리를 나타내기 위해 시각화에서 사용할 컬러를 선택합니다.
모양 표시물리 디버그 시각화에 표시할 쿼리 모양을 선택합니다. 쿼리 모양을 활성화하여 해당 모양의 쿼리를 시각화에 표시합니다. 쿼리 모양을 비활성화하여 해당 모양의 쿼리를 시각화에서 제거합니다.

옵션은 다음과 같습니다.
- 박스 모양 쿼리
- 캡슐 모양 쿼리
- 콜라이더 모양 쿼리
- 레이트 셰이프 쿼리
타입 표시시각화에 표시할 쿼리 타입을 선택합니다. 쿼리 타입을 활성화하여 시각화에 해당 타입의 쿼리를 표시합니다. 쿼리 유형을 비활성화하여 해당 유형의 쿼리를 시각화에서 제거합니다. PhysX 쿼리 유형에 대한 자세한 내용은 지오메트리 쿼리에 대한 NVIDIA PhysX 기술 자료를 참조하십시오.

옵션은 다음과 같습니다.
- 쿼리 오버랩
- 쿼리 검사
- 캐스트 쿼리
최대 쿼리물리 디버그가 한 번에 시각화할 수 있는 최대 쿼리 수를 정의합니다. 기본값은 100입니다.
표시 없음모든 필터링 기준을 지우고 모든 쿼리 모양 및 타입을 시각화에서 숨기려면 Show None을 선택합니다.
모두 표시모든 필터를 활성화하고 시각화에 모든 쿼리 모양과 타입을 표시하려면 Show All을 선택합니다.