Debugging the simulation content

It is possible to configure your Vortex-Unity application with the capabilities of the Vortex® Studio Player that lets you monitor and visualize the Vortex simulation so that you can troubleshoot and diagnose problems in the dynamics content.

Setting up Vortex setup file for debugging

Before you can debug your simulation, you must configure the Vortex setup (.vxc) file that is used for simulation following these steps:

By default, Vortex-Unity application uses the installed VortexIntegration.vxc. If you use another Vortex setup file for your simulation, you must modify that file.

For more details on Vortex setup, see https://cm-labs.atlassian.net/wiki/spaces/VSD22/pages/86048777/Prepare+the+simulator+topologies+for+Vortex+Launcher#Setup-Document

1) Run Vortex® Studio Editor and open the Vortex setup file.

2) If the following extensions and modules are not already present in the node containing the Dynamics Engine module, add them via the Toolbox:

  • Dynamics Visualizer

  • Contact Visualizer

  • Dynamics Visualizer Page

  • Graphics Module

  • 3D Display

3) Select Dynamics Visualizer Page in the Explorer view:

local_debugger_explorer_dyanVisualizerPage.png

4) Assign Dynamics Visualizer extension and a Contact Visualizer extension to the DynamicsVisualizer Extension and ContactVisualizer Extension fields:

local_debugger_dynamicsVisualizer_link.png

5) Select Dynamics Visualizer in the Explorer view. In the property panel, select the checkbox to customize the default visualize options:

6) Select 3D Display in the Explorer view. In the property panel, set Placement mode field to windowed.

7) Save the Vortex setup file.

Debugging Dynamics

For more details on integrating Vortex Studio with Unity, see https://vortexstudio.atlassian.net/wiki/spaces/VSD2401/pages/3448046106

Loading Content for debugging

When the Vortex simulation is started, the Player containing the Dynamics Visualizer Pagetab and the debug graphics will appear in separate windows. The debug graphics window will show the graphics of the selected simulation content.

Note that if after the simulation is started and the debug graphics window still does not show the debug displays (e.g. geometries, contacts etc.) it means the simulation content needs to be loaded. Use the Browser tab in the Player window to browser and load the content.

Use the Add Assets buttons to add content files. Any files that you add are displayed in the Browser list. To load the content, double-click on the file (or use Load button ) you want to see in the graphics window.

Setting Dynamics Displays

In the Dynamics Visualizer tab, click to check the checkboxes to enable the debug displays.

The contact materials can be shown by enabling Display Contact Material Names in the Streamed Terrain extension via the Content Debugger.

Using Shortcut keys

The collision geometries can be displayed by pressing Shift+G to see the geometry of the terrain which is being streamed from Unity into Vortex.

The contacts can be shown by pressing Shift+C. The contact visualization mode can be toggled with Alt+C. The contact legend visibility can be toggled with Alt+L.

Everything can be displayed in wireframe by pressing F2.

The 3D display must be focused when use shortcut keys.

See https://vortexstudio.atlassian.net/wiki/spaces/VSD2401/pages/3448046924 for more details on the various debug settings/keyboard shortcuts.

 

Â