Skip to content

Modifier Tools

ModifierTools

The modifier tools, as the name suggests, are primarily used to modify existing shapes.

The tools are:

Offset

Hotkey = Alt + O

The offset tool is used to create outlines around existing shapes, either inward or outward, offset from the original by a given amount. We use the offset tool in the 'Making a Simple Project' topic, so that's a great introduction.

OffsetDialog

The corner style option chooses how outward corners are offset:

OffsetCorners

The offset tool remembers the last set of options you used, and if you hold the Ctrl key when you click the offset button, it will perform the offset operation using the previous settings, without bringing up the dialog.

Weld

Hotkey = Ctrl/⌘ + W

Clicking on the Weld icon will join all the selected shapes into a single entity that is the outline of all the selected shapes. Note that Weld requires closed shapes, but will accept an arbitrary collection of inputs, and tries to do the right thing, but sometimes gets it wrong. If you weld something and the middle content disappears, use Boolean Union instead.

Boolean Union

Union is similar to weld, but works with 2 selected objects only. However these selected objects can actually be grouped items, not just a single vector shape.

Boolean Subtract

Hotkey = Alt + -

Boolean subtract (also called Boolean Difference) will remove the area that the second selected shape overlaps the first shape by. The order in which you select shapes will determine the outcome. This tool also works with grouped items. If you end up subtracting the items in the wrong order, Undo, then perform the operation again - The undo switches the order of the items, so a simple Undo and click-again of of the Subtract button is a quick fix.

Boolean Intersection

Hotkey = Alt + *

This will create a shape from 2 selected shapes that has an outline defined by only the areas in which the shapes overlap. This tool also works with grouped items.

The three different Boolean operations are shown here:

  • Union keeps the area covered by either shape - it merges them.
  • Difference is the 2nd shape removed from the first.
  • Intersection keeps the area covered by both shapes.

Boolean Assistant

Hotkey = Ctrl/⌘ + B

Because it can be hard to remember which operation (or which order) is going to do the thing you want, we've added a new Boolean Helper that will let you preview each of the Boolean operations before deciding on one.

Click any of the first 4 buttons to see what that operation will look like, or click the 'Reset' button to see the original shapes. If your design is not complex, hovering over the buttons will also work. When you see the result you want, click the 'Ok' button to keep it, or click 'Cancel' to revert.

Video Walkthrough of the Boolean Operations

Click for a Boolean demonstration video

The above video describes in more detail how the various Boolean operations differ, and why welding text to a circle should be done with a Boolean Union instead.

Grid Array

The Grid Array tool allows you to copy a shape (or shapes) with regular spacing horizontally, vertically, or both, and includes options to adjust spacing, to shift odd rows, mirror the shapes, and more.

The X and Y columns settings let you specify how many copies of your shape to make in each direction.

Total Width and Total Height are convenience options that allow you to tell it the maximum size to occupy/ It will set the X Columns and Y Rows values to whatever is necessary to fill the specified size without going over, based on the other provided settings.

Spacing can be specified between edges (how much padding between shapes) or between centers (absolute object spacing).

Column and Row Shift values let you offset alternate columns or rows, and you can mirror them as well, allowing you to more efficiently pack oddly shaped items together, like this:

Virtual Arrays

There is also a Virtual Array option that can be selected by checking "Create Virtual Array" at the bottom of the Grid Array dialog. Instead of making copies of the original shapes, this will generate virtual clones of the original that stay synced at all times. When using a virtual array, the virtual clones will render with a dashed outline and muted fill color to denote they are virtual:

Note that these virtual shapes are not selectable and will always be laid out based on the array options you provided. However, any changes made to the original shapes are automatically reflected in the array.

Beyond just altering the original shapes, there are many operations that can be done after the fact to virtual arrays, all of which are available from the shape context menu. This menu is available from any shape that is currently part of a virtual array. You do not have to select all shapes in that array first.

  • Edit Array: Display the "Create Grid Array" dialog again, but for this existing array. This allows you to modify any of the parameters and even convert it back into a normal array, by unchecking "Create Virtual Array".
  • Duplicate Array: Virtual arrays cannot be selected directly, only the shapes included in them. So this allows you to duplicate an entire virtual array and all of the shapes in it.
  • Flatten Array: Convert the virtual array into a standard array where all shapes are separate copies and no longer synced to the original shapes.
  • Remove from Array: Remove the currently selected shape(s) from the virtual array.
  • Add to Array: Add any currently selected shapes not in the virtual array to the array. Note, you must select at least one shape that is in a virtual array and one shape that is not in a virtual array currently.

Radial Array

The Radial Array (or circular array) tool lets you create copies of a shape (or shapes) around a central point. This is useful for creating ornamental patterns, clock faces, and more.

You can manually enter the point of rotation, but it's much simpler to create a shape to use as the center point, and select that shape last. The created copies can be rotated or not - Numbers on a clock, for example, are often left upright for readability, but roman numerals are usually rotated.

In the above example, the small center circle was selected last, and the 'Use last selected object position as center' option is chosen, along with 'Rotate object copies' to produce the pattern.

Start Point Editor

The Start Point edit tool lets you tell LightBurn where to start cutting a shape, and in which direction. By default, the starting point is the first point of the shape, and the direction will be the direction that the selection marquee animates in. In the Optimization Settings, if you tell LightBurn to choose the best starting point or best direction, it can choose a different point than the default if it will reduce cutting time. The Start Point editor lets you force the starting point and direction.

With a shape selected, click the 'Start Point' tool and you'll see the starting point and direction indicated by an arrow. If the arrow is gray, it means this shape is displaying the default point and direction, but it is not forced. If you click any node on the shape, the arrow will move there, and turn blue, indicating that the user has chosen this as the starting point and direction.

Holding Shift and clicking a point will choose the opposite direction, and holding Ctrl and clicking the shape will clear the starting point back to the default.

Radiused Corners

The Radiused Corners tool lets you round sharp corners where two lines meet. After clicking the Radiused Corners tool and entering a radius value below it, select a shape, then hover over a corner. If that corner can be curved, you should see the cursor change, like this:

If you click the corner, it will be rounded to the radius you've chosen, like this: