# Configure Cameras

Camera objects define how the Camera Coverage & Overlap Analysis evaluates the tracking volume.

Each camera should be positioned and configured to match the intended real-world setup as closely as possible. The analysis uses the camera position, rotation, field of view, focus distance, and focus range to calculate the voxel result.

{% hint style="info" %}
The Camera Coverage & Overlap Analysis is not limited to standard Camera objects. Other camera-based objects, such as sensor camera objects or OptiTrack cameras, can also be used if they provide the required camera parameters for the analysis.
{% endhint %}

### Open the Camera Settings

Select a camera object in the **Project Tree**.

The camera parameters are shown in the **Inspector**. Open the **Camera** tab to configure the settings used by the analysis.

***

### Position and Rotation

Use the **Coordinates** tab to place and rotate the camera in the 3D scene.

The position and rotation should match the planned or existing physical camera position. Incorrect camera transforms will directly affect the coverage result.

***

### Field of View

In the **Camera** tab, set the **Field of View** to match the real camera lens or the planned lens setup.

<div align="left"><figure><img src="/files/FGNa1peXgkBO6xYzX909" alt="" width="493"><figcaption></figcaption></figure></div>

The Field of View defines the visible area of the camera and is used to determine which parts of the analysis volume can be seen by each camera.

***

### Aspect Ratio

If the camera aspect ratio needs to be changed, open the **Panel** section inside the **Camera** tab.

<div align="left"><figure><img src="/files/Hw8zlfAwxNyKle5XJ3gm" alt="" width="493"><figcaption></figcaption></figure></div>

The aspect settings are located there.

***

### Focus Distance and Focus Range

The analysis uses the camera **Focus Distance** and **Focus Range** to calculate the usable coverage area.

<div align="left"><figure><img src="/files/6WOUTHC5Qk49peXEBLh2" alt="" width="493"><figcaption></figcaption></figure></div>

**Focus Distance** defines the focus point of the camera.\
**Focus Range** defines the depth range around that focus point that is considered usable.

{% hint style="warning" %}
The default Focus Distance is **50 m**. If the Focus Distance and Focus Range are outside the Camera Analysis volume, the analyzer may not show a result.
{% endhint %}

Make sure that the focus area intersects with the analysis volume before calculating the result. This is especially important when using the **Out of Focus** analysis mode.

***

### Camera Setup Checklist

Before continuing, make sure that:

* Each camera is placed at the correct position in the 3D scene.
* Each camera is rotated toward the intended tracking area.
* The Field of View matches the real or planned camera setup.
* The aspect ratio is configured if required.
* The Focus Distance is inside or near the analysis volume.
* The Focus Range covers the relevant tracking area and is set to a realistic value for the physical camera setup.

***

### Tip: Adjust the Camera Viewport Display

<div align="left"><figure><img src="/files/qIsGpzhRSLFk2KnYQsJH" alt="" width="563"><figcaption></figcaption></figure></div>

The camera object can be displayed in different ways inside the 3D viewport. These settings are useful when setting up cameras for Camera Coverage & Overlap Analysis, because they help visualize the camera direction, frustum, and focus area.

Select a camera and open the **Camera** tab in the **Inspector**. In the **Frustum** section, you can adjust how the camera is shown in the viewport.

Useful settings include:

* **Frustum Length**: Defines how long the camera frustum is displayed in the viewport.
* **Frustum Source**: Defines what drives the displayed frustum length, for example a custom length or the camera focus distance.
* **Display Type**: Defines the visual representation of the camera in the viewport, such as camera, pyramid, or line display.
* **Display Frustum**: Shows or hides the camera frustum.
* **Display Targetline**: Shows or hides the line from the camera toward the target or focus direction.

These display settings can make it easier to position cameras, check their direction, and understand how the focus distance and focus range relate to the analysis volume.

{% hint style="info" %}
The viewport display settings are mainly visual helpers. Make sure the actual camera parameters, such as Field of View, Focus Distance, and Focus Range, are also configured correctly for the analysis
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/camera-analysis/using-camera-analysis/configure-cameras.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.
