Encrust

From first model to first print

The first time, read them in order: each one starts where the last one ends. After that, go straight to the step you need.

Start with the first guide

Getting started

  1. Install Encrust

    On Windows, install Encrust from the Microsoft Store: no warning, and the Store keeps it updated. On macOS and Linux, download the file for your system from the latest release. The downloads aren't code-signed, so macOS needs one Terminal command before the first launch. The Linux packages need no extra step.

    4 min read
  2. Your first print

    You'll end with a small exposure plaque sliced for your printer, carrying your resin's own exposure. Add the printer and resin in Machine and resin, put the Exposure check plaque on the plate, read what Check finds, then slice the file your printer reads.

    7 min read
  3. Save a project and come back to it

    Press Cmd+S (Ctrl+S on Windows and Linux), name the file, and the plate is saved as an .encrust project: models, the supports you placed, the hollow shell, and which printer and resin it was for. Print settings are not kept. File > Open project... brings the plate back: a hollowed model opens hollow, and a support stands where it was grown.

    8 min read

Preparing a model

  1. Move, rotate, scale and auto-orient

    Pick a model with the Select tool. Auto-orient turns it for the preset beside it: Auto, Supports, Peel or Time. With a printer chosen it test-prints its best poses before picking one. Lay on face puts a clicked face down. Move, Rotate, Scale and Place do the rest by hand.

    11 min read
  2. Check and repair a model

    Encrust welds, orients and counts every mesh as it opens, and tags a model Broken when holes, faces without area or faces drawn twice are left. Press 3 for the Repair tool, read what it found, pick a method and click Repair. It adds no surface unasked and leaves a model as it came if a repair would leave it with more defects.

    9 min read
  3. Cut and split a model

    To cut a model, press 6, choose an axis, set the position in millimetres and click Cut. Each half closes with a flat face and lands on the plate as its own model. Join the halves adds dowels, pins, magnets or a key, so the pieces glue back true. About ten minutes.

    10 min read
  4. Arrange models and use more than one plate

    Click Arrange the plate in the Models card: Encrust packs every visible model, with the supports and raft already built for it, into the plate with the Gap you set (5 mm by default). A model that doesn't fit stays put and a message says it found no room. Send it to another plate with Edit > Move to plate.

    6 min read
  5. Hollowing and drain holes

    A hollow model with no way out prints full of liquid resin. Open Hollow (key 4), keep the 2 mm wall and press Hollow, then open Drain (key 5) and press Check drainage. Encrust paints each cavity the resin can't leave, and Drill a hole into each cuts a hole into every pocket.

    7 min read
  6. Supports: automatic, then by hand

    A new plate starts on Auto, which builds each support to Light, Medium or Heavy by what it holds. Open Supports (key 8), click Grow the supports, and Encrust puts one under every island and overhang. Then place, paint, pick and move single supports by hand.

    8 min read
  7. Press a texture into the surface

    Press 7 for the Relief tool, keep the Texture mode, choose a built-in texture, your own picture or the texture an OBJ or 3MF brought, set Depth in millimetres and click Press it in. White raises the surface by the Depth, black leaves it. Press before supports. Text and Combine have their own guides.

    9 min read
  8. Write text on a model

    Press 7, click the Text icon, type the words, choose Raised or Sunk, set Letter height and Depth in millimetres, then click the model where the text goes. The letters join the model exactly, with its sharp edges kept. About five minutes.

    6 min read
  9. Combine models: union, subtract, intersect

    Pick two or more models, press 7, click the Combine icon, choose Union, Subtract or Intersect and click Combine. Two 20 mm cubes overlapping by 10 mm come out as 15,000, 7,000 or 1,000 mm³. Subtract keeps the model you picked first and takes the rest out of it.

    6 min read
  10. Read the layer check before you print

    Check lists what is wrong on the plate at once, then reads every layer as Encrust would write it and lists where the print is likely to fail. An island cures over nothing and fails the print. A lever is a thin neck pulled off-centre. A peel is a layer the film pulls hard on. Each comes with its numbers.

    10 min read
  1. Printer, resin and support profiles

    In Machine and resin, Add a machine opens the library of bundled printers: pick one to install it, or choose Custom printer and enter panel, volume and file format. Each printer's Resins tab holds its own resins, retuned with Duplicate or taken from a sliced file. Every edit saves itself as a TOML file you can Export and Import.

    10 min read
  2. Exposure, lift and rest times

    Exposure is how long each layer is lit; lift, retract and waits decide how the plate moves between layers. Encrust keeps them in the resin, per printer, and hides every field your printer's firmware runs itself. This guide sets each one, and says which printers lock which.

    11 min read
  3. Layer height, adaptive layers and anti-aliasing

    Slice at the layer height your resin maker gives an exposure for, and leave Edge smoothing on Balanced. Adaptive height works only on a printer you have marked as accepting variable layers, which no bundled profile does. The other looks, Grey levels, Edge blur and the edge grey range are for tuning an edge once a print shows a problem.

    10 min read
  4. Get the size right

    Print a test part at 100 % Shrinkage, cure it, measure it cold and divide: percent = 100 x drawn / measured. A 20 mm bar measuring 19.90 mm wants 100.503 %. Enter it under Shrinkage in the resin's Compensation card, with its switch on. Tight holes (a, under Tolerance) and the time estimate (Unaccounted per layer) are separate.

    8 min read
  5. Open a sliced file and check its layers

    Encrust opens a .goo, .ctb, .pwmx or any other sliced file as a model rebuilt from its layers, which you can move, support again or cut for another printer. The window never shows the file's own layers. The command line does: encrust info prints the header and decodes every layer.

    6 min read
  6. Convert a sliced file to another format

    You'll end with the same layers in another printer format, such as .ctb to .goo, with no model and no new slice, in a few minutes. Encrust copies the masks unchanged, so the printer's panel must match the file's. On any other panel, the file has to be sliced again.

    8 min read
  7. A command-line resin slicer

    The encrust command is a resin slicer for the terminal. It slices a model, a project's plates or a whole folder into a printer file such as .ctb or .goo with no window, and runs a printer on your network. With --json it prints one JSON document per run, and its exit code tells a script how it went.

    10 min read

Help the project

  1. Confirm your printer with one test print

    A profile is confirmed when someone prints an Encrust file on that machine. Slice a small piece in your printer's own software, slice the same piece in Encrust, compare what both files state, print Encrust's, then report the result on GitHub with the vendor's file attached. Plan for the length of one small print.

    5 min read