언리얼 엔진 5 문서가 에픽 디벨로퍼 커뮤니티로 이전되었습니다

While working with Geometry Collections, it may be useful to see information for a particular Geometry Collection (or set of Geometry Collections). The Geometry Collection Debug Draw Actor provides a way to toggle the display of information such as the hierarchy, clustering, information about rigid bodies, and more either through the properties in the Details panel or through console commands.

Debug From the Editor

Once you have Geometry Collections in your Level that you want to debug, during a Play in Editor session, use the World Outliner and find and select the GeometryCollectionDebugDrawActor .

This will show the Debug Draw properties panel that controls the different types of visualization modes available for the Geometry Collections inside the current Level.

Show Rigid Body Ids

A good place to start debugging is to visualize the Rigid Body Ids. In the Actor's Debug Draw category and Rigid Body sub-category, enable the Show Rigid Body Id checkbox.

The Selected Rigid Body property enables you to view all Rigid Bodies (-1) or enter in the Id for the Rigid Body you want to visualize.

In addition to entering the Id into the Selected Rigid Body field, you can use the eyedropper to select something from your scene.

You can also get more information by visualizing the inactive children of a clustered Geometry Collection by enabling the Debug Draw Clustering option.

Navigating through the Clusters

Under the Selected Rigid Body option, you can move between child/parents as well as cycle between the different clusters.

Visualization Options

You can choose whether to visualize the whole collection with the Debug Draw Whole Collection property. This will display the debug information for all Rigid Bodies belonging to the same Geometry Collection as the selected Rigid Body Id.

You can also visualize your geometry information in a top-down manner (by default, graphic representation of the Geometry Collection is from the bottom of the hierarchy). If the focus is to explore the top nodes' geometries, then the Debug Draw Hierarchy option will enable the ability to visualize the parents first. This option can also be combined with the Debug Draw Clustering option to show both the parent and children.

Hiding Geometry

By default, the geometry associated with the selected Rigid Body Id only gets hidden when the Collision Volumes are displayed, but there are a few other options available under the Hide Geometry property.

Toggle Properties to Visualize

You can toggle the desired properties you want to visualize in the Details panel (or through the console). Combining multiple properties together will produce different results, for example below we enable Show Rigid Body Collision along with the Show Rigid Body Id and Hide Geometry with the Hide Selected option.

There are several different categories which are grouped into multiple categories: Rigid Body , Rigid Clustering , and Geometry Collection Component . These categories apply either to the selected Rigid Body or to the entire Geometry Collection containing the selected Rigid Body.

Most properties are self-explanatory, for example, Show Vertices toggles the display of the Rigid Bodies vertices on or off or Show Bounding Box toggles the display of the Rigid Bodies Bounding Box on or off. There are some exceptions which are cited below.

• Show Rigid Body Velocity - this displays both Linear (arrow's length) and Angular velocities (circle's radius).

• Show Rigid Body Force - displays both Force (arrow) and Torque (circle).

• Show Rigid Body Infos - displays the complete on-screen textual debug information for the selected Rigid Body.

• Show Connectivity Edges - shows each logical connection to the sibling Rigid Body while they are still clustered.

  Requires the Debug Draw Clustering option, since it's visualizing the child nodes' information.

• Show Single Face and Single Face Index - display a selected face to help debug geometries.

  This visualization is available only once a specific Geometry Collection is selected ( Selected Rigid Body must not be -1).

Visualization Settings

You can toggle the debug visualization settings under the Settings category.

Customizations, such as changing the drawing color or the transform scale properties, can be made here. This can help with cases where the color background makes it harder to see the visualization. Most of these properties are self-explanatory and affect the drawing of the basic debug draw elements. Also enable Use Active Visualization to allow the visualization to change with each cluster level of the Geometry Collection, debug lines and text will get darker, while transform axis will get smaller as the clustering level increases.

Debug From the Console

All Geometry Collection Debug Draw Actor properties can also be directly changed from the console by following these steps.

List the Debug Draw Commands

The Geometry Collection Debug Draw commands are all under the p.gc prefix:

Each command's description can be accessed by adding and interrogation mark ? at the end of the command:

To Display the Rigid Body Ids

Use the command:

p.gc.ShowRigidBodyIds 1

To select the Rigid Body to Debug Draw

Use the command:

p.gc.SelectedRigidBodyId X

In the command above, replace X with the Id of the Rigid Body you want to visualize information for.

Enable/Disable Visualization of the Whole Collection.

Use the command:

p.gc.DebugDrawWholeCollection 1

This will display the debug information for all Rigid Bodies belonging to the same Geometry Collection as the selected Rigid Body Id.

Hiding Geometry

By default, the geometry associated with the selected Rigid Body Id only gets hidden when the Collision Volumes are displayed, use this command to select another option:

p.gc.HideGeometry [0|1|2|3|4|]
0 Hide None, do not hide any geometry.
1 Hide with Collision, hide the geometry associated with rigid bodies that are selected for collision volume visualization (the default).
2 Hide Selected, hide the geometry associated with the selected rigid bodies.
3 Hide Whole Collection, hide the entire geometry collection associated with the selected rigid bodies.
4 Hide All, hide all geometry collections.

Enable/Disable/Query the Debug Draw properties

The following commands are also avaliable through the console:

Rigid Body Collision

The following commands are available for showing Rigid Body Collisions:

To enable:

p.gc.ShowRigidBodyCollision 1

To disable:

p.gc.ShowRigidBodyCollision 0

To query:

p.gc.ShowRigidBodyCollision

Changing the Visualization Settings

The following commands are also available to help you customize the way the debug information are drawn:

Effects of Post Processing

If you notice artifacts on the debug draw lines it is likely that post-processing is affecting the way the Debug Draw lines are rendered.

Switching Post-Processing Off for Lines

Using a console command, it is possible to switch off post-processing:

ShowFlag.PostProcessing 0

Before, with post-processing on:

After, with post-processing off:

Switching Post-Processing on for LevelSet Renders

Before using the Debug Draw to visualize LevelSet, you must ensure that the post-processing is on as otherwise the Ray March material will not get rendered.

ShowFlag.PostProcessing 2

Before, with post-processing off, the LevelSet isn't rendered:

After, with post-processing on, the LevelSet is drawn as expected: