# Map Input

There are various types of input maps that can be linked into various different objects.

Map Input can also be from external IO connections. These maps translate the incoming data from the IO connection into data that the object can use, for example, positional and rotational coordinates.

Available map inputs vary depending on the object type, therefore not all IO connections can be mapped into every object.

### How to add a Map Input

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

Under the Maps tab of an object, click on the (+) icon on the right hand side to bring up the list of avaiable sources for the object.

Depending on what IO connections are already added into the project the list of options will vary along with the object that you are trying to add a map input for.

IO connections such as OSC are node-based and must be connected to the object parameters within the board.

All Map Input have the option to add delays to the individual components of the data packet. This option is off by default.

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

| Name              | Description                                       |
| ----------------- | ------------------------------------------------- |
| Delay Position    | Delay the position data by x number of frames     |
| Delay Rotation    | Delay the rotation data by x number of frames     |
| Delay Custom Data | Delay all other custom data by x number of frames |

{% hint style="info" %}
If you do require this, you will need to enable this by clicking on the icon next to the Delay container
{% endhint %}

### **Simulated Map Inputs**

**In the situation where you do not yet have the signal source, but still would like to test the rest of the signal chain or the logic that you would want to build out, Grid Studio provides a few ways for you to simulate some data.**

**For a single point object, you can make use of the** [**Animator**](/grid/maps-input-and-output-with-filters/map-input/animator.md) **Map Input to animate a point moving around in 3D space.**

In the case where you like to have simulated data of a group of points moving around inside a volume, you can use the [Volume - Test](/grid/maps-input-and-output-with-filters/map-input/volume-test.md) Map Input.

### Object Specific Map Inputs

As mentioned before, depending on the type of IO connections that have been created in the project, different objects will have access to maps from different IO connections. For the specific details, please refer to the tables further down this page.

There are some other internal maps that are available for specific objects to help with creating a better / easier workflow.

* [Follow Object](/grid/maps-input-and-output-with-filters/map-input/follow-object.md)
* [Volume - Interpolated Point Data](/grid/maps-input-and-output-with-filters/map-input/volume-interpolated-point-data.md)
* [Volume - Point Data](/grid/maps-input-and-output-with-filters/map-input/volume-point-data.md)
* [Volume - Volume Points](/grid/maps-input-and-output-with-filters/map-input/volume-volume-points.md)

### IO Maps In

These are objects which are compatible with receiving data from specific IO connections.

### 2D Tracking

| 2D Tracking | **Tuio**                  | **Optitrack Camera**                     | **Sick LMS**             | **Blobtracking Client**  |
| ----------- | ------------------------- | ---------------------------------------- | ------------------------ | ------------------------ |
| Object      | <ul><li>Tracker</li></ul> | <ul><li>Tracker</li><li>Volume</li></ul> | <ul><li>Volume</li></ul> | <ul><li>Volume</li></ul> |

### 3D Tracking

| 3D Tracking | **Blacktrax (RTTrPM)**                          | **Open VR**                                                                                                                                                                                                                                                | **Kinexon**                                                                                                                                                                                                                          | **Optitrack (NatNet)**                     | **Optitrack (Motive API)**                 | **Pozyx**                                                                                                                                                                                                                                                                  | **Sewio**                                                                                                                                                                                                                                                  | **PosiStageNet IN**                                    |
| ----------- | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------ | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| Object      | <ul><li>Tracker</li><li>Laser Fixture</li></ul> | <ul><li>Tracker</li><li>Skeleton</li><li>Camera</li><li>Centroid</li><li>Volume</li><li>Moveable</li><li>Winch</li><li>Winch 3</li><li>Light Fixture</li><li>Laser Fixture</li><li>Pixel</li><li>Multipixel</li><li>PTZ Camera</li><li>Spotlight</li></ul> | <ul><li>Tracker</li><li>Skeleton</li><li>Camera</li><li>Centroid</li><li>Volume</li><li>Moveable</li><li>Winch</li><li>Winch 3</li><li>Light Fixture</li><li>Pixel</li><li>Multipixel</li><li>PTZ Camera</li><li>Spotlight</li></ul> | <ul><li>Tracker</li><li>Centroid</li></ul> | <ul><li>Tracker</li><li>Centroid</li></ul> | <ul><li>Tracker</li><li>Skeleton</li><li>Camera</li><li>Centroid</li><li>Volume</li><li>Moveable</li><li>Winch</li><li>Winch 2</li><li>Winch 3</li><li>Light Fixture</li><li>Laser Fixture</li><li>Pixel</li><li>Multipixel</li><li>PTZ Camera</li><li>Spotlight</li></ul> | <ul><li>Tracker</li><li>Skeleton</li><li>Camera</li><li>Centroid</li><li>Volume</li><li>Moveable</li><li>Winch</li><li>Winch 3</li><li>Light Fixture</li><li>Laser Fixture</li><li>Pixel</li><li>Multipixel</li><li>PTZ Camera</li><li>Spotlight</li></ul> | <ul><li>Tracker</li><li>Volume</li><li>Pixel</li></ul> |

### Camera Tracking

| Camera Tracking | **ARRI CAP**             | **FreeD UDP**            | **Star Tracker (Mo-Sys)**                | **Stype (Stype HF)**                     | **Technocrane**          | **Cmotion**              |
| --------------- | ------------------------ | ------------------------ | ---------------------------------------- | ---------------------------------------- | ------------------------ | ------------------------ |
| Object          | <ul><li>Camera</li></ul> | <ul><li>Camera</li></ul> | <ul><li>Tracker</li><li>Camera</li></ul> | <ul><li>Tracker</li><li>Camera</li></ul> | <ul><li>Camera</li></ul> | <ul><li>Camera</li></ul> |

### Kinectic & Sensors

| Kinectic & Sensors | **MoveCat**                                                              | **Phidget 1047-1**                        | **Phidget ENC1000**                       |
| ------------------ | ------------------------------------------------------------------------ | ----------------------------------------- | ----------------------------------------- |
| Object             | <ul><li>Tracker</li><li>Moveable</li><li>Winch</li><li>Winch 3</li></ul> | <ul><li>Camera</li><li>Moveable</li></ul> | <ul><li>Moveable</li><li>Camera</li></ul> |

### Protocol

| Protocol | **OSC**                               | **Artnet**                                                                                                                                                                                                                                                                                                 | **SPNet**                                                                                                                                                                                                                                                                     |
| -------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Object   | <ul><li>Volume</li><li>Area</li></ul> | <ul><li>Tracker</li><li>Skeleton</li><li>Camera</li><li>Rigid Body</li><li>Centroid</li><li>Volume</li><li>Moveable</li><li>Winch</li><li>Winch 2</li><li>Winch 3</li><li>Light Fixture</li><li>Laser Fixture</li><li>Pixel</li><li>Multipixel</li><li>PTZ Camera</li><li>Spotlight</li><li>Area</li></ul> | <ul><li>Tracker</li><li>Skeleton</li><li>Camera</li><li>Rigid Body</li><li>Centroid</li><li>Volume</li><li>Moveable</li><li>Winch</li><li>Winch 3</li><li>Light Fixture</li><li>Laser Fixture</li><li>Pixel</li><li>Multipixel</li><li>PTZ Camera</li><li>Spotlight</li></ul> |

### Skeleton

| Skeleton | **Kinect**                                                                                                                                                                                                                                                                                                 | **Perception Neuron**      | **Azure Kinect**                                                                                                                                                                                                                                                                              |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Objects  | <ul><li>Tracker</li><li>Skeleton</li><li>Camera</li><li>Rigid Body</li><li>Centroid</li><li>Volume</li><li>Moveable</li><li>Winch</li><li>Winch 2</li><li>Winch 3</li><li>Light Fixture</li><li>Laser Fixture</li><li>Pixel</li><li>Multipixel</li><li>PTZ Camera</li><li>Spotlight</li><li>Area</li></ul> | <ul><li>Skeleton</li></ul> | <ul><li>Tracker</li><li>Skeleton</li><li>Camera</li><li>Rigid Body</li><li>Centroid</li><li>Volume</li><li>Moveable</li><li>Winch</li><li>Winch 2</li><li>Winch 3</li><li>Light Fixture</li><li>Laser Fixture</li><li>Pixel</li><li>Multipixel</li><li>PTZ Camera</li><li>Spotlight</li></ul> |

### Controller

| Controller | **GamePad**                                                                                                                                                                                                                                                                                   | **Joystick**              | **3D Connecion**                         |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------- | ---------------------------------------- |
| Objects    | <ul><li>Tracker</li><li>Skeleton</li><li>Camera</li><li>Rigid Body</li><li>Centroid</li><li>Volume</li><li>Moveable</li><li>Winch</li><li>Winch 2</li><li>Winch 3</li><li>Light Fixture</li><li>Laser Fixture</li><li>Pixel</li><li>Multipixel</li><li>PTZ Camera</li><li>Spotlight</li></ul> | <ul><li>Tracker</li></ul> | <ul><li>Tracker</li><li>Camera</li></ul> |

### Interface

There are nodes within the board that also have mapping capabilities, below are the interface nodes and the compatible IO connections.

| Interface Type | **Reference**                                                                                                                                              | **Button**                                                                                              | **Slider**                                                                                                                                                                      | **Colour Field**                                                                                                                                                                            | **Controller**                                                                                                                                                                                                   |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| IO Connection  | <ul><li>Artnet</li><li>SPNet</li><li>OpenVR</li><li>Sewio</li><li>Kinexon</li><li>GamePad</li><li>Kinect</li><li>Disto</li><li>Perception Neuron</li></ul> | <ul><li>OSC</li><li>MIDI</li><li>Artnet</li><li>SPNet</li><li>PSN Out</li><li>Vertex Commands</li></ul> | <ul><li>Artnet</li><li>SPNet</li><li>OpenVR</li><li>Sewio</li><li>Kinexon</li><li>GamePad</li><li>Kinect</li><li>Azure Kinect</li><li>Disto</li><li>Perception Neuron</li></ul> | <ul><li>OSC</li><li>Artnet</li><li>SPNet</li><li>OpenVR</li><li>Sewio</li><li>Kinexon</li><li>GamePad</li><li>Kinect</li><li>Azure Kinect</li><li>Disto</li><li>Perception Neuron</li></ul> | <ul><li>OSC</li><li>Artnet</li><li>SPNet</li><li>OpenVR</li><li>Sewio</li><li>Kinexon</li><li>GamePad</li><li>3D Connexion</li><li>Kinect</li><li>Azure Kinect</li><li>Disto</li><li>Perception Neuron</li></ul> |


---

# 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://stage-precision.gitbook.io/grid/maps-input-and-output-with-filters/map-input.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.