# Camera Pose Estimation in VIOSO 7

In the [Align 3D](https://docs.vioso.com/calibration/content-mapping/3d-mapping) step, defining the camera’s precise position and orientation relative to the screen's 3D model is critical. Traditionally, this is a manual process requiring the input of exact coordinates for position and rotation angles.

**VIOSO 7** introduces an automated estimation process to streamline this setup. By utilizing the [markers generated during the Design](https://docs.vioso.com/start/project-mode/creating-markers) step, the software can calculate an initial camera pose.

**Preparation**

Before starting the estimation, ensure your camera parameters are accurately configured:

* **Camera Type**: Select the correct lens profile.
* **FOV**: Set the field of view.
* **Border PX**: Define any sensor cropping or active pixel areas.

Once configured, click the **Estimate Pose** button to open the estimation interface.

<figure><img src="https://3901153090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqQOJaA9kiXUCmPo5Lma3%2Fuploads%2FeUCtSkZcF6pXZIu4g9BW%2Fimage.png?alt=media&#x26;token=6255c95e-e837-409c-b0bf-20a4c515922d" alt=""><figcaption></figcaption></figure>

This opens Pose estimation dialogue:&#x20;

<figure><img src="https://3901153090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqQOJaA9kiXUCmPo5Lma3%2Fuploads%2FAQZjyL6XCFbomrVgh12U%2Fimage.png?alt=media&#x26;token=afb13d3d-15f3-4d27-9f4a-1260961cc3ea" alt=""><figcaption></figcaption></figure>

#### Marker Management

* **Point list**: Displays all available markers. The Use column indicates if a point is active in the current calculation. Double-clicking a description allows for renaming.
* **Add Point**: Manually creates a new marker by entering specific 3D $$X,Y,Z$$ coordinates.
* **Change Point**: Allows you to edit the 3D coordinates of the currently selected marker if its digital position in the model needs adjustment.
* **Delete Points**: Removes the selected marker(s) from the list.
* **Save to / Load from**: Exports or imports the current marker configuration (positions and names) to a file.
* Start Point Picker: Switches back to the "Show Model" view to visually select or generate new markers directly from the 3D geometry.

#### Step 1: Rough Marker Placement

Using your mouse, drag the digital markers over the camera screenshot to match their physical locations on the screen from the camera's perspective.

* During this stage, markers will also be projected onto the real screen by the projector.
* Aim for a rough visual match to align the digital model's points with the physical surface.

#### Step 2: Precise Marker  Alignment

To achieve a valid calculation, the markers must be placed with higher precision:

1. Select a marker in the interface.
2. Use the keyboard arrow keys for fine adjustments.
3. Observe the real projected screen; the projected marker should sit exactly on the corresponding feature of the physical screen.

<figure><img src="https://3901153090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqQOJaA9kiXUCmPo5Lma3%2Fuploads%2FsaFFgDuZrQLkfzxGmcQ1%2Fimage.png?alt=media&#x26;token=f7db23e7-8743-4a0b-9a80-6d74d3ace6d7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3901153090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqQOJaA9kiXUCmPo5Lma3%2Fuploads%2FFttyhPLYuCjyCrOHnL56%2Fimage.png?alt=media&#x26;token=55aacdf1-482e-4ff5-a765-0b955a39768b" alt=""><figcaption></figcaption></figure>

* **Test Current Configuration**: Press to test current marker placement. The software will provide an Error Value. For a successful pose, the error should ideally not exceed a few pixels.

<figure><img src="https://3901153090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqQOJaA9kiXUCmPo5Lma3%2Fuploads%2FR8PlKBAeWX1nLugchQEa%2Fimage.png?alt=media&#x26;token=e5669df6-3a64-4168-8aea-1e328db341d8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3901153090-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqQOJaA9kiXUCmPo5Lma3%2Fuploads%2F640XadxviSxmY4oBTzUp%2Fimage.png?alt=media&#x26;token=91510243-b185-4994-9abd-82dc5be065b0" alt=""><figcaption></figcaption></figure>

* **Estimate**: Finalizes the calculation. This button automatically updates the camera's position and orientation in the 3D space based on the marker alignment.
* **Close**: Exits the dialogue

**Note**: Since automatically generated markers are based on the 3D model rather than precisely measured positions of the physical space, this tool provides a only initial pose estimation. Some final manual fine-tuning of the coordinates may still be required to achieve perfect alignment.
