.. _driven-panel:

Driven Target Panel
++++++++++++++++++++++++++++

This Panel Shows the List of Driven Target Item by the Active Controller in the :ref:`Controller Driver Panel <driver-panel>`

.. image:: /static/DrivenPanel.webp


List Item
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Refer to :ref:`Driven Target List Item <driven-list-item>`

.. _load-driven:

Load Driven
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Loads Selected Objects as Driven Targets, This can be both Bones and Objects

Target Properties
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Shows the Propertes of this Driven Target Item

.. image:: /static/TargetProperties.webp

Object
~~~~~~~~~

The Driven Target Object that will be controlled

Bone Name
~~~~~~~~~

The Driven Target Bone Name that will be controlled

Master Action / Override Action
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This will Show the Action the Addon will Record the movement in 

By Default It will use the Constraint Action Displayed on top of the addon

You can Choose to Override with your Own Action and the Addon will use that instead

Important: If no Override Action is used, it will automatically uses Master Action

Action Slot Identifier
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This is the Action Slot name that the addon will record the movement to, This is Stored as String


Constraint Name
~~~~~~~~~~~~~~~~~

The Exact String that the addon use to find the correct constraints

if the Constraint is not found, it will create a new one using the controller constraint name

This has a separate Constraint name to prevent duplicated constraint name being missed out (To Capture Constraint name with .001 for example)

Constraint Toggle 
~~~~~~~~~~~~~~~~~~~

Mute / Unmute the Action Constraint

.. note::

   When Driven Target is an Object instead of Bone, the pivot point of the object will be at the center of the scene, this might not be desirable, this is a :ref:`object-origin-limitation`

   To compensate for this, if you Disable the action constraint, it will bring its pivot point back


Enabled
#########

Upon Enabled, it will set all the related objects or bone to rest pose, this is to prevent double transformation from the action constraint

Disabled
#########

Upon Disabled, it will move the object to the position of the keyframes, so that you can continue keying your object

Create Constraint 
####################

If the Target Items's constraint is not yet created, this button will present itself as create constraint, it is basicly just :ref:`update constraints <update-constraints>`



.. _set-driven-key:

Set Driven Key
~~~~~~~~~~~~~~~~~~~

Internally will run :ref:`Update Constraints <update-constraints>` to set up the constraints and actions, and then it will set the key based on the current position of the object

This Operator works both when the constraint is enabled or disabled

.. note::

  It is adviced to only keep only one action constraints on at once when using set driven key for it to be more predictable


.. _update-constraints:

Update Constraints
~~~~~~~~~~~~~~~~~~~

This Operator will update the constraint Properties

It will also create constraints if is not already exist, as well as relevant actions if not exist