언리얼 엔진과 RenderDoc 함께 사용하기

RenderDoc은 싱글 프레임 캡처를 수행하고 조사할 수 있는 독립형 오픈 소스 그래픽 디버거입니다.

Choose your operating system:

Windows

macOS

Linux

RenderDoc은 언리얼 엔진과 같은 애플리케이션에서 싱글 프레임 캡처를 수행하고 조사할 수 있는 독립형 오픈 소스 그래픽 디버거입니다. RenderDoc으로 캡처를 로드하면 이벤트, API 등을 통해 GPU 상황을 자세히 조사할 수 있습니다.

RenderDoc 설치하기

오픈소스 그래픽 디버거 RenderDoc은 RenderDoc.org에서 무료로 다운로드 및 설치할 수 있습니다.

아래 표시된 지원 운영체제 및 API는 현재 RenderDoc의 지원 대상을 나타내므로 언리얼 엔진 지원 대상과 다를 수 있습니다. 최신 업데이트는 RenderDoc FAQ 페이지를 참고하세요.

지원 운영체제

Windows 7 및 10

Linux

Android

Google Stadia

Nintendo Switch

지원 API

Vulkan

D3D11

D3D12

Open GL3.2+

Open GL ES 2.0 - 3.2

RenderDoc 플러그인 활성화하기

RenderDoc 플러그인을 활성화하지 않아도 언리얼 엔진 프로젝트에서 RenderDoc을 사용할 수 있습니다. 독립형 RenderDoc은 UE 실행파일과 함께 사용이 가능합니다. 구성 가이드는 RenderDoc 문서를 참고하세요.

언리얼 엔진 4는 에디터 내에서 쉽게 다음 프레임을 캡처하고 자동으로 RenderDoc에서 캡처를 열 수 있는 플러그인을 지원합니다. 아래 단계에 따라 프로젝트에서 플러그인을 활성화할 수 있습니다.

  1. 메인 메뉴로 이동한 뒤 편집(Edit) > 플러그인(Plugins) 을 선택해 플러그인 브라우저를 엽니다.

  2. 렌더링(Rendering) 카테고리에서 RenderDoc 플러그인(RenderDoc Plugin) 을 찾거나 플러그인 브라우저 창 상단에 있는 검색창을 이용합니다.

    EnablingRenderDoc_1.png

  3. 활성화됨(Enabled) 옆의 박스를 체크하고 알림이 뜨면 에디터를 재시작합니다.

에디터가 다시 시작되면 레벨 뷰포트 우측 상단에 새로운 UI 버튼이 나타납니다. 이 버튼을 사용하여 캡처할 수 있습니다.

EnablingRenderDoc_2.png

프레임 캡처하기

아래에서는 통합 RenderDoc 플러그인을 사용하거나 RenderDoc 애플리케이션을 직접 이용해 언리얼 엔진 프로젝트의 싱글 프레임을 캡처하는 방법을 대략적으로 설명합니다.

RenderDoc 기능과 사용에 대한 자세한 정보는 RenderDoc 문서를 참고하세요.

RenderDoc 플러그인

아래는 언리얼 엔진의 RenderDoc 플러그인을 사용해 프레임을 캡처하는 방법입니다.

  1. 프로젝트에 RenderDoc 플러그인을 활성화합니다.

  2. 캡처하려는 프로젝트와 씬을 엽니다.

  3. 레벨 뷰포트에서 RenderDoc 캡처(RenderDoc Capture) 버튼을 클릭합니다.

    이미지를 클릭하면 최대 크기로 볼 수 있습니다.

RenderDoc 애플리케이션

아래에서는 독립형 RenderDoc 실행 파일로 언리얼 엔진에서 프레임을 캡처하는 방법을 대략적으로 설명합니다.

  1. 적절한 명령줄 인수로 게임을 실행하거나 UEEditor.exe를 시작하도록 RenderDoc을 환경설정합니다.

    UEEditor.exe를 실행할 때에는 자손 프로세스 캡처(Capture Child Processes) 를 활성화합니다.

  2. 실행파일을 엽니다.

  3. 단축키 F12 를 눌러 프레임을 캡처합니다.

RenderDoc 구성. 애플리케이션 실행, 프레임 캡처에 대한 자세한 정보는 RenderDoc 시작 가이드를 참고하세요.

프로젝트 세팅

프로젝트 세팅 창을 사용해 RenderDoc 플러그인 추가 세팅을 설정합니다. 메인 메뉴에서 편집(Edit) > 프로젝트 세팅(Project Settings) 을 선택한 다음 플러그인(Plugins) 카테고리에서 RenderDoc 을 선택합니다.

RenderDoc_ProjectSettings.png

프로퍼티

설명

프레임 캡처 세팅

Capture all activity

모든 활동 캡처 - 활성화하면 RenderDoc이 현재 뷰포트뿐 아니라 전체 프레임에 대해 모든 뷰포트와 에디터 창의 모든 활동을 캡처합니다.

Capture all call stacks

모든 콜 스택 캡처 - 활성화하면 RenderDoc이 모든 API 호출에 대해 콜 스택을 캡처합니다.

Reference all resources

모든 리소스 참조 - 활성화하면 RenderDoc이 프레임에서 사용되지 않은 리소스를 비롯해 캡처의 모든 렌더링 리소스를 포함합니다.

이 프로퍼티를 활성화하면 캡처 크기가 대폭 증가합니다.

Save all initial states

모든 초기 스테이트 저장 - 활성화하면 RenderDoc이 프레임에서 사용되지 않을 가능성이 높은 리소스를 비롯해 모든 렌더링 리소스의 초기 스테이트를 항상 캡처합니다.

이 프로퍼티를 활성화하면 캡처 크기가 대폭 증가합니다.

고급 세팅

Show help on startup

시작 시 도움말 표시 - 활성화하면 에디터를 시작할 때 RenderDoc 도움말 창이 표시됩니다.

Use the RenderDoc crash handler

RenderDoc 크래시 핸들러 사용 - 활성화하면 크래시 발생 시 RenderDoc 크래시 핸들러가 사용됩니다.

RenderDoc 애플리케이션에 문제가 있어 RenderDoc 개발자들에게 알리고 싶은 경우에만 사용하세요.

RenderDoc executable path

RenderDoc 실행 가능 경로 - RenderDoc 실행파일이 사용할 경로를 설정합니다.

RenderDoc을 설치하면 자동으로 정확한 경로가 입력됩니다.

추가 참고사항 및 리소스

  • RenderDoc 사용과 프레임 캡처 분석에 대한 자세한 정보는 RenderDoc 문서를 참고하세요.

  • 언리얼 엔진을 위한 RenderDoc 플러그인은 Fredrik Lindh(Temaran)이 제작 및 개발했습니다. 자세한 정보는 RenderDoc GitHub 저장소를 참고하세요.

언리얼 엔진의 이전 버전을 위해 작성된 페이지입니다. 현재 언리얼 엔진 5 버전을 위해 업데이트되지 않았습니다.