Skip to content

Lens Tracking (FreeD)


This page details the options for setting up tracking through the FreeD protocol.

1. Tracking Protocol

This dock is accessible from the Capture step.

Possible values:

2. Distortion Source

Using a lens profile file is the only option with FreeD tracking, since the other lens parameters like focal length and sensor size need to be infered from the lens profile as well.

Press the button on the right, indicated by a folder icon, to browse and pick a lens profile:

If the file was successfully loaded, its name will be displayed at the left of the button:

3. Tracking Receiver

Warning

This assumes a tracking system has been configured on the camera to calibrate, and it currently sends FreeD data to the computer running EZlineup on a specific port.

3.1. IP

IP address of this computer. In most cases leave 0.0.0.0 (0.0.0.0 means "any IPv4 address at all"). If you want to make sure to only listen to the data on a specific network adapter, you can choose its IP instead from the list.

The IP list can be refreshed by clicking the refresh button, indicated by two arrows following each other.

3.2. Port

Port on which to receive FreeD messages. This is the port that should be given along with the true IP address of the computer running EZlineup (not 0.0.0.0) to the tracking apparatus.

3.3. Camera ID

There is a Camera ID in FreeD to identify multiple cameras sent on the same port. By default this is not filtered by EZlineup.

To activate Camera ID filtering, check the "Filter ID" box. You can then put the desired ID in the field on the left.

3.4. Start/Stop

Once IP, Port and filters have been configured, use this button to toggle the FreeD receiver. The fact that the button is green only indicates that the receiver is running, not that it is actually receiving messages. To check this, you can look at the tracking values on the right, which should move if you move the camera.

In addition to that, there is a Frequency indicator under the button. It gives an estimate of the frequency at which messafges are received. If no messages are received the frequency will be zero.

While receiving, the tracking UI will become greyed out. To unlock it, press "Stop Receiving".