Para ayudarte a identificar comportamientos de física inusuales, Chaos Visual Debugger (CVD) proporciona herramientas de dibujado de depuración para visualizar aspectos de tus aplicaciones que normalmente no son visibles en tiempo de ejecución.
Puedes controlar qué herramientas de dibujado de depuración se visualizan en el visor activando los indicadores de datos. Los indicadores de datos se organizan en las siguientes categorías:
Ciertos indicadores, como el del centro de masas, pueden tener un impacto en el rendimiento del CVD. Si se alcanza el límite de dibujado de depuración, aparecerá un aviso en el visor con el siguiente mensaje:
¡Se ha alcanzado el límite máximo de líneas de dibujado de depuración! Intenta seleccionar menos categorías de dibujado de depuración o enfoca la cámara en un área más reducida.
Datos de colisión
Los datos de colisión visualizados pueden ayudarte a identificar áreas donde las colisiones se están comportando de forma inesperada. Por ejemplo, cuando dos objetos se intersecan entre sí, en lugar de colisionar como se esperaba.
Para habilitar los datos de colisión, sigue estos pasos:
En la barra de herramientas del visor, haz clic en Mostrar > Indicadores de datos de colisión > Habilitar trazado. Esta opción abre una lista de indicadores de datos.
Selecciona indicadores de datos de la lista para activarlos o desactivarlos.
Haz clic en Ajustes de visualización de datos de colisión para personalizar cómo se trazan los datos en el visor.
Los ajustes de visualización incluyen las siguientes opciones:
Mostrar texto de depuración: activa y desactiva el texto de depuración del visor (si lo hay).
Prioridad de profundidad: traza los datos en el espacio global o en primer plano (siempre por encima de cualquier otro componente de escena).
Opciones de escala y radio: controla el tamaño de los elementos de dibujado de depuración haciéndolos más fáciles de ver en el visor.
La mayoría de indicadores de datos incluyen ajustes de visualización que contienen funciones similares.
Consultas de escena
Las consultas de escena visualizadas (dibujos de línea, barridos y solapes) pueden ayudarte a depurar los casos en los que realizaste una consulta durante el tiempo de ejecución, pero esta no encontró el objeto esperado.
Para activar los datos de consulta de escena, sigue estos pasos:
En la barra de herramientas del visor, clic en Mostrar > Indicadores de datos de la consulta de escena > Habilitar trazado. Esta opción abre una lista de indicadores de datos.
Selecciona indicadores de datos de la lista para activarlos o desactivarlos.
Haz clic en Ajustes de visualización de las consultas de escena para personalizar cómo se dibujan los datos en el visor.
Datos de partículas
Los datos de partículas visualizados pueden ayudarte a identificar el comportamiento irregular de las partículas, como una partícula que se mueve más rápido de lo esperado después de aplicar una fuerza.
Para habilitar los datos de partículas, sigue estos pasos:
En la barra de herramientas del visor, haz clic en Mostrar > Indicadores de datos de partículas > Habilitar trazado. Esta opción abre una lista de indicadores de datos.
Selecciona indicadores de datos de la lista para activarlos o desactivarlos.
Haz clic en Ajustes de visualización de los datos de partículas para personalizar cómo se trazan los datos en el visor.
CVD solo graba y visualiza datos de partículas de subprocesos de física, no datos de partículas de subprocesos del juego. Los datos de partículas del subproceso del juego no se visualizan.
Geometría
La mayoría de las partículas tienen geometrías de colisión tanto simples como complejas, pero solo se usan una para la detección de colisiones.
Las opciones para alternar entre geometría simple y compleja, así como otros indicadores de visualización de geometría, se encuentran en la barra de herramientas del visor, en el menú Mostrar > Indicadores de geometría.
La geometría de solo consulta se visualiza con material traslúcido. Puedes hacer clic en los materiales traslúcidos pulsando la tecla T (o haciendo clic en Permitir seleccionar traslúcidos en el menú de trres rayas) para activar o desactivar las selecciones traslúcidas.
Coloración de partículas
Para aumentar la visibilidad del dibujo, puedes colorear las partículas de uno de los siguientes modos:
Ninguno: traza las partículas en gris predeterminado.
Estado: aplica el color en función del estado de un cuerpo físico en una simulación (dinámico, en reposo, cinemática o estático).
Tipo de forma: aplica el color en función del tipo de geometría de colisión (formas simples, convexas, de campo de altura o trimalla).
Cliente servidor: aplica el color según las partículas generadas por el cliente o el servidor.
Estado y gris predeterminado
Para cambiar el modo y personalizar los colores, sigue estos pasos:
En la barra de herramientas del visor, haz clic en Mostrar > Coloración de partículas.
En el desplegable Modo de colores, haz clic en el desplegable Modo de color de partícula y selecciona el modo que quieras usar.
Haz clic en el menú desplegable Colores por [modo] para personalizar los colores. Luego, haz clic en una tesela de color para abrir un selector de color contextual.
En la siguiente tabla se describe la interfaz de usuario del selector de color contextual.
| Número | Descripción |
|---|---|
1 | Rueda de color (o espectro de color si se activa). |
2 | Muestra los colores actuales y los seleccionados anteriormente. |
3 | Alterna la vista previa de sRGB. |
4 | Alterna entre la rueda de color y el espectro de colores. |
5 | Alterna la visibilidad de los esquemas de color. |
6 | Herramienta cuentagotas. |
7 | Controles deslizantes RBG/HSV. |
8 | Control deslizante alfa. |
9 | Muestra el código hexadecimal del color actual. |
10 | Esquemas de color: funcionan de forma similar a las muestras de Adobe Photoshop y otros programas de diseño. |
Restricciones de articulaciones
Las articulaciones visualizadas pueden ayudarte a depurar comportamientos de maniquí no deseados, como la torsión de las articulaciones. CVD graba los datos de las restricciones de las articulaciones como un dato individual para cada fotograma. Debido a esto, actualmente no es posible mantener una selección en todos los fotogramas del juego.
Para activar los datos de restricción de las articulaciones, sigue estos pasos:
En la barra de herramientas del visor, haz clic en Mostrar > Indicadores de datos de articulaciones > Habilitar trazado. Esta opción abre una lista de indicadores de datos.
Selecciona indicadores de datos de la lista para activarlos o desactivarlos.
Haz clic en Ajustes de visualización de las restricciones de las articulaciones para personalizar cómo se trazan los datos en el visor.
Por defecto, CVD no graba las restricciones de las articulaciones. Para que lo haga, ve al menú desplegable Canal de datos de la barra de herramientas principal y marca JointConstraints.
Restricciones del personaje en el suelo
CVD puede grabar el estado de las restricciones del personaje en el suelo usadas por el sistema de movimiento de personajes de Unreal Engine llamado
Para habilitar los datos de restricciones del personaje en el suelo, sigue estos pasos:
En la barra de herramientas del visor, clic en Mostrar > Indicadores de datos de las restricciones del personaje en el suelo > Habilitar trazado. Esta opción abre una lista de indicadores de datos.
Selecciona indicadores de datos de la lista para activarlos o desactivarlos.
Haz clic en Ajustes de visualización de las restricciones del personaje en el suelo para personalizar cómo se trazan los datos en el visor.
Por defecto, CVD no graba las restricciones del personaje en el suelo. Para habilitar esta opción, haz clic en el menú desplegable Canal de datos de la barra de herramientas principal y marca Restricciones del personaje en el suelo.
Datos genéricos de dibujado de depuración
Las siguientes macros de C++ y nodos de blueprint graban formas de dibujado de depuración directamente en CVD. Las formas de dibujado de depuración pueden ofrecer contexto al depurar cálculos de física.
Por ejemplo, si usas dos puntos en el espacio para calcular una fuerza aplicada a un cuerpo físico, CVD solo mostrará el cuerpo antes y después de aplicar la fuerza. Si algo no va bien, puedes usar macros de dibujado de depuración genéricas (o nodos de blueprint) para visualizar los dos puntos y la fuerza fotograma a fotograma. Este proceso de trabajo puede proporcionar contexto sobre cómo se calculó la fuerza y ayudarte a corregirla.
Macros de C++
Dependiendo de la forma que necesites trazar, cada macro tiene su propio conjunto de parámetros que usa cada macro (a excepción de los siguientes parámetros opcionales):
| Macro | Parámetro | Descripción |
|---|---|---|
TraceDebugDrawBox | InBox | La forma que quieres grabar. |
Todas las macros | Tag | El FName que se usa como etiqueta para el filtro, la búsqueda y el dibujado de depuración como etiqueta de texto en el visor de CVD. |
Todas las macros | Color | El color que se aplicará a esta forma cuando se trace en modo de depuración en CVD. |
Todas las macros | SolverID | El ID del solucionador con el que debería asociarse esta forma. Si no se proporciona ningún ID, esta forma se añade como parte del juego actual desde el cubo de datos. |
TraceDebugDrawLine, TraceDebugDrawVector | InStartLocation | El punto de inicio de la línea. |
TraceDebugDrawLine | InEndLocation | El punto final de la línea. |
TraceDebugDrawVector | InVector | El vector que quieres grabar. |
TraceDebugDrawSphere | Centro | El punto de origen de la esfera. |
TraceDebugDrawSphere | Radius | El radio de la esfera. |
Todas las macros | Owner | Cualquier UObject con el que esté relacionada esta forma de dibujado de depuración. Se usa internamente para saber si una forma proviene de un solucionador de servidor o de un solucionador de cliente. |
Nodos de blueprint
Las siguientes macros de dibujado de depuración genéricas también se pueden implementar como nodos de función en el grafo de eventos de un blueprint:
Esfera de dibujado de depuración de grabación de CVD
Caja de dibujado de depuración de grabación de CVD
Línea de dibujado de depuración de grabación de CVD
Para obtener más información sobre cada nodo, consulta la sección de Chaos Visual Debugger en la Referencia de la API de blueprint de Unreal Engine.
Habilitar datos genéricos de dibujado de depuración
Para activar los datos genéricos de dibujado de depuración, sigue estos pasos:
En la barra de herramientas del visor, clic en Mostrar > Indicadores de datos genéricos de dibujado de depuración > Habilitar trazado. Esta opción abre una lista de indicadores de datos.
Selecciona indicadores de datos de la lista para activarlos o desactivarlos.
Haz clic en Ajustes de visualización de los datos genéricos de dibujado de depuración para personalizar cómo se dibujan los datos en el visor.
Estructuras de aceleración
CVD puede grabar y visualizar estructuras de aceleración usadas por el sistema de consulta de escena, que actualmente es un árbol AABB (caja delimitadora alineada con el eje). Un árbol AABB es una jerarquía de volúmenes delimitadores que puedes usar para determinar posibles solapamientos entre objetos.
En CVD, puedes usar la visualización de árbol AABB para ver la composición del árbol y los límites de cada objeto a medida que se añaden al árbol.
Esta visualización es útil cuando un objeto al que debería haber afectado una consulta de escena no lo ha hecho, o ni siquiera ha sido evaluado por el motor de física. Puedes usar la visualización de árbol AABB en CVD para inspeccionar los límites del objeto y determinar si el error se debe, por ejemplo, a que los límites no engloban visualmente al objeto o a límites incorrectos dentro del árbol.
Para personalizar qué indicadores de datos de la estructura de aceleración se dibujan, sigue estos pasos:
En el visor, haz clic en Mostrar > Indicadores de datos de la estructura de aceleración y selecciona los indicadores de datos que quieras.
Haz clic en Ajustes de visualización de la estructura de aceleración para personalizar cómo se dibujan los datos en el visor.
Por defecto, CVD no graba estructuras de aceleración. Para que lo haga, haz clic en el menú desplegable Canal de datos de la barra de herramientas principal y marca la casilla Datos de estructuras de aceleración.
Habilitadores de visibilidad comunes
El menú Indicadores de visibilidad comunes contiene indicadores derivados del propio motor que pueden ayudar con la visibilidad en CVD.
Para personalizar qué indicadores se activan, en la barra de herramientas del visor, haz clic en Mostrar > Indicadores comunes.
Siguiente
Inspectores de datos
Comprende los inspectores de datos en Chaos Visual Debugger.
Captura de datos con Chaos Visual Debugger
Captura y reproduce grabaciones con Chaos Visual Debugger.