Return to main page


Creation Tools

CreationTools

The shape creation tools are the basic ways you build stuff from scratch in LightBurn, along with the Selection tool, and the 'Click to Position' tool.

The tools are:

Selection tool Selection

You'll likely use this more than any other tool in LightBurn. The selection arrow is used to choose which things in your workspace you want to change, and there are number of different ways that selection happens in LightBurn.

Click Selection

Point at the outline of a shape and click with the left mouse button to select it. The shape will change from solid to an animated pattern of dashes. There are several things you can tell from this pattern:

SelectionPattern

The circle on the left is not selected. The circle in the middle is selected, and it is a simple shape, because the pattern is just simple dashes. The two circles on the right are grouped - visible because the pattern is a combination of dots and dashes.

The direction that the pattern animates shows the direction that the shape will be cut in (unless you tell LightBurn that it's ok to choose a different direction).

To clear the current selection, left click an empty space in the view, or press the Esc key.

Drag Selection

If you click an empty space in the edit window and drag the cursor, a selection rectangle appears. Drag the rectangle out over a number of shapes and let go to select them. There are two types of drag selection:

Enclosing Selection:

If you drag from left to right, you'll see a red rectangle. Selecting a shape with an enclosing selection means the shape must be completely contained by the rectangle in order to select it.

DragSelect-Enclosing

Crossing Selection:

If you drag from right to left, you'll see a green rectangle. Selecting a shape with a crossing selection means that if the rectangle crosses the shape at all, the shape will be selected:

DragSelect-Enclosing

Selection Modifiers

To supplement click-select and rectangle selection, LightBurn supports these modifier keys:

  • Shift: Holding Shift while selecting will add the new selection to the current one
  • Ctrl+Shift: Holding both Ctrl and Shift will remove the new selection from the current one
  • Ctrl: Holding Ctrl by itself will toggle the selection state of the new selection

(Note that on MacOS, the Command key is used instead of the Ctrl key)

Moving, Resizing, and Rotating

When one or more shapes are selected, several controls appear around them, like this:

ClickSelect

The small squares around the outside of the selection can be clicked and dragged to resize the selection from that side or corner. If you move the mouse over one, the cursor will change to show that the action is available.

When dragging one of the four corners, the shape will maintain its relative width to height (aspect ratio) so it doesn't 'stretch'. You can override that by holding the Shift key while dragging a corner.

When dragging any of the sizing adjustments, the behavior is asymmetric - the other side of the object acts like an anchor and stays in place. Holding the Ctrl key (or Command on MacOS) makes the action symmetrical, using the center of the object as the anchor instead of the other side.

The center square that appears is a movement handle - you can click and drag it to reposition the shape, however you can also click anywhere on the boundary of the shape to do this, and you don't even have to select it first - Simply click the boundary, and while continuing to hold the left button, drag the shape.

The circular arrows shown at the four corners are used to rotate the shape. By default the rotation is "free", however holding the Ctrl key will snap it to 5 degree increments.

When dragging, scaling, or rotating shapes, the bottom status bar in the main window will often show feedback, like this:

RotateFeedback

Here I can see the position of my mouse, and the angle I have rotated the shape to while I'm rotating it.

Snapping

When you move the mouse over a shape to select it, you will occasionally see the cursor change to a small crosshair. This shows that you are over a snap point, like a corner, node, the center of a line, or the center of a shape. If you click at this moment, the point you drag the object from will be that snap point. When dragging an object to move it, as you get near other objects, those objects may also snap the cursor location, allowing you to position shapes perfectly with each other. If you are close to a grid point, the selection will snap to the grid as well.

UnsnappedMoveUnsnappedMove

If you do not want shapes to snap when dragging, hold the Ctrl key to temporarily turn off the snapping behavior.

Draw Lines tool DrawLines

Click the pencil to use the Line tool. Click anywhere on the page to start a line, then move to a new location and click again to finalize the current line at that point. This will continue until you either click back at the starting point of the shape to close it, or click the right mouse button to stop. You can also press the Esc key to cancel the current line.

DrawLinesExample

Measuring

A little known feature of the Line tool is that it is also intended to be used for measuring distances. The status display at the bottom of the main window shows the length of the line being drawn, even before you've completed it.

If you want to measure the distance between two points in your design, start a line at one point, then move the mouse to the other point, but don't click yet. Look at the status window to see the length of the line in progress. When you have noted your measurement, right-click or press Esc to cancel the line.

LineToolMeasurement

The status window shows:

  • dx: the distance along the X axis only
  • dy: the distance along the Y axis only
  • len: the length of the current line segment
  • It will also show the angle between successive line segments as you create them

Rectangle tool

The rectangle tool is used to draw squares and rectangles. Holding Shift while dragging will lock the width and height, producing a perfect square. Holding Ctrl will drag the rectangle or square from the center, instead of the corner.

With a rectangle selected, if you look in the Shape Properties Window you can adjust the 'Corner Radius' property to produce rounded rectangles, or frames with inward corners:

RectangleProperties

Ellipse tool

The ellipse tool is used to draw ellipses and circles. Similar to the Rectangle tool, holding Shift while dragging will lock the width and height, producing a perfect circle. Holding Ctrl will drag the ellipse or circle from the center, instead of the corner.

Polygon tool

The polygon tool is used to draw regular polygons, like hexagons. Holding Shift while dragging will lock the width and height. Holding Ctrl will drag the polygon from the center, instead of the corner.

With a polygon selected, if you look in the Shape Properties Window you can adjust the Sides property to change the number of sides the polygon has:

RectangleProperties

Click to Move tool

The Click-to-Move tool is a quick way to jog your laser to a location somewhere in the workspace. Select this tool, then click anywhere on the page and LightBurn will issue a command to send your laser there. This tool automatically turns itself off after about 10 seconds, in case you accidentally leave it on. Trying to select a shape and having the laser move away from where you want it can be confusing.