Base material settings (#32)

* HOME: Base material settings

* Create material_flow_ratio_and_pressure_advance.md

* Create material_basic_information.md

* Create material_print_chamber_temperature.md

* material temp

* Create material_volumetric_speed_limitation.md

* Create material_cooling_for_specific_layer.md

* Create material_part_cooling_fan.md

* Material fan union

* Create material_setting_overrides.md

* Create material_advanced.md

* Unify material multimaterial

* Create material_dependencies.md

* Update Home.md

Home.md

@@ -54,6 +54,21 @@ OrcaSlicer is a powerful open source slicer for FFF (FDM) 3D Printers. This wiki
 
 ![filament](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/filament.svg?raw=true) Settings related to the 3D printing material.
 
+- Material settings
+  - ![param_information](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_information.svg?raw=true) [Basic Information](material_basic_information)
+  - ![param_flow_ratio_and_pressure_advance](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_flow_ratio_and_pressure_advance.svg?raw=true) [Flow Ratio and Pressure Advance](material_flow_ratio_and_pressure_advance)
+  - ![param_chamber_temp](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_chamber_temp.svg?raw=true) [Print Chamber temperature](material_print_chamber_temperature)
+  - ![param_extruder_temp](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_extruder_temp.svg?raw=true)![param_bed_temp](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_bed_temp.svg?raw=true) [Material temperatures](material_temperatures)
+  - ![param_volumetric_speed](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_volumetric_speed.svg?raw=true) [Volumetric Speed limitation](material_volumetric_speed_limitation)
+- Cooling
+  - ![param_cooling_specific_layer](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_cooling_specific_layer.svg?raw=true) [Cooling for specific layer](material_cooling_for_specific_layer)
+  - ![param_cooling_part_fan](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_cooling_part_fan.svg?raw=true) [Material Fan](material_fan)
+- [Setting Overrides](material_setting_overrides)
+- ![param_gcode](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_gcode.svg?raw=true) [Advanced](material_advanced)
+- [Multimaterial](material_multimaterial)
+- ![param_dependencies_printers](https://github.com/OrcaSlicer/OrcaSlicer/blob/main/resources/images/param_dependencies_printers.svg?raw=true) [Dependencies](material_dependencies)
+
+
 ## Process Settings
 
 ![process-preset](https://github.com/OrcaSlicer/OrcaSlicer_WIKI/blob/main/images/GUI/process-preset.png?raw=true)

material_settings/advanced/material_advanced.md

@@ -0,0 +1,11 @@
+# Advanced Material Settings
+
+Advanced material settings provide additional customization options for fine-tuning the behavior of different materials in your 3D printing projects. These settings allow you to optimize print quality, adhesion, and overall performance based on the specific characteristics of each material.
+
+## Filament start G-code
+
+These settings allow you to define custom G-code commands that will be executed at the start of a print using a specific material. This can be useful for priming the nozzle, purging old filament, or performing any other necessary actions before printing.
+
+## Filament end G-code
+
+These settings allow you to define custom G-code commands that will be executed at the start and end of a print using a specific material. This can be useful for priming the nozzle, purging old filament, or performing any other necessary actions before or after printing.

material_settings/cooling/material_cooling_for_specific_layer.md

@@ -0,0 +1,13 @@
+# Material Cooling for Specific Layer
+
+This setting allows you to customize the cooling behavior of your 3D printer for specific layers of your print.  
+Proper cooling is essential for achieving high-quality prints, especially when dealing with overhangs and bridges.
+
+## No cooling for the first
+
+Number of layers to turn off cooling fans.  
+Turn off all cooling fans for the first few layers. This can be used to improve build plate adhesion.
+
+## Full fan speed at layer
+
+Fan speed will be ramped up linearly from zero at layer "close_fan_the_first_x_layers" to maximum at layer "full_fan_speed_layer". "full_fan_speed_layer" will be ignored if lower than "close_fan_the_first_x_layers", in which case the fan will be running at maximum allowed speed at layer "close_fan_the_first_x_layers" + 1.

material_settings/cooling/material_fan.md

@@ -0,0 +1,107 @@
+# Material Part Cooling Fan
+
+These settings control the behavior of the part cooling fan during printing. Proper configuration of these parameters can significantly enhance print quality by optimizing cooling for different features and layer times.
+
+- [Fan speed threshold](#fan-speed-threshold)
+  - [Min fan speed threshold](#min-fan-speed-threshold)
+  - [Max fan speed threshold](#max-fan-speed-threshold)
+- [Keep fan always on](#keep-fan-always-on)
+- [Slow printing down for better layer cooling](#slow-printing-down-for-better-layer-cooling)
+- [Don't slow down outer walls](#dont-slow-down-outer-walls)
+- [Min print speed](#min-print-speed)
+- [Force cooling for overhangs and bridges](#force-cooling-for-overhangs-and-bridges)
+- [Overhang cooling activation threshold](#overhang-cooling-activation-threshold)
+- [Overhangs and external bridges fan speed](#overhangs-and-external-bridges-fan-speed)
+- [Internal bridges fan speed](#internal-bridges-fan-speed)
+- [Support interface fan speed](#support-interface-fan-speed)
+- [Ironing fan speed](#ironing-fan-speed)
+- [Auxiliary part cooling fan](#auxiliary-part-cooling-fan)
+- [Exhaust fan](#exhaust-fan)
+  - [Activate air filtration](#activate-air-filtration)
+  - [During print](#during-print)
+  - [Complete print](#complete-print)
+
+## Fan speed threshold
+
+These settings define how the slicer manages part-cooling behavior and printing speed based on the estimated time it takes to print each layer.
+
+### Min fan speed threshold
+
+When a layer’s estimated print time falls below the minimum time, the slicer begins enabling the part-cooling fan. The fan speed is gradually interpolated between the configured minimum and maximum fan speeds, depending on how short the layer time is.
+If a minimum speed threshold is defined, the slicer may also slow down the G-code printing speed for layers faster than this value to ensure adequate cooling.
+
+### Max fan speed threshold
+
+Layers with an estimated time below the maximum time may trigger additional print-speed reduction to improve cooling.
+When auto-cooling is enabled, the fan speed may increase as needed, up to the defined maximum fan speed, which acts as the upper limit for cooling adjustments.
+
+## Keep fan always on
+
+Enabling this setting means that part cooling fan will never stop entirely and will instead run at least at minimum speed to reduce the frequency of starting and stopping.
+
+## Slow printing down for better layer cooling
+
+Enable this option to slow printing speed down to ensure that the final layer time is not shorter than the layer time threshold in "Max fan speed threshold", so that the layer can be cooled for a longer time. This can improve the quality for small details.
+
+## Don't slow down outer walls
+
+If enabled, this setting will ensure external perimeters are not slowed down to meet the minimum layer time. This is particularly helpful in the below scenarios:
+
+1. To avoid changes in shine when printing glossy filaments
+2. To avoid changes in external wall speed which may create slight wall artifacts that appear like Z banding
+3. To avoid printing at speeds which cause VFAs (fine artifacts) on the external walls
+
+## Min print speed
+
+The minimum print speed to which the printer slows down to maintain the minimum layer time defined above when the slowdown for better layer cooling is enabled.
+
+## Force cooling for overhangs and bridges
+
+Enable this option to allow adjustment of the part cooling fan speed for specifically for overhangs, internal and external bridges. Setting the fan speed specifically for these features can improve overall print quality and reduce warping.
+
+## Overhang cooling activation threshold
+
+When the overhang exceeds this specified threshold, force the cooling fan to run at the 'Overhang Fan Speed' set below. This threshold is expressed as a percentage, indicating the portion of each line's width that is unsupported by the layer beneath it. Setting this value to 0% forces the cooling fan to run for all outer walls, regardless of the overhang degree.
+
+## Overhangs and external bridges fan speed
+
+Use this part cooling fan speed when printing bridges or overhang walls with an overhang threshold that exceeds the value set in the 'Overhangs cooling threshold' parameter above. Increasing the cooling specifically for overhangs and bridges can improve the overall print quality of these features.
+
+Please note, this fan speed is clamped on the lower end by the minimum fan speed threshold set above. It is also adjusted upwards up to the maximum fan speed threshold when the minimum layer time threshold is not met.
+
+## Internal bridges fan speed
+
+The part cooling fan speed used for all internal bridges. Set to -1 to use the overhang fan speed settings instead.
+
+Reducing the internal bridges fan speed, compared to your regular fan speed, can help reduce part warping due to excessive cooling applied over a large surface for a prolonged period of time.
+
+## Support interface fan speed
+
+This part cooling fan speed is applied when printing support interfaces. Setting this parameter to a higher than regular speed reduces the layer binding strength between supports and the supported part, making them easier to separate.  
+Set to -1 to disable it.  
+This setting is overridden by disable_fan_first_layers.
+
+## Ironing fan speed
+
+This part cooling fan speed is applied when ironing. Setting this parameter to a lower than regular speed reduces possible nozzle clogging due to the low volumetric flow rate, making the interface smoother.  
+Set to -1 to disable it.
+
+## Auxiliary part cooling fan
+
+Enable this option if [machine has auxiliary](printer_basic_information_accessory#auxiliary-part-cooling-fan) part cooling fan. G-code command: M106 P2 S(0-255).
+
+## Exhaust fan
+
+Missing tooltip for this entry
+
+### Activate air filtration
+
+Activate for better air filtration. G-code command: M106 P3 S(0-255)
+
+### During print
+
+Missing tooltip for this entry
+
+### Complete print
+
+Missing tooltip for this entry

material_settings/dependencies/material_dependencies.md

@@ -0,0 +1,21 @@
+# Material Dependencies
+
+Material dependencies help ensure that a material profile is only used with compatible printer and process profiles, preventing potential printing issues.
+
+## Compatible printers
+
+Set of printers that this material profile is compatible with if you want to limit its usage to specific printers.
+
+### Printer Condition
+
+ boolean expression using the configuration values of an active printer profile.  
+ If this expression evaluates to true, this profile is considered compatible with the active printer profile.
+
+## Compatible process profiles
+
+Set of process profiles that this material profile is compatible with if you want to limit its usage to specific process profiles.
+
+### Process Condition
+
+A boolean expression using the configuration values of an active print profile.  
+If this expression evaluates to true, this profile is considered compatible with the active print profile.

material_settings/filament/material_basic_information.md

@@ -0,0 +1,88 @@
+# Material Basic Information
+
+This section contains basic information about the filament material.
+
+- [Type](#type)
+- [Vendor](#vendor)
+- [Soluble material](#soluble-material)
+- [Support material](#support-material)
+- [Filament ramming length](#filament-ramming-length)
+- [Required nozzle HRC](#required-nozzle-hrc)
+- [Default color](#default-color)
+- [Diameter](#diameter)
+- [Adhesiveness Category](#adhesiveness-category)
+- [Density](#density)
+- [Shrinkage (XY)](#shrinkage-xy)
+- [Shrinkage (Z)](#shrinkage-z)
+- [Price](#price)
+- [Softening temperature](#softening-temperature)
+- [Idle temperature](#idle-temperature)
+- [Recommended nozzle temperature](#recommended-nozzle-temperature)
+
+## Type
+
+Material base type (e.g., PLA, ABS, PETG, etc.).  
+This setting affects coefficients used in various calculations, such as brim width or temperature warnings.
+
+## Vendor
+
+Vendor of filament. For show only.
+
+## Soluble material
+
+Soluble material is commonly used to print supports and support interfaces.
+
+## Support material
+
+Support material is commonly used to print supports and support interfaces.
+
+## Filament ramming length
+
+When changing the extruder, it is recommended to extrude a certain length of filament from the original extruder. This helps minimize nozzle oozing.
+
+## Required nozzle HRC
+
+Minimum HRC of nozzle required to print the filament. A value of 0 means no checking of the nozzle's HRC.
+
+## Default color
+
+Default filament color.  
+Right click to reset value to system default.
+
+## Diameter
+
+Filament diameter is used to calculate extrusion variables in G-code, so it is important that this is accurate and precise.
+
+## Adhesiveness Category
+
+Filament category.
+
+## Density
+
+Filament density, for statistical purposes only.
+
+## Shrinkage (XY)
+
+Enter the shrinkage percentage that the filament will get after cooling (94% if you measure 94mm instead of 100mm).  
+The part will be scaled in XY to compensate. Only the filament used for the perimeter is taken into account.  
+Be sure to allow enough space between objects, as this compensation is done after the checks.
+
+## Shrinkage (Z)
+
+Enter the shrinkage percentage that the filament will get after cooling (94% if you measure 94mm instead of 100mm). The part will be scaled in Z to compensate.
+
+## Price
+
+Filament price, for statistical purposes only.
+
+## Softening temperature
+
+The material softens at this temperature, so when the bed temperature is equal to or greater than this, it's highly recommended to open the front door and/or remove the upper glass to avoid clogs.
+
+## Idle temperature
+
+Nozzle temperature when the tool is currently not used in multi-tool setups. This is only used when 'Ooze prevention' is active in Print Settings. Set to 0 to disable.
+
+## Recommended nozzle temperature
+
+Min and max recommended nozzle temperature for this filament.

material_settings/filament/material_flow_ratio_and_pressure_advance.md

@@ -0,0 +1,24 @@
+# Material Flow Ratio and Pressure Advance
+
+Flow ratio and pressure advance settings for the selected material.
+
+## Flow Ratio
+
+The material may have volumetric change after switching between molten and crystalline states. This setting changes all extrusion flow of this filament in G-code proportionally.  
+The recommended value range is between 0.95 and 1.05. You may be able to tune this value to get a nice flat surface if there is slight overflow or underflow.  
+The final object flow ratio is this value multiplied by the filament flow ratio.
+
+### Pressure Advance
+
+Pressure advance (Klipper) AKA Linear advance factor (Marlin).
+
+> [!NOTE]
+> Auto calibration result will be overwritten once enabled
+
+### Enable adaptive Pressure Advance (beta)
+
+With increasing print speeds (and hence increasing volumetric flow through the nozzle) and increasing accelerations, it has been observed that the effective PA value typically decreases. This means that a single PA value is not always 100% optimal for all features and a compromise value is usually used that does not cause too much bulging on features with lower flow speed and accelerations while also not causing gaps on faster features.
+
+This feature aims to address this limitation by modeling the response of your printer's extrusion system depending on the volumetric flow speed and acceleration it is printing at. Internally, it generates a fitted model that can extrapolate the needed pressure advance for any given volumetric flow speed and acceleration, which is then emitted to the printer depending on the current print conditions.
+
+When enabled, the pressure advance value above is overridden. However, a reasonable default value above is strongly recommended to act as a fallback and for when tool changing.

material_settings/filament/material_print_chamber_temperature.md

@@ -0,0 +1,6 @@
+# Material Print Chamber Temperature
+
+Enable this option for automated chamber temperature control. This option activates the emitting of an M191 command before the "machine_start_gcode" which sets the chamber temperature and waits until it is reached.  
+In addition, it emits an M141 command at the end of the print to turn off the chamber heater, if present.
+
+This option relies on the firmware supporting the M191 and M141 commands either via macros or natively and is usually used when an active chamber heater is installed.

material_settings/filament/material_temperatures.md

@@ -0,0 +1,11 @@
+# Material Temperatures
+
+Set the temperatures for the selected material.
+
+## Nozzle
+
+Set the nozzle temperature for the selected material for First Layer and Other Layers.
+
+## Bed
+
+Set the bed temperature for the selected material for First Layer and Other Layers for each Bed type if [Support multi bed types](printer_basic_information_printable_space#support-multi-bed-types) is enabled in printer settings.

material_settings/filament/material_volumetric_speed_limitation.md

@@ -0,0 +1,11 @@
+# Material Volumetric Speed Limitation
+
+This setting allows you to limit the volumetric speed of extrusion for a specific material. It helps to prevent issues such as under-extrusion or poor layer adhesion that can occur when printing at high speeds.
+
+## Adaptive volumetric speed
+
+When enabled, the extrusion flow is limited by the smaller of the fitted value (calculated from line width and layer height) and the user-defined maximum flow. When disabled, only the user-defined maximum flow is applied.
+
+## Max volumetric speed
+
+This setting is the volume of filament that can be melted and extruded per second. Printing speed is limited by max volumetric speed, in case of too high and unreasonable speed setting. This value cannot be zero.

material_settings/multimaterial/material_multimaterial.md

@@ -0,0 +1,83 @@
+# Material Multimaterial Settings
+
+This page documents the settings used when printing with multiple materials in Orca Slicer. It explains wipe-tower parameters, tool-change behaviour for both single-extruder and multi-extruder multimaterial setups, and ramming/purge options that help ensure reliable, contamination-free material changes.
+
+## Multimaterial Wipe Tower Parameters
+
+Wipe towers are sacrificial structures printed alongside the main object to purge excess material from the nozzle after a tool change in multimaterial printing. This ensures that the next extrusion uses the correct filament color or type without contamination from the previous material.
+
+### Minimal purge on wipe tower
+
+After a tool change, the exact position of the newly loaded filament inside the nozzle may not be known, and the filament pressure is likely not yet stable. Before purging the print head into an infill or a sacrificial object, Orca Slicer will always prime this amount of material into the wipe tower to produce successive infill or sacrificial object extrusions reliably.
+
+## Tool change parameters with single extruder MM printers
+
+These settings control filament loading and unloading for single-extruder multimaterial systems (where multiple filaments are fed to a single hotend). They govern how much filament is primed or purged on the wipe tower, the speeds used during load/unload phases, delays for flexible materials, cooling-move behaviour, stamping and the ramming routine. Proper tuning reduces cross-contamination between filaments and improves tool-change reliability.
+
+### Loading speed at the start
+
+Speed used at the very beginning of loading phase.
+
+### Loading speed
+
+Speed used for loading the filament on the wipe tower.
+
+### Unloading speed at the start
+
+Speed used for unloading the tip of the filament immediately after ramming.
+
+### Unloading speed
+
+Speed used for unloading the filament on the wipe tower (does not affect initial part of unloading just after ramming).
+
+### Delay after unloading
+
+Time to wait after the filament is unloaded. May help to get reliable tool changes with flexible materials that may need more time to shrink to original dimensions.
+
+### Number of cooling moves
+
+Filament is cooled by being moved back and forth in the cooling tubes. Specify desired number of these moves.
+
+### Speed of the first cooling move
+
+Cooling moves are gradually accelerating beginning at this speed.
+
+### Speed of the last cooling move
+
+Cooling moves are gradually accelerating towards this speed.
+
+### Stamping loading speed
+
+Speed used for stamping.
+
+### Stamping distance measured from the center of the cooling tube
+
+If set to non-zero value, filament is moved toward the nozzle between the individual cooling moves ("stamping"). This option configures how long this movement should be before the filament is retracted again.
+
+### Ramming parameters
+
+This string is edited by RammingDialog and contains ramming specific parameters.
+
+#### Total ramming
+
+The total amount of filament that will be forcibly extruded (rammed) into the nozzle during the ramming stage. This value represents the full volume (or equivalent extrusion length) applied by the ramming routine to ensure the nozzle contains the intended material and pressure before printing resumes.
+
+#### Ramming line
+
+Defines the geometry or pattern used when ramming material (for example a short line or dot on the wipe tower). The ramming line parameters control where the rammed material is deposited so it is reliably captured by the wipe structure instead of contaminating the printed part.
+
+## Tool change parameters with multi extruder MM printers
+
+These options apply to printers that use multiple independent extruders or hotends (multi-tool setups). When enabled, ramming and related parameters define a small, controlled extrusion on the wipe tower immediately before a tool change to ensure the outgoing tool is cleared and the incoming tool begins with consistent filament at the nozzle. Use these settings to tune multi-tool handoffs and avoid color or material mixing.
+
+### Enable ramming for multi-tool setups
+
+Perform ramming when using multi-tool printer (i.e. when the 'Single Extruder Multimaterial' in Printer Settings is unchecked). When checked, a small amount of filament is rapidly extruded on the wipe tower just before the tool change. This option is only used when the wipe tower is enabled.
+
+#### Multi-tool ramming volume
+
+The volume to be rammed before the tool change.
+
+#### Multi-tool ramming flow
+
+Flow used for ramming the filament before the tool change.

material_settings/setting overrides/material_setting_overrides.md

@@ -0,0 +1,11 @@
+# Material Setting Overrides
+
+Material setting overrides allow you to customize specific settings for different materials used in your 3D printing projects. This flexibility ensures optimal print quality and performance by tailoring parameters to the unique characteristics of each material.
+
+## Retraction
+
+This group of settings allows you to override the default retraction settings for the selected material. You can specify custom retraction distances, speeds, and other parameters to optimize print quality for specific materials.
+
+## Ironing
+
+These settings control the ironing process, which smooths the top surfaces of prints by moving the nozzle over them without extruding material. You can adjust parameters such as ironing speed, flow rate, and pattern to achieve the desired surface finish.