diff --git a/README.md b/README.md index eff7c963171..feb2b5ba243 100644 --- a/README.md +++ b/README.md @@ -28,9 +28,9 @@ Optimize your prints with ultra-fast slicing, intelligent support generation, an - **[Advanced Calibration Tools](https://github.com/SoftFever/OrcaSlicer/wiki/Calibration)** Comprehensive suite: temperature towers, flow rate, retraction & more for optimal performance. -- **[Precise Wall](https://github.com/SoftFever/OrcaSlicer/wiki/Precise-wall) and [Seam Control](https://github.com/SoftFever/OrcaSlicer/wiki/quality_settings_seam)** +- **[Precise Wall](https://github.com/SoftFever/OrcaSlicer/wiki/quality_settings_precision#precise-wall) and [Seam Control](https://github.com/SoftFever/OrcaSlicer/wiki/quality_settings_seam)** Adjust outer wall spacing and apply scarf seams to enhance print accuracy. -- **Sandwich Mode and [SuperSlicer Polyholes](https://github.com/supermerill/SuperSlicer/wiki/Polyholes) Support** +- **Sandwich Mode and [Polyholes](https://github.com/SoftFever/OrcaSlicer/wiki/quality_settings_precision#polyholes) Support** Use varied infill patterns and accurate hole shapes for improved clarity. - **Overhang and Support Optimization** Modify geometry for printable overhangs with precise support placement. diff --git a/doc/Home.md b/doc/Home.md index c0738b56ddb..53b9ca44407 100644 --- a/doc/Home.md +++ b/doc/Home.md @@ -2,16 +2,25 @@ Orca slicer is a powerful open source slicer for FFF (FDM) 3D Printers. This wiki page aims to provide an detailed explanation of the slicer settings, how to get the most out of them as well as how to calibrate and setup your printer. +- [Prepare](#prepare) - [Print Settings, Tips and Tricks](#print-settings-tips-and-tricks) - [Quality Settings](#quality-settings) - [Speed Settings](#speed-settings) - - [Multi material](#multi-material) + - [Strength Settings](#strength-settings) +- [Material Settings](#material-settings) - [Printer Settings](#printer-settings) - [Printer Calibration](#printer-calibration) - [Developer Section](#developer-section) > [!NOTE] -> The Wiki is **Work In Progress** so bear with us while we get it up and running! +> The Wiki is **Work In Progress** so bear with us while we get it up and running! +> Please consider contributing to the wiki following the [How to contribute to the wiki](How-to-wiki) guide. + +## Prepare + +First steps to prepare your model/s for printing. + +- [STL Transformation](stl-transformation) ## Print Settings, Tips and Tricks @@ -22,17 +31,30 @@ The below sections provide a detailed settings explanation as well as tips and t - [Layer Height Settings](quality_settings_layer_height) - [Line Width Settings](quality_settings_line_width) - [Seam Settings](quality_settings_seam) -- [Precise wall](Precise-wall) -- [Precise Z height](precise-z-height) -- [STL Transformation](stl-transformation) +- [Precision](quality_settings_precision) + - [Precise Wall](quality_settings_precision#precise-wall) + - [Precise Z Height](quality_settings_precision#precise-z-height) + - [Slice gap closing radius](quality_settings_precision#slice-gap-closing-radius) + - [Resolution](quality_settings_precision#resolution) + - [Arc fitting](quality_settings_precision#arc-fitting) + - [X-Y Compensation](quality_settings_precision#x-y-compensation) + - [Elephant foot compensation](quality_settings_precision#elephant-foot-compensation) + - [Precise wall](quality_settings_precision#precise-wall) + - [Precise Z Height](quality_settings_precision#precise-z-height) + - [Polyholes](quality_settings_precision#polyholes) ### Speed Settings -- [Extrusion rate smoothing](extrusion-rate-smoothing) +- [Extrusion rate smoothing](speed_extrusion_rate_smoothing) -### Multi material +### Strength Settings + +- [Infill](strength_settings_infill) + +## Material Settings - [Single Extruder Multimaterial](semm) +- [Pellet Printers (pellet flow coefficient)](pellet-flow-coefficient) ### Printer Settings @@ -41,8 +63,6 @@ The below sections provide a detailed settings explanation as well as tips and t - [Chamber temperature control](chamber-temperature) - [Adaptive Bed Mesh](adaptive-bed-mesh) - [Using different bed types in Orca](bed-types) -- [Pellet Printers (pellet flow coefficient)](pellet-flow-coefficient) -- [Fill Patterns](fill-patterns) ## Printer Calibration @@ -61,8 +81,12 @@ The [Calibration Guide](Calibration) outlines Orca’s key calibration tests and ## Developer Section +This is a documentation from someone exploring the code and is by no means complete or even completely accurate. Please edit the parts you might find inaccurate. This is probably going to be helpful nonetheless. + - [How to build Orca Slicer](How-to-build) - [Localization and translation guide](Localization_guide) -- [Developer Reference](Developers-Home) - [How to create profiles](How-to-create-profiles) - [How to contribute to the wiki](How-to-wiki) +- [Preset, PresetBundle and PresetCollection](Preset-and-bundle) +- [Plater, Sidebar, Tab, ComboBox](plater-sidebar-tab-combobox) +- [Slicing Call Hierarchy](slicing-hierarchy) diff --git a/doc/Precise-wall.md b/doc/Precise-wall.md deleted file mode 100644 index b1ba5f3de31..00000000000 --- a/doc/Precise-wall.md +++ /dev/null @@ -1,25 +0,0 @@ -# Precise Wall - -The 'Precise Wall' is a distinctive feature introduced by OrcaSlicer, aimed at improving the dimensional accuracy of prints and minimizing layer inconsistencies by slightly increasing the spacing between the outer wall and the inner wall. - -## Technical explanation - -Below is a technical explanation of how this feature works. - -First, it's important to understand some basic concepts like flow, extrusion width, and space. Slic3r has an excellent document that covers these topics in detail. You can refer to this [article](https://manual.slic3r.org/advanced/flow-math). - -Now, let's dive into the specifics. Slic3r and its forks, such as PrusaSlicer, SuperSlicer, and OrcaSlicer, assume that the extrusion path has an oval shape, which accounts for the overlaps. For example, if we set the wall width to 0.4mm and the layer height to 0.2mm, the combined thickness of two walls laid side by side is 0.714mm instead of 0.8mm due to the overlapping. - -- **Precise Wall Off** - - ![PreciseWallOff](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/PreciseWall/PreciseWallOff.svg?raw=true) - -- **Precise Wall On** - - ![PreciseWallOn](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/PreciseWall/PreciseWallOn.svg?raw=true) - -This approach enhances the strength of 3D-printed parts. However, it does have some side effects. For instance, when the inner-outer wall order is used, the outer wall can be pushed outside, leading to potential size inaccuracy and more layer inconsistency. - -It's important to keep in mind that this approach to handling flow is specific to Slic3r and its forks. Other slicing software, such as Cura, assumes that the extrusion path is rectangular and, therefore, does not include overlapping. Two 0.4 mm walls will result in a 0.8 mm shell thickness in Cura. - -OrcaSlicer adheres to Slic3r's approach to handling flow. To address the downsides mentioned earlier, OrcaSlicer introduced the 'Precise Wall' feature. When this feature is enabled in OrcaSlicer, the overlap between the outer wall and its adjacent inner wall is set to zero. This ensures that the overall strength of the printed part is unaffected, while the size accuracy and layer consistency are improved. diff --git a/doc/print_settings/calibration/Calibration.md b/doc/calibration/Calibration.md similarity index 100% rename from doc/print_settings/calibration/Calibration.md rename to doc/calibration/Calibration.md diff --git a/doc/print_settings/calibration/adaptive-pressure-advance-calib.md b/doc/calibration/adaptive-pressure-advance-calib.md similarity index 100% rename from doc/print_settings/calibration/adaptive-pressure-advance-calib.md rename to doc/calibration/adaptive-pressure-advance-calib.md diff --git a/doc/print_settings/calibration/cornering-calib.md b/doc/calibration/cornering-calib.md similarity index 100% rename from doc/print_settings/calibration/cornering-calib.md rename to doc/calibration/cornering-calib.md diff --git a/doc/print_settings/calibration/flow-rate-calib.md b/doc/calibration/flow-rate-calib.md similarity index 100% rename from doc/print_settings/calibration/flow-rate-calib.md rename to doc/calibration/flow-rate-calib.md diff --git a/doc/print_settings/calibration/input-shaping-calib.md b/doc/calibration/input-shaping-calib.md similarity index 100% rename from doc/print_settings/calibration/input-shaping-calib.md rename to doc/calibration/input-shaping-calib.md diff --git a/doc/print_settings/calibration/pressure-advance-calib.md b/doc/calibration/pressure-advance-calib.md similarity index 100% rename from doc/print_settings/calibration/pressure-advance-calib.md rename to doc/calibration/pressure-advance-calib.md diff --git a/doc/print_settings/calibration/retraction-calib.md b/doc/calibration/retraction-calib.md similarity index 100% rename from doc/print_settings/calibration/retraction-calib.md rename to doc/calibration/retraction-calib.md diff --git a/doc/print_settings/calibration/temp-calib.md b/doc/calibration/temp-calib.md similarity index 100% rename from doc/print_settings/calibration/temp-calib.md rename to doc/calibration/temp-calib.md diff --git a/doc/print_settings/calibration/tolerance-calib.md b/doc/calibration/tolerance-calib.md similarity index 100% rename from doc/print_settings/calibration/tolerance-calib.md rename to doc/calibration/tolerance-calib.md diff --git a/doc/print_settings/calibration/volumetric-speed-calib.md b/doc/calibration/volumetric-speed-calib.md similarity index 100% rename from doc/print_settings/calibration/volumetric-speed-calib.md rename to doc/calibration/volumetric-speed-calib.md diff --git a/doc/developer-reference/Developers-Home.md b/doc/developer-reference/Developers-Home.md deleted file mode 100644 index 8080e95abf0..00000000000 --- a/doc/developer-reference/Developers-Home.md +++ /dev/null @@ -1,7 +0,0 @@ -# For Developers - -This is a documentation from someone exploring the code and is by no means complete or even completely accurate. Please edit the parts you might find inaccurate. This is probably going to be helpful nonetheless. - -- [Preset, PresetBundle and PresetCollection](Preset-and-bundle) -- [Plater, Sidebar, Tab, ComboBox](plater-sidebar-tab-combobox) -- [Slicing Call Hierarchy](slicing-hierarchy) diff --git a/doc/How-to-build.md b/doc/developer-reference/How-to-build.md similarity index 100% rename from doc/How-to-build.md rename to doc/developer-reference/How-to-build.md diff --git a/doc/How-to-create-profiles.md b/doc/developer-reference/How-to-create-profiles.md similarity index 100% rename from doc/How-to-create-profiles.md rename to doc/developer-reference/How-to-create-profiles.md diff --git a/doc/How-to-wiki.md b/doc/developer-reference/How-to-wiki.md similarity index 100% rename from doc/How-to-wiki.md rename to doc/developer-reference/How-to-wiki.md diff --git a/doc/Localization_guide.md b/doc/developer-reference/Localization_guide.md similarity index 100% rename from doc/Localization_guide.md rename to doc/developer-reference/Localization_guide.md diff --git a/doc/images/Precision/PolyHoles.png b/doc/images/Precision/PolyHoles.png new file mode 100644 index 00000000000..7fce37757b5 Binary files /dev/null and b/doc/images/Precision/PolyHoles.png differ diff --git a/doc/images/PreciseWall/PreciseWallOff.svg b/doc/images/Precision/PreciseWallOff.svg similarity index 100% rename from doc/images/PreciseWall/PreciseWallOff.svg rename to doc/images/Precision/PreciseWallOff.svg diff --git a/doc/images/PreciseWall/PreciseWallOn.svg b/doc/images/Precision/PreciseWallOn.svg similarity index 100% rename from doc/images/PreciseWall/PreciseWallOn.svg rename to doc/images/Precision/PreciseWallOn.svg diff --git a/doc/images/PreciseZ/PreciseZOff.png b/doc/images/Precision/PreciseZOff.png similarity index 100% rename from doc/images/PreciseZ/PreciseZOff.png rename to doc/images/Precision/PreciseZOff.png diff --git a/doc/images/PreciseZ/PreciseZOn.png b/doc/images/Precision/PreciseZOn.png similarity index 100% rename from doc/images/PreciseZ/PreciseZOn.png rename to doc/images/Precision/PreciseZOn.png diff --git a/doc/images/Precision/arc-fitting.svg b/doc/images/Precision/arc-fitting.svg new file mode 100644 index 00000000000..acb997cedee --- /dev/null +++ b/doc/images/Precision/arc-fitting.svg @@ -0,0 +1,3 @@ + + +
Sliced GCode Path
Sliced GCode Path
New GCode Arc
New GCode Arc \ No newline at end of file diff --git a/doc/images/Precision/elephant-foot-compensation.png b/doc/images/Precision/elephant-foot-compensation.png new file mode 100644 index 00000000000..55d87c251da Binary files /dev/null and b/doc/images/Precision/elephant-foot-compensation.png differ diff --git a/doc/images/Precision/elephant-foot.svg b/doc/images/Precision/elephant-foot.svg new file mode 100644 index 00000000000..88a29c0136b --- /dev/null +++ b/doc/images/Precision/elephant-foot.svg @@ -0,0 +1,3 @@ + + + \ No newline at end of file diff --git a/doc/images/WallGenerator/wallgenerator-arachne.png b/doc/images/WallGenerator/wallgenerator-arachne.png new file mode 100644 index 00000000000..21d14d77f39 Binary files /dev/null and b/doc/images/WallGenerator/wallgenerator-arachne.png differ diff --git a/doc/images/WallGenerator/wallgenerator-classic.png b/doc/images/WallGenerator/wallgenerator-classic.png new file mode 100644 index 00000000000..8d884f6a657 Binary files /dev/null and b/doc/images/WallGenerator/wallgenerator-classic.png differ diff --git a/doc/pellet-flow-coefficient.md b/doc/material_settings/pellet-flow-coefficient.md similarity index 100% rename from doc/pellet-flow-coefficient.md rename to doc/material_settings/pellet-flow-coefficient.md diff --git a/doc/semm.md b/doc/material_settings/semm.md similarity index 100% rename from doc/semm.md rename to doc/material_settings/semm.md diff --git a/doc/precise-z-height.md b/doc/precise-z-height.md deleted file mode 100644 index fa862bf9224..00000000000 --- a/doc/precise-z-height.md +++ /dev/null @@ -1,15 +0,0 @@ -# Precise Z Height Adjustment - -This feature ensures the accurate Z height of the model after slicing, even if the model height is not a multiple of the layer height. - -For example, slicing a 20mm x 20mm x 20.1mm cube with a layer height of 0.2mm would typically result in a final height of 20.2mm due to the layer height increments. - -By enabling this parameter, the layer height of the last five layers is adjusted so that the final sliced height matches the actual object height, resulting in an accurate 20.1mm (as shown in the picture). - -- **Precise Z Height Off** - - ![PreciseZOff](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/PreciseZ/PreciseZOff.png?raw=true) - -- **Precise Z Height On** - - ![PreciseZOn](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/PreciseZ/PreciseZOn.png?raw=true) diff --git a/doc/stl-transformation.md b/doc/print_prepare/stl-transformation.md similarity index 100% rename from doc/stl-transformation.md rename to doc/print_prepare/stl-transformation.md diff --git a/doc/print_settings/quality/quality_settings_precision.md b/doc/print_settings/quality/quality_settings_precision.md new file mode 100644 index 00000000000..b6f0bca7934 --- /dev/null +++ b/doc/print_settings/quality/quality_settings_precision.md @@ -0,0 +1,112 @@ +# Precision + +This section covers the settings that affect the precision of your prints. These settings can help you achieve better dimensional accuracy, reduce artifacts, and improve overall print quality. + +- [Slice gap closing radius](#slice-gap-closing-radius) +- [Resolution](#resolution) +- [Arc fitting](#arc-fitting) +- [X-Y Compensation](#x-y-compensation) +- [Elephant foot compensation](#elephant-foot-compensation) +- [Precise wall](#precise-wall) + - [Technical explanation](#technical-explanation) +- [Precise Z Height](#precise-z-height) +- [Polyholes](#polyholes) + + +## Slice gap closing radius + +Cracks smaller than 2x gap closing radiusCracks smaller than 2x gap closing radius are being filled during the triangle mesh slicing. The gap closing operation may reduce the final print resolution, therefore it is advisable to keep the value reasonably low. + +## Resolution + +The G-code path is generated after simplifying the contour of models to avoid too many points and G-code lines. Smaller value means higher resolution and more time to slice. + +## Arc fitting + +Enable this to get a G-code file which has [G2 and G3](https://marlinfw.org/docs/gcode/G002-G003.html) moves. + +After a model is sliced this feature will replace straight line segments with arcs where possible. This is particularly useful for curved surfaces, as it allows the printer to move in a more fluid manner, reducing the number of G-code commands and improving the overall print quality. + +This will result in a smaller G-code file for the same model, as arcs are used instead of many short line segments. This can improve print quality and reduce printing time, especially for curved surfaces. + +![arc-fitting](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Precision/arc-fitting.svg?raw=true) + +> [!IMPORTANT] +> This option is only available for machines that support G2 and G3 commands and may impact in CPU usage on the printer. + +> [!NOTE] +> **Klipper machines**, this option is recommended to be disabled. +Klipper does not benefit from arc commands as these are split again into line segments by the firmware. This results in a reduction in surface quality as line segments are converted to arcs by the slicer and then back to line segments by the firmware. + +## X-Y Compensation + +Used to compensate external dimensions of the model. +With this option you can compensate material expansion or shrinkage, which can occur due to various factors such as the type of filament used, temperature fluctuations, or printer calibration issues. + +Follow the [Calibration Guide](https://github.com/SoftFever/OrcaSlicer/wiki/Calibration) and [Filament Tolerance Calibration](https://github.com/SoftFever/OrcaSlicer/wiki/tolerance-calib) to determine the correct value for your printer and filament combination. + +## Elephant foot compensation + +This feature compensates for the "elephant foot" effect, which occurs when the first few layers of a print are wider than the rest due: + +- Weight of the material above them. +- Thermal expansion of the material. +- Bed temperature being too high. +- Inaccurate bed height. + +![elephant-foot](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Precision/elephant-foot.svg?raw=true) + +To mitigate this effect, OrcaSlicer allows you to specify a negative distance that will be applied to the first specified number of layers. This adjustment effectively reduces the width of the first few layers, helping to achieve a more accurate final print size. + +![elephant-foot-compensation](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Precision/elephant-foot-compensation.png?raw=true) + +## Precise wall + +The 'Precise Wall' is a distinctive feature introduced by OrcaSlicer, aimed at improving the dimensional accuracy of prints and minimizing layer inconsistencies by slightly increasing the spacing between the outer wall and the inner wall. + +### Technical explanation + +Below is a technical explanation of how this feature works. + +First, it's important to understand some basic concepts like flow, extrusion width, and space. Slic3r has an excellent document that covers these topics in detail. You can refer to this [article](https://manual.slic3r.org/advanced/flow-math). + +Now, let's dive into the specifics. Slic3r and its forks, such as PrusaSlicer, SuperSlicer, and OrcaSlicer, assume that the extrusion path has an oval shape, which accounts for the overlaps. For example, if we set the wall width to 0.4mm and the layer height to 0.2mm, the combined thickness of two walls laid side by side is 0.714mm instead of 0.8mm due to the overlapping. + +- **Precise Wall Off** + + ![PreciseWallOff](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Precision/PreciseWallOff.svg?raw=true) + +- **Precise Wall On** + + ![PreciseWallOn](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Precision/PreciseWallOn.svg?raw=true) + +This approach enhances the strength of 3D-printed parts. However, it does have some side effects. For instance, when the inner-outer wall order is used, the outer wall can be pushed outside, leading to potential size inaccuracy and more layer inconsistency. + +It's important to keep in mind that this approach to handling flow is specific to Slic3r and its forks. Other slicing software, such as Cura, assumes that the extrusion path is rectangular and, therefore, does not include overlapping. Two 0.4 mm walls will result in a 0.8 mm shell thickness in Cura. + +OrcaSlicer adheres to Slic3r's approach to handling flow. To address the downsides mentioned earlier, OrcaSlicer introduced the 'Precise Wall' feature. When this feature is enabled in OrcaSlicer, the overlap between the outer wall and its adjacent inner wall is set to zero. This ensures that the overall strength of the printed part is unaffected, while the size accuracy and layer consistency are improved. + +## Precise Z Height + +This feature ensures the accurate Z height of the model after slicing, even if the model height is not a multiple of the layer height. + +For example, slicing a 20mm x 20mm x 20.1mm cube with a layer height of 0.2mm would typically result in a final height of 20.2mm due to the layer height increments. + +By enabling this parameter, the layer height of the last five layers is adjusted so that the final sliced height matches the actual object height, resulting in an accurate 20.1mm (as shown in the picture). + +- **Precise Z Height Off** + + ![PreciseZOff](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Precision/PreciseZOff.png?raw=true) + +- **Precise Z Height On** + + ![PreciseZOn](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Precision/PreciseZOn.png?raw=true) + +## Polyholes + +A polyhole is a technique used in FFF 3D printing to improve the accuracy of circular holes. Instead of modeling a perfect circle, the hole is represented as a polygon with a reduced number of flat sides. This simplification forces the slicer to treat each segment as a straight line, which prints more reliably. By carefully choosing the number of sides and ensuring the polygon sits on the outer boundary of the hole, you can produce openings that more closely match the intended diameter. + +![PolyHoles](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/Precision/PolyHoles.png?raw=true) + +- Original implementation: [SuperSlicer Polyholes](https://github.com/supermerill/SuperSlicer/wiki/Polyholes) +- Idea and mathematics: [Hydraraptor](https://hydraraptor.blogspot.com/2011/02/polyholes.html) diff --git a/doc/print_settings/quality/quality_settings_seam.md b/doc/print_settings/quality/quality_settings_seam.md index 605c1fdf79a..4c85ce79d93 100644 --- a/doc/print_settings/quality/quality_settings_seam.md +++ b/doc/print_settings/quality/quality_settings_seam.md @@ -73,14 +73,14 @@ To minimize the visibility of potential over-extrusion at the start of an extern This is useful when printing with Outer/Inner or Inner/Outer/Inner wall print order, as in these modes, it is more likely an external perimeter is printed immediately after a de-retraction move, which would cause slight extrusion variance at the start of a seam. -## Tips: +## Tips With seams being inevitable when 3D printing using FFF, there are two distinct approaches on how to deal with them: 1. **Try and hide the seam as much as possible:** This can be done by enabling scarf seam, which works very well, especially with simple models with limited overhang regions. 2. **Try and make the seam as "clean" and "distinct" as possible:** This can be done by tuning the seam gap and enabling role-based wipe speed, wipe on loops, and wipe before the external loop. -## Troubleshooting Seam Performance: +## Troubleshooting Seam Performance The section below will focus on troubleshooting traditional seams. For scarf seam troubleshooting, refer to the guide linked above. @@ -93,7 +93,7 @@ However, due to mechanical and material tolerances, as well as the very nature o ![seam-quality](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/seam/seam-quality.jpg?raw=true) -### Troubleshooting the Start of a Seam: +### Troubleshooting the Start of a Seam Imagine the scenario where the toolhead finishes printing a layer line on one side of the bed, retracts, travels the whole distance of the bed to de-retract, and starts printing another part. Compare this to the scenario where the toolhead finishes printing an internal perimeter and only travels a few mm to start printing an external perimeter, without even retracting or de-retracting. @@ -113,7 +113,7 @@ So this is a trade-off between print speed and print quality. From experimental In addition, larger nozzle diameters allow for more opportunity for material to leak compared to smaller diameter nozzles. A 0.2/0.25 mm nozzle will have significantly better seam performance than a 0.4, and that will have much better performance than a 0.6mm nozzle and so forth. -### Troubleshooting the End of a Seam: +### Troubleshooting the End of a Seam The end of a seam is much easier to get right, as the extrusion system is already at a pressure equilibrium while printing. It just needs to stop extruding at the right time and consistently. @@ -125,7 +125,7 @@ Furthermore, the printer mechanics have tolerances – the print head may be req Finally, the techniques of **wiping can help improve the visual continuity and consistency of a seam** (please note, these settings do not make the seam less visible, but rather make them more consistent!). Wiping on loops with a consistent speed helps tuck in the end of the seam, hiding the effects of retraction from view. -### The Role of Wall Ordering in Seam Appearance: +### The Role of Wall Ordering in Seam Appearance The order of wall printing plays a significant role in the appearance of a seam. **Starting to print the external perimeter first after a long travel move will always result in more visible artifacts compared to printing the internal perimeters first and traveling just a few mm to print the external perimeter.** diff --git a/doc/print_settings/quality/quality_settings_wall-generator.md b/doc/print_settings/quality/quality_settings_wall-generator.md new file mode 100644 index 00000000000..f7279aa2537 --- /dev/null +++ b/doc/print_settings/quality/quality_settings_wall-generator.md @@ -0,0 +1,23 @@ +# Wall Generator + +WIP... + +## Classic + +WIP... + +![wallgenerator-classic](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/WallGenerator/wallgenerator-classic.png?raw=true) + +## Arachne + +WIP... + +![wallgenerator-arachne](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/WallGenerator/wallgenerator-arachne.png?raw=true) + +- Wall transitioning threshhold angle +- Wall transitioning filter +- Wall transitioning length +- Wall distribution count +- First layer minimum wall width +- Minimum feature size +- Minimum wall length diff --git a/doc/print_settings/speed/extrusion-rate-smoothing.md b/doc/print_settings/speed/speed_extrusion_rate_smoothing.md similarity index 98% rename from doc/print_settings/speed/extrusion-rate-smoothing.md rename to doc/print_settings/speed/speed_extrusion_rate_smoothing.md index 232279515cb..49ded01387a 100644 --- a/doc/print_settings/speed/extrusion-rate-smoothing.md +++ b/doc/print_settings/speed/speed_extrusion_rate_smoothing.md @@ -1,191 +1,191 @@ -# Extrusion rate smoothing - -Extrusion rate smoothing (ERS), also known as pressure equalizer in Prusa Slicer, aims to **limit the rate of extrusion volume change to be below a user set threshold (the ERS value).** It aims to assist the printer firmware internal motion planners, pressure advance in achieving the desired nozzle flow and reducing deviations against the ideal flow. - -This happens by reducing the stresses put on the extrusion system as well as reducing the absolute deviations from the ideal extrusion flow caused by pressure advance smooth time. - -This feature is especially helpful when printing at high accelerations and large flow rates as the deviations are larger in these cases. - -![ers-intro](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/ERS/ers-intro.jpg?raw=true) - -## Theory - -Enabling this feature creates a small **speed "ramp"** by slowing down and ramping up print speeds prior to and after the features causing a sudden change in extrusion flow rate needs, such as overhangs and overhang perimeters. - -This works by breaking down the printed line segments into smaller "chunks", proportional to the ERS segment length, and reduces the print speed of these segments so that the **requested extrusion volumetric flow rate change is less than or equal to the ERS threshold**. - -In summary, **it takes the "edge" off rapid extrusion changes caused by acceleration/deceleration as these are now spread over a longer distance and time.** Therefore, it can reduce wall artefacts that show when the print speeds change suddenly. These artefacts are occuring because the extruder and firmware cannot perfectly adhere to the requested by the slicer flow rates, especially when the extrusion rate is changing rapidly. - -**The example below shows the artefact that is mitigated by ERS.** -![ers-artefact](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/ERS/ers-artefact.jpg?raw=true) - -The bulging visible above is due to the extruder not being able to respond fast enough against the required speed change when printing with high accelerations and high speeds and requested to slow down for an overhang. - -In the above scenario, the printer (Bambu Lab X1 Carbon) was requested to slow down from a 200mm/sec print speed to 40mm/sec at an acceleration of 5k/sec2. **The extruder could not keep up with the pressure change, resulting in a slight bump ahead at the point of speed change.** - -This parameter interacts with the below printer kinematic settings and physical limits: - -**1. The limits of the extruder system** - how fast can it change pressure in the nozzle - -**2. The configured pressure advance values** - that also affect pressure changes in the nozzle - -**3. The acceleration profile of the printer** - higher accelerations mean higher pressure changes - -**4. The pressure advance smooth time (klipper)** - higher smooth time means higher deviation from ideal extrusion, hence more opportunity for this feature to be useful. - -

Acceleration vs. Extrusion rate smoothing

A printer's motion system does -not exactly follow the speed changes seen in the gcode preview screen of Orca -slicer. - -When a speed change is requested, the firmware look ahead planner calculates the slow down needed to achieve the target speed. The rate of slowdown is limited by the move's acceleration value. - -**Lets consider an example.** Assume printing an overhang wall with **2k external wall acceleration**, were the printer is called to slow down from **200mm/sec to 40mm/sec**. - -This deceleration move would happen over approximately 9.6mm. This is derived from the following equation: - -Where: - -- vf = final speed. -- vi = initial speed. -- a = acceleration (in this case, it will be negative as it's a deceleration). -- d = distance. - -```math -d = \frac{v_f^2 - v_i^2}{2a} -``` - -The time taken to decelerate to this new speed would be approx. 0.08 seconds, derived from the following equation: - -```math -t = \frac{v_f - v_i}{a} -``` - -A printer printing at 200mm/sec with a 0.42 line width and 0.16 layer height would be extruding plastic at approx. 12.16mm3/sec, as can also be seen from the below visual. - -![ers-printspeed](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/ERS/ers-printspeed.jpg?raw=true) - -When the printer is extruding at 40mm/sec with the same line width and layer height as above, the flow rate is 2.43mm3/sec. - -So what we are asking the extruder to do in this example is **slow down from 12.16mm3/sec flow to 2.43mm3/sec flow in 0.08 seconds** or an extrusion change rate of 121mm3/sec2. - -**This value is proportional to the acceleration of the printer. At 4k this value doubles, at 1k it is half and is independent of the speed of movement or starting and ending speeds.** - -**This value is also proportional to the line width - double the line width will result in double the extrusion rate change and vice versa. Same for layer height.** - -So, continuing with the worked example, a 2k acceleration produces an extrusion rate change ramp of 121mm3/sec2. **Therefore, setting a value higher than this would not bring any benefit to the print quality as the motion system would slow down less aggressively based on its acceleration settings.** - -**Therefore, the acceleration values act as a meaningfull upper limit to this setting.** An indicative set of values has been provided later in this page. - -### Pressure advance vs extrusion rate smoothing - -Then we need to consider pressure advance and smooth time as factors that influence extrusion rate. - -**Pressure Advance** adjusts the extruder's speed to account for the pressure changes inside the hot end’s melt zone. When the print head moves and extrudes filament, there's a delay between the movement of the extruder gear and the plastic being extruded due to the compressibility of the molten plastic in the hot end. This delay can cause too much plastic to be extruded when the print head starts moving or not enough plastic when the print head stops, leading to issues like blobbing or under-extrusion. - -**Pressure Advance Smooth time** helps to mitigate potential negative effects on print quality due to the rapid changes in extruder flow rate, which are controlled by the Pressure Advance algorithm. This parameter essentially adds a smoothing effect to the adjustments made by Pressure Advance, aiming to prevent sharp or sudden changes in the extrusion rate. - -When Pressure Advance adjusts the extruder speed to compensate for the pressure build-up or reduction in the hot end, it can lead to abrupt changes in the flow rate. These abrupt changes can potentially cause issues like: - -1. Extruder motor skipping, -2. Increased wear on the extruder gear and filament, -3. Visible artifacts on the print surface due to non-uniform extrusion. - -The smooth time setting introduces a controlled delay over which the Pressure Advance adjustments are spread out. This results in a more gradual application or reduction of extrusion pressure, leading to smoother transitions in filament flow. - -The trade-off is extrusion accuracy. There is a deviation between the requested extrusion amount and the actual extrusion amount due to this smoothing. - -**1. Increasing Smooth Time:** Leads to more gradual changes in extrusion pressure. While this can reduce artifacts and stress on the extruder system, setting it too high may diminish the effectiveness of Pressure Advance, as the compensation becomes too delayed to counteract the pressure dynamics accurately. - -**2. Decreasing Smooth Time:** Makes the Pressure Advance adjustments more immediate, which can improve the responsiveness of pressure compensation but may also reintroduce abrupt changes in flow rate, potentially leading to the issues mentioned above. - -In essence, p**ressure advance smooth time creates an intentional deviation from the ideal extruder rotation** and, therefore, extrusion amount, to allow the printer's extruder to perform within its mechanical limits. Typically, this value is set to 0.04sec, which means that when Pressure Advance adjusts the extruder's flow rate to compensate for changes in pressure within the hot end, these adjustments are spread out over a period of 0.04 seconds. - -There is a great example of pressure advance smooth time induced deviations [here](https://klipper.discourse.group/t/pressure-advance-smooth-time-skews-pressure-advance/13451) that is worth a read to get more insight in this trade-off. - -In the worked example above, **we need to set an Extrusion Rate smoothing value enough to decrease the error introduced by pressure advance smooth time against the produced output flow.** The lower the extrusion rate smoothing value, the lower the changes in flow over time hence the lower the absolute deviation from the ideal extrusion caused by the smooth time algorithm. However, going too low will result in a material decrease in overall print speed, as the print speed will be materially reduced to achieve low extrusion deviations between features, for no real benefit after a point. - -**The best way to find what the lower beneficial limit is through experimentation.** Print an object with sharp overhangs that are slowed down because off the overhang print speed settings and observe for extrusion inconsistencies. - -

Finding the ideal Extrusion Rate smoothing value

- -**Firstly, this value needs to be lower than the extrusion rate changes resulting from the acceleration profile of the printer.** As, generally, the greatest impact is in external wall finish, use your external perimeter acceleration as a point of reference. - -**Below are some approximate ERS values for 0.42 line width and 0.16 layer height.** - -1. 30mm3/sec for 0.5k acceleration -2. 60.5mm3/sec for 1k acceleration -3. 121mm3/sec2 for 2k acceleration -4. 242mm3/sec2 for 4k acceleration - -**Below are some approximate ERS values for 0.42 line width and 0.20 layer height.** - -1. 38mm3/sec for 0.5k acceleration -2. 76mm3/sec for 1k acceleration -3. 150mm3/sec2 for 2k acceleration -4. 300mm3/sec2 for 4k acceleration - -**Below are some approximate ERS values for 0.45 line width and 0.16 layer height.** - -1. 32mm3/sec for 0.5k acceleration -2. 65mm3/sec for 1k acceleration -3. 129mm3/sec2 for 2k acceleration -4. 260mm3/sec2 for 4k acceleration - -**So, your tuning starting point needs to be an ERS value that is less than this.** A good point experiment with test prints would be **a value of 60-80%** of the above maximum values. This will give some meaningful assistance to pressure advance, reducing the deviation introduced by pressure advance smooth time. The greater the smooth time, the greater the quality benefit will be. - -Therefore, for a **0.42 line width and 0.16 layer height**, the below are a recommended set of starting ERS values - -1. 18-25mm3/sec for 0.5k acceleration -2. 35-50mm3/sec for 1k acceleration -3. 70-100mm3/sec2 for 2k acceleration -4. 145-200mm3/sec2 for 4k acceleration - -If you are printing with a 0.2 layer height, you can increase these values by 25% and similarly reduce if printing with lower. - -**The second factor is your extruder's mechanical abilities.** Direct drive extruders with a good grip on the filament typically are more responsive to extrusion rate changes. Similarly with stiff filaments. So, a Bowden printer or when printing softer material like TPU or soft PLAs like polyterra there is more opportunity for the extruder to slip or deviate from the desired extrusion amount due to mechanical grip or material deformation or just delay in propagating the pressure changes (in a Bowden setup). - -**The final factor is the deviation introduced by pressure advance smooth time**, or equivalents in closed source firmware. The higher this value the larger the extrusion deviation from ideal. If you are using a direct drive extruder, reduce this value to 0.02 in your klipper firmware before tuning ERS, as a lower value results in lower deviations to mitigate. Then proceed to experimentaly tune ERS. - -**So where does that leave us?** - -Perform a test print with the above ERS settings as a starting point and adjust to your liking! If you notice budging on sharp overhangs where speed changes, like the hull of the benchy, reduce this value by 10% and try again. - -If you're not noticing any artefacts, increase by 10%, but don’t go over the maximum values recommended above because then this feature would have no effect in your print. - -## A note for Bowden printers using marlin without pressure advance. - -If your printer is not equipped with pressure advance and, especially, if you are using a Bowden setup, you don’t have the benefit of pressure advance dynamically adjusting your flow. - -In this special case, ERS will be doing all the heavy lifting that pressure advance would typically perform. In this scenario a low value of 8-10mm3/sec is usually recommended, irrespective of your acceleration settings, to smooth out pressure changes in the extrusion system as much as possible without impacting print speed too much. - -## A note on ERS Segment length - -Ideally you want this value set to 1 to allow for the largest number of steps between each speed transition. However, this may result in a too large of a gcode, with too many commands sent to your MCU per second and it may not be able to keep up. It will also slow down the Orca slicer front end as the sliced model is more complex to render. - -For Klipper printers, a segment length of 1 works OK as the RPI or similar have enough computational power to handle the gcode command volume. - -Similarly, for a Bambu lab printer, a segment length of 1 works well. **However, if you do notice your printer stuttering or stalling** (which may be the case with the lower powered P1 series printers) **or getting "Timer too close" errors** in Klipper, **increase this value to 2 or 3**. This would reduce the effectiveness of the setting but will present a more manageable load to your printer. - -## Limitations - -**This feature can only work where speed changes are induced by the slicer** - for example when transitioning from fast to slow print moves when printing overhangs, bridges and from printing internal features to external features and vice versa. - -However, it will not affect extruder behaviour when the printer is slowing down due to firmware commands - for example when turning around corners. - -In this case, the printer slows down and then accelerates independently of what the slicer has requested. In this case, the slicer is commanding a consistent speed; however, the printer is adjusting this to operate within its printer kinematic limits (SCV/Jerk) and accelerations. As the slicer is not aware of this slow down, it cannot apply pre-emptive extrusion rate smoothing to the feature and instead, the changes are governed by the printer firmware exclusively. - -## Credits - -**Original feature authors and creators:** The Prusa Slicer team, including [@bubnikv](https://github.com/bubnikv), [@hejllukas](https://github.com/hejllukas). - -**Enhanced by:** [@MGunlogson](https://github.com/MGunlogson), introducing the feature to external perimeters, enhancing it by taking into account travel, retraction and implementing near-contiguous extrusions pressure equalizer adjustments. - -**Ported to Orca:** [@igiannakas](https://github.com/igiannakas). - -**Enhanced by:** [@noisyfox](https://github.com/Noisyfox), per object pressure equalization and fixing calculation logic bugs. - -**Wiki page:** [@igiannakas](https://github.com/igiannakas). - -**Overall Orca owner and assurance:** [@softfever](https://github.com/SoftFever). - +# Extrusion rate smoothing + +Extrusion rate smoothing (ERS), also known as pressure equalizer in Prusa Slicer, aims to **limit the rate of extrusion volume change to be below a user set threshold (the ERS value).** It aims to assist the printer firmware internal motion planners, pressure advance in achieving the desired nozzle flow and reducing deviations against the ideal flow. + +This happens by reducing the stresses put on the extrusion system as well as reducing the absolute deviations from the ideal extrusion flow caused by pressure advance smooth time. + +This feature is especially helpful when printing at high accelerations and large flow rates as the deviations are larger in these cases. + +![ers-intro](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/ERS/ers-intro.jpg?raw=true) + +## Theory + +Enabling this feature creates a small **speed "ramp"** by slowing down and ramping up print speeds prior to and after the features causing a sudden change in extrusion flow rate needs, such as overhangs and overhang perimeters. + +This works by breaking down the printed line segments into smaller "chunks", proportional to the ERS segment length, and reduces the print speed of these segments so that the **requested extrusion volumetric flow rate change is less than or equal to the ERS threshold**. + +In summary, **it takes the "edge" off rapid extrusion changes caused by acceleration/deceleration as these are now spread over a longer distance and time.** Therefore, it can reduce wall artefacts that show when the print speeds change suddenly. These artefacts are occuring because the extruder and firmware cannot perfectly adhere to the requested by the slicer flow rates, especially when the extrusion rate is changing rapidly. + +**The example below shows the artefact that is mitigated by ERS.** +![ers-artefact](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/ERS/ers-artefact.jpg?raw=true) + +The bulging visible above is due to the extruder not being able to respond fast enough against the required speed change when printing with high accelerations and high speeds and requested to slow down for an overhang. + +In the above scenario, the printer (Bambu Lab X1 Carbon) was requested to slow down from a 200mm/sec print speed to 40mm/sec at an acceleration of 5k/sec2. **The extruder could not keep up with the pressure change, resulting in a slight bump ahead at the point of speed change.** + +This parameter interacts with the below printer kinematic settings and physical limits: + +**1. The limits of the extruder system** - how fast can it change pressure in the nozzle + +**2. The configured pressure advance values** - that also affect pressure changes in the nozzle + +**3. The acceleration profile of the printer** - higher accelerations mean higher pressure changes + +**4. The pressure advance smooth time (klipper)** - higher smooth time means higher deviation from ideal extrusion, hence more opportunity for this feature to be useful. + +

Acceleration vs. Extrusion rate smoothing

A printer's motion system does +not exactly follow the speed changes seen in the gcode preview screen of Orca +slicer. + +When a speed change is requested, the firmware look ahead planner calculates the slow down needed to achieve the target speed. The rate of slowdown is limited by the move's acceleration value. + +**Lets consider an example.** Assume printing an overhang wall with **2k external wall acceleration**, were the printer is called to slow down from **200mm/sec to 40mm/sec**. + +This deceleration move would happen over approximately 9.6mm. This is derived from the following equation: + +Where: + +- vf = final speed. +- vi = initial speed. +- a = acceleration (in this case, it will be negative as it's a deceleration). +- d = distance. + +```math +d = \frac{v_f^2 - v_i^2}{2a} +``` + +The time taken to decelerate to this new speed would be approx. 0.08 seconds, derived from the following equation: + +```math +t = \frac{v_f - v_i}{a} +``` + +A printer printing at 200mm/sec with a 0.42 line width and 0.16 layer height would be extruding plastic at approx. 12.16mm3/sec, as can also be seen from the below visual. + +![ers-printspeed](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/ERS/ers-printspeed.jpg?raw=true) + +When the printer is extruding at 40mm/sec with the same line width and layer height as above, the flow rate is 2.43mm3/sec. + +So what we are asking the extruder to do in this example is **slow down from 12.16mm3/sec flow to 2.43mm3/sec flow in 0.08 seconds** or an extrusion change rate of 121mm3/sec2. + +**This value is proportional to the acceleration of the printer. At 4k this value doubles, at 1k it is half and is independent of the speed of movement or starting and ending speeds.** + +**This value is also proportional to the line width - double the line width will result in double the extrusion rate change and vice versa. Same for layer height.** + +So, continuing with the worked example, a 2k acceleration produces an extrusion rate change ramp of 121mm3/sec2. **Therefore, setting a value higher than this would not bring any benefit to the print quality as the motion system would slow down less aggressively based on its acceleration settings.** + +**Therefore, the acceleration values act as a meaningfull upper limit to this setting.** An indicative set of values has been provided later in this page. + +### Pressure advance vs extrusion rate smoothing + +Then we need to consider pressure advance and smooth time as factors that influence extrusion rate. + +**Pressure Advance** adjusts the extruder's speed to account for the pressure changes inside the hot end’s melt zone. When the print head moves and extrudes filament, there's a delay between the movement of the extruder gear and the plastic being extruded due to the compressibility of the molten plastic in the hot end. This delay can cause too much plastic to be extruded when the print head starts moving or not enough plastic when the print head stops, leading to issues like blobbing or under-extrusion. + +**Pressure Advance Smooth time** helps to mitigate potential negative effects on print quality due to the rapid changes in extruder flow rate, which are controlled by the Pressure Advance algorithm. This parameter essentially adds a smoothing effect to the adjustments made by Pressure Advance, aiming to prevent sharp or sudden changes in the extrusion rate. + +When Pressure Advance adjusts the extruder speed to compensate for the pressure build-up or reduction in the hot end, it can lead to abrupt changes in the flow rate. These abrupt changes can potentially cause issues like: + +1. Extruder motor skipping, +2. Increased wear on the extruder gear and filament, +3. Visible artifacts on the print surface due to non-uniform extrusion. + +The smooth time setting introduces a controlled delay over which the Pressure Advance adjustments are spread out. This results in a more gradual application or reduction of extrusion pressure, leading to smoother transitions in filament flow. + +The trade-off is extrusion accuracy. There is a deviation between the requested extrusion amount and the actual extrusion amount due to this smoothing. + +**1. Increasing Smooth Time:** Leads to more gradual changes in extrusion pressure. While this can reduce artifacts and stress on the extruder system, setting it too high may diminish the effectiveness of Pressure Advance, as the compensation becomes too delayed to counteract the pressure dynamics accurately. + +**2. Decreasing Smooth Time:** Makes the Pressure Advance adjustments more immediate, which can improve the responsiveness of pressure compensation but may also reintroduce abrupt changes in flow rate, potentially leading to the issues mentioned above. + +In essence, p**ressure advance smooth time creates an intentional deviation from the ideal extruder rotation** and, therefore, extrusion amount, to allow the printer's extruder to perform within its mechanical limits. Typically, this value is set to 0.04sec, which means that when Pressure Advance adjusts the extruder's flow rate to compensate for changes in pressure within the hot end, these adjustments are spread out over a period of 0.04 seconds. + +There is a great example of pressure advance smooth time induced deviations [here](https://klipper.discourse.group/t/pressure-advance-smooth-time-skews-pressure-advance/13451) that is worth a read to get more insight in this trade-off. + +In the worked example above, **we need to set an Extrusion Rate smoothing value enough to decrease the error introduced by pressure advance smooth time against the produced output flow.** The lower the extrusion rate smoothing value, the lower the changes in flow over time hence the lower the absolute deviation from the ideal extrusion caused by the smooth time algorithm. However, going too low will result in a material decrease in overall print speed, as the print speed will be materially reduced to achieve low extrusion deviations between features, for no real benefit after a point. + +**The best way to find what the lower beneficial limit is through experimentation.** Print an object with sharp overhangs that are slowed down because off the overhang print speed settings and observe for extrusion inconsistencies. + +

Finding the ideal Extrusion Rate smoothing value

+ +**Firstly, this value needs to be lower than the extrusion rate changes resulting from the acceleration profile of the printer.** As, generally, the greatest impact is in external wall finish, use your external perimeter acceleration as a point of reference. + +**Below are some approximate ERS values for 0.42 line width and 0.16 layer height.** + +1. 30mm3/sec for 0.5k acceleration +2. 60.5mm3/sec for 1k acceleration +3. 121mm3/sec2 for 2k acceleration +4. 242mm3/sec2 for 4k acceleration + +**Below are some approximate ERS values for 0.42 line width and 0.20 layer height.** + +1. 38mm3/sec for 0.5k acceleration +2. 76mm3/sec for 1k acceleration +3. 150mm3/sec2 for 2k acceleration +4. 300mm3/sec2 for 4k acceleration + +**Below are some approximate ERS values for 0.45 line width and 0.16 layer height.** + +1. 32mm3/sec for 0.5k acceleration +2. 65mm3/sec for 1k acceleration +3. 129mm3/sec2 for 2k acceleration +4. 260mm3/sec2 for 4k acceleration + +**So, your tuning starting point needs to be an ERS value that is less than this.** A good point experiment with test prints would be **a value of 60-80%** of the above maximum values. This will give some meaningful assistance to pressure advance, reducing the deviation introduced by pressure advance smooth time. The greater the smooth time, the greater the quality benefit will be. + +Therefore, for a **0.42 line width and 0.16 layer height**, the below are a recommended set of starting ERS values + +1. 18-25mm3/sec for 0.5k acceleration +2. 35-50mm3/sec for 1k acceleration +3. 70-100mm3/sec2 for 2k acceleration +4. 145-200mm3/sec2 for 4k acceleration + +If you are printing with a 0.2 layer height, you can increase these values by 25% and similarly reduce if printing with lower. + +**The second factor is your extruder's mechanical abilities.** Direct drive extruders with a good grip on the filament typically are more responsive to extrusion rate changes. Similarly with stiff filaments. So, a Bowden printer or when printing softer material like TPU or soft PLAs like polyterra there is more opportunity for the extruder to slip or deviate from the desired extrusion amount due to mechanical grip or material deformation or just delay in propagating the pressure changes (in a Bowden setup). + +**The final factor is the deviation introduced by pressure advance smooth time**, or equivalents in closed source firmware. The higher this value the larger the extrusion deviation from ideal. If you are using a direct drive extruder, reduce this value to 0.02 in your klipper firmware before tuning ERS, as a lower value results in lower deviations to mitigate. Then proceed to experimentaly tune ERS. + +**So where does that leave us?** + +Perform a test print with the above ERS settings as a starting point and adjust to your liking! If you notice budging on sharp overhangs where speed changes, like the hull of the benchy, reduce this value by 10% and try again. + +If you're not noticing any artefacts, increase by 10%, but don’t go over the maximum values recommended above because then this feature would have no effect in your print. + +## A note for Bowden printers using marlin without pressure advance. + +If your printer is not equipped with pressure advance and, especially, if you are using a Bowden setup, you don’t have the benefit of pressure advance dynamically adjusting your flow. + +In this special case, ERS will be doing all the heavy lifting that pressure advance would typically perform. In this scenario a low value of 8-10mm3/sec is usually recommended, irrespective of your acceleration settings, to smooth out pressure changes in the extrusion system as much as possible without impacting print speed too much. + +## A note on ERS Segment length + +Ideally you want this value set to 1 to allow for the largest number of steps between each speed transition. However, this may result in a too large of a gcode, with too many commands sent to your MCU per second and it may not be able to keep up. It will also slow down the Orca slicer front end as the sliced model is more complex to render. + +For Klipper printers, a segment length of 1 works OK as the RPI or similar have enough computational power to handle the gcode command volume. + +Similarly, for a Bambu lab printer, a segment length of 1 works well. **However, if you do notice your printer stuttering or stalling** (which may be the case with the lower powered P1 series printers) **or getting "Timer too close" errors** in Klipper, **increase this value to 2 or 3**. This would reduce the effectiveness of the setting but will present a more manageable load to your printer. + +## Limitations + +**This feature can only work where speed changes are induced by the slicer** - for example when transitioning from fast to slow print moves when printing overhangs, bridges and from printing internal features to external features and vice versa. + +However, it will not affect extruder behaviour when the printer is slowing down due to firmware commands - for example when turning around corners. + +In this case, the printer slows down and then accelerates independently of what the slicer has requested. In this case, the slicer is commanding a consistent speed; however, the printer is adjusting this to operate within its printer kinematic limits (SCV/Jerk) and accelerations. As the slicer is not aware of this slow down, it cannot apply pre-emptive extrusion rate smoothing to the feature and instead, the changes are governed by the printer firmware exclusively. + +## Credits + +**Original feature authors and creators:** The Prusa Slicer team, including [@bubnikv](https://github.com/bubnikv), [@hejllukas](https://github.com/hejllukas). + +**Enhanced by:** [@MGunlogson](https://github.com/MGunlogson), introducing the feature to external perimeters, enhancing it by taking into account travel, retraction and implementing near-contiguous extrusions pressure equalizer adjustments. + +**Ported to Orca:** [@igiannakas](https://github.com/igiannakas). + +**Enhanced by:** [@noisyfox](https://github.com/Noisyfox), per object pressure equalization and fixing calculation logic bugs. + +**Wiki page:** [@igiannakas](https://github.com/igiannakas). + +**Overall Orca owner and assurance:** [@softfever](https://github.com/SoftFever). + **Community testing and feedback:** [@HakunMatat4](https://github.com/HakunMatat4), [@psiberfunk](https://github.com/psiberfunk), [@u3dreal](https://github.com/u3dreal) and more. \ No newline at end of file diff --git a/doc/fill-patterns.md b/doc/print_settings/strength/strength_settings_infill.md similarity index 93% rename from doc/fill-patterns.md rename to doc/print_settings/strength/strength_settings_infill.md index 73a832b7846..f77d3fbfea1 100644 --- a/doc/fill-patterns.md +++ b/doc/print_settings/strength/strength_settings_infill.md @@ -1,83 +1,91 @@ -# Infill Patterns +# Infill WIP... -## Concentric +## Sparse infill density + +WIP... + +## Sparse Infill Pattern + +WIP... + +### Concentric ![infill-top-concentric](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-concentric.png?raw=true) ![infill-iso-concentric](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-concentric.png?raw=true) -## Rectilinear +### Rectilinear ![infill-top-rectilinear](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-rectilinear.png?raw=true) ![infill-iso-rectilinear](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-rectilinear.png?raw=true) -## Grid +### Grid ![infill-top-grid](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-grid.png?raw=true) ![infill-iso-grid](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-grid.png?raw=true) -## 2D Lattice +### 2D Lattice ![infill-top-2d-lattice](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-2d-lattice.png?raw=true) ![infill-iso-2d-lattice](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-2d-lattice.png?raw=true) -## Line +### Line ![infill-top-line](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-line.png?raw=true) ![infill-iso-line](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-line.png?raw=true) -## Cubic +### Cubic ![infill-top-cubic](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-cubic.png?raw=true) ![infill-iso-cubic](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-cubic.png?raw=true) -## Triangles +### Triangles ![infill-top-triangles](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-triangles.png?raw=true) ![infill-iso-triangles](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-triangles.png?raw=true) -## Tri-hexagon +### Tri-hexagon ![infill-top-tri-hexagon](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-tri-hexagon.png?raw=true) ![infill-iso-tri-hexagon](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-tri-hexagon.png?raw=true) -## Gyroid +### Gyroid ![infill-top-gyroid](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-gyroid.png?raw=true) ![infill-iso-gyroid](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-gyroid.png?raw=true) -## Honeycomb +### Honeycomb ![infill-top-honeycomb](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-honeycomb.png?raw=true) ![infill-iso-honeycomb](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-honeycomb.png?raw=true) -## Adaptive Cubic +### Adaptive Cubic ![infill-top-adaptive-cubic](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-adaptive-cubic.png?raw=true) ![infill-iso-adaptive-cubic](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-adaptive-cubic.png?raw=true) -## Aligned Rectilinear +### Aligned Rectilinear ![infill-top-aligned-rectilinear](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-aligned-rectilinear.png?raw=true) ![infill-iso-aligned-rectilinear](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-aligned-rectilinear.png?raw=true) -## 3D Honeycomb +### 3D Honeycomb ![infill-top-3d-honeycomb](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-3d-honeycomb.png?raw=true) ![infill-iso-3d-honeycomb](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-3d-honeycomb.png?raw=true) -## Hilbert Curve +### Hilbert Curve ![infill-top-hilbert-curve](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-hilbert-curve.png?raw=true) ![infill-iso-hilbert-curve](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-hilbert-curve.png?raw=true) -## Archimedean Chords +### Archimedean Chords ![infill-top-archimedean-chords](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-archimedean-chords.png?raw=true) ![infill-iso-archimedean-chords](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-archimedean-chords.png?raw=true) -## Octagram Spiral +### Octagram Spiral ![infill-top-octagram-spiral](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-octagram-spiral.png?raw=true) ![infill-iso-octagram-spiral](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-octagram-spiral.png?raw=true) -## Support Cubic +### Support Cubic ![infill-top-support-cubic](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-support-cubic.png?raw=true) ![infill-iso-support-cubic](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-support-cubic.png?raw=true) -## Lightning +### Lightning ![infill-top-lightning](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-lightning.png?raw=true) ![infill-iso-lightning](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-lightning.png?raw=true) -## Cross Hatch +### Cross Hatch ![infill-top-cross-hatch](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-cross-hatch.png?raw=true) ![infill-iso-cross-hatch](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-cross-hatch.png?raw=true) -## Quartered Cubic +### Quartered Cubic ![infill-top-quartered-cubic](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-top-quartered-cubic.png?raw=true) ![infill-iso-quartered-cubic](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/fill/infill-iso-quartered-cubic.png?raw=true) diff --git a/doc/Auxiliary-fan.md b/doc/printer_settings/Auxiliary-fan.md similarity index 100% rename from doc/Auxiliary-fan.md rename to doc/printer_settings/Auxiliary-fan.md diff --git a/doc/Chamber-temperature.md b/doc/printer_settings/Chamber-temperature.md similarity index 100% rename from doc/Chamber-temperature.md rename to doc/printer_settings/Chamber-temperature.md diff --git a/doc/adaptive-bed-mesh.md b/doc/printer_settings/adaptive-bed-mesh.md similarity index 100% rename from doc/adaptive-bed-mesh.md rename to doc/printer_settings/adaptive-bed-mesh.md diff --git a/doc/air-filtration.md b/doc/printer_settings/air-filtration.md similarity index 100% rename from doc/air-filtration.md rename to doc/printer_settings/air-filtration.md diff --git a/doc/bed-types.md b/doc/printer_settings/bed-types.md similarity index 100% rename from doc/bed-types.md rename to doc/printer_settings/bed-types.md diff --git a/resources/data/hints.ini b/resources/data/hints.ini index 86b1e4d0079..6f833597b20 100644 --- a/resources/data/hints.ini +++ b/resources/data/hints.ini @@ -64,7 +64,7 @@ [hint:Precise wall] text = Precise wall\nDid you know that turning on precise wall can improve precision and layer consistency? -documentation_link = https://github.com/SoftFever/OrcaSlicer/wiki/Precise-wall +documentation_link = https://github.com/SoftFever/OrcaSlicer/wiki/quality_settings_precision [hint:Sandwich mode] text = Sandwich mode\nDid you know that you can use sandwich mode (inner-outer-inner) to improve precision and layer consistency if your model doesn't have very steep overhangs? diff --git a/src/slic3r/GUI/Tab.cpp b/src/slic3r/GUI/Tab.cpp index e566b15f00c..f8285677662 100644 --- a/src/slic3r/GUI/Tab.cpp +++ b/src/slic3r/GUI/Tab.cpp @@ -2076,13 +2076,13 @@ void TabPrint::build() optgroup = page->new_optgroup(L("Precision"), L"param_precision"); optgroup->append_single_option_line("slice_closing_radius"); optgroup->append_single_option_line("resolution"); - optgroup->append_single_option_line("enable_arc_fitting", "acr-move"); - optgroup->append_single_option_line("xy_hole_compensation", "xy-hole-contour-compensation"); - optgroup->append_single_option_line("xy_contour_compensation", "xy-hole-contour-compensation"); - optgroup->append_single_option_line("elefant_foot_compensation"); - optgroup->append_single_option_line("elefant_foot_compensation_layers"); - optgroup->append_single_option_line("precise_outer_wall", "Precise-wall"); - optgroup->append_single_option_line("precise_z_height", "precise-z-height"); + optgroup->append_single_option_line("enable_arc_fitting", "quality_settings_precision#arc-fitting"); + optgroup->append_single_option_line("xy_hole_compensation", "quality_settings_precision#xy-compensation"); + optgroup->append_single_option_line("xy_contour_compensation", "quality_settings_precision#xy-compensation"); + optgroup->append_single_option_line("elefant_foot_compensation", "quality_settings_precision#elefant-foot-compensation"); + optgroup->append_single_option_line("elefant_foot_compensation_layers", "quality_settings_precision#elefant-foot-compensation"); + optgroup->append_single_option_line("precise_outer_wall", "quality_settings_precision#precise-wall"); + optgroup->append_single_option_line("precise_z_height", "quality_settings_precision#precise-z-height"); optgroup->append_single_option_line("hole_to_polyhole"); optgroup->append_single_option_line("hole_to_polyhole_threshold"); optgroup->append_single_option_line("hole_to_polyhole_twisted"); @@ -2097,7 +2097,7 @@ void TabPrint::build() optgroup->append_single_option_line("ironing_angle"); optgroup = page->new_optgroup(L("Wall generator"), L"param_wall_generator"); - optgroup->append_single_option_line("wall_generator", "wall-generator"); + optgroup->append_single_option_line("wall_generator", "quality_settings_wall-generator"); optgroup->append_single_option_line("wall_transition_angle"); optgroup->append_single_option_line("wall_transition_filter_deviation"); optgroup->append_single_option_line("wall_transition_length"); @@ -2126,7 +2126,7 @@ void TabPrint::build() option.opt.is_code = true; option.opt.height = 15; optgroup->append_single_option_line(option, "small-area-infill-flow-compensation"); - + optgroup = page->new_optgroup(L("Bridging"), L"param_bridge"); optgroup->append_single_option_line("bridge_flow"); optgroup->append_single_option_line("internal_bridge_flow"); @@ -2136,8 +2136,8 @@ void TabPrint::build() optgroup->append_single_option_line("thick_internal_bridges"); optgroup->append_single_option_line("enable_extra_bridge_layer"); optgroup->append_single_option_line("dont_filter_internal_bridges"); - optgroup->append_single_option_line("counterbore_hole_bridging","counterbore-hole-bridging"); - + optgroup->append_single_option_line("counterbore_hole_bridging"); + optgroup = page->new_optgroup(L("Overhangs"), L"param_overhang"); optgroup->append_single_option_line("detect_overhang_wall"); optgroup->append_single_option_line("make_overhang_printable"); @@ -2157,15 +2157,15 @@ void TabPrint::build() optgroup = page->new_optgroup(L("Top/bottom shells"), L"param_shell"); optgroup->append_single_option_line("top_shell_layers"); optgroup->append_single_option_line("top_shell_thickness"); - optgroup->append_single_option_line("top_surface_pattern", "fill-patterns#Infill of the top surface and bottom surface"); + optgroup->append_single_option_line("top_surface_pattern"); optgroup->append_single_option_line("bottom_shell_layers"); optgroup->append_single_option_line("bottom_shell_thickness"); - optgroup->append_single_option_line("bottom_surface_pattern", "fill-patterns#Infill of the top surface and bottom surface"); + optgroup->append_single_option_line("bottom_surface_pattern"); optgroup->append_single_option_line("top_bottom_infill_wall_overlap"); optgroup = page->new_optgroup(L("Infill"), L"param_infill"); - optgroup->append_single_option_line("sparse_infill_density"); - optgroup->append_single_option_line("sparse_infill_pattern", "fill-patterns#infill types and their properties of sparse"); + optgroup->append_single_option_line("sparse_infill_density", "strength_settings_infill#sparse-infill-density"); + optgroup->append_single_option_line("sparse_infill_pattern", "strength_settings_infill#sparse-infill-pattern"); optgroup->append_single_option_line("lattice_angle_1"); optgroup->append_single_option_line("lattice_angle_2"); optgroup->append_single_option_line("infill_anchor_max"); @@ -2205,7 +2205,7 @@ void TabPrint::build() optgroup->append_single_option_line("support_speed"); optgroup->append_single_option_line("support_interface_speed"); optgroup = page->new_optgroup(L("Overhang speed"), L"param_overhang_speed", 15); - optgroup->append_single_option_line("enable_overhang_speed", "slow-down-for-overhang"); + optgroup->append_single_option_line("enable_overhang_speed"); // Orca: DEPRECATED // optgroup->append_single_option_line("overhang_speed_classic", "slow-down-for-overhang"); optgroup->append_single_option_line("slowdown_for_curled_perimeters"); @@ -2247,11 +2247,11 @@ void TabPrint::build() optgroup->append_single_option_line("initial_layer_jerk"); optgroup->append_single_option_line("travel_jerk"); optgroup->append_single_option_line("default_junction_deviation"); - + optgroup = page->new_optgroup(L("Advanced"), L"param_advanced", 15); - optgroup->append_single_option_line("max_volumetric_extrusion_rate_slope", "extrusion-rate-smoothing"); - optgroup->append_single_option_line("max_volumetric_extrusion_rate_slope_segment_length", "extrusion-rate-smoothing"); - optgroup->append_single_option_line("extrusion_rate_smoothing_external_perimeter_only", "extrusion-rate-smoothing"); + optgroup->append_single_option_line("max_volumetric_extrusion_rate_slope", "speed_extrusion_rate_smoothing"); + optgroup->append_single_option_line("max_volumetric_extrusion_rate_slope_segment_length", "speed_extrusion_rate_smoothing"); + optgroup->append_single_option_line("extrusion_rate_smoothing_external_perimeter_only", "speed_extrusion_rate_smoothing"); page = add_options_page(L("Support"), "custom-gcode_support"); // ORCA: icon only visible on placeholders optgroup = page->new_optgroup(L("Support"), L"param_support");