printCAD GitHub Download

Printing

What printCAD offers for the step from a model to a printer: the parts list's printing columns, nut traps for captive nuts, and the print layout that lays every part flat on the bed for export or the slicer. The bed itself (its size, where its origin is, whether it is drawn) and the slicer command are set in Preferences › 3D printing; Print bed on the view's pill, or View › Print bed, shows or hides it.

Printing columns

The Assembly's Parts list (B) carries three columns for printing beside the count and size of each part:

Printed in under the list picks the material: PLA (1.24 g/cm³), PETG (1.27), ABS (1.04), ASA (1.07), TPU (1.21), Nylon (1.14) or PC (1.20), or Custom with a density of your own. It is kept with the document. A body given a material of its own (Appearance, or doc.set_body) is weighed at that material's density instead.

The line under the list adds it up: how many pieces, their volume and the filament they take. Copy as CSV and Save as CSV carry the Print, Volume (cm³) and Mass (g) columns too.

A Threads column beside them names each part's cosmetic threads by designation and count ("2 × M6 thread"), the screws or inserts it takes: see HOLES.md for the threads and ASSEMBLY.md for the rest of the list.

From a script, asm.parts answers print, volume, mass and density for each part, asm.part{body = ..., print = 3} sets a count and asm.print_material{name = "PETG"} the material (a name of your own needs its density).

Text on a face

Design's Text on faces writes a label on the part in one step: click the face, pick the tool, and type in its task. Its Mode buttons raise the text out of the face, sink it in, or only imprint it, by its Height; Size, Spacing, Angle, and Across and Up (mm its middle moves on the face) place it. On a cylinder or a cone the text wraps onto the face (on by itself there): its Wrap buttons lay it round the axis, up it, or spread evenly round the whole cylinder, the gap across the back as wide as the rest; the lit one clicked again lays it flat, carried straight along the face's normal, which suits a flat face. A {formula} in the text shows its value, so a serial or revision number follows its variable, and Size, Spacing, Angle, Across and Up take formulas as any feature's numbers do. A size of zero or less is an error on the feature.

The text is written in a sketch of its own, hidden under the feature and standing 2 mm off the face: open it from the tree to lay the text out in a frame or along curves. A size, spacing or angle a formula sets on the feature sets the sketch's too, so the sketch shows the text as it builds; the sketch keeps the Across and Up typed in the task, and the build moves the text to where their formulas put it. Deleting the feature takes its sketch with it.

Text laid flat on a curved face has nowhere to land past the part's outline as seen from the front.

Nut traps

A Hole's Nut trap (in the Hole task, under the hole cut) cuts a hexagonal pocket at one end of the hole for a nut to sit in captive, so a screw turns into it from the other side.

A nut trap under an M5 hole, cut through its centre

The panel says what the pocket comes to, or why it cannot be cut (no metric size, a pocket no wider than the hole, one deeper than the hole). A nut trap's clearance, depth, across-flats and turn take formulas (Hole.nut_clearance, Hole.nut_depth, Hole.nut_across_flats, Hole.nut_turn).

ISO 4032 across flats and thickness, mm:

Size M2 M2.5 M3 M4 M5 M6 M8 M10 M12 M16 M20
Across flats 4 5 5.5 7 8 10 13 16 18 24 30
Thickness 1.6 2 2.4 3.2 4.7 5.2 6.8 8.4 10.8 14.8 18

From a script, nut_trap is a field of design.hole: nut_trap = true for the usual pocket at the mouth, or a table, {side = "Bottom", clearance = 0.4, depth = 3, across_flats = 7, turn_deg = 30, standard = "Din934"}, each field left out taking its usual value.

Hollow parts

Design's Thickness hollows a solid into walls of a set thickness. With faces picked it opens them: an open box from a block with its top picked. With no face picked it seals the hollow, a closed shell: a resin part printed hollow to save material, or a light FDM part. A resin print needs a way out for the liquid trapped inside; add a hole or a small pocket through the wall after the Thickness as its drain. The walls go inward by default; Inward off puts them outside the solid, which becomes the cavity, and Both sides puts them on both.

The layout lays out bodies, not the pieces inside one: a body whose solid is in several pieces is one part. Separate pieces on its menu makes each piece a body of its own, laid out and counted on its own.

File › Print layout… (also in the command palette) lays every part to print on the bed, as many copies as the parts list's Print column asks for, and shows them there in the view while its task is open. Nothing moves: the model is back where it was when the task closes, and the layout is only where export and the slicer put the copies.

Three parts laid flat in a corner of the bed The Print layout task

The bed is the one in Preferences › 3D printing (its width, depth, build height and whether its origin is the centre).

The task's Send to slicer writes the layout in the slicer's format and opens it in the slicer; Export… opens the export dialog set to Laid out for printing, which the dialog offers at any time. Send to slicer sends the layout (or Preferences › 3D printing › Send the print layout) makes File › Send to slicer (Ctrl+P) send the layout always. With several plates, the file holds them all, side by side.

From a script, pc.doc.print_layout{} answers where each copy goes (its body, name, plate, bounds on the bed and the transform from the body's own frame), with bed = {x, y, z} and gap to lay out for another printer; pc.doc.set_body{body = ..., print_on = 3} lies a part on its face 3 (as pc.doc.faces numbers them), print_on = "as_modelled" drops it unturned and print_on = "auto" gives the choice back; pc.file.export{path = ..., layout = true} writes the layout and pc.file.send_to_slicer{layout = true} sends it.

Files for the slicer

File › Export (Ctrl+E) writes the visible bodies, or with Selected body only the selected ones, as STEP, STL or 3MF. A file per body writes each body in a file of its own instead, named after the body, into a folder it asks for; laid out for printing, each copy gets its own file ("Bracket 1", "Bracket 2"). Files of the same name already in the folder are replaced, each written whole or not at all, as every export is.

File › Send to slicer (Ctrl+P) writes the visible bodies to a file of the slicer's format and opens it in the slicer. Send selection to slicer (File menu and command palette) sends only the selected bodies; when the layout is sent, it lays out only their parts.

From a script, pc.file.export{path = folder, per_body = true} writes a file per body and answers each file's path in files, and pc.file.send_to_slicer{selected = true} sends the selection.

A 3MF names each body's object after it and carries the colour the body shows in; a face given a colour of its own, or imported with one, keeps it, so the slicer shows the bodies as the view draws them. STL carries no colour.

Overhangs

Before printing, Inspection's Overhangs shows which surface the printer cannot lay down without support: everything leaning out past the limit (45° by default) paints hot, and the legend says how much of the surface that is. Turn the body to try another orientation; see Inspection.

Fit check

A housing for something that exists (a device, a shaft, a bearing) can be checked against its scan before printing: place the scan in it and Inspection's Fit check paints where the two interfere and how much gap is left everywhere else; see Inspection.

Clearance

A part that fits over or into another needs play between them. Design's Offset solid grows or shrinks a whole body by a distance: offset a copy of the inner part by the clearance (0.2 to 0.3 mm suits most FDM printers) and cut it from the outer one with Boolean, and the cavity keeps that gap all round (Editing › Design features).

Compensation from a scan

A print rarely comes out the size it was drawn: plastic shrinks as it cools, more across than up or the other way. Scan the print, align it onto the body it was printed from (Inspection's Best fit), and pc.inspect.compensation{scan = …, reference = …} reads how each axis came out. Each scan point's distance to the model is explained as each axis stretching about the model's middle, plus a leftover shift, by least squares. A support's remains and other defects (points past three times the fit's RMS) are left out.

stretch is each axis's stretch in percent (−0.5 is a print 0.5 % small), and compensation the factors to scale the model by so the next print comes out as drawn. tie_xy = true fits one stretch for X and Y together. rms_before and rms_after show how much of the difference the stretch explains: what is left is warp, flare at the first layer, and the scanner's own noise.

The fit reads more than the axes. Scan points on the walls of the model's round holes and of its bosses and pins each add one unknown, the radius error of that kind beyond what the stretch explains: holes and bosses give radius_error (a hole printing 0.1 mm small in radius reads −0.1) and offset, the radius change to draw them with. The side walls of the first 0.6 mm are left out of the fit and read against it afterwards: flare is how far they stand out (the elephant's foot). warp reads the bottom face: flatness, lift (how high its highest part stands over its middle height, a corner come off the bed) and at, where. The model is read as it stood on the bed, +Z up.

To print with it, pc.app.print_compensation{x = c.compensation.x, y = c.compensation.y, z = c.compensation.z, holes = c.holes.offset, bosses = c.bosses.offset, from = "PLA on the Mk4"}, or Preferences › Printing › Shrinkage. STL, 3MF and Send to slicer then draw each solid's round holes and bosses that much larger in radius (the kernel offsets their faces, the neighbours following) and scale each body about its middle by the factors; the log says by how much. A mesh body is only scaled, and STEP still writes the bodies as drawn. Make up for shrinkage turns it off and on.

The start page's Calibration coupon, or pc.doc.coupon{}, makes a test part to measure it from: holes and pins of graded sizes on a plate, a ladder of narrow slots and a fan of overhangs from 30° to 70°. The command answers where each hole, pin, slot and leaning face is, and the calibration coupon recipe fits each hole and pin on the aligned scan and dimensions it against its drawn size.

This page's source