Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this section we add some behaviours using some behaviours module to some agents group.


Animation modules

These behaviour modules handle and interact with the animation clip


Clip reader behaviour module

This module attach a clip reader node to each agent, so every agent will play in loop a specific clip

  • Create an agent group
  • Add a grid layout module and set the size attribute to (3,0,3)
  • Add a clip reader module
  • Set a compatible clip in the clipName attribute of the clip reader module
  • If you want set a different clip for some agents press the icon next to the clipName field. Select the agent you want from the list inside the agents override dialog or use the "Agent selection tool" (you can activate the seleciton tool using the button in the settings panel of the agent group aetemplate) and set a clip name there.
  • Rewind your scene and the press play




State machine behaviour module

This module create all the clip reader, merge, state machine nodes inside the dg network of each agent, Then the "state" metadata is used to play the right animation clip based on the data from the state machine.

  • Create an agent group
  • Add a grid layout module and set the size attribute to (3,0,3)
  • Add a state machine module
  • Set a valid id number in the state attribute of the state machine module (if you are using the atomsRobot agen type, use 1 for the walk state)
  • Rewind your scene and the press play
  • The state attribute can be animated, so put a keyframe at frame 20 with value 1 and one at frame 21 with value 2
  • Rewind your scene and the press play
  • You can override the state of some agent using agents override dialog




Sync behaviour module

The sync module is used to syncronize agents and create a parent/child or constraint relation between agents of different agent group, please look at the sync module section for more information.




Directional modules

To drive your agents you can use different behaviour modules, these modules change the "direction" metadata of the agents.

Follow curve behaviour module

Let's start with the follow curve module.

  • Create a agent group
  •  Add a grid layout module
  •  Add state machine module. Set the "state" attribute of the stateMachine module to 1
  • Create a curve in your scene
  • Add a follow curve module
  • in the curve attribute of the follow curve module drag and drop form the outliner the curve or enter the curve name inside the attribute field
  • Rewind your scene and the press play. The agent will follow the curve you created



Curve field behaviour module

The curve field generate a vector field using multiple effects so the agent are affeted by the direciton of multiple curves

  • Create a agent group
  •  Add a grid layout module, Set the size to (3,0,3)
  •  Add state machine module. Set the "state" attribute of the stateMachine module to 1
  • Create some curves in your scene
  • Add a curve field module
  • in the curves attribute of the curve field module, expand the panel and press the add button to add input curves and then drag and drop from the outliner the curves or enter the names inside each field
  • Set max distance attribute to 500
  • Rewind your scene and the press play. The agents will follow the curves you created




Mesh avoidance behaviour module

With this module you can avoid the intersection between agents and geometries in your scene

  • Create a agent group
  • Add a grid layout module
  • Add state machine module. Set the "state" attribute of the stateMachine module to 1
  • Create a curve in your scene
  • Add a follow curve module
  • In the curve attribute of the follow curve module drag and drop form the outliner the curve or enter the curve name inside the attribute field
  • Create a cube or some geo in your scene. If you are going to create multiple geos, please remenber to combine all together
  • Add a mesh avoidance module
  • In the mesh attribute of the mesh avoidance module drag and drop form the outliner the geo or enter his name inside the attribute field
  • Rewind your scene and the press play. The agent will follow the curve you created avoiding the geos

Please remember that the module are evaluated from top to down. In this case the mesh avoidance shoudl be at the bottom because it shoudl override the direction that comes from the follow curve module. If you put the mesh avoidance module before the follow curve you will have a wrong behaviour because the follow curve will override the directions formt he mseh avoidance module


There are others directional modules, please have a look to the behaviour modules reference section




Area trigger behaviour module

With this module you can change a metadata value when the agents enter inside a mesh area

  • Create a agent group
  • Add a grid layout module and set the size to (5,0,5)
  • Add state machine module. Set the "state" attribute of the stateMachine module to 1
  • Create a curve in your scene
  • Add a follow curve module
  • In the curve attribute of the follow curve module drag and drop form the outliner the curve or enter the curve name inside the attribute field
  • Create a plane, scale it and put it in front of the agents
  • Add a area trigger module
  • Connect the plane to the mesh attribute of the area trigger, you can drag&drop from the outliner or write the plane name in the mesh field
  • Connect the plane translate,scale,rotate to the agentGroupShapeNode1.atoms_areaTrigger_meshTranslation/Rotation/Scale
  • Set the metadata attribute in the area trigger module to state
  • Set the intValue attribute in the area trigger module to 2 in this way the agents will change the state to 2
  • Set the keepValue on so the agents will keep the new state value
  • Add another area trigger module and create and attach a new plane
  • Inside the new area trigger module, set the metadata to frameRate and the doubleValue to 0.5, the keepValue to off
  • Set the Blend In Frame and Blend Out Frame attribute of the new trigger module to 10
  • To add more variation to your simulation set the Reandom In and Random Out to 5
  • Rewind your scene and the press play. Now when the agents enter inside the first plane they'll start to run because the state metadata is changed to 2, then when they enters in the second plane they slow down but only inside the plane.

Image Added




Network editor behaviour module




Pose modules

The pose modules affect the joints transformation




Agent scale behaviour module





Joint transfrorm behaviour module





Parent constraint behaviour module





Tilt behaviour module