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 Capture New Image 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 4 well-spread points for perspective correction, or the recommended 9-point layout for a wide-angle camera.

If only the edges are wrong

Manual adjustment and Camera Mapping cannot correct perspective or lens curvature. Use Align Camera with the recommended 9-point layout to solve perspective and estimate radial distortion. Recheck the reference coordinates and include points near the edges.

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. A saved alignment describes the surface used during setup and does not automatically compensate for a different material height.

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?