Retargeting Sidebar

3D Viewport -> Retargeting Sidebar

Additional controls and tools for the Animation Retargeting addon. 2.1.0 or later must be installed to see these controls

Sections:

• Add Bone Mapping
• Rest Position Adjustments

---

Add Bone Mapping

Displayed when entering 'Bone Mapping Mode' in the animation retargeting addon.

Sections:

• Mapping Controls
• Add Mapping by Bone Type

---

Mapping Controls

Used for additional control while updating/adding bone mappings from source armature to target armature

Controls:

• Active bone name: Will display the bone name AND if this bone name exists on the metadata dictionary, will display a description of the bone as well in English.
• Set as Target: Set the target bone based on what is the 'active' bone on the viewport
• Target bone name: Click on it to set this bone as the active bone in the viewport (useful if all the bones are in Japanese and it's hard to know visually which bone is actually mapped)
• Find source bone: Click on it to automatically find the source bone (based on what is on the target bone field). Uses the metadata dictionary to find a bone names on the same row
• Source bone name: Click on it to set this bone as the active bone in the viewport (useful if all the bones are in Japanese and it's hard to know visually which bone is actually mapped)
• Clear The Mapping List: Wipes the entire mapping list.

Video:

2023-11-30.16-46-10.mp4

---

Add Mapping by Bone Type

Used to bulk add bone mappings. Leverages the metadata dictionary to find a matching bone between the source armature and target armature.

'All' will look for any matching bone on the metadata dictionary on the same row, but the other groups are based on the 'animation_retargeting_group' column for bone names on the same row in the metadata dictionary.

Video:

2023-11-29.15-27-24.mp4

---

Rest Position Adjustments

Sections:

• Reset Armature Pose
• Apply Rotation to Target

---

Reset Armature Pose

Resets the source or target armature to the original rest pose.

---

Apply Rotation to Target

Will look for source bones and target bones of the same name on the metadata dictionary, and if found on the same row, will apply a copy rotation modifier to the target armature's bones, as well as set the bone roll to match the source armature's bone roll. Used for automating the the rest pose position in Animation Retargeting Addon.

Controls:

• Upper Arms:

  • looks for equivalent of 'arm_L/R' bones on source armature.
  • Also copies source armature's bone roll from the parent bone to target armature's parent bone to prevent any copy rotation issues.

• Forearms:

  • looks for equivalent of 'elbow_L/R' bones on source armature.

• Wrists:

  • looks for equivalent of 'wrist_L/R' bones on source armature.

• Hands:

  • looks for equivalent of 'thumb1_L/R','thumb2_L/R','fore1_L/R','fore2_L/R','fore3_L/R','middle1_L/R','middle2_L/R','middle3_L/R','third1_L/R','third2_L/R','third3_L/R','little1_L/R','little2_L/R','little3_L/R' bones on source armature.

• Upper Legs:

  • looks for equivalent of 'leg_L/R' bones on source armature.
  • Also copies source armature's bone roll from the parent bone to target armature's parent bone to prevent any copy rotation issues.

• Lower Legs:

  • looks for equivalent of 'knee_L/R','knee_2_L/R' on the source armature.
  • Special handling for this because most source MMD models do not have a knee_2_L/R, so if that occurs, it will reset target armature's knee_2_L/R back to rest position.

• Feet:

  • looks for equivalent of 'ankle_L/R' bones on source armature.

• Toe:

  • looks for equivalent of 'toe_L/R' bones on source armature.

• Reset bone on Target Armature if Source Bone not found: If checked, does exactly what it says upon pressing any of the above buttons.

Video:

2023-11-29.15-28-42.mp4