Camera Alignment

Correct perspective and wide-angle lens distortion by matching camera-image points to workspace coordinates.

The Camera Alignment dialog solves a corrected image warp from camera pixels to workspace coordinates. A saved alignment positions the corrected still-image overlay and takes precedence over Camera Mapping.

Four points correct perspective. Six or more well-spread points allow the solver to estimate radial lens distortion, which is why the 9-point layout is recommended. The workflow does not correct mirroring.

When it opens

Camera panel → Align Camera.

What you see

The latest captured frame, when available, with markers for each point.
Layout buttons for Quick setup (4 points) and Wide-angle setup (9 points, recommended).
9 initial point-pair rows.
A radio button that selects which point is edited by clicking the image.
Camera X / Y for image pixels.
Workspace X / Y in the current display unit.
After solving: Quality, RMSE, Scale, Rotation, and Translation.

Buttons

Add Point: add another pair.
Remove: remove a row when more than 3 rows exist.
Solve: compute a result from the current pairs.
Save Alignment: persist the most recently solved result.
Reset Saved: clear the alignment saved on the active profile.
Close: dismiss the dialog.

Workflow

Choose the 4-point or 9-point layout.
Select a point row.
Click the matching physical feature in the captured image to fill Camera X/Y.
Enter the feature's known Workspace X/Y position.
Repeat for every point in the layout.
Click Solve, review the result, then click Save Alignment.

At least 4 point pairs are required. Camera points and workspace points must stay inside their respective bounds and span a non-zero area. Editing, adding, or removing a point invalidates the solved result, so solve again before saving.

Notes

The 4-point layout uses positions near the frame and workspace corners. It corrects perspective but cannot measure lens curvature by itself.
The recommended 9-point layout uses a 3 by 3 grid across the frame and workspace. Replace every starting value with the real corresponding point for accurate correction.
Workspace coordinates are converted correctly for top-left and bottom-left machine origins.
Changing the camera or capture resolution invalidates alignment data that no longer matches.
Lower RMSE means the point pairs agree more closely. Verify against known physical positions before running a job.
Manual overlay adjustment remains available after corrected alignment is saved.