Animation rig retargeting allows you to retarget an agent animation onto the original animation rig. This is particularly useful when you want a more artist driven animation for one or more agents.
This feature is for Maya only.
You can access this tool via the menu: Atoms > Tools > Animation Rig Retarget Tool
Controls Mapping
This feature requires some extra setup when exporting your agent type config.
Import your animation rig in your scene, if you are not already working with it.
Once your skeleton and animation controls are in the scene you can start working on the mapping.
You map joints to controls from within the "Setup" tab of the Animation Rig Retarget Tool.
Every time you select a joint the tool will cache it, leaving you free to select any other item in the scene. Select the controls you want to map to the current joint and click on the "Add button".
If you are not happy with the mapping list, you can remove an item at any point by selecting it from the list and pressing the "Remove" button.
If you don't want the joint selection to be automatic, you can toggle the "Automatic selection" checkbox.
Once your control mapping is done, export your agent type config.
Retargeting
The retargeting tool needs an FBX file as input. You can export an FBX file from your agent group simulation with the Atoms FBX exporter (Atoms > Exporters > FBX Exporter).
In your animation scene, import/reference your animation rig.
From the "Retargeting" tab provide a namespace (optional) and the FBX you previously exported.
Click on "Run".
The retargeting process will try to match your rig with the FBX animation.