=============
Pose Manager
=============

.. codeauthor:: Jeremy Ernst

Overview
--------

The pose manager is meant for users who may need to repose their model in order to have a better pose for rigging.
For example, in the image below, we have a mesh that is modeled in a pose where the feet are not planted.
This isn't ideal for rigging and animation.


.. image:: /images/pose_manager_model.png


Using the pose manager, we can store this "model" pose, and create a new "rig" pose, and freely switch between them.
This way, when we build our deformation skeleton, we'll build it in the rig pose, so the rotations are nice and clean,
but then we can set it to the model pose, so that the skeleton lines up with the mesh for doing deformations.

.. image:: /images/pose_manager_overview.gif


Right-clicking on a pose will bring up a context menu that allows you to remove the pose.

.. image:: /images/pose_manager_remove.png


This diagram shows the workflow intended with the pose manager. In the section below, we'll go through the process step
by step.

.. image:: /images/pose_manager_diagram.png

Usage
-----

Using the above example, we have a mesh that was modeled in a pose like this:

.. image:: /images/pose_manager_model.png

We place our components in this pose, but we don't really want to build our rig in this pose, so using the pose manager,
we can store our model pose by opening the interface, and clicking the bottom button to store the pose. Give the pose a
name, like "model".

.. image:: /images/pose_manager_modelpose.gif

Now, let's re-pose our components so that the legs are straight and the bends in the arms are removed (for example).

.. image:: /images/pose_manager_rigpose.png

Using the pose manager, we can now store this as a pose. I'll call it "rig".

.. image:: /images/pose_manager_rigpose.gif

Now, when we build the skeleton, I'll use the pose manager to set the pose to the rig pose. This way, our skeleton is
built in this pose, which is the pose we want our rig to be built in. By building in this pose, we ensure the
rotation values are clean and zeroed out.

.. image:: /images/pose_manager_buildskeleton.gif

Now we can use the pose manager to set the pose back to "model", so our skeleton fits the mesh again, and do our
deformations.

.. image:: /images/pose_manager_deform.gif

When we go to build the rig, we'll want to set the pose back to the "rig" pose.