기술 자료

Unity 엔진

Unity 엔진

RenderDoc 통합

RenderDoc 디버거를 사용하여 프레임별로 그래픽스를 디버깅합니다.
읽는 시간 2분최근 업데이트: 9일 전

에디터는 RenderDoc 그래픽스 디버거의 통합 실행 및 캡처를 지원하여 상세한 프레임 인트로스펙션 및 디버깅을 지원합니다.
통합은 RenderDoc 버전 0.26 이상에서만 지원되므로 이전 버전이 현재 설치되어 있는 경우 최소 버전 0.26로 업데이트해야 합니다.
참고
통합은 에디터에서만 사용할 수 있지만 스탠드얼론 플레이어 빌드에서 추가 설정 없이 일반적으로 RenderDoc을 사용할 수 있습니다.
참고
프레임은 Unity RenderDoc이 지원하는 플랫폼과 API 실행 중인 경우에만 캡처할 수 있습니다. 다른 API 사용 중인 경우 지원되는 API 활성화될 때까지 RenderDoc 통합이 일시적으로 비활성화됩니다. 지원되는 플랫폼 및 API에 대한 자세한 내용은 RenderDoc 문서를 참조하십시오.

RenderDoc 로딩 중

RenderDoc 설치가 감지되면 에디터를 로드한 후 언제든지 게임 뷰 또는 씬 뷰 탭을 오른쪽 클릭하여 'RenderDoc 로드' 옵션을 클릭할 수 있습니다. 이렇게 하면 그래픽스 디바이스가 다시 로드되므로 변경 사항을 저장해야 하지만, 이후에는 에디터를 재시작하거나 스탠드얼론 플레이어를 빌드할 필요 없이 RenderDoc을 캡처할 수 있습니다.
참고
일반적으로 RenderDoc을 통해 에디터를 실행하거나 -load-renderdoc 커맨드 라인 옵션을 통해 시작 시 RenderDoc을 로드할 수도 있습니다.

RenderDoc으로 프레임 캡처

에디터에 로드된 RenderDoc 호환 버전이 감지되면 게임 및 씬 뷰의 툴바 오른쪽에 새 버튼이 나타납니다.

Capturing a frame with RenderDoc

이 버튼을 누르면 뷰의 다음 렌더링 프레임 캡처가 트리거됩니다. RenderDoc 툴 UI가 열리지 않은 경우 캡처를 보여주는 새 인스턴스가 실행되고, 이미 실행 중인 경우 최신 캡처가 자동으로 표시됩니다. 여기에서 캡처를 열고 툴을 사용하여 디버그할 수 있습니다.

List of frame captures in RenderDoc

셰이더 디버그 정보 포함

기본적으로 DirectX11 셰이더의 크기를 최적화하기 위해 디버깅 정보가 제거됩니다. 즉, 상수 및 리소스에는 이름이 없으며 셰이더 소스를 사용할 수 없습니다. 이 디버깅 정보를 셰이더에 포함하려면 셰이더의
HLSLPROGRAM
블록에 # pragma enable_d3d11_debug_symbols를 포함합니다.

대체 그래픽스 디버깅 기법

D3D11을 사용하여 스탠드얼론 플레이어를 빌드하는 경우 Visual Studio 그래픽스 디버거를 사용하여 프레임을 캡처하고 디버그할 수 있습니다.

RenderDoc에서 Android SDK 설정

RenderDoc을 사용하여 Android 애플리케이션을 개발하는 경우 다음 방법 중 하나를 사용하여 Android SDK 올바르게 설정해야 합니다.

Unity 동일한 SDK를 사용하도록 RenderDoc 설정(권장)

  1. RenderDoc 창에서 도구 > 설정 > Android로 이동합니다.
  2. Android SDK 루트 경로 아래에 Unity가 Android SDK에 사용하는 경로를 입력합니다. Unity 에디터의 Edit > Preferences > Android SDK Tools Installed with Unity에서 이 경로를 찾을 수 있습니다.

RenderDoc과 Unity 간 ADB 버전 및 경로 정리

RenderDoc 설정에서 Android SDK 루트 경로가 설정되지 않은 경우 RenderDoc은
PATH
환경 변수에서 ADB에 설정된 경로를 사용합니다.
  1. PATH
    변수에서 설정된 ADB 경로를 찾습니다.
    • Windows PowerShell:
      Get-Command adb | Select-Object Path
    • Windows 명령 프롬프트:
      where adb
  2. Windows 터미널에서 ADB 버전을 확인하십시오.
    C:\[adb path from command output]\adb.exe version
    .
  3. Unity 사용하는 ADB 경로를 찾습니다. Unity 에디터에서 Edit > Preferences > Android SDK Tools Installed with Unity로 이동합니다.
  4. Windows 터미널에서 해당 ADB 버전을 확인합니다.
    C:\[path to Android sdk platform-tools]\adb.exe version
    .
  5. RenderDoc과 Unity 사용하는 ADB 버전을 비교합니다. 두 툴이 다르면 ADB 위치 중 하나를 선택하고 두 툴이 동일한 경로를 사용하도록 설정합니다.
참고
Android Studio의 Android SDK 관리자를 사용하여 선택한 SDK의 플랫폼 툴이 최신 버전인지 확인합니다.