Filament: Retraction

22 settings. Keys are OrcaSlicer's own names. See the index for the other groups and the guide for how to read and apply them.

#filament_deretraction_speed

Filament deretraction speed

• Type: list of numbers, one per extruder
• Unit: mm/s
• Default: [0]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_long_retractions_when_cut

Filament long retractions when cut

• Type: list of booleans, one per extruder
• Default: [false]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_after_wipe

Filament retract after wipe

• Type: list of percents, one per extruder
• Unit: %
• Default: [0]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_before_wipe

Filament retract before wipe

• Type: list of percents, one per extruder
• Unit: %
• Default: [100]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_length_nc

Filament retract length nc

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [10]
• Recommended range: 0 to 18
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_length_toolchange

Filament retract length toolchange

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [10]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_lift_above

Filament retract lift above

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [0]
• Recommended range: 0 to no maximum
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_lift_below

Filament retract lift below

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [0]
• Recommended range: 0 to no maximum
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_lift_enforce

Filament retract lift enforce

• Type: list of enum values, one per extruder
• Default: ["All Surfaces"]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Values: All Surfaces, Top Only, Bottom Only, Top and Bottom
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_restart_extra

Filament retract restart extra

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [0]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_restart_extra_toolchange

Filament retract restart extra toolchange

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [0]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retract_when_changing_layer

Filament retract when changing layer

• Type: list of booleans, one per extruder
• Default: [false]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retraction_distances_when_cut

Filament retraction distances when cut

• Type: list of numbers, one per extruder
• Default: [18]
• Recommended range: 10 to 18
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retraction_length

Filament retraction length

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [0.8]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retraction_minimum_travel

Filament retraction minimum travel

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [2]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_retraction_speed

Filament retraction speed

• Type: list of numbers, one per extruder
• Unit: mm/s
• Default: [30]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_wipe

Filament wipe

• Type: list of booleans, one per extruder
• Default: [false]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_wipe_distance

Filament wipe distance

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [1]
• Recommended range: 0 to no maximum
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_z_hop

Filament Z hop height

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [0.4]
• Recommended range: 0 to 5
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#filament_z_hop_types

Filament z hop types

• Type: list of enum values, one per extruder
• Default: ["Slope Lift"]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Values: Auto Lift, Normal Lift, Slope Lift, Spiral Lift
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#long_retractions_when_ec

Long retractions when ec

• Type: list of booleans, one per extruder
• Default: [false]
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)

#retraction_distances_when_ec

Retraction distances when ec

• Type: list of numbers, one per extruder
• Unit: mm
• Default: [10]
• Recommended range: 0 to 10
• Nullable: A profile can store nil to take the value from another profile; the key is then left out.
• Changing it redoes: G-code only
• PrintPilot class: read (not in the catalog: never written)