The animation rig retargeting tool 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 characters.
This feature is for Maya only.
You can access this tool via the menu: Atoms > Tools > Animation Rig Retarget Tool
Please note, the animation rig retargeting process works only for controls which can be mapped directly to a joint. Retargeting inverse feet and legs might not always be possible.
Controls Mapping
This feature requires some extra setup when exporting your agent type config.
You will need both your skeleton and animation controls in your scene, they can be part of the same rig or from two different rigs.
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 for a joint, 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 match your rig with the FBX animation.
