Skip to main content

Generators

Generators create finished parts from a few dimensions instead of drawing them by hand. They are all in the Toolbox (Tools → Toolbox …, Window → Toolbox or the tile button in the tools toolbar), sorted into groups and searchable.

PageGenerators
Gears and racksGear, gear pair, rack
Pulleys and camsTiming pulley, disc cam
Finger-jointed boxesFinger Joint Box, Finger Joint Box with Dividers
Box composerA box with freely placed inner walls (extension)
Drawers, inserts and shelvesDrawer, divider insert, slot-together shelf
Layered and rib modelsLayered model and rib model from an STL or OBJ file
Disc sphereA sphere or lamp shade made of interlocking discs
Multi-layer workYour own shapes stacked into a layered relief

More generators, such as a jigsaw puzzle, rulers and scales, game boards, layered art and a street map, are extensions from the catalogue. Once installed, they appear in the Toolbox under From extensions and work like the built-in ones.

Joints between your own shapes, the lid hinge, living hinges and slots are tools rather than generators: see Joints, hinges and 3D view. Jigs are described under Print and Cut and jigs, dimensioned sketches under Snapping, guides and measuring.

Working with generators​

All generators, the built-in ones included, run as plugins in a separate process. The editor stays usable while a large part is being computed, and a long computation can be cancelled.

The generator dialog​

Every generator dialog shows a live preview and checks the values as you type; problems appear in red or orange next to the fields. Rarely needed settings are under Advanced. The preview can be zoomed with the mouse wheel and panned with the middle mouse button; the dialog can be made larger with the grip in its bottom-right corner, and the preview grows with it. Some generators have several steps, lists or a drawing surface on which you place things with the mouse (the box composer, for example). Help, fields and messages are in the right column.

Generators that need the material or the work area take them from the current layer and device: the thickness, kerf and play of a calibrated material, for example. Some can also start from the current selection, such as an image for layered art.

Create and Add​

  • Create makes the part and closes the dialog.
  • Add makes the part and keeps the dialog open, so you can set up the next one with other values. When you edit an existing part, Add creates a new one and leaves the edited part unchanged.

New parts go to the first free spot on the page, starting at the bottom left, 2 mm apart and 3 mm from the edge. Every object on the page is avoided, and an assembly (such as a box) keeps its layout. When the page is full, the part goes onto a new page. An assembly larger than the work area can spread its parts over several pages and still stays one object that you edit, save and undo in one step. A part larger than the work area asks first: Create anyway in the centre, go back, or cancel. Each Create or Add is one undo step.

Editing a part later​

Generators create parametric parts: they keep their parameters in the project. Double-click a part to reopen its dialog. The outline is recalculated, and position and rotation stay. For an assembly such as a box, a double-click on any panel edits the whole box; parts that are no longer needed disappear and new ones (such as a lid) are added.

Some changes would break the parameters: scaling, node editing, or a Boolean operation without "Keep originals". KizamuBeam then asks whether to convert the part to ordinary paths or to edit its parameters instead. Convert to Path does the conversion on purpose.

Formulas and parameters​

Every numeric field accepts a project parameter or a formula, for example {Thickness} or {Width} - 2 * {Thickness}. Choice and yes/no fields get a parameter with the ƒ button. That way a box in a template follows the values filled in, and changing the material thickness in one place updates every part.

Kerf and clearance​

Most generators have a Kerf field: the width of the laser cut. Outlines are offset outward by half of it and holes and slots get smaller, so parts come out at their nominal size. A kerf offset on the layer is applied on top, so set the kerf in one place only.

Slot-together parts also have a Fit clearance: how much play each joint gets (negative values give a press fit). Once the material of the layer is calibrated, new parts take thickness, kerf and clearance from the calibration, and existing parts offer a button to apply it.

Checking the result​

The 3D view shows assemblies put together and marks collisions in red. The design check tests the fit of every joint and whether the parts can be assembled in some order.