Beam Bench Docs

Overlay does not line up

The captured bed image is offset, scaled, rotated, or distorted relative to the canvas.

Start with the current frame

Click Update Overlay before troubleshooting. If the material, lid, camera, or bed moved after the last capture, the still image no longer represents the current setup.

If the whole image is shifted, rotated, or uniformly too large

Use the quick visual workflow:

  1. Click Fit to Bed.
  2. Click Adjust Overlay.
  3. Drag inside the frame to move it, a corner to scale it, or the top handle to rotate it.
  4. Click Save Alignment.

For repeatable point-based setup, use Align Camera with at least 3 non-collinear points spread around the work area.

If only the edges are wrong

The current camera transform cannot correct barrel distortion, fisheye curvature, or perspective. Adding more points can reveal the error but cannot model non-linear distortion.

Use a lens with less distortion, mount the camera farther away with a narrower field of view, and keep it centered and square to the bed. Favor the central part of the image for precision work.

If material height changes the position

A fixed camera sees taller material from a slightly different angle. Align at the material height you plan to use. The current transform does not compensate for height or perspective.

If the image is mirrored

A 180-degree camera orientation can be corrected with rotation. A true left-to-right mirrored camera feed cannot be corrected by the current transform. Disable mirroring in the camera driver or virtual-camera software.

If a saved result disappeared

Beam Bench clears mappings when you select a different camera or capture at a resolution that does not match the saved transform. Capture a current frame and align again.

Verify it worked

  • Check several known points across the work area, not only one corner.
  • Place a design over a known fixture or mark and confirm the canvas position matches.
  • Run Frame before firing the laser.

Still stuck?

On this page

Start with the current frameIf the whole image is shifted, rotated, or uniformly too largeIf only the edges are wrongIf material height changes the positionIf the image is mirroredIf a saved result disappearedVerify it workedStill stuck?