The target armature is the rig in the Blender files which receives the animation. The BVH
Retargeter recognizes a number of known target rigs, defined by json
files located in the target_rigs directory. When the add-on is first
enabled, the Target Armature panel consists of a single button:
- Init Target Panel: Read in all json files in the target_rigs directory. This button also initializes the json files in the t_poses directory. Several other buttons automatically initializes the target panel.
After initialization, the panel looks like this:
- Reinit Target Panel: Reread in all json files in the target_rigs directory.
- Target Rig: The currently selected target rig.
- T-Pose Target: The currently selected target T-pose.
- Include Fingers: Include finger bones when identifying the target rig.
- Ignore Hidden Layers: Don't retarget animations to bones on hidden bone layers.
- Reverse Hip: The target rig has a reverse hip setup
- Identify Target Rig: Automatically detect the rig type of the active armature.
- Verify Target Rig: Verify that the active armature matches the selected rig type.
- List Target Rig: Display the identification of the source rig bones.
- Put In T-pose (Target): Sets the active armature in the reference T-pose.
The Target Rig drop-down list. Automatic means that bones are identified
automatically, by looking at the bone hierarchy and bone locations in the reference T-pose.
The T-Pose Target drop-down list. If the target armature has a reasonable rest pose, the target T-pose should be set to Default. However, if we for some reason want to retarget an animation to an armature with a strange rest pose, we could specify that T-pose here. In that case the target rig could be set to Automatic, because bone identification takes place when the armature is in the reference T-pose.
It is rather common that an armature has a reverse
hip. In a normal hip setup, the armature root is the hip or pelvis bone,
and the thighs and the rest of the spine are children of this bone. In a
reverse hip setup, the first bone in the spine has been reversed. There
is a separate root bone, and the two lowest bones in the spine are both
children of thise root, whereas the thighs are children of the reversed
hip.
The
advantage of such a setup is that the upper and lower body can be posed
independently. However, the BVH Retargeter fails to identify the
bones, unless the Reverse Hip option has been enabled.
Identify Target Rig checks the known target rigs (define by json files in the target_rigs directory) to find a rig type that matches the bone names. The Target Rig field is change to Genesis 3,8. The T-Pose field is currently not changed in any case, but it may happen if a target rig type is uniquely associated with a specific T-pose.
Verify Target Rig checks that the bone names matches the bones of the target rig type specified above. If this is not the case an error message is displayed.
List Target Rig displays a pop-up menu with the bone identifications.
Put In T-pose (Target) puts the armature in the reference T-pose, which is used to identify the
difference between the roll angles of the source and target armatures.
