Lumberyard
User Guide (Version 1.21)

Retargeting Motions

This feature is in preview release and is subject to change.

Use the Animation Editor to retarget motions from one actor to another actor. This lets you reuse motions that you've created for an actor, and to quickly prototype motions on other actors while you wait for new ones to be created. The retarget feature is also important to ensure that actors are scaled appropriately. Without this feature, the retargeted actor stretches and scales to the size of the original actor for which the motion was recorded. With this feature, the retargeted actor retains its size.

For example, you may have a human character that's six feet tall and your motions are recorded for that actor. You may also have a giant character that's 18 feet tall. If you play the motions for the human character on the giant character without retargeting, the giant character will scale to the size of the human character. When you enable the retarget feature, the giant character retains its height of 18 feet.

To retarget motions, you must do the following:

  • Include the bind pose of the original actor in the first frame for all motions. For example, you may have frames 1 to 100 in your motion. You must add the actor's bind pose (skinning and bones) to frame 0.

  • Use the same bone names and hierarchy for both the original actor and the retargeted actor. You can use additional leaf bones on the retargeted actor, as long as the retargeted areas and hierarchy match the original actor.

Note

If your retargeted actor has the same bone names and transforms as the original actor, you do not need to use the retarget motions procedure.

To retarget motions

  1. In your DCC tool, add the actor's bind pose, which includes skinning and bones, to the first frame of your motion. Then export the file into Lumberyard. For more information, see Importing Assets into Lumberyard.

  2. Open Lumberyard Editor.

  3. In the Asset Browser, right-click the file that you imported, and choose Edit Settings.

  4. In the Fbx Settings window, on the Motions tab, choose Add Modifier, Motion range.

    Note

    If you do not see the Motion range modifier, be sure that your .fbx file has keyframes.

  5. Under Motion range, do the following:

    1. Set the Start frame to the frame that does not include the bind pose. For example, if the original actor's bind pose is on frame 0, set the Start frame to 1. This ensures that the bind pose does not play in your motion.

    2. Set the End frame to the last frame of your motion. Based on the example in the previous step, the last frame would be 100.

    3. Click Update.

      Note

      If you receive an error, check the number of keyframes in your motion, and update the End frame.

    The frame settings are shown in the following example:

    
                    Specify the motion range keyframe for your actor's motion in the Lumberyard
                        Animation Editor
  6. Repeat steps 1 to 5 for all of the motions that you want to retarget.

  7. In Lumberyard Editor, choose Tools, Animation Editor.

  8. In the Animation Editor, in the center pane, on the Anim Graph tab, open your animation graph.

  9. In the right pane, on the Attributes tab, select the Retarget check box.

    
                    Select the Retarget check box for your animation graph in the Lumberyard Animation Editor

    Note

    You can also toggle the retarget feature on the Motion, Blend Space 1D, and Blend Space 2D nodes.

  10. On the Anim Graph tab, save your animation graph.

  11. To now use your motions and animation graph on a different actor:

    1. In the Animation Editor, choose File, Open Actor, and select the actor to retarget.

    2. In the center pane, on the Motion Sets tab, open the motion set that has the motions that you previously modified.

    3. In the center pane, on the Anim Graph tab, open the animation graph that you previously saved.

    4. Verify that the actor with the retargeted motions and animation graph behave like the original actor.