# LightTrack

{% embed url="<https://www.youtube.com/watch?v=cYJzlceCqjc>" %}

Lightrack is a markerless tracking for interactive installations and events. It tracks by using various types of depth cameras installed on a ceiling. The system works in dark or bright spaces and both indoors and outdoors. It is also fully integrated into LightAct. This means you can track and output using the same software.

## Tracking modes

LighTrack has two tracking modes:

* **Simulation** and
* **LightTrack live**.

<div align="center"><figure><img src="/files/xB6V3yxRuF6e4KEM72tW" alt="" width="398"><figcaption></figcaption></figure></div>

### Simulation

Simulation tracking mode is used for simulating your camera positioning in the space you want to track people. It tracks the *People* objects. It doesn't require special hardware and can be used with the free LightAct license.

<figure><img src="/files/9xNWryhHl74sOZaOzeaT" alt=""><figcaption></figcaption></figure>

To use Simulation tracking mode add a LightTrack sensor and a LightTrack system objects to the Viewport. In the *LightTrack system* properties under *Sources* add the available sensors to selection by double-clicking on them. Change the position of the *LightTrack sensor* to above a *People* object. Now click **Start** in the *LightTrack system* properties.

### LightTrack live

LightTrack tracking mode is used for real-time tracking, rendering, and outputting. It tracks physical people in a physical space. It requires a paid LightAct license and hardware like depth cameras and projectors.

[Here](https://youtu.be/cYJzlceCqjc?feature=shared) you can see how it works.

To enable LighTrack live add an OAK receiver node in *Devices* window. In the *Viewport* window add a LightTrack sensor and choose *OAK camera* as a source. Add a LighTrack system as well and choose *LightTrack sensor* as a source.

To start tracking click **Start** in the LightTrack system properties window.

<figure><img src="/files/6LGBRx5jrNdjRDqsBGXc" alt="" width="491"><figcaption></figcaption></figure>

For using data from the LightTrack system you can use **Get LightTrack data** node in Layer Layout.

<figure><img src="/files/uEmXT3UcryrJ7acSMqz8" alt=""><figcaption></figcaption></figure>

## LightTrack viewport objects

### LightTrack system

LightTrack system is a viewport object that aggregates data from sensors.

To use it drag it from the *Side bar* to the *Viewport* and select it to open the *Properties window*. You can choose to use LightTrack system in[ Simulate](#simulation) or [LighTrack](#lighttrack-live) mode.

<figure><img src="/files/mr7j63BV8tJsOtC8j7NP" alt="" width="356"><figcaption></figcaption></figure>

### LightTrack sensor

Similarly, LightTrack sensor is a viewport object that reads data from devices like OAK camera. Place it in the Viewport so that it mimics the physical space. In its properties window you can select a device as a source and adjust different settings like FOV to match the camera you have.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.lightact.com/lighttrack/lighttrack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.