Beam Bench Docs

Camera Calibration

Solve lens distortion and perspective for the active camera. Run before alignment.

The Camera Calibration dialog computes the lens correction (distortion + perspective) for the active camera. Do this first, before Camera Alignment, alignment assumes calibration is in place.

When it opens

Camera panelCalibrate Lens. Or Device Settings → Camera area.

What you see

  • Frame size display at the top (camera's native pixel dimensions).
  • A list of point-pair rows. Each has Image X, Image Y (pixels), Ref X, Ref Y (mm, coordinates on a reference grid).
  • A solved-metrics summary: Quality (%), RMSE (px), Scale, Rotation (deg), Translation (px).

Buttons

  • Add Point
  • Solve
  • Save Calibration
  • Reset Saved
  • Close

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

Workflow

  1. Print or set up a calibration target (a regular grid of dots or crosses with known spacing).
  2. Place it in the camera's view.
  3. For at least 2 points (more is better), enter:
    • Image X / Y: the pixel location in the camera image.
    • Ref X / Y: the real-world spacing on the target (e.g. dot 3,4 on a 10 mm grid is at 30, 40).
  4. Solve.
  5. Save Calibration.

Notes

  • Frame size is auto-populated from the live overlay or the saved calibration.
  • Calibration is per-camera and per-lens. Swap lenses or zoom levels → redo calibration.
  • Reset Saved clears the saved calibration on the profile but does not affect the dialog's current points.

On this page