# Retargeting with HEAT

## PREPARING YOUR RIGGED CHARACTER

{% hint style="warning" %}
For successful retargeting from HEAT your character's **Rest Pose** must be in a **T-Pose**.
{% endhint %}

* Begin by checking your characters rest pose by selecting the armature of your character and opening the '**Armature Data**' tab (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FmdV6X48ZNYLWhIVYBskW%2Fimage.png?alt=media&#x26;token=88773645-6176-453f-800c-c15219115fd7" alt="" data-size="line">) in the properties window along the right side of the screen.  Next click the '**Rest Position**' button at the top of the window.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FBiqn5TV8J62o5vSsR0Sf%2Fimage.png?alt=media&#x26;token=ddcf4701-81c3-42f6-8459-1de7334eb269" alt=""><figcaption><p>Rest Position pose selector</p></figcaption></figure>

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FztylV7bMDXmw9odHOC2n%2Fimage.png?alt=media&#x26;token=50c3a97f-ed32-4e63-934c-00146bdaf457" alt="" width="563"><figcaption><p>Character with Rest Position set in A-Pose will need adjustment</p></figcaption></figure>

* If your characters '**Rest Position**' is not in a T-Pose follow these steps to adjust it:
  1. Select your characters armature.
  2. In the upper left hand corner of the 3D viewer change the '**Object Interaction Mode**' to '**Pose Mode**'
  3. In the armature data panel switch the back to '**Pose Position**' from rest position.
  4. Adjust your characters pose to be in a T-Pose by selecting the upper arm or shoulder bones and rotating them until the pose is correct.  If you need more help with posing we recommend reading the [Blender documentation for more information](https://docs.blender.org/manual/en/latest/animation/armatures/posing/index.html).
  5. Once your rigged character is in T-Pose select the '**Pose to Rest**' button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FBaGwaPKeLRQsrf5qZYdh%2Fimage.png?alt=media&#x26;token=7c329a93-1879-4546-a3a8-8240eecea630" alt="" data-size="line">) in the HeatTools Armature pane of the heat sidebar menu.  Make sure you are still have the armature selected and are still in pose mode.
  6. You're current pose position will now be set as the '**Rest Position**' and you are ready to retarget!

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FUwe0Zip6dR85UzB099Gu%2Fblender-demo-posetorest.gif?alt=media&#x26;token=81f39b27-1d13-438c-9eaa-97f9e87c0513" alt=""><figcaption><p>Example of applying pose position to rest pose using HEAT</p></figcaption></figure>

## RETARGETING TO YOUR RIGGED CHARACTER

{% hint style="warning" %}
Please follow above section to make sure your rigged character is in T-Pose before retargeting with HEAT.  Retargeting will not come out as expected if the character is not in T-Pose.
{% endhint %}

* Make sure you have a HEAT armature in your scene that has a HEAT animation applied to it.
* Open the '**Heat Retargeting**' pane (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FjpmFW0xKGE3nTxL7I8Vd%2Fimage.png?alt=media&#x26;token=34ecb648-d044-413e-9d0a-286de307234d" alt="" data-size="line">) of the HeatTools sidebar menu.
* In the Heat Retargeting pane click the eyedropper in the '**Source**' section (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FxA4YYG9stPradcDDurs6%2Fimage.png?alt=media&#x26;token=7487cbb7-186e-4ab8-a19d-e27962c353f0" alt="" data-size="line">) and select the HEAT armature in either the 3D viewport or in the Scene collection window.
* Now click the eyedropper in the '**Target**' section (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FURd2fymM1VPrjcI4MVIr%2Fimage.png?alt=media&#x26;token=27d6eee0-506b-497d-827b-b07a8f6f3abd" alt="" data-size="original">) and select your rigged characters armature.
* With both armatures properly in the '**Source**' and '**Target**' fields click the '**Build Bone List**' button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FneATi1lmMNoTLNkFnTbD%2Fimage.png?alt=media&#x26;token=6e035e99-0217-4af9-a59f-d7685eec8dba" alt="" data-size="line">).
* The bone list will appear and HEAT will attempt to match all of the HEAT bones to your rigged characters bones.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FfSUom4WJRrXR9mqqdBdT%2Fimage.png?alt=media&#x26;token=e80e680d-2103-4223-b15f-80996670522a" alt=""><figcaption><p>HEAT Retargeting bone list</p></figcaption></figure>

* Look through the bone list and ensure that all of the HEAT bones are matched to the correct corresponding bones.  If any bones are missing or not properly paired click the bone field  (![](https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2Ff3bUB32hOr1z9U7U870j%2Fimage.png?alt=media\&token=eb28f3f8-9498-4131-ad1b-0d5f914ab64e)) and select the correct bone.
* Once the bone list looks correct click the '**Retarget Animation**' button (<img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FgdjJlf0shxB1ILRQB5Zw%2Fimage.png?alt=media&#x26;token=bb45a6c6-6257-4575-b9ad-8629c84f2bd6" alt="" data-size="line">).
* Play your animation and you should see your own rigged character now performing the same movement as the HEAT armature.

<figure><img src="https://3615087246-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FayEAytwtGUY9ZVsFfLoQ%2Fuploads%2FBBwwQNQX3rwSNcbslB4D%2Fblender-demo-retarget.gif?alt=media&#x26;token=81ad760d-3fca-423e-9f6c-143f31d15c7a" alt=""><figcaption><p>Retargeting process using HEAT</p></figcaption></figure>

{% hint style="warning" %}
When retargeting it is best to keep your custom character zeroed out in the 3D viewer in the same space as the HEAT armature.  This will ensure that the retargeted animation on your character has the same origin point as the source animation.
{% endhint %}

Next we will go over binding a HEAT armature to your own custom character mesh.
