### Linux Permissions Setup Source: https://github.com/lightburnsoftware/documentation/blob/master/Installation.md Commands to add the current user to the 'dialout' and 'tty' groups for proper device access in Linux. This is a crucial step before running LightBurn on Linux. ```bash sudo adduser $USER dialout && sudo adduser $USER tty ``` -------------------------------- ### Linux .7z Installer Execution Source: https://github.com/lightburnsoftware/documentation/blob/master/Installation.md Instructions for executing the LightBurn Linux 64-bit application from a .7z archive. This involves extracting the archive and granting execute permissions to the AppRun script. ```bash chmod +x AppRun ./AppRun ``` -------------------------------- ### Linux .run Installer Execution Source: https://github.com/lightburnsoftware/documentation/blob/master/Installation.md Command to execute the LightBurn Linux 64-bit installer script. This command assumes you are in the directory where the .run file was downloaded. ```bash bash ./LightBurn-Linux64-v*.run ``` -------------------------------- ### Rotary Attachment Configuration in LightBurn Source: https://github.com/lightburnsoftware/documentation/blob/master/RotarySetup.md This section outlines the general steps for setting up a rotary attachment within the LightBurn software. It covers selecting the attachment type, enabling the rotary feature, inputting steps per revolution, and defining object dimensions for engraving. ```APIDOC Rotary Setup Dialog: - Controller Type: Select Ruida, or A-axis for Smoothie/Grbl/C3D/Smoothieware. - Attachment Type: Choose between Chuck or Roller style. - Enable Rotary: Checkbox to activate rotary functionality. - Steps per Revolution: Input the number of steps for one full rotation. - Object Diameter/Circumference: Enter one value, the other is calculated. - Start From: Recommended setting is 'Current Position'. - Usage Note: Remember to uncheck 'Use Rotary Attachment' after use. ``` -------------------------------- ### Controller Configuration for Rotary Axis (C3D, Smoothieware, GRBL) Source: https://github.com/lightburnsoftware/documentation/blob/master/RotarySetup.md This guide explains how to configure the rotary axis on GCode controllers like Cohesion3D, Smoothieboard, or GRBL. It details calculating 'steps per degree' based on motor steps, microstepping, gear reduction, and controller-specific settings. ```APIDOC Steps per Degree Calculation: Formula: (Motor Steps * Microstepping Multiplier * Gear Reduction) / 360 Example (Cohesion3D/HolgaMods Rotary): - 3200 steps (200 * 8 micro steps * 2x reduction) / 360 = 8.88888888 steps per degree - 6400 steps (400 * 8 micro steps * 2x reduction) / 360 = 17.7777778 steps per degree Configuration Locations: - Smoothieware: 'delta' settings in config.txt. - GRBL: Edit > Machine Settings > Vendor Settings (A Axis). ``` -------------------------------- ### LightBurn Date and Time Formatting Examples Source: https://github.com/lightburnsoftware/documentation/blob/master/VariableTextFormats.md Provides practical examples of how to combine date and time formatting expressions in LightBurn to achieve specific output formats. ```APIDOC Example Formats (for 21 May 2001 14:13:09.120): dd.MM.yyyy -> 21.05.2001 ddd MMMM d yy -> Tue May 21 01 hh:mm:ss.zzz -> 14:13:09.120 hh:mm:ss.z -> 14:13:09.12 h : m : s ap -> 2 : 13 : 9 pm ``` -------------------------------- ### LightBurn Power Scale Test Grid Setup Source: https://github.com/lightburnsoftware/documentation/blob/master/CreatePowerScale.md Steps to create a power scale test grid in LightBurn. This involves creating a square, setting initial power and speed, using the grid tool to create power level rows, and then duplicating these rows for different speed settings. ```English 1. Create a 15x15mm square. 2. Set the lowest speed for testing. 3. Set the laser power to 100% of your desired maximum (e.g., 70% if your max is 70%). 4. Use the grid tool to create a row of power levels (e.g., 10 levels). 5. Select the leftmost square, open Shape Properties, and set Power Scale to the lowest test power (e.g., 10%). 6. Increase the Power Scale for each subsequent square in the row by the desired increment (e.g., 10%). 7. Select the entire row and use the Grid tool to create the required number of rows for different speeds. 8. Assign each row to a new layer. 9. Set the layer's Speed to the next lowest speed setting. 10. Ensure Min and Max powers for each layer match the initial square's settings. ``` -------------------------------- ### Shapeoko Workspace Offset Source: https://github.com/lightburnsoftware/documentation/blob/master/CommonGrblSetups.md Applies a workspace offset for Shapeoko machines that use negative workspace coordinates. This command shifts the origin to align with LightBurn's expectations. ```APIDOC Shapeoko Workspace Offset: G10 L2 P1 X-812 Y-812 - Sets an offset for the first coordinate system (P1). - Shifts the origin by -812mm in X and -812mm in Y. - Use your machine's width and height values if different from 812mm. - Essential for machines with negative workspace coordinates. G10 L2 P1 X0 Y0 - Clears the previously set workspace offset. - Restores the machine to its default CNC origin settings. ``` -------------------------------- ### File List Window Operations (DSP Controllers) Source: https://github.com/lightburnsoftware/documentation/blob/master/Toolbars.md Describes the functionality of the File List tool window for DSP controllers in LightBurn. It covers refreshing the file list, selecting, starting, deleting, and downloading files from the controller, as well as uploading local files. ```English Hit the Refresh button to query your controller for the list of hosted files. You can select a file and press Start to cut it, Delete to remove it from the controller, or Download to save it locally. Pressing Upload will let you choose a local cut file to send to the controller (this is not the same as the current job, which you can upload with the "Send" button in the Laser window - see the [Machine Instructions](MachineInstructions.md) page for more details). Be careful with the Delete All Files button. ``` -------------------------------- ### X-Carve GRBL 1.1f Configuration Source: https://github.com/lightburnsoftware/documentation/blob/master/CommonGrblSetups.md Configuration commands for X-Carve machines running GRBL 1.1f. Sets spindle max RPM and enables laser mode for optimal laser performance. ```APIDOC X-Carve GRBL 1.1f Settings: $30=1000 - Sets the spindle max RPM to 1000. $32=1 - Enables laser mode. ``` -------------------------------- ### Move Tool Window - Jog and Home Functions Source: https://github.com/lightburnsoftware/documentation/blob/master/Toolbars.md Explains the Jog and Home functions available in the Move tool window of LightBurn. It details how to manually move the laser head using arrow buttons, set custom origins, clear origins, and get the current reported position. It also notes controller-specific differences (e.g., Ruida). ```English Here you can manually jog your laser head to different positions by selecting one of the arrow buttons around the home button. This will move your head by the set distance, speed and power entered in the toolbox. You can also set or clear a custom origin or get the current reported position. **Note:** If you have a Ruida controller, you will not see Set Origin, Clear Origin, or Set Finish Position, as these are handled by the controller itself. LightBurn will generally show only controls you can use. ``` -------------------------------- ### Creating a New Blank Material Library Source: https://github.com/lightburnsoftware/documentation/blob/master/MaterialLibrary.md Explains how to create a completely new, empty Material Library if you wish to manage different sets of presets separately. ```English Click the *New* button at the lower-right corner of the "Library" window to start a new, blank library. ``` -------------------------------- ### Help and Information Access Source: https://github.com/lightburnsoftware/documentation/blob/master/MenuCommands.md Provides access to various help resources, including hotkey lists, usage notes, online documentation, video tutorials, and license management. ```APIDOC Quick Help and Notes: Description: Accesses hotkey list, general usage notes, and version information. Shortcut: F1 Online Documentation: Description: Accesses the comprehensive documentation for LightBurn. Online Video Tutorials: Description: Accesses tutorial videos for LightBurn. Check for Updates: Description: Verifies and installs the latest version of the software. License Activation and Trial: Description: Manages license keys and displays trial period status. Related: Enters the license dialog. ``` -------------------------------- ### Providing Feedback and Suggestions Source: https://github.com/lightburnsoftware/documentation/blob/master/FAQ.md Advises users to post suggestions on the dedicated suggestion site () where others can vote, helping the development team prioritize features. ```Documentation Q: I have suggestions – should I post them here? A: You should post them to our suggestion site. Other people can vote on suggestions, we read it regularly, and it helps us prioritize feature development. It’s here: ``` -------------------------------- ### Set Machine Origin to Absolute Zero Source: https://github.com/lightburnsoftware/documentation/blob/master/CommonGrblSetups.md Moves the machine to its absolute origin position (0,0) after homing. This is a preliminary step to determine the coordinate system. ```GCode G0 X0 Y0 ``` -------------------------------- ### File Menu Commands Source: https://github.com/lightburnsoftware/documentation/blob/master/MenuCommands.md Provides details on file operations within LightBurn, including creating new projects, opening recent or existing files, importing various file types, saving and exporting projects, and exiting the application. ```English New: Clears current project and creates a new one. Shortcut: Ctrl + N (Cmd + N on Mac). Open recent projects: Displays a list of recently opened files. Open: Opens an existing or saved file. Shortcut: Ctrl + O (Cmd + O on Mac). Import: Imports supported LightBurn files (svg, ai, pdf, dxf, hpgl, plt, png, jpg, bmp) into the current project. Save: Saves the current project. Shortcut: Ctrl + S. 'Save As' keeps the original file intact. Export: Exports the file to SVG or AI format. Bitmaps and text are not currently exported. Exit: Closes LightBurn. Shortcut: Ctrl + Q. Prompts to save unsaved changes. ``` -------------------------------- ### Test Setup for Scanning Offset Measurement Source: https://github.com/lightburnsoftware/documentation/blob/master/ScanningOffsetAdjustment.md Instructions for setting up a test in LightBurn to measure the scanning offset. Involves creating a rectangle and configuring scan settings. ```APIDOC Test Setup: - Create a rectangle (e.g., 50mm wide, 10mm high). - Set scan interval to 0.5mm. - For GCode devices: Enable overscan (5% or greater). - Set power high enough to mark material. - Run at multiple speeds (e.g., 100mm/sec, 200mm/sec, 300mm/sec). - Measure the distance between the ends of the lines at each speed. ``` -------------------------------- ### G-Code Console Commands Source: https://github.com/lightburnsoftware/documentation/blob/master/MachineInstructions.md Allows direct input and execution of G-Code commands to a connected device. Enter a command in the text box and press return to send. ```APIDOC G-Code Console: Input G-Code commands directly. Press 'Return' to send commands to the connected device. ``` -------------------------------- ### LightBurn Image Mode Dithering Comparison Source: https://github.com/lightburnsoftware/documentation/blob/master/EngravingImages.md Illustrates the visual differences between Threshold, Ordered, and Dithered image modes in LightBurn using the 'Madrid truck' example image. ```text Original image (Madrid truck): ![MadridTruck-Original](img/MadridTruck-Original.png) Threshold: ![MadridTruck-Threshold](img/MadridTruck-Threshold.png) Ordered: ![MadridTruck-Ordered](img/MadridTruck-Ordered.png) Dithered: ![MadridTruck-Dithered](img/MadridTruck-Dithered.png) ``` -------------------------------- ### Saving and Loading Material Libraries Source: https://github.com/lightburnsoftware/documentation/blob/master/MaterialLibrary.md This section covers how to save your current Material Library to a file for backup or sharing, and how to load a previously saved library into LightBurn. ```English Save: Click the *Save* button to periodically save your library additions. Load: Select *Load* to open a file finding window, point to a saved library file, and click *Open* to make it the active library. ``` -------------------------------- ### GRBL Configuration Settings Source: https://github.com/lightburnsoftware/documentation/blob/master/CommonGrblSetups.md Essential GRBL settings for LightBurn compatibility. Adjusts spindle max RPM and enables laser mode for improved laser cutting and marking. ```APIDOC GRBL Settings: $30=1000 - Sets the maximum spindle RPM value to 1000, matching LightBurn's default. - Affects the 'S-Value Max' setting in LightBurn's Device Settings. $32=1 - Enables 'Laser Mode' for GRBL firmware version 1.1f and later. - Allows for variable power control, turning the laser off when the machine stops. $10=0 - Sets machine status reporting to be relative to the workspace origin, not the machine origin. ``` -------------------------------- ### Test Workspace Movement Source: https://github.com/lightburnsoftware/documentation/blob/master/CommonGrblSetups.md Moves the machine 10mm into the work area on both X and Y axes to verify positive workspace coordinates. If the machine bumps rails, it indicates negative coordinates. ```GCode G0 X10 Y10 ``` -------------------------------- ### LightBurn Camera Alignment Wizard Steps Source: https://github.com/lightburnsoftware/documentation/blob/master/Using_a_Camera.md This section outlines the sequential steps within the LightBurn Camera Alignment wizard, from cutting alignment markers to final placement and saving the results. It details user interactions and expected outcomes at each stage. ```APIDOC Camera Alignment Wizard: 1. **Cutting Alignment Markers** - Initiate wizard: Tools -> Calibrate Camera Alignment. - Select camera used in Lens Calibration. - Configure laser settings (speed, power) for marking material without cutting through. - Use 'Frame' to check material alignment. - Click 'Start' to cut the target pattern. - Adjust settings and retry if the cut is incorrect. 2. **Capturing the Target Marker Image** - Ensure the target marker is not moved after cutting. - Move the laser out of the camera's view. - Click 'Capture' when all four targets are clearly visible. - An undistorted camera view with targets should appear. 3. **Marking the Targets** - Double-click the center of each target marker in numerical order (1, 2, 3, 4). - A red '+' mark indicates placement. - Use pan/zoom controls for accuracy. - 'Undo Last' option available for corrections. - Verify all markers are centered and visible after placement. 4. **Finishing the Process** - Click 'Next' after marker placement. - Click 'Finish' to save calibration results. - Alternatively, click 'Align Camera' on the final page to proceed automatically. ``` -------------------------------- ### Console Commands Source: https://github.com/lightburnsoftware/documentation/blob/master/Toolbars.md Provides a console toolbox for directly inputting commands on non-Ruida machines. Users can type commands and view results, useful for manual G-Code or retrieving configuration details. Not available on non-gcode devices like Ruida and Trocen controllers. ```APIDOC Console: Input: Text box for entering commands (e.g., G-Code). Output: Displays results of executed commands. Availability: Non-Ruida machines only. ``` -------------------------------- ### Configure GRBL for Shifted Origin Source: https://github.com/lightburnsoftware/documentation/blob/master/CommonGrblSetups.md Sets the GRBL parameter $10 to 0 to make GRBL report its location relative to the shifted origin, rather than machine space. This ensures consistency with the applied workspace offset. ```GCode $10=0 ``` -------------------------------- ### Accessing the Material Library Window Source: https://github.com/lightburnsoftware/documentation/blob/master/MaterialLibrary.md Instructions on how to ensure the Material Library window is visible within the LightBurn interface. ```English In the top menu, select "Window" to ensure that "Library" is checked on. If not, select it to turn the window on. ``` -------------------------------- ### Set Center Origin Workspace Offset Source: https://github.com/lightburnsoftware/documentation/blob/master/CommonGrblSetups.md For machines with a center origin, this command applies a workspace offset by half the machine's total travel dimensions. This effectively moves the origin to a corner, similar to negative coordinate machines. ```GCode G0 X0 Y0 G10 L2 P1 X-300 Y-200 ``` -------------------------------- ### Help System Hot Keys Source: https://github.com/lightburnsoftware/documentation/blob/master/HotKeys.md Describes keyboard shortcuts for accessing help documentation within LightBurn. ```APIDOC Help System Shortcuts: - Help and Notes: F1 - F1 while hovering over the edit window: Opens documentation for the current editing mode. - F1 while hovering over some tools: Shows help for that specific tool. ``` -------------------------------- ### LightBurn Job Origin Settings Source: https://github.com/lightburnsoftware/documentation/blob/master/CoordinatesOrigin.md Explains the 'Start From' options in LightBurn's Laser tab, which determine how the job is positioned relative to the machine's work area. Options include Absolute Coordinates, Current Position, and User Origin. ```APIDOC Start From Options: 1. Absolute Coordinates: - The page grid in the main editing window directly corresponds to the machine's work area. - Objects placed in the grid are cut in the corresponding physical location. - Ideal for users with small lasers (e.g., K40) due to its simplicity. - Job Origin and Machine Origin are always in the same place. 2. Current Position: - The job cuts relative to the laser head's position when the 'Start' button is pressed. - The 'Job Origin' setting in the Settings window determines the job's positioning relative to the laser head. - Allows for easy alignment on materials by positioning the laser head over the desired starting point. 3. User Origin: - Similar to Current Position, but the starting location is programmable. - For Ruida controllers, uses the 'Origin' button on the machine. - For GCode systems, uses the 'Set Origin' button in LightBurn. - The laser moves back to the programmed location to start the cut. ``` -------------------------------- ### Identify Grbl Firmware Version Source: https://github.com/lightburnsoftware/documentation/blob/master/CommonGrblSetups.md Determines the Grbl firmware version by observing the initial console message. Grbl 1.1f or later supports M4 variable power and uses the 'Grbl' driver. Older versions (1.1e or earlier) require the 'Grbl-M3' driver. ```English Smoothie Grbl 1.1f [$ for help] ``` -------------------------------- ### Create New Material Library Entry Source: https://github.com/lightburnsoftware/documentation/blob/master/MaterialLibrary.md This describes the process of creating a new entry in the LightBurn Material Library by using the current cut settings of a selected layer. It involves filling out a details sheet with the material's name, thickness, and a description. ```English 1. Select one of your cut layers then click the *Create new from layer* button in the "Library" window. 2. Fill out the details sheet providing a *Name*, *Thickness* (if appropriate) and a short *Description* of the cut layer parameters. Once completed, click the *Ok* button to save this new entry into your library. 3. Now you can use this new entry titled "Birch Ply" anytime in the future and easily assign it to a new cut layer. ``` -------------------------------- ### LightBurn Camera Calibration Process Source: https://github.com/lightburnsoftware/documentation/blob/master/Using_a_Camera.md Guides users through the camera calibration process in LightBurn. This involves teaching LightBurn to remove lens distortion and determine the camera's position relative to the laser's work area. A YouTube video walkthrough and a downloadable calibration image are provided. ```LightBurn Download and print the Calibration-Circles.png image. Mount the image to stiff card, foam-board, or wood, ensuring it remains flat. The image should be approximately 148mm x 105mm (5.8" x 4.1") with at least 6mm (1/4") of white space around the pattern. ``` -------------------------------- ### DXF Import Settings Source: https://github.com/lightburnsoftware/documentation/blob/master/Settings.md Configures how DXF files are imported, including setting the measurement units for correct scaling and defining an auto-close tolerance to connect nearby lines and curves. ```English ##### Units DXF files do not store the measurement system that was used to create them. If you create an object that is 5 inches wide, it might import as 5mm wide, because LightBurn can only see the '5'. Similarly, if your object was created in microns, it might import huge. Set this value as appropriate before importing DXF files to ensure correct scaling. ##### Auto Close Tolerance DXF files are often saved as a collection of discrete pieces, instead of continuous paths. The Auto-Close Tolerance value tells LightBurn to connect any lines or curves that are on the same layer and closer together than this value. ``` -------------------------------- ### Tools Toolbar Source: https://github.com/lightburnsoftware/documentation/blob/master/Toolbars.md Contains commonly used design tools accessible via icons and tool menu, with associated hotkeys. Includes tools for selection, drawing lines, rectangles, ellipses, and polygons. Snapping functionality is available for precise placement and alignment. ```APIDOC Tools Toolbar: Select Tool: Selects objects, accesses menus, and returns to selection mode via Esc. - Snapping: Objects snap to grid, other object centers, endpoints, and midpoints. Ctrl (Cmd on Mac) bypasses snapping. Draw Lines Tool (Ctrl-L / Cmd-L): Draws straight lines. Rectangle Tool (Ctrl-R / Cmd-R): Draws rectangles. Ellipse Tool: Draws ellipses. Polygon Tool: Draws regular polygons (sides adjustable in Shape Properties). ``` -------------------------------- ### Apply Workspace Offset for Negative Coordinates Source: https://github.com/lightburnsoftware/documentation/blob/master/CommonGrblSetups.md Offsets the machine's origin to the opposite corner (e.g., front-left) by applying a negative offset equal to the machine's total travel dimensions. This aligns negative coordinate systems with LightBurn's positive workspace expectation. ```GCode G10 L2 P1 X-250 Y-250 G10 L2 P1 X-600 Y-400 ``` -------------------------------- ### X/Y Axis Movement Correction Source: https://github.com/lightburnsoftware/documentation/blob/master/FAQ.md Addresses issues where the X/Y axis moves in the wrong direction upon starting. The solution involves checking and potentially changing the origin setting (back to front or vice versa) and understanding the difference between homing position and zero position. ```Documentation Q: My X/Y axis moves the wrong way when I Start A: Change the origin from back to front or vice versa. The most common mistake people make is thinking that the homing position and zero position are the same. They often aren’t. On a K40, for example, the limit switches for homing are in the rear left, but X0 Y0 is front left. ``` -------------------------------- ### Tools Menu Commands Source: https://github.com/lightburnsoftware/documentation/blob/master/MenuCommands.md Offers tools for selecting, drawing, and editing vector objects, manipulating shapes, tracing images, applying paths to text, zooming, positioning the laser, previewing the project, and configuring rotary attachments. ```English Select: Selects objects in the workspace or accesses menus and toolbars. Draw Lines: Draws straight lines. Shortcut: Ctrl + L Rectangle Tool: Draws rectangles. Shortcut: Ctrl + R Ellipse Tool: Draws ellipses. Shortcut: Ctrl + E Edit Nodes: Edits nodes of objects. Shortcut: Ctrl + ~ Edit Text: Creates or edits text. Shortcut: Ctrl + T Offset Shapes: Creates new shapes offset inward or outward from the current selection. Weld Shapes: Fuses multiple shapes into a single outline. Trace Image: Opens a dialog to trace bitmap images into vector graphics. Apply Path to Text: Attaches selected text to a selected shape's path. Zoom In: Zooms in on the workspace. Shortcut: Ctrl + = Zoom Out: Zooms out on the workspace. Shortcut: Ctrl + - Frame Selection: Zooms the view to contain the current selection. Shortcut: Ctrl + Shift + A Position Laser: Allows clicking on the workspace to move the laser head. Preview: Opens the preview window showing the laser project, cut lines (black), and traversal moves (red). Shortcut: Alt + P Rotary: Opens the rotary setup dialog for rotary attachment configuration. ``` -------------------------------- ### LightBurn Trace Image Controls Explained Source: https://github.com/lightburnsoftware/documentation/blob/master/TracingImages.md Detailed explanation of the controls within the LightBurn Trace Image dialog, including 'Ignore less than', 'Smoothness', 'Threshold', 'Optimize', 'Fade Image', and 'Show Points'. ```English Ignore less than: This setting tells the vectorizer to ignore anything smaller than this many pixels in area. If you are trying to vectorize a noisy image, increasing this may help. Smoothness: Bitmap images are made of pixels, and pixels are rectangles. Image tracing tries to infer shapes from these arrangements of rectangles, and has to smooth out the results or everything would just look like stairs. Part of the process is trying to recover smooth shapes from jagged lines, and this number controls how aggressive the smoothing is. A value of 1.333 is the maximum, and will make almost everything into curves. A value of 0.0 will produce all straight lines. The difference is shown below: Notice in the left image, with a Smoothness of zero, the area highlighted in red is made of several line segments, whereas the same area in the right image is a continuous curve. The area shown in blue is also sharp in the left image, but with the Smoothness value set to maximum, the image at right shows how even sharp corners become smoothed, and this is rarely desired. The default value of 1.0 is a good mix between producing smooth curves while still maintaining sharp corners. Threshold: The Threshold value controls the brightness value used as the cutoff between "light" and "dark" pixels. In images with continuous shading, or images that are very light or dark, you may need to adjust this value to get the best result. Optimize: After generating lines and curves, the image trace feature will attempt to merge similar lines and curves together to reduce the node count of the result. The Optimize parameter controls how aggressive this is. 0 means no merging. The default of 0.2 is a nice balance between accuracy of the result and node count. Fade Image: Dims the image to make it easier to see the resulting vector shapes Show Points: Enables the display of the points (nodes) of the resulting vector trace. Enabling this is useful when you are tuning the Optimize parameter to see the resulting points. ``` -------------------------------- ### Feature List and Documentation Source: https://github.com/lightburnsoftware/documentation/blob/master/FAQ.md States that a comprehensive, up-to-date list of supported features is not maintained due to frequent software updates. Users are directed to the online documentation for detailed information. ```Documentation Q: Do you have a list of supported features somewhere? A: Sort of – our documentation is available online if you’re one of those rare unicorns who reads such things. Writing a real list of supported features would take a long time, and would constantly be out of date – we update **very** often. () ``` -------------------------------- ### Units and Grid Settings Source: https://github.com/lightburnsoftware/documentation/blob/master/Settings.md Manages measurement units (inches/mm), speed units (per second/minute), visual grid spacing, snap distances for positioning, click selection tolerance, and object snapping behavior. ```English ##### Inches / mm LightBurn internally operates in millimeters, but can display in either millimeters or inches. Speeds can be represented as either units per second or units per minute. Users with diode lasers will likely prefer the units per minute setting, whereas CO2 lasers generally express speeds using units per second. ##### Visual Grid Spacing The visual grid is set to 10mm by default. Note that this is independent of the Grid Snap setting below. ##### Grid Snap Distance Positioning of lines and other primitives will snap to the Grid Snap distance unless overridden using the Ctrl key. The default for this is 1mm. ##### Click Selection Tolerance This is how close you have to be to a line or vertex, in screen pixels, to click it. Increase this number if you have trouble selecting things, decrease it if you find yourself selecting things you didn't mean to. ##### Object Snap Distance Controls how close, in screen pixels, your cursor has to be to an object vertex or center to engage the object snapping behavior. ##### Snap to Objects / Snap to Grid LightBurn has two snapping behaviors which can be enabled / disabled here. Snap to Objects will snap your pointer location to the nearest object center or vertex when creating new objects, or drawing lines, making it easier to connect and align shapes. Snap to Grid will snap your cursor position to the nearest grid location, as specified by the Grid Snap value. Note that the Grid Snap and the Visual Grid do not have to be the same. ``` -------------------------------- ### Object Arrangement and Movement Commands Source: https://github.com/lightburnsoftware/documentation/blob/master/MenuCommands.md Commands for arranging objects in specific patterns like grids or circles, and for moving objects to predefined positions on the page. ```APIDOC Move H-together: Description: Moves shapes horizontally, keeping them together like distribute. Move V-together: Description: Moves shapes vertically, keeping them together like distribute. Move to Page Center: Description: Moves selected objects to the center of the page. Move to Upper Left: Description: Moves selected objects to the upper-left corner of the page. Move to Upper Right: Description: Moves selected objects to the upper-right corner of the page. Move to Lower Left: Description: Moves selected objects to the lower-left corner of the page. Move to Lower Right: Description: Moves selected objects to the lower-right corner of the page. Grid / Array: Description: Creates a grid or array of objects. Opens a window for parameter input. Circular Array: Description: Creates a circular array of objects. Opens a window for parameter input. ``` -------------------------------- ### LightBurn Trace Image Tool Usage Source: https://github.com/lightburnsoftware/documentation/blob/master/TracingImages.md Instructions on how to use the Trace Image feature in LightBurn to convert bitmaps to vectors. It covers importing, selecting, and accessing the tool via the menu or keyboard shortcut. ```English To start, import an image object into LightBurn, select it, then choose Tools -> Trace Image from the menu (or press Alt-T) ``` -------------------------------- ### Managing Existing Material Library Entries Source: https://github.com/lightburnsoftware/documentation/blob/master/MaterialLibrary.md This details the various management options for existing entries in the Material Library, including editing cut settings, editing descriptions (name, thickness, description), duplicating entries, and deleting entries. ```English Edit Cut: Click *Edit Cut* to open the "Cut Settings Editor" and modify cut parameters. Edit Description: Click *Edit Description* to modify the Name, Thickness, and Description for the highlighted entry. Duplicate: Click *Duplicate* to create a copy of the highlighted entry. Delete: Click *Delete* to remove a single cut setting entry from the library. ```