Chaos Visual Debugger (CVD) es una herramienta que puedes usar para grabar simulaciones de física. Con CVD, puedes grabar juegos y aplicaciones que se ejecuten en tu ordenador, así como desde un ordenador remoto o una plataforma conectada a tu ordenador.
Al reproducir grabaciones en CVD, puedes inspeccionar los datos para depurarlos. Estas grabaciones son independientes del proyecto, lo que significa que se pueden cargar incluso sin tener acceso a los archivos de proyecto de Unreal Engine (UE), permitiendo la colaboración entre equipos o la depuración remota.
Entre los datos que recopila CVD, se incluyen los siguientes:
Partículas (incluidas velocidades, aceleraciones, propiedades de masa y estados de objetos)
Geometría de colisión (incluidos los canales de colisión)
Restricciones de colisión (pares de contactos con su estado)
Restricciones de articulaciones (ajustes de estado y articulaciones)
Restricciones del personaje en el suelo (movimiento del personaje basado en la física)
Consultas de escena (incluidos trazados de línea, barridos y superposiciones)
Nodos de animación de cuerpos rígidos (RBAN)
En el contexto de CVD, las partículas suelen referirse a cuerpos rígidos.
Cómo se inicia Chaos Visual Debugger
Existen dos formas de iniciar CVD: desde el editor o como programa independiente.
Desde Unreal Editor
Para abrir Chaos Visual Debugger desde Unreal Editor, haz clic en Herramientas > Depurar > Chaos Visual Debugger en la barra de menús. Después de seleccionar CVD, la herramienta se abrirá en una nueva ventana.
Como programa independiente
Para ejecutar CVD como un programa independiente, debes usar una compilación del código fuente de Unreal Engine. Puedes descargar una compilación del código fuente en GitHub. Para obtener más información, consulta Compilación de Unreal Engine desde el código fuente.
Puedes compilar y ejecutar CVD como programa independiente desde un archivo ejecutable (no portátil) o por lotes (portátil). La siguiente tabla describe la posición de los archivos y los pasos de compilación para cada opción.
| Proceso de compilación | Descripción |
|---|---|
Archivo ejecutable de CVD | El archivo ejecutable se encuentra en la siguiente ruta: Para compilar y ejecutar CVD, sigue estos pasos:
Una vez compilado, puedes crear un acceso directo al archivo ejecutable y ejecutar la herramienta con un solo clic. |
Archivo por lotes de CVD | El archivo por lotes se encuentra en la siguiente ruta: Para compilar y ejecutar CVD, sigue estos pasos:
|
La interfaz de usuario de CVD
En esta sección, se describen los botones, los paneles y las barras de herramientas más comunes con los que interactuarás en Chaos Visual Debugger. Aunque algunos de estos elementos son similares a la interfaz de Unreal Editor, deberías familiarizarte con CVD debido a las diferencias visuales entre CVD y algunas versiones de Unreal Editor.
Las siguientes secciones describen dónde encontrar cada elemento de la interfaz de usuario (IU) y ofrecen casos prácticos sencillos. Para obtener más información, sigue los enlaces de esta página.
| Número | Nombre | Introducción |
|---|---|---|
1 | Barra de menús | Opciones para cargar grabaciones recientes y modificar la disposición de CVD. |
2 | Barra de herramientas principal | Opciones para iniciar o detener grabaciones, cargar grabaciones y personalizar qué datos grabar. |
3 | Barra de herramientas del visor | Opciones para modificar qué datos se muestran en el visor y cómo se diferencian visualmente. |
4 | Esquematizador de escena | Muestra una lista de los componentes de escena en una grabación. |
5 | Visor | Muestra una grabación cargada o en tiempo real, como el visor de Unreal Editor. Esto puede incluir:
|
6 | Controles de reproducción | Muestra una colección de registros y cronogramas de reproducción, incluidos los siguientes: |
7 | Panel Detalles | Muestra información sobre una selección realizada en el visor que no tiene un inspector de datos dedicado, como las partículas. |
8 | Inspectores de datos | Proporciona detalles adicionales para: |
Barra de menús
| Nombre | Descripción | Imagen |
|---|---|---|
Archivo | Acceso rápido para abrir tus grabaciones recientes. |  |
Ventana | Muestra u oculta partes de la IU de CVD. |  |
Barra de herramientas principal
| Número | Nombre | Descripción |
|---|---|---|
1 | Abrir archivo | Carga las grabaciones |
2 | Conectarse a la sesión | (Antiguo) Se conecta con un dispositivo remoto para la depuración remota. Ahora solo se usa al grabar una sesión remota a través de la línea de comandos. Consulta (Antiguo) Cómo grabar una sesión en tiempo real con la interfaz de línea de comandos para obtener más información. |
3 | Combinar | Combina varias grabaciones abiertas en CVD en un solo archivo |
4 | Explorador de consultas de escena | Inspecciona todas las consultas de escena realizadas para un único fotograma. Para obtener más información al respecto, consulta la sección Inspectores de datos. |
5 | Objetivos de la sesión | Selecciona los objetivos que grabarás. |
6 | Modo de carga | Carga grabaciones únicas o múltiples (que combinan datos). |
7 | Grabar en archivo | Comienza una grabación y la guarda en un archivo. |
8 | Grabar sesión en tiempo real | Inicia una grabación y renderiza la visualización en tiempo real. |
9 | Canales de datos | Personaliza los datos capturados durante la grabación, como: |
10 | Ajustes | Personaliza la IU y el rendimiento de CVD. |
Barra de herramientas del visor
Menú de tres líneas
| Nombre | Descripción | Imagen |
|---|---|---|
Reproducir con la tasa de fotogramas grabada | Anula la tasa de fotogramas grabada por una fija. |  |
Seguimiento de objetos (F8) | Fija la cámara en un objeto en el visor. |  |
Opciones del campo de visión | Ajusta el campo de visión (FOV) del visor y la distancia máxima de renderizado. |  |
Permitir la selección traslúcida (T) | Activa o desactiva la capacidad de hacer clic en objetos traslúcidos. |  |
Ir a la ubicación | Teletransporta la cámara a una posición introducida en este campo con el formato XYZ. |  |
Modo de vista
El modo de visualización cambia entre las vistas Perspectiva, Superior, Inferior, Izquierda, Derecha, Frontal y Posterior en el visor.
| Perspectiva | Superior | Izquierda |
|---|---|---|
 |  |  |
Modo de iluminación
El modo de iluminación cambia entre los modos de visualización Iluminado, No iluminado, Estructura alámbrica iluminada y Estructura alámbrica en el visor.
Modos de iluminación
Para mejorar la visibilidad al usar el modo No iluminado, activa Bordes de malla.
Botón Mostrar
El botón Mostrar modifica qué indicadores de visualización y qué texto de depuración están visibles en el visor de una grabación existente. Para obtener más información sobre los indicadores de datos, consulta la sección Indicadores de visualización de datos.
Los ajustes de este menú se mantienen entre sesiones de CVD a menos que se restablezcan los valores predeterminados.
Barra de herramientas de acoplamiento y transformación
La barra de herramientas de acoplamiento y transformación es similar a la barra de herramientas del visor de versiones anteriores de Unreal Editor. La mayoría de las veces usarás estas herramientas para manipular actores de iluminación.
| Icono | Nombre | Descripción |
|---|---|---|
 | Seleccionar objetos | Selecciona objetos dentro del visor. |
 | Seleccionar y trasladar objetos | Mueve los actores de iluminación alrededor del mundo a lo largo de ejes individuales, ejes dobles o en los tres ejes. |
 | Seleccionar y rotar objetos | Rota los actores de iluminación a lo largo de ejes individuales. |
 | Seleccionar y escalar objetos | Escala los actores de iluminación con el gizmo de escala. Usa el gizmo para escalar objetos a lo largo de ejes individuales, ejes dobles o uniformemente en tres ejes. |
 | Sistema de coordenadas | Cambia cíclicamente el sistema de coordenadas entre Mundo y Local. |
 | Acoplar a superficie | Establece el comportamiento de acoplamiento de los actores de iluminación cuando los arrastras por la superficie de otro objeto. |
 | Ajustar a cuadrícula | Activa o desactiva si los actores de iluminación se acoplan a la cuadrícula y establece el incremento. |
 | Incrementos de rotación | Activa o desactiva la rotación de los actores de iluminación en incrementos y establece el grado. |
 | Incrementos de escalado | Activa o desactiva si los actores de iluminación escalan en incrementos y establece el incremento. |
 | Velocidad de la cámara | Afecta a la velocidad a la que la cámara puede moverse por el mundo. |
Esquematizador de escena
El esquematizador de escena muestra una lista de los componentes de escena en una grabación. Dado que cada grabación puede contener varios solucionadores, las partículas de cada solucionador se colocan en una carpeta con el nombre y el ID del solucionador al que pertenecen. Dentro de esa carpeta, cada partícula está etiquetada con su nombre de depuración de Chaos.
En CVD, un solucionador de física es una instancia de una simulación de física (normalmente del mundo de un juego) gestionada por el motor de física de Chaos.
Controles de reproducción
Chaos Visual Debugger incluye controles para reproducir y retroceder grabaciones existentes en función de los fotogramas del subproceso del juego, fotogramas del solucionador de física o etapas de una simulación. Esto maximiza el grado en el que puedes inspeccionar situaciones que usan física en red, física asíncrona o múltiples mundos de juego (como los juegos multijugador).
Cronograma de fotogramas del juego
El cronograma de fotogramas del juego representa cada fotograma del subproceso del juego para una grabación.
Cuando reproduzcas una grabación con este cronograma, verás que también se reproduce el cronograma del solucionador. Esto se debe a que, para cada fotograma del subproceso del juego que se reproduce, CVD busca el fotograma del solucionador de física más cercano disponible en esa marca de tiempo.
Es posible que los números de fotograma del cronograma de fotogramas del juego no siempre coincidan con los del cronograma del solucionador. Esto se debe a que los fotogramas del subproceso del juego pueden corresponder a varios fotogramas del solucionador de física. Acceder a ambos cronogramas significa que puedes inspeccionar situaciones en las que esto ocurra, como cuando se usa la física asíncrona.
Para obtener una explicación detallada de cómo CVD visualiza las físicas de sincronización y asíncrona, los datos de múltiples mundos del juego y los fotogramas resimulados, consulta este vídeo en el minuto 16:05.
Cronograma del solucionador
El cronograma del solucionador representa cada fotograma del solucionador de física para una grabación. Cada solucionador tiene una pista dedicada. Con este cronograma, puedes reproducir los datos de cualquier pista del solucionador y ver qué fotograma del solucionador corresponde a un fotograma específico del subproceso del juego.
| Ajuste | Descripción | Imagen |
|---|---|---|
Modo de sincronización del cronograma | Controla cómo se sincroniza cada pista del solucionador.
|  |
Insignia de resimulación | Aparece en cualquier pista del solucionador que incluya fotogramas que formen parte de una resimulación realizada durante el proceso de corrección de la desincronización de red. |  |
Control de visibilidad | Muestra u oculta los datos visualizados de una pista del solucionador concreta. |  |
Cronograma de etapas del solucionador
Con el cronograma de etapas del solucionador, puedes saltar a una etapa específica de una simulación de física. Las etapas son instantáneas de una simulación tomadas en distintos puntos de un mismo fotograma de física.
Puedes visualizar las siguientes etapas usando una simulación de partículas como ejemplo:
| Fase | Descripción |
|---|---|
Inicio de la evolución | Realiza una instantánea de todas las partículas al principio del paso del solucionador. |
Después de la integración | Realiza una instantánea de todas las partículas después de realizar el cálculo de |
Fase amplia de detección de colisiones | Realiza una instantánea de todas las fases intermedias (se crea un objeto por cada par de partículas cuyos límites se solapan) después de ejecutar la fase amplia del proceso de detección de colisiones. |
Fase reducida de detección de colisiones | Realiza una instantánea de todas las fases intermedias después de ejecutar la fase reducida del proceso de detección de colisiones. |
Antes de resolver las restricciones | Realiza una instantánea de todas las partículas antes de resolver las restricciones disponibles. |
Después de resolver las restricciones | Realiza una instantánea de todas las partículas después de resolver las restricciones. |
Fin de la evolución | Realiza una instantánea de todas las partículas al final del paso del solucionador. |
El cronograma de la etapa del solucionador es útil para inspeccionar comportamientos inusuales dentro de fotogramas singulares, como cuando un objeto aparece en la posición correcta al principio de un fotograma pero en una posición inesperada al final de un fotograma.
Registro de salida grabado
La pestaña Registro de salida, situada junto a la pestaña Pistas del cronograma del solucionador, es donde CVD graba los registros de tu aplicación para su inspección retroactiva.
Registro de salida
El registro de salida es un registro en tiempo real para monitorizar la actividad. Esta pestaña muestra el registro activo de la instancia de CVD actual y contiene errores o advertencias para el propio CVD.
Panel de detalles
El panel Detalles muestra información de una selección realizada en el visor.
Este panel también actúa como el inspector de datos para los datos de partículas. Para obtener más información, consulta Datos de partículas (panel Detalles).
Siguiente
Inspectores de datos
Comprende los inspectores de datos en Chaos Visual Debugger.
Indicadores de visualización de datos
Comprende los indicadores de visualización de datos en Chaos Visual Debugger.
Captura de datos con Chaos Visual Debugger
Captura y reproduce grabaciones con Chaos Visual Debugger.