RenderDoc es un depurador de gráficos de código abierto independiente y gratuito que se puede utilizar para realizar capturas de fotogramas individuales de una aplicación, como Unreal Engine. La captura se carga en RenderDoc para inspeccionar con todo detalle lo que ocurre en la GPU a través de los eventos, la API y mucho más.
Cómo instalar RenderDoc
RenderDoc es un depurador de gráficos de código abierto gratuito que se puede descargar e instalar en RenderDoc.org.
La siguiente lista de sistemas operativos y API compatibles refleja lo que RenderDoc admite actualmente, que puede diferir de lo que admite Unreal Engine. Para conocer las últimas actualizaciones, consulta la página de preguntas frecuentes de RenderDoc.
RenderDoc es compatible con los siguientes sistemas operativos:
Windows 7, 10 y 11
Linux
Android
RenderDoc es compatible con las siguientes API:
Vulkan
D3D11
D3D12
OpenGL 3.2 y versiones posteriores
OpenGL ES 2.0 a 3.2
Cómo habilitar RenderDoc en tu proyecto
El complemento RenderDoc se incluye con el motor y está habilitado por defecto. Existen dos formas de ejecutar RenderDoc con tu proyecto: mediante un argumento de línea de comandos o una configuración del proyecto.
Cuando RenderDoc se conecta al inicio, verás el icono de RenderDoc en la esquina superior derecha del visor de niveles.
Sigue los pasos que se indican a continuación para ver cómo se activa cada uno.
Activación con la configuración del proyecto del complemento
En la configuración del proyecto, en Complementos > RenderDoc, en Ajustes avanzados, activa Adjuntar automáticamente al inicio. Este método es ideal cuando quieres ejecutar RenderDoc al inicio cada vez que se carga el proyecto.
Activación con la línea de comandos
Habilita los argumentos de la línea de comandos con un atajo del editor. En la pestaña Atajo, añade lo siguiente a la línea Destino: -AttachRenderDoc. Este método es ideal cuando solo quieres ejecutar RenderDoc de vez en cuando.
Cómo realizar una captura de fotograma
Los pasos que se indican a continuación describen a grandes rasgos cómo realizar una captura de un solo fotograma con tu proyecto de Unreal Engine utilizando el complemento integrado RenderDoc o directamente desde la aplicación RenderDoc.
Puedes encontrar más información sobre las funciones y el uso de RenderDoc en sus manuales.
Complemento RenderDoc
Para capturar un fotograma con el complemento RenderDoc de Unreal Engine, sigue estos pasos:
Habilita el complemento RenderDoc para tu proyecto.
Abre tu proyecto y la escena en la que deseas realizar una captura.
Haz clic en el botón de captura de RenderDoc del visor de niveles.
Haz clic en la imagen para verla a tamaño completo.
Aplicación RenderDoc
A continuación se describen los pasos generales necesarios para capturar un fotograma con Unreal Engine mediante el ejecutable independiente de RenderDoc:
Configura RenderDoc para iniciar tu juego o UEEditor.exe con los argumentos de línea de comandos adecuados.
Habilita Capturar procesos hijo al iniciar con UEEditor.exe.
Inicia el ejecutable.
Pulsa la tecla de acceso rápido F12 para realizar una captura de fotograma.
Para obtener información detallada sobre cómo configurar RenderDoc, iniciar una aplicación y realizar una captura de fotograma, consulta la guía de introducción a RenderDoc.
Configuración del proyecto
Usa la ventana Configuración del proyecto para establecer ajustes adicionales del complemento RenderDoc. Desde el menú principal, haz clic en Editar > Configuración del proyecto y, a continuación, en la categoría Complementos, selecciona RenderDoc.
| Propiedad | Descripción |
|---|---|
| Ajustes de captura de fotogramas | |
Capturar toda la actividad | Cuando está habilitado, RenderDoc captura toda la actividad en todas las ventanas del visor y del editor para el mismo fotograma, en lugar de capturar únicamente la del visor actual. |
Capturar todas las pilas de llamadas | Cuando está habilitado, RenderDoc captura las pilas de llamadas de todas las llamadas a la API. |
Hacer referencia a todos los recursos | Cuando está habilitado, RenderDoc incluye todos los recursos de renderizado en la captura, incluso los que no se hayan utilizado durante el fotograma. Al habilitar esta propiedad, el tamaño de la captura aumentará considerablemente. |
Guardar todos los estados iniciales | Cuando está habilitado, RenderDoc siempre captura el estado inicial de todos los recursos de renderizado, incluso si es probable que no se utilicen durante el fotograma. Al habilitar esta propiedad, el tamaño de la captura aumentará considerablemente. |
| Ajustes avanzados | |
Mostrar ayuda al inicio | Cuando está habilitado, se muestra una ventana de ayuda con RenderDoc al iniciar el editor. |
Utilizar el controlador de errores de RenderDoc | Si esta opción está habilitada, se usará el controlador de errores de RenderDoc si se produce un error. Solo debería utilizarse si sabes que el problema está relacionado con la aplicación RenderDoc y quieres avisar a los desarrolladores de RenderDoc. |
Ruta ejecutable de RenderDoc | Establece la ruta del ejecutable de RenderDoc que se usará. Debería rellenarse automáticamente con la ruta correcta cuando se instala RenderDoc. |
Notas y recursos adicionales
Para obtener más información sobre el uso y el análisis de capturas de fotogramas con RenderDoc, consulta la documentación de RenderDoc.
El complemento RenderDoc fue creado y desarrollado por Fredrik Lindh («Temaran») para Unreal Engine. Para obtener más información al respecto, consulta el repositorio de GitHub de RenderDoc.