.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.44.1.
.TH SLIC3R "1" "June 2014" "slic3r 1.1.4" "User Commands"
.SH NAME
slic3r \- Slice 3D models into G-Code for 3D-printing
.SH SYNOPSIS
.B slic3r
[ \fIOPTIONS \fR] [ \fIfile.stl \fR] [ \fIfile2.stl \fR] ...
.SH DESCRIPTION
Slic3r is a STL\-to\-GCODE translator for RepRap 3D printers written by
Alessandro Ranellucci <aar@cpan.org> \- http://slic3r.org/
.SH OPTIONS
.B Common options:
.RS
.TP
\fB\-\-help\fR
Output usage screen and exit

.TP
\fB\-\-version\fR
Output the version of Slic3r and exit

.TP
\fB\-\-save\fR \fI<file>\fR
Save configuration to the specified file

.TP
\fB\-\-load\fR \fI<file>\fR
Load configuration from the specified file. It can be used
more than once to load options from multiple files.

.TP
\fB\-o\fR, \fB\-\-output\fR \fI<file>\fR
File to output gcode to (by default,
the file will be saved into the same directory as the input file using the
\fB\-\-output\-filename\-format\fR to generate the filename.) If a directory is
specified for this option, the output will be saved under that directory, and
the filename will be generated by \fB\-\-output\-filename\-format\fR.
.RE

.B Non\-slicing actions (no G\-code will be generated):
.RS
.TP
\fB\-\-repair\fR
Repair given STL files and save them as <name>_fixed.obj
.TP
\fB\-\-cut\fR <z>
Cut given input files at given Z (relative) and export
them as <name>_upper.stl and <name>_lower.stl
.TP
\fB\-\-split\fR
Split the shells contained in given STL file into several STL files
.TP
\fB\-\-info\fR
Output information about the supplied file(s) and exit
.TP
\fB\-j\fR, \fB\-\-threads\fR <num> Number of threads to use (1+, default: 2)
.RE

.B GUI options:
.RS
.TP
\fB\-\-no\-plater\fR
Disable the plater tab
.TP
\fB\-\-gui\-mode\fR
Overrides the configured mode (simple/expert)
.TP
\fB\-\-autosave\fR <file>
Automatically export current configuration to the specified file
.RE

.B Output options:
.RS
.TP
\fB\-\-output\-filename\-format\fR
Output file name format; all config options enclosed in brackets
will be replaced by their values, as well as [input_filename_base]
and [input_filename] (default: [input_filename_base].gcode)
.TP
\fB\-\-post\-process\fR
Generated G\-code will be processed with the supplied script;
call this more than once to process through multiple scripts.
.TP
\fB\-\-export\-svg\fR
Export a SVG file containing slices instead of G\-code.
.TP
\fB\-m\fR, \fB\-\-merge\fR
If multiple files are supplied, they will be composed into a single
print rather than processed individually.
.RE

.B Printer options:
.RS
.TP
\fB\-\-nozzle\-diameter\fR
Diameter of nozzle in mm (default: 0.5)
.TP
\fB\-\-print\-center\fR
Coordinates in mm of the point to center the print around
(default: 100,100)
.TP
\fB\-\-z\-offset\fR
Additional height in mm to add to vertical coordinates
(+/\-, default: 0)
.TP
\fB\-\-gcode\-flavor\fR
The type of G\-code to generate (reprap/teacup/makerware/sailfish/mach3/no\-extrusion,
default: reprap)
.HP
\fB\-\-use\-relative\-e\-distances\fR Enable this to get relative E values (default: no)
.TP
\fB\-\-use\-firmware\-retraction\fR
Enable firmware\-controlled retraction using G10/G11 (default: no)
.TP
\fB\-\-use\-volumetric\-e\fR
Express E in cubic millimeters and prepend M200 (default: no)
.TP
\fB\-\-gcode\-arcs\fR
Use G2/G3 commands for native arcs (experimental, not supported
by all firmwares)
.TP
\fB\-\-gcode\-comments\fR
Make G\-code verbose by adding comments (default: no)
.TP
\fB\-\-vibration\-limit\fR
Limit the frequency of moves on X and Y axes (Hz, set zero to disable;
default: 0)
.TP
\fB\-\-pressure\-advance\fR
Adjust pressure using the experimental advance algorithm (K constant, set zero
to disable; default: 0)
.RE

.B Filament options:
.RS
.TP
\fB\-\-filament\-diameter\fR
Diameter in mm of your raw filament (default: 3)

.TP
\fB\-\-extrusion\-multiplier\fR
Change this to alter the amount of plastic extruded. There should be
very little need to change this value, which is only useful to
compensate for filament packing (default: 1)
.TP
\fB\-\-temperature\fR
Extrusion temperature in degree Celsius, set 0 to disable (default: 200)
.TP
\fB\-\-first\-layer\-temperature\fR Extrusion temperature for the first layer, in degree Celsius,
set 0 to disable (default: same as \fB\-\-temperature\fR)
.TP
\fB\-\-bed\-temperature\fR
Heated bed temperature in degree Celsius, set 0 to disable (default: 0)
.TP
\fB\-\-first\-layer\-bed\-temperature\fR Heated bed temperature for the first layer, in degree Celsius,
set 0 to disable (default: same as \fB\-\-bed\-temperature\fR)
.RE

.B Speed options:
.RS
.TP
\fB\-\-travel\-speed\fR
Speed of non\-print moves in mm/s (default: 130)
.TP
\fB\-\-perimeter\-speed\fR
Speed of print moves for perimeters in mm/s (default: 30)
.TP
\fB\-\-small\-perimeter\-speed\fR
Speed of print moves for small perimeters in mm/s or % over perimeter speed
(default: 30)
.TP
\fB\-\-external\-perimeter\-speed\fR
Speed of print moves for the external perimeter in mm/s or % over perimeter speed
(default: 70%)
.TP
\fB\-\-infill\-speed\fR
Speed of print moves in mm/s (default: 60)
.TP
\fB\-\-solid\-infill\-speed\fR Speed of print moves for solid surfaces in mm/s or % over infill speed
(default: 60)
.TP
\fB\-\-top\-solid\-infill\-speed\fR Speed of print moves for top surfaces in mm/s or % over solid infill speed
(default: 50)
.TP
\fB\-\-support\-material\-speed\fR
Speed of support material print moves in mm/s (default: 60)
.TP
\fB\-\-support\-material\-interface\-speed\fR
Speed of support material interface print moves in mm/s or % over support material
speed (default: 100%)
.TP
\fB\-\-bridge\-speed\fR
Speed of bridge print moves in mm/s (default: 60)
.TP
\fB\-\-gap\-fill\-speed\fR
Speed of gap fill print moves in mm/s (default: 20)
.TP
\fB\-\-first\-layer\-speed\fR Speed of print moves for bottom layer, expressed either as an absolute
value or as a percentage over normal speeds (default: 30%)
.RE

.B Acceleration options:
.RS
.TP
\fB\-\-perimeter\-acceleration\fR
Overrides firmware's default acceleration for perimeters. (mm/s^2, set zero
to disable; default: 0)
.TP
\fB\-\-infill\-acceleration\fR
Overrides firmware's default acceleration for infill. (mm/s^2, set zero
to disable; default: 0)
.TP
\fB\-\-bridge\-acceleration\fR
Overrides firmware's default acceleration for bridges. (mm/s^2, set zero
to disable; default: 0)
.TP
\fB\-\-first\-layer\-acceleration\fR
Overrides firmware's default acceleration for first layer. (mm/s^2, set zero
to disable; default: 0)
.TP
\fB\-\-default\-acceleration\fR
Acceleration will be reset to this value after the specific settings above
have been applied. (mm/s^2, set zero to disable; default: 130)
.RE

.B Accuracy options:
.RS
.TP
\fB\-\-layer\-height\fR
Layer height in mm (default: 0.4)
.HP
\fB\-\-first\-layer\-height\fR Layer height for first layer (mm or %, default: 0.35)
.TP
\fB\-\-infill\-every\-layers\fR
Infill every N layers (default: 1)
.TP
\fB\-\-solid\-infill\-every\-layers\fR
Force a solid layer every N layers (default: 0)
.RE

.B Print options:
.RS
.TP
\fB\-\-perimeters\fR
Number of perimeters/horizontal skins (range: 0+, default: 3)
.TP
\fB\-\-top\-solid\-layers\fR
Number of solid layers to do for top surfaces (range: 0+, default: 3)
.TP
\fB\-\-bottom\-solid\-layers\fR
Number of solid layers to do for bottom surfaces (range: 0+, default: 3)
.TP
\fB\-\-solid\-layers\fR
Shortcut for setting the two options above at once
.TP
\fB\-\-fill\-density\fR
Infill density (range: 0%\-100%, default: 40%)
.TP
\fB\-\-fill\-angle\fR
Infill angle in degrees (range: 0\-90, default: 45)
.TP
\fB\-\-fill\-pattern\fR
Pattern to use to fill non\-solid layers (default: honeycomb)
.HP
\fB\-\-external\-fill\-pattern\fR
Pattern to use to fill solid layers (default: rectilinear)
.TP
\fB\-\-start\-gcode\fR
Load initial G\-code from the supplied file. This will overwrite
the default command (home all axes [G28]).
.TP
\fB\-\-end\-gcode\fR
Load final G\-code from the supplied file. This will overwrite
the default commands (turn off temperature [M104 S0],
home X axis [G28 X], disable motors [M84]).
.TP
\fB\-\-layer\-gcode\fR
Load layer\-change G\-code from the supplied file (default: nothing).
.TP
\fB\-\-toolchange\-gcode\fR
Load tool\-change G\-code from the supplied file (default: nothing).
.TP
\fB\-\-seam\-position\fR
Position of loop starting points (random/nearest/aligned, default: aligned).
.HP
\fB\-\-external\-perimeters\-first\fR Reverse perimeter order. (default: no)
.TP
\fB\-\-spiral\-vase\fR
Experimental option to raise Z gradually when printing single\-walled vases
(default: no)
.TP
\fB\-\-only\-retract\-when\-crossing\-perimeters\fR
Disable retraction when travelling between infill paths inside the same island.
(default: no)
.TP
\fB\-\-solid\-infill\-below\-area\fR
Force solid infill when a region has a smaller area than this threshold
(mm^2, default: 70)
.TP
\fB\-\-infill\-only\-where\-needed\fR
Only infill under ceilings (default: no)
.TP
\fB\-\-infill\-first\fR
Make infill before perimeters (default: no)
.IP
Quality options (slower slicing):
.TP
\fB\-\-extra\-perimeters\fR
Add more perimeters when needed (default: yes)
.HP
\fB\-\-avoid\-crossing\-perimeters\fR Optimize travel moves so that no perimeters are crossed (default: no)
.TP
\fB\-\-thin\-walls\fR
Detect single\-width walls (default: yes)
.TP
\fB\-\-overhangs\fR
Experimental option to use bridge flow, speed and fan for overhangs
(default: yes)
.RE

.B Support material options:
.RS
.TP
\fB\-\-support\-material\fR
Generate support material for overhangs
.TP
\fB\-\-support\-material\-threshold\fR
Overhang threshold angle (range: 0\-90, set 0 for automatic detection,
default: 0)
.TP
\fB\-\-support\-material\-pattern\fR
Pattern to use for support material (default: pillars)
.TP
\fB\-\-support\-material\-spacing\fR
Spacing between pattern lines (mm, default: 2.5)
.TP
\fB\-\-support\-material\-angle\fR
Support material angle in degrees (range: 0\-90, default: 0)
.TP
\fB\-\-support\-material\-interface\-layers\fR
Number of perpendicular layers between support material and object (0+, default: 3)
.TP
\fB\-\-support\-material\-interface\-spacing\fR
Spacing between interface pattern lines (mm, set 0 to get a solid layer, default: 0)
.TP
\fB\-\-raft\-layers\fR
Number of layers to raise the printed objects by (range: 0+, default: 0)
.TP
\fB\-\-support\-material\-enforce\-layers\fR
Enforce support material on the specified number of layers from bottom,
regardless of \fB\-\-support\-material\fR and threshold (0+, default: 0)
.TP
\fB\-\-dont\-support\-bridges\fR
Experimental option for preventing support material from being generated under bridged areas (default: yes)
.RE

.B Retraction options:
.RS
.TP
\fB\-\-retract\-length\fR
Length of retraction in mm when pausing extrusion (default: 1)
.TP
\fB\-\-retract\-speed\fR
Speed for retraction in mm/s (default: 30)
.TP
\fB\-\-retract\-restart\-extra\fR
Additional amount of filament in mm to push after
compensating retraction (default: 0)
.TP
\fB\-\-retract\-before\-travel\fR
Only retract before travel moves of this length in mm (default: 2)
.TP
\fB\-\-retract\-lift\fR
Lift Z by the given distance in mm when retracting (default: 0)
.TP
\fB\-\-retract\-layer\-change\fR
Enforce a retraction before each Z move (default: yes)
.TP
\fB\-\-wipe\fR
Wipe the nozzle while doing a retraction (default: no)
.IP
Retraction options for multi\-extruder setups:
.TP
\fB\-\-retract\-length\-toolchange\fR
Length of retraction in mm when disabling tool (default: 1)
.TP
\fB\-\-retract\-restart\-extra\-toolchnage\fR
Additional amount of filament in mm to push after
switching tool (default: 0)
.RE

.B Cooling options:
.RS
.TP
\fB\-\-cooling\fR
Enable fan and cooling control
.TP
\fB\-\-min\-fan\-speed\fR
Minimum fan speed (default: 35%)
.TP
\fB\-\-max\-fan\-speed\fR
Maximum fan speed (default: 100%)
.TP
\fB\-\-bridge\-fan\-speed\fR
Fan speed to use when bridging (default: 100%)
.TP
\fB\-\-fan\-below\-layer\-time\fR Enable fan if layer print time is below this approximate number
of seconds (default: 60)
.TP
\fB\-\-slowdown\-below\-layer\-time\fR Slow down if layer print time is below this approximate number
of seconds (default: 30)
.TP
\fB\-\-min\-print\-speed\fR
Minimum print speed (mm/s, default: 10)
.HP
\fB\-\-disable\-fan\-first\-layers\fR Disable fan for the first N layers (default: 1)
.TP
\fB\-\-fan\-always\-on\fR
Keep fan always on at min fan speed, even for layers that don't need
cooling
.RE

.B Skirt options:
.RS
.TP
\fB\-\-skirts\fR
Number of skirts to draw (0+, default: 1)
.TP
\fB\-\-skirt\-distance\fR
Distance in mm between innermost skirt and object
(default: 6)
.TP
\fB\-\-skirt\-height\fR
Height of skirts to draw (expressed in layers, 0+, default: 1)
.TP
\fB\-\-min\-skirt\-length\fR
Generate no less than the number of loops required to consume this length
of filament on the first layer, for each extruder (mm, 0+, default: 0)
.TP
\fB\-\-brim\-width\fR
Width of the brim that will get added to each object to help adhesion
(mm, default: 0)
.RE

.B Transform options:
.RS
.TP
\fB\-\-scale\fR
Factor for scaling input object (default: 1)
.TP
\fB\-\-rotate\fR
Rotation angle in degrees (0\-360, default: 0)
.TP
\fB\-\-duplicate\fR
Number of items with auto\-arrange (1+, default: 1)
.TP
\fB\-\-duplicate\-grid\fR
Number of items with grid arrangement (default: 1,1)
.TP
\fB\-\-duplicate\-distance\fR
Distance in mm between copies (default: 0)
.TP
\fB\-\-xy\-size\-compensation\fR
Grow/shrink objects by the configured absolute distance (mm, default: 0)
.RE

.B Sequential printing options:
.RS
.TP
\fB\-\-complete\-objects\fR
When printing multiple objects and/or copies, complete each one before
starting the next one; watch out for extruder collisions (default: no)
.TP
\fB\-\-extruder\-clearance\-radius\fR Radius in mm above which extruder won't collide with anything
(default: 20)
.TP
\fB\-\-extruder\-clearance\-height\fR Maximum vertical extruder depth; i.e. vertical distance from
extruder tip and carriage bottom (default: 20)
.RE

.B Miscellaneous options:
.RS
.TP
\fB\-\-notes\fR
Notes to be added as comments to the output file
.TP
\fB\-\-resolution\fR
Minimum detail resolution (mm, set zero for full resolution, default: 0)
.IP
Flow options (advanced):
.TP
\fB\-\-extrusion\-width\fR
Set extrusion width manually; it accepts either an absolute value in mm
(like 0.65) or a percentage over layer height (like 200%)
.TP
\fB\-\-first\-layer\-extrusion\-width\fR
Set a different extrusion width for first layer
.TP
\fB\-\-perimeter\-extrusion\-width\fR
Set a different extrusion width for perimeters
.TP
\fB\-\-external\-perimeter\-extrusion\-width\fR
Set a different extrusion width for external perimeters
.TP
\fB\-\-infill\-extrusion\-width\fR
Set a different extrusion width for infill
.TP
\fB\-\-solid\-infill\-extrusion\-width\fR
Set a different extrusion width for solid infill
.TP
\fB\-\-top\-infill\-extrusion\-width\fR
Set a different extrusion width for top infill
.TP
\fB\-\-support\-material\-extrusion\-width\fR
Set a different extrusion width for support material
.HP
\fB\-\-bridge\-flow\-ratio\fR Multiplier for extrusion when bridging (> 0, default: 1)
.RE

.B Multiple extruder options:
.RS
.TP
\fB\-\-extruder\-offset\fR
Offset of each extruder, if firmware doesn't handle the displacement
(can be specified multiple times, default: 0x0)
.TP
\fB\-\-perimeter\-extruder\fR
Extruder to use for perimeters (1+, default: 1)
.TP
\fB\-\-infill\-extruder\fR
Extruder to use for infill (1+, default: 1)
.TP
\fB\-\-solid\-infill\-extruder\fR
Extruder to use for infill (1+, default: 1)
.TP
\fB\-\-support\-material\-extruder\fR
Extruder to use for support material (1+, default: 1)
.TP
\fB\-\-support\-material\-interface\-extruder\fR
Extruder to use for support material interface (1+, default: 1)
.TP
\fB\-\-ooze\-prevention\fR
Drop temperature and park extruders outside a full skirt for automatic wiping
(default: no)
.TP
\fB\-\-standby\-temperature\-delta\fR
Temperature difference to be applied when an extruder is not active and
\fB\-\-ooze\-prevention\fR is enabled (default: \fB\-5\fR)