Concise guide to LaserPost settings (1.2)

This guide is for LaserPost version 1.2

Using an older version? Guides for Laserpost v1.1 and Laserpost v1.0.

There are two flavors of LaserPost, one for LightBurn and the other for SVG (for importing shapes into most every laser program). One significant difference between the two, other than the file format, of course, is that LightBurn projects contain all layer settings so when those projects are opened, everything is ready to burn. SVG files, on the other hand, are organized by color and a setup sheet (<program-name>-setup.txt) is created that maps colors to laser settings.

As of version 1.2, LaserPost has two modes of operation: Standard and Advanced:

  • Standard: Simple to use, and is recommended for most users (and is the default). When using LaserPost for Lightburn, it provides integration with LightBurn Material Libraries, making it simple to select existing materials to create laser-ready projects.  Changes made to your LightBurn Material Library will be shared by all models.
  • Advanced: extends Standard bywith advanced laser settings, using the CAM applications (e.g. Fusion 360) Tool Library to build out material libraries, and gives precise control over laser settings.  This can be valuable, especially with larger projects and teams, as all laser settings are retained with your solid model for precise control and long term retention.

Throughout this guide, we will use Fusion 360 as our CAM program as it is by far the most popular, but the concept is the same (though the steps and screens somewhat different) for Inventory and HSMWorks.

LaserPost configuration

LaserPost is configured in multiple places, including on the machine setup, CAM setup, the individual cutting operations, and when doing the post-generation. This is accomplished using the Autodesk CAM post-processors ability to provide custom properties (as well as by redefining the purpose of some existing properties in Advanced mode). For this to work, you must have (and use) a machine definition that has the LaserPost post-processor selected (do not just select the post-processor when generating or many of these options will not be available).

Most properties are available in all flavors of LaserPost, but there are differences, and these are indicated below with the name of the product that supports the feature.

Machine Settings

Standard LaserPost machine settings (click to enlarge).

Advanced LaserPost machine settings (click to enlarge).

To open, right-click your setup to open properties, and on the Setup tab (default) click Edit for your Machine.  If this is a installation, see installation steps above)

Machine settings are shared by all models, and have only a few features that rarely need adjustment. Access your machine settings by editing the CAM setup, under "Machine" click the "Edit..." button, and switch to the post-processing tab.

  • LaserPost Features: Choose from Standard (default) and Advanced modes.  Note: You must run one post before the change will be available (because the Autodesk post-processor API is not informed of property changes until it is executed).

  • Machine orientation (LaserPost for LightBurn): LightBurn files need to know how to configure the machine orientation to match your laser cutter/engraver. Set this property to match how LightBurn machine properties are configured (Upper left, upper right, lower left, lower right).

  • LightBurn library (LaserPost for LightBurn): LightBurn material libraries can be directly integrated into Fusion 360, allowing for simply setup of laser settings on operations and for using a single material library across Fusion 360 and LightBurn.  Changes made to the LightBurn library take affect immediately.  You must specify the full path to the library (e.g. "C:\Users\BobLaser\Documents\LightBurn\MyLaser").  To find the path, from the LightBurn Library tab, click on "Load" and the window that opens is likely at the directory that stores your libraries.  Note: You must run one post before the change will be available (because the Autodesk post-processor API is not informed of property changes until it is executed).

  • LightBurn library units (LaserPost for LightBurn): By default, LaserPost will use metric units for thicknesses in the LightBurn material library.  You can change it to use inches instead here.  Note: You must run one post before the change will be available (because the Autodesk post-processor API is not informed of property changes until it is executed).

  • SVG file units (LaserPost for SVG): By default, SVG files are generated using the standard "pixels" unit (which is 96 per inch).  Most laser programs import this perfectly, but some use an incorrect scaling for pixels (XTools XCS uses 72), resulting in the import being the wrong size.  This setting allows other units to be used, including "inch", "mm", and "point".  If you are having a scaling problem with imports, or would like the generated SVG geometry to be in a specific unit, try changing this option.
  • Speed units: Selects if "mm/min" or "mm/sec" should be the unit of speed measurement. This option only affects comments and notes and does not change any actual lasering or shape behavior.

  • Check for updates: Sets a schedule for how often LaserPost will check for updated versions being available. Checking is only done when generating a LaserPost project. Updates are never automatically installed, and when updates are available a message will appear during a post and will also be included as "important" notes.

  • Beta releases: By default, update notifications only include official release versions. Enable this to also be notified of Beta and Release Candidate releases.

Tool Cutting Data Settings

Tool cutting properties are not used with Standard mode.

CAM Setup Job Settings

Fusion 360 CAM Setup (click to enlarge).

Select the job setup in the CAM browser tree, right-mouse click, and select "Edit".

Each model must have one (or more) CAM setups that contain cutting operations. There are no custom LaserPost properties on this window, but the following setup details are important for the successful use of LaserPost:

  • Machine: You must set up a machine that is configured to use the LaserPost post-processor, and the setup must select that machine. If this is skipped, custom properties in the 2D Profile Cutting Operation will not be available.

  • Work Coordinate System (WCS) section: The fields in this section are used to set the orientation of your CAM operations relative to the stock, and to set a point that defines what will become the lower-left corner of the shapes when loaded in your laser program.

    Use the orientation dropdown to select an orientation method, and follow the options to select a stock point. You must have the final WCS coordinate show the Z arrow pointing up (toward the laser head), and the X and Y arrows pointing toward the stock (not away from it).

    Tip: If you are having difficulty getting X, Y, and Z arrows pointing in the correct direction, try the "Select Z axis/plane & X axis" option. Then select your Z (the depth), and then a horizontal line for X. This approach locks Z on the correct axis, and by adjusting Flip X and Flip Z you can get any corner to work.

2D Profile Cutting Operation Settings

All LaserPost shapes are defined using the "2D Profile" cutting operations (including for cutting and engraving tasks) where you select the geometry of your model. While you can have a single operation for large jobs (that share the same settings), it is recommended to use multiple, smaller operations (such as one to cut inside shapes, and another for an outside cut). This makes managing and understanding the operations easier, and results in more usable LightBurn groups.

The following three tabs are important to set up correctly.

2D Profile cutting operation (click to enlarge).

On any 2D Profile cutting operation, right-mouse click, select "Edit" and click the "Tool" tab.

The first tab is the Tool setting tab, where you select the tool (the base material), and set the cutting mode and preset that define how the operation will cut or engrave the material.

  • Tool: All operations require a tool.  In Standard mode, you can almost any tool.  For example, click Select..., and choose "Fusion 360 Library", then"Cutting Tools (metric)" and then "Laser Cutter".

2D Profile cutting operation (click to enlarge).

On any 2D Profile cutting operation, right-mouse click, select "Edit" and click the "Geometry" tab.

The Geometry tab is where you select the parts of your solid model (or sketch) you want to include in this operation. There are no LaserPost-specific settings.

Standard: 2D Profile cutting operation (click to enlarge).

On any 2D Profile cutting operation, right-mouse click, select "Edit" and click the "Post Properties" tab.

Advanced: 2D Profile cutting operation (click to enlarge).

On any 2D Profile cutting operation, right-mouse click, select "Edit" and click the "Post Properties" tab.

The post-properties tab on the 2D Profile cutting operation is where the connection from your operation to laser settings occurs.  If this tab is not showing up, make sure your CAM setup (see above) has selected a machine that is configured to use the LaserPost post-processor.

  • LightBurn library material (LaserPost for LightBurn): If you have specified the path to a LightBurn material library, this dropdown will show all materials in the library.  Simply choose a material and setting, and your laser configuration will be all set.  Note: If you change your path or units for the library, available in Machine Settings, they will not be available until you run one post (because the Autodesk post-processor API is not informed of property changes until it is executed).

  • Grouping name: For more precise control over the grouping of shapes in operations, this field can be given a name (such as "Logos"). All operations that share the same name will be automatically grouped (with their operation as a sub-group, unless disabled in post-property generation).

Post-processor Generate Settings

Standard: LaserPost post-processor actions (click to enlarge).

On the Actions menu bar, select Generate to start the post-processor.

Advanced: LaserPost post-processor actions (click to enlarge).

On the Actions menu bar, select Generate to start the post-processor.

Several options are available when starting a LaserPost post-process (with the Actions / Post Process menu option). Unlike the other properties in LaserPost, Autodesk does not save these with the project but instead keeps them the same from project to project.

LaserPost file settings:

  • Organization: Instructs LaserPost on how to organize operations into layers and files. You can also select to group by operation (all shapes organized by the operation, including shared group name), by layer (multiple operations that share the same laser settings) in a single file ("By layer"), or generate each layer into a different file, where the first filename will be your post name, and the remainder will have "-1", "-2", etc. appended ("By file layer"). LaserPost for LightBurn defaults to "By operation" since layers are managed within LightBurn, and LaserPost for SVG defaults to "By layer" to help with selecting shapes that share the same laser settings.

  • Group shapes: This checkbox, default on, tells LaserPost that shapes found within a single operation should be grouped. If the operation contains only one shape, no group will be created even when this is enabled.

  • Alignment marks: LaserPost can add alignment marks (circles with a cross-hatch in the middle) on each layer created. These are useful when importing shapes (especially when using "Organization / By file layer") and manual alignment of the shapes are needed to have perfect positioning. By default, this is off (None), but can be set to the stock's upper-right, center-right or lower-right position.

  • Notes: Notes are automatically created that summarize the configuration and laser settings, as well as contain important information such as problems detected or updates to LaserPost being available. In LaserPost for LightBurn, these are placed into the LightBurn project where they will appear in LightBurn under the File / Show Notes menu option. In LaserPost for SVG, these are stored in a "<post>-setup.txt" file and are useful to to set up the mapping of SVG colors to laser settings. Options include "Disable" (not recommended), "Hidden" (in LightBurn, doesn't show notes but they can be shown with File / Show Notes; in SVG the file is generated but no popup window appears saying it has been created), "Show when important" (auto-opens in LightBurn or displays a message when posting with SVG), or "Always show".

  • Comments: LaserPost injects helpful comments into the generated file(s). These comments do not affect the operation of the project but can be useful when looking at the project's XML. Options include "Disable", "Normal" (default), "Debug" (useful when trying to understand how LaserPost is working), and "Insane" (rarely needed but occasionally needed to debug LaserPost issues).

  • Launch on post: When checked, the generated file will be automatically started (launched), streamlining the workflow from solid model to laser. This is similar to double-clicking the file, where the default associated application is launched (e.g. LightBurn, or your default SVG display/edit program).

Power overrides: 

Power overrides are not used with Standard mode.


  • Trace stock: When enabled, includes a layer and shape that outlines the edges of the stock in the generated file(s). This layer will have its output turned off in LaserPost for LightBurn, and will have the setup sheet indicate it should be off (or deleted) in LaserPost for SVG. Unselect the checkbox to disable this feature. The default is on for LaserPost for LightBurn and off for LaserPost for SVG.

Help us improve LaserPost

Hopefully, this has been helpful to get the most out of LaserPost. If you find anything inaccurate or missing, wish we would add a feature, or find a bug, please let us know by opening an issue on GitHub or sending us a message. And please consider sharing LaserPost with your friends and colleagues or more broadly with videos and articles on social media.

Share your thoughts.

    Join the discussion!

    We look forward to your thoughts, but please be patient as it may take a few hours to appear (thanks to spambots and unscrupulous hackers).

    Leave a Reply

    Your email address will not be published. Required fields are marked *