Beam Bench Docs

Camera Mapping

Fit camera pixels to known reference coordinates with a similarity transform.

The Camera Mapping dialog solves a uniform scale, rotation, and translation from image pixels to known reference coordinates. The saved mapping can position the overlay when no Camera Alignment is saved.

It does not correct lens distortion, perspective, or mirroring.

When it opens

Camera panelMap Camera.

What you see

  • The current frame dimensions.
  • 3 initial point-pair rows.
  • Image X / Y for a point's pixel location.
  • Ref X / Y for the matching reference location.
  • After solving: Quality, RMSE, Scale, Rotation, and Translation.

Buttons

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

Requirements

  • At least 3 finite point pairs.
  • Image coordinates inside the captured frame.
  • Image points that span a non-zero area.
  • Reference points that span a non-zero area.

Three points on one line are rejected. Spread points across the useful camera area for a more meaningful fit.

Editing, adding, or removing a point invalidates the solved result. Click Solve again before saving.

Notes

  • A different camera or frame resolution invalidates mapping data that no longer matches.
  • Lower RMSE means the pairs agree more closely, but always verify the overlay against known physical positions.
  • Camera Alignment takes precedence when both a mapping and an alignment are saved.

On this page