ZSLICEDOCS

User guide

The command line

The zslice tool slices a part with no window. Use it in scripts, on a server, or to check a slice. The user guide explains the apps.

Build zslice

You need Zig 0.16 (https://ziglang.org/download/).

git clone https://github.com/beetlebugorg/zslice
cd zslice
zig build -Doptimize=ReleaseFast

The tool is zig-out/bin/zslice. Copy it to a folder in your PATH, or use the full path.

Slice a part

zslice slice part.stl -o part.gcode

zslice reads binary and ASCII STL files and 3MF files. It writes G-code for printers with Marlin or Klipper firmware. At the end, it shows a summary:

239 layers, 3.92 m filament (11.7 g), about 50 min, sliced in 383 ms

The time is an estimate. It uses the acceleration and the corner speed of the machine settings. The heat-up and the start G-code are not in it.

Without -o, zslice writes the G-code to the standard output.

Change settings

Use -s group.name=value for each change:

zslice slice part.stl -o part.gcode \
  -s project.layer_height=0.15 \
  -s project.wall_count=3 \
  -s filament.nozzle_temp=220

Use -m, -f, and -p for a machine, a filament, and a project profile:

zslice slice part.stl -m generic -f generic-petg -p fine -o part.gcode

To see all settings and their default values:

zslice settings
zslice profiles      # the built-in profiles

The settings reference explains each setting. To keep settings in files (one for your printer, one for each filament), see Profiles.

The three groups

The settings have three groups. Each group has a different owner:

GroupWhat it describesWhen it changes
machineThe printer: the bed size, the nozzle, the speed limits, the start and end G-code.When you change the printer.
filamentThe material: the diameter, the temperatures, the maximum flow, the cooling.When you change the filament.
projectWhat you want for this part: the layer height, the walls, the skin, the infill.For each part.

The engine group has options that do not change the print, for example the number of threads.

How much plastic

zslice computes the plastic for each line from the shape of a real bead. The nozzle presses the bead flat on the top and the bottom, and its sides are round. A line 0.44 mm wide and 0.2 mm tall has a cross section of 0.079 mm². If your lines come out too thin or too thick, calibrate filament.flow_ratio.

zslice 0.1 used a rectangle (width x height) for this area, as Cura does. That is about 11 % more plastic for this line. If you calibrated flow_ratio with zslice 0.1, calibrate it again.

Speeds

A project does not set speeds in mm/s. It sets a ratio (0 to 1) for each feature, for example project.outer_wall_speed=0.5. zslice computes the allowed speed of each line from two limits:

  1. The machine limit: machine.max_speed.
  2. The flow limit of the filament: filament.max_flow divided by the cross section of the line (line width x layer height). A wide, tall line needs more plastic for each millimeter, so it must go slower.

The allowed speed is the lower of the two. The ratio of the feature then scales it. An example with the defaults: a 0.44 mm x 0.2 mm line can go at 12 / (0.44 x 0.2) = 136 mm/s. The outer wall ratio is 0.5, so the outer wall goes at 68 mm/s.

Thus one project works on a slow printer and on a fast printer, and with PLA and with TPU. Only the machine and filament settings change.

Look at a layer

preview writes an SVG picture of one layer. Open it in a web browser.

zslice preview part.stl --layer 20 -o layer20.svg
ColorFeature
OrangeOuter wall
YellowInner walls
BlueSkin (solid top and bottom fill)
GreenSparse infill
PurpleIroning
BrownSkirt and brim
Light graySupport
Dark graySupport interface
TealSlope smoothing (beads in the steps of a sloped top)
LimeSlope ironing (ironing over the steps of a sloped top)
Gray dashesTravel moves

The light gray area is the outline of the layer. Each line has the width of the line, so you can see gaps and overlaps.

Layer numbers start at 0. If the number is too large, zslice shows the number of layers in the part.

Try the demo part

zslice demo demo.stl
zslice preview demo.stl --layer 28 -o layer28.svg

The demo part is a wide box with a smaller box on top, and a tube. Layer 28 is just below the step. It has skin on the step and in the floor of the tube hole, and sparse infill under the upper box.

Check a part

These commands print what the apps show in their Gaps and Check tools:

zslice gaps part.stl               # the gaps of each layer
zslice gaps part.stl --layer 49    # the gaps of one layer
zslice check part.stl              # what can make the print fail

See which settings matter for a part

zslice sweep slices the part again and again. For each project and filament setting, it tries values across the usual range. The other settings keep their base values:

zslice sweep part.stl -m my-printer -f my-pla -p my-project -o sweep.tsv

The file has one row for each slice: the setting, the value, the print time, the plastic in grams, the cost, the travel, and the retractions. At the end, the tool lists the settings that change the print time and the cost of this part the most. The cost is the plastic weight times filament.price_per_kg.

A sweep of the Benchy (382 slices) runs for about 45 seconds.

Measure the speed

zslice bench part.stl slices the part many times and prints the time of a full slice and of a slice after a change of one setting:

full slice     wall median   349.7 ms
late (infill)  wall median    62.4 ms
wall count     wall median   310.0 ms

These times are for a 3DBenchy on a desktop CPU from 2015 with 4 cores (8 threads).