Camera Alignment

The Camera Alignment dialog computes the affine transform between camera pixels and workspace millimeters. You give it 2+ matched point pairs (camera location + real-world location) and it solves the transform.

After alignment, the camera overlay sits in the right place over the canvas.

When it opens

Camera panel → Align Camera. Or Device Settings → Camera area.

What you see

• Top: a list of point-pair rows. Each has Camera X, Camera Y (pixels), Workspace X, Workspace Y (mm).
• A solved-metrics summary appears below once Solve runs successfully: Quality (%), RMSE (mm), Scale, Rotation (deg), Translation (mm).

Buttons

• Add Point: add a new row.
• Solve: compute the transform from the current points. Requires at least 2 valid rows.
• Save Alignment: persist the solved alignment to the active machine profile.
• Reset Saved: clear the saved alignment.
• Close: dismiss the dialog.

Each row above the minimum (3+ total) has a remove button.

Workflow

1. Place a feature on the bed that you can locate both in the camera image and on the workspace (e.g. fiducial marker, known machine feature).
2. Add Point.
3. Enter the feature's pixel location in the camera image (Camera X / Y).
4. Enter the feature's workspace location in mm (Workspace X / Y).
5. Repeat for at least 2 points. More points improve accuracy.
6. Solve.
7. Check the Quality percentage. Higher is better.
8. Save Alignment to persist.

Notes

• 2 points is the minimum but produces a fragile alignment. 4+ points spread around the workspace give better results.
• If Solve fails, the points are likely inconsistent (typo in coordinates, or feature misidentified in one of the images).
• Reset Saved does not clear the dialog's current points, it clears what is saved to the profile.

Related

• Camera Calibration: for lens distortion, do this first
• Camera panel
• Align overlay guide
• Camera troubleshooting