# How to setup a tracker

The tracker is a feature of Blinderkitten that allows you to direct the moving heads in your project to a precise point, defined by three-dimensional coordinates.

For the tracker to calculate the necessary pan and tilt values, you must provide the following data:

* Minimum and maximum pan angles in the fixture type
* Minimum and maximum tilt angles in the fixture type
* Position and rotation for each fixture

To find and define the minimum and maximum PAN angles of your moving head, we will use one of these fixtures, patched in Blinderkitten, mounted upside down, and without rotation.

We'll define a lot of values with custom <kbd>names</kbd> during this setup, feel free to take a paper and pen or a notepad to write down these informations.

### Step 1 : Set up the pan physical range

<figure><img src="https://299662507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw59sww6VHZX6Ff8CcfcH%2Fuploads%2F85YcwQgeiD0lDT8imzmT%2Fimage.png?alt=media&#x26;token=7875e4e8-00b6-4857-b3ef-f70d26c2612d" alt=""><figcaption></figcaption></figure>

To setup the pan angle, we need to find some informations, then, we'll be able to calculate the range.

* Turn on the dimmer of your fixture, and set its pan channel to 0, the tilt channel shoud be set to a value superior to 0.5 and the beam should be parralel to the ground.
* the beam should now be pointing to a direction, please use the pan angle reference image above to check what is the angle of the beam. We'll call this angle <kbd>min angle</kbd>.
* when you **increase** the value of your pan channel, viewed **from above**  the beam should turn clockwise or anticlockwise. We'll call this <kbd>direction</kbd>.
* increase again the value of you pan channel until it is at full, your beam should have make multiple turns (often one and a half), we'll call that <kbd>turns</kbd>.

You must have these three informations before continuing : <kbd>min angle</kbd>, <kbd>direction</kbd> and <kbd>turns</kbd>.

* convert your number of turns in degrees (if one turn : 360, one and a half : 540, two turns : 720..), we'll call this value <kbd>pan range</kbd>.&#x20;
* we'll calculate now <kbd>max angle</kbd> : &#x20;
  * if direction is clockwise, <kbd>max angle</kbd> equals to <kbd>min angle</kbd>+ <kbd>range</kbd>.
  * if directions is anti-clockwise, <kbd>max angle</kbd> equals to <kbd>min angle</kbd> - <kbd>range</kbd>  the value can be less than 0.
* You must adjust <kbd>min angle</kbd> and <kbd>max angle</kbd> in order to have one value above 0 and one value below 0 by adding or removing 360 **to both values at the same time**. No value should be 0 !

We can now fill the values we calculated in the physical range of our fixture type :&#x20;

<figure><img src="https://299662507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw59sww6VHZX6Ff8CcfcH%2Fuploads%2FdQ13Wr61eVAt9FRxbXMu%2Fimage.png?alt=media&#x26;token=a7bcf501-890c-4ab3-bff4-55c129b7a5f1" alt=""><figcaption></figcaption></figure>

### Step 2 :  Define the tilt range

<figure><img src="https://299662507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw59sww6VHZX6Ff8CcfcH%2Fuploads%2FTCNSN7qi3Qw7G8GJkz52%2Fimage.png?alt=media&#x26;token=7f8d1907-6e53-4c69-9675-3e7db0b942e1" alt=""><figcaption></figcaption></figure>

Now, you need to find your <kbd>tilt angle</kbd> by measuring it, or check in your fixture's manual, it should be half the range given in most manuals.

You can now set <kbd>- tilt angle</kbd> and <kbd>tilt angle</kbd> in the physical range of the tilt channel of your fixture type

<figure><img src="https://299662507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw59sww6VHZX6Ff8CcfcH%2Fuploads%2FsGKxptrxCfdiSemKVAKb%2Fimage.png?alt=media&#x26;token=46b93df6-f7da-4077-b5e7-e6bd025e344d" alt=""><figcaption></figcaption></figure>

Your fixture type is now usable by trackers :)

### Step 3 : position your fixtures

Now that your fixture type is properly configured, you must set the coordinates of your fixtures in the inspector. You must select your fixture in a list or edit it from the grid.

You must specify position and rotation (if rotated) for X, Y, Z axes. Axes are defined here : [coordinate-system](https://norbertrostaing.gitbook.io/blinderkitten/annexes/coordinate-system "mention").

<figure><img src="https://299662507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw59sww6VHZX6Ff8CcfcH%2Fuploads%2FgGmQ6vk6vH6bkztoK9mT%2Fimage.png?alt=media&#x26;token=3c4ad56b-5ef6-420e-b13e-91cfc4583c7d" alt=""><figcaption></figcaption></figure>

Be careful to use the same unit system you will use in your tracker and you layout if you want to use them together !

Please also consider wich axis you use when rotating, rotate 180° for example has a different result for each axis !

<figure><img src="https://299662507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fw59sww6VHZX6Ff8CcfcH%2Fuploads%2FB2IFnyJkpxuWUYtKhLy1%2Fimage.png?alt=media&#x26;token=4ce97385-e4fd-46b4-8c07-1a8c6acb5c14" alt=""><figcaption></figcaption></figure>

Positions and rotations should be imported when you're importinjg a MVR file.

You should now be able to use your trackers :)
