Version: 2023.2
언어: 한국어
Unity의 디버그 프레임
프레임 디버거 이벤트 계층 구조

Frame Debugger 창 레퍼런스

Frame Debugger 창은 Unity의 프레임 디버거에 대한 사용자 인터페이스입니다.Frame Debugger 창은 렌더링 이벤트 정보를 표시하고 구성 중인 프레임의 재생을 제어합니다.

Frame Debugger 창
Frame Debugger 창
Label 설명
활성화/비활성화:프레임 디버거를 활성화하거나 비활성화합니다.
타겟 선택자:프레임 디버거를 연결할 프로세스를 지정합니다.기본적으로 Unity 에디터이지만 이를 사용하여 프레임 디버거를 빌드된 애플리케이션에 연결할 수 있습니다.자세한 내용은 빌드된 프로젝트에 프레임 디버거 연결을 참조하십시오.
이벤트 스크러버:현재 프레임의 렌더링 이벤트를 선형적으로 이동하는 데 사용할 수 있는 슬라이더입니다.
이전 이벤트:현재 선택한 이벤트의 이전 이벤트를 선택합니다.
다음 이벤트:현재 선택한 이벤트의 다음 이벤트를 선택합니다.
이벤트 계층 구조:프레임을 구성하는 렌더링 이벤트의 순서를 나열합니다.자세한 내용은 이벤트 계층 구조를 참조하십시오.
이벤트 정보 패널:드로우 콜에 사용되는 셰이더 및 지오메트리 세부 정보와 같은 이벤트에 대한 정보를 표시합니다.자세한 내용은 이벤트 정보 패널을 참조하십시오.

프레임 디버깅

프레임 디버거를 사용하여 프레임을 디버깅하려면 다음을 수행하십시오.

  1. 프레임 디버거(메뉴:Window > Analysis > Frame Debugger)를 엽니다.
  2. 타겟 선택자를 사용하여 프레임 디버거에 연결할 프로세스를 선택합니다.Unity 에디터에서 프레임을 디버깅하려면 이를 Editor로 설정합니다.빌드된 애플리케이션에서 프레임을 디버깅하려는 경우 빌드된 프로젝트에 프레임 디버거 연결을 참조하십시오.
  3. Enable을 클립합니다.이렇게 하면 프레임 디버거가 프레임을 캡처합니다.프레임을 구성하는 드로우 콜 및 다른 이벤트로 이벤트 계층 구조를 채우고 게임 뷰에서 프레임을 렌더링합니다.
    참고:애플리케이션이 실행 중인 경우 프레임 디버거가 애플리케이션을 일시 중지합니다.
  4. 이벤트 계층 구조에서 이벤트를 선택하여 해당 이벤트를 비롯한 표시되는 씬을 확인합니다.이렇게 하면 이벤트 정보 패널에 있는 이벤트에 대한 정보도 표시됩니다.이전 이벤트 및 다음 이벤트 버튼, 화살표 키, 이벤트 스크러버를 사용하여 프레임을 선형으로 이동할 수 있습니다.Unity에서 디버깅하려는 지오메트리를 어떤 이벤트에서 렌더링하는지 모르는 경우 이러한 네비게이션 툴은 선형으로 이동하여 이벤트를 찾는 데 유용합니다.

드로우 콜 이벤트가 게임 오브젝트의 지오메트리에 해당하면 Unity는 계층 구조에서 해당 게임 오브젝트를 강조 표시합니다.

이벤트가 RenderTexture로 렌더링된 경우 Unity는 게임 뷰와 Frame Debugger 창에 해당 RenderTexture의 콘텐츠를 표시합니다.이는 다양한 오프스크린 렌더 타겟이 어떻게 빌드되는지 검사하는 데 유용합니다.예시:

디퍼드 렌더링 중에 디퓨즈 G 버퍼를 생성하기 위해 누적되는 이벤트 보기
디퍼드 렌더링 중에 디퓨즈 G 버퍼를 생성하기 위해 누적되는 이벤트 보기

빌드된 프로젝트에 프레임 디버거 연결

프레임 디버거의 타겟 프로세스를 변경하여 빌드된 Unity 플레이어에 프레임 디버거를 연결할 수 있습니다.프레임 디버거와 호환되려면 Unity 플레이어는 다음을 충족해야 합니다.

  • Development Build Build Setting을 사용합니다.
  • 멀티스레드 렌더링을 지원합니다. 웹을 제외한 모든 Unity 플랫폼은 이를 지원합니다.
  • 데스크톱 플랫폼의 경우 Run In Background 플레이어 설정을 사용합니다.그렇지 앟으면 Unity 에디터에서 Frame Debugger 창에 포커스를 맞출 때 Unity 플레이어가 포커스를 잃고 렌더링 변경 사항을 반영하지 않습니다.

Unity 플레이어가 위의 요구 조건을 충족하는 경우 다음 프레임 디버깅을 할 때 Unity 플레이어에 프레임 디버거를 연결할 수 있습니다.

Unity의 디버그 프레임
프레임 디버거 이벤트 계층 구조