table of contents
SLIC3R(1) | User Commands | SLIC3R(1) |
NAME¶
slic3r - Slice 3D models into G-Code for 3D-printing
SYNOPSIS¶
slic3r [ OPTIONS ] [ file.stl ] [ file2.stl ] ...
DESCRIPTION¶
Slic3r is a STL-to-GCODE translator for RepRap 3D printers written by Alessandro Ranellucci <aar@cpan.org> - http://slic3r.org/
OPTIONS¶
Common options:
- --help
- Output usage screen and exit
- --version
- Output the version of Slic3r and exit
- --save <file>
- Save configuration to the specified file
- --load <file>
- Load configuration from the specified file. It can be used more than once to load options from multiple files.
- -o, --output <file>
- File to output gcode to (by default, the file will be saved into the same directory as the input file using the --output-filename-format 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 --output-filename-format.
Non-slicing actions (no G-code will be generated):
- --repair
- Repair given STL files and save them as <name>_fixed.obj
- --cut <z>
- Cut given input files at given Z (relative) and export them as <name>_upper.stl and <name>_lower.stl
- --split
- Split the shells contained in given STL file into several STL files
- --info
- Output information about the supplied file(s) and exit
- -j, --threads <num> Number of threads to use (1+, default: 2)
GUI options:
- --no-plater
- Disable the plater tab
- --gui-mode
- Overrides the configured mode (simple/expert)
- --autosave <file>
- Automatically export current configuration to the specified file
Output options:
- --output-filename-format
- 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)
- --post-process
- Generated G-code will be processed with the supplied script; call this more than once to process through multiple scripts.
- --export-svg
- Export a SVG file containing slices instead of G-code.
- -m, --merge
- If multiple files are supplied, they will be composed into a single print rather than processed individually.
Printer options:
- --nozzle-diameter
- Diameter of nozzle in mm (default: 0.5)
- --print-center
- Coordinates in mm of the point to center the print around (default: 100,100)
- --z-offset
- Additional height in mm to add to vertical coordinates (+/-, default: 0)
- --gcode-flavor
- The type of G-code to generate (reprap/teacup/makerware/sailfish/mach3/no-extrusion, default: reprap)
--use-relative-e-distances Enable this to get relative E values (default: no)
- --use-firmware-retraction
- Enable firmware-controlled retraction using G10/G11 (default: no)
- --use-volumetric-e
- Express E in cubic millimeters and prepend M200 (default: no)
- --gcode-arcs
- Use G2/G3 commands for native arcs (experimental, not supported by all firmwares)
- --gcode-comments
- Make G-code verbose by adding comments (default: no)
- --vibration-limit
- Limit the frequency of moves on X and Y axes (Hz, set zero to disable; default: 0)
- --pressure-advance
- Adjust pressure using the experimental advance algorithm (K constant, set zero to disable; default: 0)
Filament options:
- --filament-diameter
- Diameter in mm of your raw filament (default: 3)
- --extrusion-multiplier
- 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)
- --temperature
- Extrusion temperature in degree Celsius, set 0 to disable (default: 200)
- --first-layer-temperature Extrusion temperature for the first layer, in degree Celsius,
- set 0 to disable (default: same as --temperature)
- --bed-temperature
- Heated bed temperature in degree Celsius, set 0 to disable (default: 0)
- --first-layer-bed-temperature Heated bed temperature for the first layer, in degree Celsius,
- set 0 to disable (default: same as --bed-temperature)
Speed options:
- --travel-speed
- Speed of non-print moves in mm/s (default: 130)
- --perimeter-speed
- Speed of print moves for perimeters in mm/s (default: 30)
- --small-perimeter-speed
- Speed of print moves for small perimeters in mm/s or % over perimeter speed (default: 30)
- --external-perimeter-speed
- Speed of print moves for the external perimeter in mm/s or % over perimeter speed (default: 70%)
- --infill-speed
- Speed of print moves in mm/s (default: 60)
- --solid-infill-speed Speed of print moves for solid surfaces in mm/s or % over infill speed
- (default: 60)
- --top-solid-infill-speed Speed of print moves for top surfaces in mm/s or % over solid infill speed
- (default: 50)
- --support-material-speed
- Speed of support material print moves in mm/s (default: 60)
- --support-material-interface-speed
- Speed of support material interface print moves in mm/s or % over support material speed (default: 100%)
- --bridge-speed
- Speed of bridge print moves in mm/s (default: 60)
- --gap-fill-speed
- Speed of gap fill print moves in mm/s (default: 20)
- --first-layer-speed Speed of print moves for bottom layer, expressed either as an absolute
- value or as a percentage over normal speeds (default: 30%)
Acceleration options:
- --perimeter-acceleration
- Overrides firmware's default acceleration for perimeters. (mm/s^2, set zero to disable; default: 0)
- --infill-acceleration
- Overrides firmware's default acceleration for infill. (mm/s^2, set zero to disable; default: 0)
- --bridge-acceleration
- Overrides firmware's default acceleration for bridges. (mm/s^2, set zero to disable; default: 0)
- --first-layer-acceleration
- Overrides firmware's default acceleration for first layer. (mm/s^2, set zero to disable; default: 0)
- --default-acceleration
- Acceleration will be reset to this value after the specific settings above have been applied. (mm/s^2, set zero to disable; default: 130)
Accuracy options:
- --layer-height
- Layer height in mm (default: 0.4)
--first-layer-height Layer height for first layer (mm or %, default: 0.35)
- --infill-every-layers
- Infill every N layers (default: 1)
- --solid-infill-every-layers
- Force a solid layer every N layers (default: 0)
Print options:
- --perimeters
- Number of perimeters/horizontal skins (range: 0+, default: 3)
- --top-solid-layers
- Number of solid layers to do for top surfaces (range: 0+, default: 3)
- --bottom-solid-layers
- Number of solid layers to do for bottom surfaces (range: 0+, default: 3)
- --solid-layers
- Shortcut for setting the two options above at once
- --fill-density
- Infill density (range: 0%-100%, default: 40%)
- --fill-angle
- Infill angle in degrees (range: 0-90, default: 45)
- --fill-pattern
- Pattern to use to fill non-solid layers (default: honeycomb)
--external-fill-pattern Pattern to use to fill solid layers (default: rectilinear)
- --start-gcode
- Load initial G-code from the supplied file. This will overwrite the default command (home all axes [G28]).
- --end-gcode
- 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]).
- --layer-gcode
- Load layer-change G-code from the supplied file (default: nothing).
- --toolchange-gcode
- Load tool-change G-code from the supplied file (default: nothing).
- --seam-position
- Position of loop starting points (random/nearest/aligned, default: aligned).
--external-perimeters-first Reverse perimeter order. (default: no)
- --spiral-vase
- Experimental option to raise Z gradually when printing single-walled vases (default: no)
- --only-retract-when-crossing-perimeters
- Disable retraction when travelling between infill paths inside the same island. (default: no)
- --solid-infill-below-area
- Force solid infill when a region has a smaller area than this threshold (mm^2, default: 70)
- --infill-only-where-needed
- Only infill under ceilings (default: no)
- --infill-first
- Make infill before perimeters (default: no)
- Quality options (slower slicing):
- --extra-perimeters
- Add more perimeters when needed (default: yes)
--avoid-crossing-perimeters Optimize travel moves so that no perimeters are crossed (default: no)
- --thin-walls
- Detect single-width walls (default: yes)
- --overhangs
- Experimental option to use bridge flow, speed and fan for overhangs (default: yes)
Support material options:
- --support-material
- Generate support material for overhangs
- --support-material-threshold
- Overhang threshold angle (range: 0-90, set 0 for automatic detection, default: 0)
- --support-material-pattern
- Pattern to use for support material (default: pillars)
- --support-material-spacing
- Spacing between pattern lines (mm, default: 2.5)
- --support-material-angle
- Support material angle in degrees (range: 0-90, default: 0)
- --support-material-interface-layers
- Number of perpendicular layers between support material and object (0+, default: 3)
- --support-material-interface-spacing
- Spacing between interface pattern lines (mm, set 0 to get a solid layer, default: 0)
- --raft-layers
- Number of layers to raise the printed objects by (range: 0+, default: 0)
- --support-material-enforce-layers
- Enforce support material on the specified number of layers from bottom, regardless of --support-material and threshold (0+, default: 0)
- --dont-support-bridges
- Experimental option for preventing support material from being generated under bridged areas (default: yes)
Retraction options:
- --retract-length
- Length of retraction in mm when pausing extrusion (default: 1)
- --retract-speed
- Speed for retraction in mm/s (default: 30)
- --retract-restart-extra
- Additional amount of filament in mm to push after compensating retraction (default: 0)
- --retract-before-travel
- Only retract before travel moves of this length in mm (default: 2)
- --retract-lift
- Lift Z by the given distance in mm when retracting (default: 0)
- --retract-layer-change
- Enforce a retraction before each Z move (default: yes)
- --wipe
- Wipe the nozzle while doing a retraction (default: no)
- Retraction options for multi-extruder setups:
- --retract-length-toolchange
- Length of retraction in mm when disabling tool (default: 1)
- --retract-restart-extra-toolchnage
- Additional amount of filament in mm to push after switching tool (default: 0)
Cooling options:
- --cooling
- Enable fan and cooling control
- --min-fan-speed
- Minimum fan speed (default: 35%)
- --max-fan-speed
- Maximum fan speed (default: 100%)
- --bridge-fan-speed
- Fan speed to use when bridging (default: 100%)
- --fan-below-layer-time Enable fan if layer print time is below this approximate number
- of seconds (default: 60)
- --slowdown-below-layer-time Slow down if layer print time is below this approximate number
- of seconds (default: 30)
- --min-print-speed
- Minimum print speed (mm/s, default: 10)
--disable-fan-first-layers Disable fan for the first N layers (default: 1)
- --fan-always-on
- Keep fan always on at min fan speed, even for layers that don't need cooling
Skirt options:
- --skirts
- Number of skirts to draw (0+, default: 1)
- --skirt-distance
- Distance in mm between innermost skirt and object (default: 6)
- --skirt-height
- Height of skirts to draw (expressed in layers, 0+, default: 1)
- --min-skirt-length
- 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)
- --brim-width
- Width of the brim that will get added to each object to help adhesion (mm, default: 0)
Transform options:
- --scale
- Factor for scaling input object (default: 1)
- --rotate
- Rotation angle in degrees (0-360, default: 0)
- --duplicate
- Number of items with auto-arrange (1+, default: 1)
- --duplicate-grid
- Number of items with grid arrangement (default: 1,1)
- --duplicate-distance
- Distance in mm between copies (default: 0)
- --xy-size-compensation
- Grow/shrink objects by the configured absolute distance (mm, default: 0)
Sequential printing options:
- --complete-objects
- When printing multiple objects and/or copies, complete each one before starting the next one; watch out for extruder collisions (default: no)
- --extruder-clearance-radius Radius in mm above which extruder won't collide with anything
- (default: 20)
- --extruder-clearance-height Maximum vertical extruder depth; i.e. vertical distance from
- extruder tip and carriage bottom (default: 20)
Miscellaneous options:
- --notes
- Notes to be added as comments to the output file
- --resolution
- Minimum detail resolution (mm, set zero for full resolution, default: 0)
- Flow options (advanced):
- --extrusion-width
- Set extrusion width manually; it accepts either an absolute value in mm (like 0.65) or a percentage over layer height (like 200%)
- --first-layer-extrusion-width
- Set a different extrusion width for first layer
- --perimeter-extrusion-width
- Set a different extrusion width for perimeters
- --external-perimeter-extrusion-width
- Set a different extrusion width for external perimeters
- --infill-extrusion-width
- Set a different extrusion width for infill
- --solid-infill-extrusion-width
- Set a different extrusion width for solid infill
- --top-infill-extrusion-width
- Set a different extrusion width for top infill
- --support-material-extrusion-width
- Set a different extrusion width for support material
--bridge-flow-ratio Multiplier for extrusion when bridging (> 0, default: 1)
Multiple extruder options:
- --extruder-offset
- Offset of each extruder, if firmware doesn't handle the displacement (can be specified multiple times, default: 0x0)
- --perimeter-extruder
- Extruder to use for perimeters (1+, default: 1)
- --infill-extruder
- Extruder to use for infill (1+, default: 1)
- --solid-infill-extruder
- Extruder to use for infill (1+, default: 1)
- --support-material-extruder
- Extruder to use for support material (1+, default: 1)
- --support-material-interface-extruder
- Extruder to use for support material interface (1+, default: 1)
- --ooze-prevention
- Drop temperature and park extruders outside a full skirt for automatic wiping (default: no)
- --standby-temperature-delta
- Temperature difference to be applied when an extruder is not active and --ooze-prevention is enabled (default: -5)
June 2014 | slic3r 1.1.4 |