# IrisVirtual

*IrisVirtual* is a feature allowing you to estimate the number of cameras your project might need, together with their location, orientation and lens type.

{% hint style="warning" %}
IrisVirtual is under development, so the features and capabilities will likely change in the upcoming releases.
{% endhint %}

## The process

1. Add as many Iris cameras into your viewport as you think you will need and place them as you think appropriate
2. Map the projection objects to these cameras
3. Run IrisVirtual which will tell you if your setup is likely to work.

{% hint style="warning" %}
Your projection object(s) need to be properly UV mapped in order for IrisVirtual to work.
{% endhint %}

Say, you want to perform a projection mapping on a cave-like projection mapping setup as shown below:

![The 3D model was kindly provided by Theoriz.](https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9sVaJpWJhPbmscipukhh%2Fuploads%2FCd2NorIWdwi3Kp6C4GBT%2FirisVirtual%20basic%20setup.png?alt=media\&token=d99c7106-7458-434f-9715-c6f4ab6f01cc)

{% hint style="warning" %}
Please make sure the resolution of your projection object is sufficiently high. As a rule, the individual pixel of the projection object should be the same or smaller size than the projected pixel. The latter depends on the resolution of the projectors and their distance and FOV from the projection object.
{% endhint %}

In the above setup, there are 8 projectors. With IrisVirtual you will be able to get an understanding of how many cameras you should need, which lenses you should choose and where you would need to place them

So to evaluate your planned setup, place Iris cameras in the Viewport and choose the lenses you want to run the evaluation for.

<div align="left"><img src="/files/Qn79HwwJMolpNvld7AeH" alt=""></div>

Then, open **Iris** window and select the **Iris camera(s)** and all 8 projectors.

<div align="left"><img src="/files/nJsev589oCDZhqpd9CPE" alt=""></div>

{% hint style="success" %}
Make sure **IrisVirtual** checkbox is selected
{% endhint %}

When you hit **Calibrate** button, the process will start

<div align="left"><img src="/files/p0a25Lgm91HMpORjR7Yq" alt=""></div>

If the result is successful, the ***Reprojection errors*** for all of the selected projectors will be below 0.

## Interpreting IrisVirtual results

IrisVirtual returns either a positive or a negative result and there are some caveats when interpreting them.

### **Negative IrisVirtual Results**

IrisVirtual can return 2 types of negative results: either reprojection error is above 1 px or the result says *“Insufficient number of points”.*

The causes can be different:

1. The camera does not see the entire projected area of the object
2. The area projected by any one projector is too small when viewed by the camera

{% hint style="info" %}
**Good to know:** if in doubt, feel free to contact us and send us your project so that we can have a look at it.
{% endhint %}

### Positive IrisVirtual Result

Positive result means that your Iris setup should work, however please see below:

{% hint style="warning" %}
There are cases when IrisVirtual returns a positive result (reprojection error below 1 px for all projectors) but in reality the setup most likely wouldn't work.

Before making a final decision, please send us your project file so that we can re-evaluate your planned Iris setup.
{% endhint %}


---

# 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/projection-mapping/iris/irisvirtual.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.
