Simulation Cache Layout Tool Overview

The Simulation Cache Layout Tool allows to apply deformation layers on a previously exported Simulation Cache displayed with a Simulation Cache Proxy. Those deformation layers are non destructive (ie they do not affect or modify exported Simulation Cache Files) and are saved into a Golaem Simulation Layout File (.gscl).


Edition of a Simulation Cache using the Simulation Cache Layout Tool.

To be able to use the Simulation Cache Layout Tool, a Simulation Cache Proxy must be created and selected in the scene.

For a better understanding of the workflow of the Simulation Cache Layout, you can check the Rendering Workflow.

LAUNCH

  • Golaem Shelf:
  • Golaem Render Menu: Simulation Cache Layout
  • MEL Command: glmSimulationCacheLayoutCmd;

SIMULATION CACHE LAYOUT GUI

The Simulation Cache Layout panel displays the information about the deformation layers applied to a Simulation Cache Proxy node:

Menu

Import and append a Simulation Cache Layout file (.gscl) to the current Simulation Cache Proxy
Save Simulation Cache Layout file (.gscl) with the Deformation Layers added to the Layout Operations Panel for every Crowd Field of every Simulation Cache Proxy in the scene
Save As Simulation Cache Layout file (.gscl) with the Deformation Layers added to the Layout Operations Panel for every Crowd Field of every Simulation Cache Proxy in the scene
Enables selected/all Layout operations
Disable selected/all Layout operations
Group selected Layout operations
Delete all Layout operations

Deformation Layers Library

Multiple Deformation Layers are available within the Simulation Cache Layout Tool. Some are accessible via the Tool bar, some with key shortcuts

Transformation Layers

Translate Layer to translate Character positions
Rotate Layer to rotate Character orientations
Scale World Layer to scale distance between Characters
Scale Object Layer to scale Characters
Scale Object Range Layer to scale Characters between and min and a max value randomly

Duplicate Layers

Duplicate Layer to duplicate Characters
SnapTo Layer to duplicate Characters and snap them on Population Tool slots

Time Edition Layers

Time Offset Layer to offset Simulation Caches for Characters
Time Warp Layer to warp Simulation Caches for Characters

Visibility Layers

Erase Layer to remove Characters from the viewport and the rendering
Unerase Layer to restore Characters to the viewport and the rendering

Posture Edition Layers

Edit Bone Layer to edit the orientation of Character Bones
Edit Posture Layer to import the Simulation Cache as a keyframed Maya skeleton and allow to edit curves
Edit Posture Layer to save a keyframed Maya skeleton in the Simulation Cache

Geometry Edition Layers

Replace Mesh Asset Layer to edit the Mesh Asset assignment of a Character (can be done with the Character Palette)
Replace Rendering Type Layer to edit the Rendering Type assigned to a Character (can be done with the Character Palette)
Replace Shader Layer to edit the Shader assigned to a Character Mesh Asset
Replace Shader Attribute Layer to edit the Shader Attribute value assigned to a Character Shader

Trajectory Edition Layers

Trajectory Smoothing Layer to smooth the trajectory of Characters
Trajectory Vector Field Layer to constrain the trajectory of Characters to a Vector Field
Trajectory Avoidance Layer to perform a simple cylinder avoidance edition on the trajectory of Characters
Trajectory Edit Layer to edit the trajectory of Characters manually
Trajectory Mode Layer to edit the mode of trajectory adaptation of Characters

Layout Operations Panel

Each time a deformation layer is applied to a Simulation Cache Proxy node, it is automatically added to the Layout Operations panel of the Simulation Cache Layout Tool. Each layer is displayed / controlled the same way:

Add a New Deformation Layer

The way to add a new Deformation Layer depends on the type of Deformation Layer. See each Deformation Layer for more information.

Delete an Existing Deformation Layer

Click on the icon of a Deformation Layer line to delete it

Enable / Disable an Existing Deformation Layer

Toggle the  icons on a Deformation Layer to enable / disable it

Group Deformation Layers

Toggle the  icon or press CTRL+G on selected Deformation Layers to group them.

 

Use the  icon of a Group line to delete it.

Edit an Existing Deformation Layer Values

It is possible to edit some Deformation Layer Values such as the Translate, Rotate, Scale World, Scale Object Deformation Layers by double clicking in the information attributes on the Deformation Layer:

Move Up / Down a Deformation Layer in the Layout Operations Panel

To move up / down a Deformation Layer in the Layout Operations Panel, select the Deformation Layer and drag it to the wanted position.

Informations

This layout contains an overview of the selected Entities and the memory used by the Simulation Cache Layout. It also allows to manually specify which Entities should be selected.

Cache Layout Settings

This panel defines how the Entities should be adapted if using the Simulation Cache Layout tool and moving Entities on the exported Terrain.

Use Cached Terrain If checked, when transformed the Entities will be adapted on the exported Terrain.
Flush the Terrain FBX/GTG cache and reload it.
Orient Pelvis On Ground Normal If checked the Entities will also be oriented along the normal of the Terrain
Show Trajectories Show/hide the edit/smooth trajectories of the layout