Beam Bench Docs

v0.1.11 Camera, Rotary, and Import Update

Corrected camera alignment, experimental GRBL rotary support, safer bounds checks, and more reliable PDF and AI imports.

Beam Bench v0.1.11 adds corrected overhead-camera alignment and an experimental rotary workflow for GRBL-family controllers. It also improves PDF and AI imports, workspace error messages, serial diagnostics, and runtime security.

Downloads

  • macOS: universal .dmg, Developer ID signed and notarized.
  • Windows: signed x64 NSIS setup .exe.
  • Linux: x64 .AppImage.

Download the latest build from beambench.com.

Corrected camera alignment

The Camera Alignment dialog now offers two point layouts:

  • Quick setup (4 points) corrects perspective. Use it with a camera that has little visible lens curvature.
  • Wide-angle setup (9 points, recommended) corrects perspective and estimates radial lens distortion. Use points spread across the camera image, including the center and outer areas.

The corrected image remains adjustable after solving. Existing saved camera profiles remain compatible. Always verify the overlay against known positions before framing or running a job.

See Align the overlay for the complete procedure.

Experimental GRBL rotary support

Machine profiles can now configure a roller or chuck rotary attachment. The setup includes X, Y, or dedicated Z-axis mapping, travel per rotation, object diameter, roller diameter when needed, and direction reversal.

Artwork, previews, and layer settings stay in surface millimeters. Beam Bench converts rotary movement and compensates feed rates when it generates GRBL-family G-code.

Important safety limits:

  • Use Start From Current Position for every rotary job.
  • Do not home while the rotary attachment is connected.
  • Framing and jobs are blocked on unsupported controllers.
  • Z-axis rotary mode cannot be combined with job Z offsets.
  • Material, focus, and interval tests are unavailable while rotary mode is active.
  • Offline rotary G-code export is not currently supported. A compatible GRBL-family machine must be connected.

See Rotary setup before connecting or running an attachment.

Clearer workspace errors

When artwork extends outside the workspace, Beam Bench now identifies and selects the offending object, names the affected edge, and reports the largest overrun in your selected display unit. Move the selected object fully inside the workspace, then preview or frame again.

More reliable PDF and AI imports

PDF and PDF-compatible AI imports preserve curved paths, nested transforms, and standard source colors more accurately. On Windows, dragging binary artwork into Beam Bench no longer risks treating it as text and producing an unreadable import.

If a PDF still imports incorrectly, send a bug report with the original file. PDF producers can encode the same visible artwork in different ways, so the source file is important for reproducing an unsupported case.

Connection and maintenance fixes

  • Serial connection errors provide clearer recovery guidance, including the actual port Beam Bench attempted to open.
  • Windows port-access failures are localized and explain common causes such as another application holding the port.
  • Tauri and other runtime dependencies include the available security fixes for this release.
  • The public repository now includes contribution, support, security-reporting, and continuous-integration workflows.

On this page