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 문서를 참고하세요.
언리얼 엔진 는 에디터 내에서 쉽게 다음 프레임을 캡처하고 자동으로 RenderDoc에서 캡처를 열 수 있는 플러그인을 지원합니다. 아래 단계에 따라 프로젝트에서 플러그인을 활성화할 수 있습니다.
- 메인 메뉴로 이동한 뒤 편집(Edit) > 플러그인(Plugins) 을 선택해 플러그인 브라우저를 엽니다.
-
렌더링(Rendering) 카테고리에서 RenderDoc 플러그인(RenderDoc Plugin) 을 찾거나 플러그인 브라우저 창 상단에 있는 검색창을 이용합니다.
- 활성화됨(Enabled) 옆의 박스를 체크하고 알림이 뜨면 에디터를 재시작합니다.
에디터가 다시 시작되면 레벨 뷰포트 우측 상단에 새로운 UI 버튼이 나타납니다. 이 버튼을 사용하여 캡처할 수 있습니다.
프레임 캡처하기
아래에서는 통합 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 저장소를 참고하세요.