RenderDoc은 언리얼 엔진과 같은 애플리케이션에서 싱글 프레임 캡처를 수행하고 조사할 수 있는 독립형 오픈 소스 그래픽 디버거입니다. RenderDoc으로 캡처를 로드하면 이벤트, API 등을 통해 GPU 상황을 자세히 조사할 수 있습니다.
RenderDoc 설치
오픈소스 그래픽 디버거 RenderDoc은 RenderDoc.org에서 무료로 다운로드 및 설치할 수 있습니다.
아래 표시된 지원 운영체제 및 API는 현재 RenderDoc의 지원 대상을 나타내므로 언리얼 엔진 지원 대상과 다를 수 있습니다. 최신 업데이트는 RenderDoc FAQ 페이지를 참고하세요.
RenderDoc은 다음 운영체제를 지원합니다.
- Windows 7, 10, 11
- Linux
- Android
- Nintendo Switch
RenderDoc은 다음 API를 지원합니다.
- Vulkan
- D3D11
- D3D12
- OpenGL 3.2+
- OpenGL ES 2.0 — 3.2
프로젝트 내 RenderDoc 활성화
RenderDoc 플러그인은 엔진에 포함되어 있으며, 디폴트로 활성화되어 있습니다. 프로젝트에서 RenderDoc을 실행하는 방법은 두 가지로, 명령줄 실행인자를 사용하거나 프로젝트 세팅을 사용하는 것입니다.
시작 시 RenderDoc을 어태치하면 레벨 뷰포트 오른쪽 상단 모서리에 RenderDoc 아이콘이 표시됩니다.

아래의 단계를 따라 각 활성화 방법을 확인해 보세요.
플러그인 프로젝트 세팅으로 활성화하기
프로젝트 세팅에서 플러그인(Plugins) > RenderDoc 의 고급 세팅(Advanced Settings) 에 있는 시작 시 자동 어태치(Auto attach on startup) 를 활성화합니다. 이 방법은 프로젝트가 로드되는 어느 시점에서든 시작 시 RenderDoc을 실행하고 싶을 때 이상적입니다.

명령줄로 활성화하기
에디터 바로가기를 사용하여 명령줄 실행인자를 활성화합니다. 바로가기(Shortcut) 탭에서 타깃(Target) 줄에 -AttachRenderDoc
을 추가합니다. 이 방법은 RenderDoc을 가끔씩 실행하고 싶을 때 이상적입니다.

프레임 캡처하기
아래에서는 통합 RenderDoc 플러그인을 사용하거나 RenderDoc 애플리케이션을 직접 이용해 언리얼 엔진 프로젝트의 싱글 프레임을 캡처하는 방법을 대략적으로 설명합니다.
RenderDoc 기능과 사용에 대한 자세한 정보는 RenderDoc 문서를 참고하세요.
RenderDoc 플러그인
아래는 언리얼 엔진의 RenderDoc 플러그인을 사용해 프레임을 캡처하는 방법입니다.
- 프로젝트에 RenderDoc 플러그인을 활성화합니다.
- 캡처하려는 프로젝트와 씬을 엽니다.
- 레벨 뷰포트에서 RenderDoc 캡처(RenderDoc Capture) 버튼을 클릭합니다.
이미지를 클릭하면 최대 크기로 볼 수 있습니다.
RenderDoc 애플리케이션
아래에서는 독립형 RenderDoc 실행 파일로 언리얼 엔진에서 프레임을 캡처하는 방법을 대략적으로 설명합니다.
- 적절한 명령줄 인수로 게임을 실행하거나 UEEditor.exe를 시작하도록 RenderDoc을 환경설정합니다.
UEEditor.exe를 실행할 때에는 자손 프로세스 캡처(Capture Child Processes) 를 활성화합니다.
- 실행파일을 엽니다.
- 단축키 F12 를 눌러 프레임을 캡처합니다.
RenderDoc 구성. 애플리케이션 실행, 프레임 캡처에 대한 자세한 정보는 RenderDoc 시작 가이드를 참고하세요.
프로젝트 세팅
프로젝트 세팅 창을 사용해 RenderDoc 플러그인 추가 세팅을 설정합니다. 메인 메뉴에서 편집(Edit) > 프로젝트 세팅(Project Settings) 을 선택한 다음 플러그인(Plugins) 카테고리에서 RenderDoc 을 선택합니다.

프로퍼티 | 설명 |
---|---|
프레임 캡처 세팅 | |
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 executable path | RenderDoc 실행 가능 경로 - RenderDoc 실행파일이 사용할 경로를 설정합니다. |
추가 참고사항 및 리소스
- RenderDoc 사용과 프레임 캡처 분석에 대한 자세한 정보는 RenderDoc 문서를 참고하세요.
- 언리얼 엔진을 위한 RenderDoc 플러그인은 Fredrik Lindh(Temaran)이 제작 및 개발했습니다. 자세한 정보는 RenderDoc GitHub 저장소를 참고하세요.