Layout tool (Realtime)

Layout tool and Points layout module

You have several modes for editing your agents: Select, Placement, and TimeOffset.

In Select mode, you can also move, rotate and scale agents using unreal manipulators.

Placement mode

Left Click to add agents in the viewport.
Ctrl+Left click and drag to edit the direction for the agents.
Shift+Left click and drag to rotate the layout (grid and poisson)

There are different layout types for placing your agents: point, grid and poisson.
Both grid and poisson have some options you can tweak through the GUI.

When you place your agents Atoms will automatically try to find the intersection with any mesh in scene.

In the Agent Types list, you can select the agent types you will be adding to your agent group. If the "Random Agent Type" checkbox is ticked, Atoms will pick an agent from list randomly. 
You can provide a percentage distribution for your agents types with the given sliders. The percentage only works when the "Random Agent Type" option is on. If no element of the "Agent Types" list is selected, all agent types will be used.

Select mode

Left click and drag to select agents with the marquee tool or middle click to use the lasso tool.
Shift+Left click and drag to add agents to the selection.
Ctrl+Left click and drag to toggle agents.

You can erase agents by pressing the "delete agents" button in the GUI.
You can also change their agent types by pressing the "Change Agent Type" button (this only works for agent groups with pointsLayout and cacheReader modules).

Select agents and press the "Separate Agents" button to move the selected agents into a new agent group.

In Select mode, you can also use the move, rotate and scale Unreal widgets as you would do with any other Unreal object.

For rotating and scaling agents, users can select the space (local/global) and its type.

Rotation types are:  "Position and Rotation" and "Position Only."

Scale types are: "Position and Agent" and "Position Only".

Time Offset Mode

The retime mode works only on agent groups with cacheReader modules.

The current time offset value will be displayed on top of each agent. 

Users can use the UI for modifying/randomizing the time offset for the selected agents.

Finally, you have the option of setting the time offset to be in place or standard.
Please make sure you set this before editing your agents as the time offset modes evaluate the translation and rotation offsets in different ways.

Points Layout module

You can use the layout tool in conjunction with the pointsLayout module to:

• add agents
• offset, rotate and scale agents
• delete agents
• separate agents

Layout tool and other layouts

You can still use the layout tool with other layouts (gridLayout, meshScatterLayout, etc). Any additional behaviour module needed by the layout tool to work will be added automatically. You can:

• offset, rotate and scale agents
• delete agents
• separate agents

CacheReader module

You can use the layout tool with the cache reader module to:

• offset, rotate and scale agents
• delete agents
• separate agents
• time offset agents