Give Page Feedback | API

World Grouping Listeners - World Cell Visualizer

This Listener visualizes the boundaries of World Cells within the Scene and Game View using Gizmos. This is primarily intended as a debug tool and is especially useful for visualizing Cell's that do not have a naturally clear border.

Creating A World Cell Visualizer Component

You can add this component by selecting a game object and then selecting from the Top Menu Bar:

Component -> Deep Space Labs -> -> SAM -> World Grouping Listeners -> World Cell Visualizer

Adding A World Cell Visualizer Component From The Top Menu Bar GIF

or by selecting a game object and using the Add Component menu via its inspector:

Component -> Deep Space Labs -> -> SAM -> World Grouping Listeners -> World Cell Visualizer

Adding A World Cell Visualizer Component From Add Component Menu GIF

How It Works

You simply need to provide a per LOD Visualization Color and assign the Visualizer to the World Groupings you want to visualize, and the Visualizer will take care of the rest. A single World Cell Visualizer is capable of being used with multiple World Groupings, however if you wish for different Groupings to have different colors, you will need to create a Visualizer for each color scheme you want to use.

Per LOD Colors

You can define colors for as many LODs (Levels of Detail) as you wish on a single Visualizer component via the Visualization Colors array. When a World Cell is drawn, its current LOD is taken into account and the color associated with that LOD is used to draw its boundaries. If the Visualization Colors array does not contain a value for that LOD, the closest LOD color is used. For example, if the Visualization Colors array defines colors for three LODs and a World Cell is using LOD 4 assets, the Visualizer will use the LOD 3 color to draw its boundaries.

It perhaps goes without saying, but this means if you only define a single Visualization Color, it will be used for all World Cells on World Groupings that use the Visualizer, regardless of the Cell's current LOD.

Draw Cells (Disabling Visualization)

Gizmos have the handy capability of disabling their drawing when the inspector for the Component that is using them is minimized. The issue with this is, when you minimize a component's inspector, all inspectors of that type are minimized.

In regards to the World Cell Visualizer Listeners, that means all visualization is disabled when any one World Cell Visualizer component is minimized.

This feature can be handy if you want to disable all visualization, however if you only want to disable the visualization displayed by a single World Cell Visualizer, it makes doing so impossible.

To get around this issue, we've included a convenient Draw Cells setting in the World Cell Visualizer inspector. Disabling this option will disable the visualization for that particular Visualizer!