O RenderDoc é um depurador gráfico de código aberto independente e gratuito que você pode usar para realizar capturas de quadro único de um aplicativo, como a Unreal Engine. A captura é carregada no RenderDoc para inspecionar detalhadamente o que está acontecendo na GPU por meio de eventos, API e muito mais.
Instale o RenderDoc
O RenderDoc é um depurador gráfico gratuito de código aberto e está disponível para baixar e instalar em RenderDoc.org.
A lista de sistemas operacionais e APIs suportados abaixo reflete a compatibilidade atual do RenderDoc, que pode ser diferente da compatibilidade da Unreal Engine. Para obter as atualizações mais recentes, consulte a página de Perguntas frequentes do RenderDoc.
O RenderDoc é compatível com os seguintes sistemas operacionais:
Windows 7, 10 e 11
Linux
Android
O RenderDoc é compatível com as seguintes APIs:
Vulkan
D3D11
D3D12
OpenGL 3.2+
OpenGL ES 2.0 — 3.2
Habilite o RenderDoc no seu projeto
O plugin RenderDoc está incluído na engine e está habilitado por padrão. Há duas formas de executar o RenderDoc com seu projeto: usando um argumento de linha de comando ou uma configuração de projeto.
Quando o RenderDoc é anexado na inicialização, você verá o ícone do RenderDoc no canto superior direito da janela de visualização do nível.
Siga as etapas a seguir para ver como utilizar cada uma.
Como habilitar com as configurações de projeto do plugin
Nas configurações de projeto em Plugins > RenderDoc, em Configurações avançadas, habilite Anexar automaticamente na inicialização. Esse método é ideal quando você deseja executar o RenderDoc na inicialização sempre que o projeto for carregado.
Como habilitar com a linha de comando
Habilite argumentos de linha de comando usando um atalho do editor. Na aba Atalho, adicione o seguinte à linha Destino: -AttachRenderDoc. Esse método é ideal quando você quer executar o RenderDoc apenas algumas da vezes.
Como executar uma captura de quadro
As etapas a seguir descrevem de maneira geral como realizar uma captura de quadro único com seu projeto Unreal Engine usando o plugin RenderDoc integrado ou diretamente do aplicativo RenderDoc.
Para obter mais detalhes sobre a funcionalidade e o uso do RenderDoc, acesse a Documentação do RenderDoc.
Plugin RenderDoc
As seguintes etapas são usadas para capturar um quadro usando o plugin RenderDoc da Unreal Engine:
Habilite o plugin RenderDoc para o seu projeto.
Abra seu projeto e cena onde deseja realizar uma captura.
Clique no botão de Captura do RenderDoc na janela de visualização do nível.
Clique na imagem para ampliar.
Aplicativo RenderDoc
Veja a seguir as etapas gerais necessárias para capturar um quadro usando a Unreal Engine com o executável do RenderDoc independente:
Configure o RenderDoc para inicializar o jogo ou o UEEditor.exe com os argumentos de linha de comando apropriados.
Habilite a Captura de processos filhos na inicialização com o UEEditor.exe.
Inicialize o executável.
Pressione a tecla de atalho F12 para capturar um quadro.
Para obter todos os detalhes sobre como configurar o RenderDoc, iniciar um aplicativo e realizar uma captura de quadro, consulte o Guia dos primeiros passos do RenderDoc.
Configurações de projeto
Use a janela de configurações de projeto para definir configurações adicionais do plugin RenderDoc. No menu principal, selecione Editar > Configurações de Projeto. Na categoria Plugins, selecione RenderDoc.
| Propriedade | Descrição |
|---|---|
| Configurações de captura de quadros | |
Capturar toda a atividade | Quando habilitado, o RenderDoc captura toda a atividade em todas as janelas de visualização e janelas do Editor para todo o quadro em vez de somente a janela de visualização atual. |
Capturar todas as pilhas de chamadas | Quando habilitado, o RenderDoc captura as pilhas de chamadas para todas as chamadas de API. |
Referenciar todos os recursos | Quando habilitado, o RenderDoc inclui todos os recursos de renderização na captura, mesmo aqueles que não foram utilizados durante o quadro. Habilitar essa propriedade aumentará significativamente o tamanho da captura. |
Salvar todos os estados iniciais | Quando habilitado, o RenderDoc sempre captura o estado inicial de todos os recursos de renderização, mesmo que não sejam usados durante o quadro. Habilitar essa propriedade aumentará significativamente o tamanho da captura. |
| Configurações avançadas | |
Mostrar ajuda na inicialização | Quando habilitado, uma janela de ajuda com o RenderDoc é mostrada na inicialização do Editor. |
Usar o manipulador de falhas do RenderDoc | Se essa opção for habilitada, o manipulador de falhas do RenderDoc será usado em caso de falha. Isso só deve ser usado se você souber que o problema envolve o aplicativo RenderDoc e quiser notificar os desenvolvedores do RenderDoc. |
Caminho do executável do RenderDoc | Define o caminho para o executável do RenderDoc a ser usado. O caminho correto deve ser preenchido automaticamente quando o RenderDoc for instalado. |
Notas e recursos adicionais
Confira a Documentação do RenderDoc para saber mais sobre o uso e a análise de capturas de quadros do RenderDoc.
O plugin RenderDoc foi criado e desenvolvido por Fredrik Beldh ("Temaran") para a Unreal Engine. Para obter mais informações, confira o Respositório do GitHub do RenderDoc.