Orca Slicer
-
- 
-Please be aware that "**orcaslicer.net**", "**orcaslicer.co**" or "**orca-slicer.com**" are NOT an official website for OrcaSlicer and may be potentially malicious. These sites appear to use AI-generated content, lacking genuine context and seems to exist solely to profit from advertisements. Worse, it may redirect download links to harmful sources. For your safety, avoid downloading OrcaSlicer from this site as the links may be compromised.
+#### Follow us:
+
-If you see the above sites in your searches, report them as spam or unsafe to the search engine. This small action will assist everyone.
+#### Join our Discord community:
+
-We deeply value our OrcaSlicer community and appreciate all the social groups that support us. However, it is crucial to address the risk posed by any group that falsely claims to be official or misleads its members. If you encounter such a group or are part of one, please assist by encouraging the group owner to add a clear disclaimer or by alerting its members.
-
-
-
-Thank you for your vigilance and support in keeping our community safe!
+> [!CAUTION]
+> There are multiple unofficial and potentially malicious websites pretending to be related to OrcaSlicer. These sites may redirect you to dangerous downloads or contain misleading information.
+>
+> If you come across any of these in search results, please report them as unsafe or spam to help keep the community secure.
# Main features
-- Auto-calibration for all printers
-- Sandwich (inner-outer-inner) mode - An improved version of the `External Perimeters First` mode
-- [Precise wall](https://github.com/SoftFever/OrcaSlicer/wiki/Precise-wall)
-- Polyholes conversion support: [SuperSlicer Wiki: Polyholes](https://github.com/supermerill/SuperSlicer/wiki/Polyholes)
-- Klipper support
-- More granular controls
-- Additional features can be found in the [change notes](https://github.com/SoftFever/OrcaSlicer/releases/)
+
+- **[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)**
+ 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**
+ Use varied infill patterns and accurate hole shapes for improved clarity.
+- **Overhang and Support Optimization**
+ Modify geometry for printable overhangs with precise support placement.
+- **Granular Controls and Customization**
+ Fine-tune print speed, layer height, pressure, and temperature with precision.
+- **Network Printer Support**
+ Seamless integration with Klipper, PrusaLink, and OctoPrint for remote control.
+- **Mouse Ear Brims & Adaptive Bed Mesh**
+ Automatic brims and adaptive mesh calibration ensure consistent adhesion.
+- **User-Friendly Interface**
+ Intuitive drag-and-drop design with pre-made profiles for popular printers.
+- **Open-Source & Community Driven**
+ Regular updates fueled by continuous community contributions.
+- **Wide Printer Compatibility**
+ Supports a broad range of printers: Bambu Lab, Prusa, Creality, Voron, and more.
+- Additional features can be found in the [change notes](https://github.com/SoftFever/OrcaSlicer/releases/)
# Wiki
+
The wiki below aims to provide a detailed explanation of the slicer settings, including how to maximize their use and how to calibrate and set up your printer.
Please note that the wiki is a work in progress. We appreciate your patience as we continue to develop and improve it!
-**[Access the wiki here](https://github.com/SoftFever/OrcaSlicer/wiki)**
+**[Access the wiki here](https://github.com/SoftFever/OrcaSlicer/wiki)**
+**[Contribute to the wiki](https://github.com/SoftFever/OrcaSlicer/wiki/How-to-wiki)**
# Download
-### Stable Release
+## Stable Release
📥 **[Download the Latest Stable Release](https://github.com/SoftFever/OrcaSlicer/releases/latest)**
Visit our GitHub Releases page for the latest stable version of Orca Slicer, recommended for most users.
-### Nightly Builds
+## Nightly Builds
🌙 **[Download the Latest Nightly Build](https://github.com/SoftFever/OrcaSlicer/releases/tag/nightly-builds)**
Explore the latest developments in Orca Slicer with our nightly builds. Feedback on these versions is highly appreciated.
# How to install
-**Windows**:
-1. Download the installer for your preferred version from the [releases page](https://github.com/SoftFever/OrcaSlicer/releases).
- - *For convenience there is also a portable build available.*
- - *If you have troubles to run the build, you might need to install following runtimes:*
- - [MicrosoftEdgeWebView2RuntimeInstallerX64](https://github.com/SoftFever/OrcaSlicer/releases/download/v1.0.10-sf2/MicrosoftEdgeWebView2RuntimeInstallerX64.exe)
- - [Details of this runtime](https://aka.ms/webview2)
- - [Alternative Download Link Hosted by Microsoft](https://go.microsoft.com/fwlink/p/?LinkId=2124703)
- - [vcredist2019_x64](https://github.com/SoftFever/OrcaSlicer/releases/download/v1.0.10-sf2/vcredist2019_x64.exe)
- - [Alternative Download Link Hosted by Microsoft](https://aka.ms/vs/17/release/vc_redist.x64.exe)
- - This file may already be available on your computer if you've installed visual studio. Check the following location: `%VCINSTALLDIR%Redist\MSVC\v142`
+## Windows
+Download the **Windows Installer exe** for your preferred version from the [releases page](https://github.com/SoftFever/OrcaSlicer/releases).
+
+ - *For convenience there is also a portable build available.*
+
-
- 
+
+
|
-
- 
+
+
|
-
-
-
-[](https://paypal.me/softfever3d)
+## Backers:
+**Ko-fi supporters** ☕: [Backers list](https://github.com/user-attachments/files/16147016/Supporters_638561417699952499.csv)
+## Support me
+
+
+
## Some background
OrcaSlicer was originally forked from Bambu Studio, it was previously known as BambuStudio-SoftFever.
[Bambu Studio](https://github.com/bambulab/BambuStudio) is forked from [PrusaSlicer](https://github.com/prusa3d/PrusaSlicer) by Prusa Research, which is from [Slic3r](https://github.com/Slic3r/Slic3r) by Alessandro Ranellucci and the RepRap community.
Orca Slicer incorporates a lot of features from [SuperSlicer](https://github.com/supermerill/SuperSlicer) by @supermerill
-Orca Slicer's logo is designed by community member Justin Levine(@freejstnalxndr)
-
+Orca Slicer's logo is designed by community member Justin Levine(@freejstnalxndr).
# License
-Orca Slicer is licensed under the GNU Affero General Public License, version 3. Orca Slicer is based on Bambu Studio by BambuLab.
+**Orca Slicer** is licensed under the GNU Affero General Public License, version 3. Orca Slicer is based on Bambu Studio by BambuLab.
-Bambu Studio is licensed under the GNU Affero General Public License, version 3. Bambu Studio is based on PrusaSlicer by PrusaResearch.
+**Bambu Studio** is licensed under the GNU Affero General Public License, version 3. Bambu Studio is based on PrusaSlicer by PrusaResearch.
-PrusaSlicer is licensed under the GNU Affero General Public License, version 3. PrusaSlicer is owned by Prusa Research. PrusaSlicer is originally based on Slic3r by Alessandro Ranellucci.
+**PrusaSlicer** is licensed under the GNU Affero General Public License, version 3. PrusaSlicer is owned by Prusa Research. PrusaSlicer is originally based on Slic3r by Alessandro Ranellucci.
-Slic3r is licensed under the GNU Affero General Public License, version 3. Slic3r was created by Alessandro Ranellucci with the help of many other contributors.
+**Slic3r** is licensed under the GNU Affero General Public License, version 3. Slic3r was created by Alessandro Ranellucci with the help of many other contributors.
The GNU Affero General Public License, version 3 ensures that if you use any part of this software in any way (even behind a web server), your software must be released under the same license.
diff --git a/cmake/modules/MacOSXBundleInfo.plist.in b/cmake/modules/MacOSXBundleInfo.plist.in
index 3de0ec036c..2f010c8a82 100644
--- a/cmake/modules/MacOSXBundleInfo.plist.in
+++ b/cmake/modules/MacOSXBundleInfo.plist.in
@@ -37,14 +37,6 @@
-
-
-
-
-### Pattern method
-
-The pattern method is adapted from [Andrew Ellis' pattern method generator](https://ellis3dp.com/Pressure_Linear_Advance_Tool/), which was itself derived from the [Marlin pattern method](https://marlinfw.org/tools/lin_advance/k-factor.html) developed by [Sineos](https://github.com/Sineos/k-factorjs).
-
-[Instructions for using and reading the pattern method](https://ellis3dp.com/Print-Tuning-Guide/articles/pressure_linear_advance/pattern_method.html) are provided in [Ellis' Print Tuning Guide](https://ellis3dp.com/Print-Tuning-Guide/), with only a few Orca Slicer differences to note.
-
-Test configuration window allow user to generate one or more tests in a single projects. Multiple tests will be placed on each plate with extra plates added if needed.
-
-1. Single test \
-
-2. Batch mode testing (multiple tests on a sinle plate) \
-
-
-Once test generated, one or more small rectangular prisms could be found on the plate, one for each test case. This object serves a few purposes:
-
-1. The test pattern itself is added in as custom G-Code at each layer, same as you could do by hand actually. The rectangular prism gives us the layers in which to insert that G-Code. This also means that **you'll see the full test pattern when you move to the Preview pane**:
-
-2. The prism acts as a handle, enabling you to move the test pattern wherever you'd like on the plate by moving the prism
-3. Each test object is pre-configured with target parameters which are reflected in the objects name. However, test parameters may be adjusted for each prism individually by referring to the object list pane:
-
-
-Next, Ellis' generator provided the ability to adjust specific printer, filament, and print profile settings. You can make these same changes in Orca Slicer by adjusting the settings in the Prepare pane as you would with any other print. When you initiate the calibration test, Ellis' default settings are applied. A few things to note about these settings:
-
-1. Ellis specified line widths as a percent of filament diameter. The Orca pattern method does the same to provide its suggested defaults, making use of Ellis' percentages in combination with your specified nozzle diameter
-2. In terms of line width, the pattern only makes use of the `Default` and `First layer` widths
-3. In terms of speed, the pattern only uses the `First layer speed -> First layer` and `Other layers speed -> Outer wall` speeds
-4. The infill pattern beneath the numbers cannot be changed becuase it's not actually an infill pattern pulled from the settings. All of the pattern G-Code is custom written, so that "infill" is, effectively, hand-drawn and so not processed through the usual channels that would enable Orca to recognize it as infill
-
-### Tower method
-
-The tower method may take a bit more time to complete, but it does not rely on the quality of the first layer.
-The PA value for this test will be increased by 0.002 for every 1 mm increase in height. (**NOTE** 0.02 for Bowden)
-Steps:
- 1. Select the printer, filament, and process you would like to use for the test.
- 2. Examine each corner of the print and mark the height that yields the best overall result.
- 3. I selected a height of 8 mm for this case, so the pressure advance value should be calculated as `PressureAdvanceStart+(PressureAdvanceStep x measured)` example: `0+(0.002 x 8) = 0.016`.
-
-
-
-
-# Temp tower
-
-Temp tower is a straightforward test. The temp tower is a vertical tower with multiple blocks, each printed at a different temperature. Once the print is complete, we can examine each block of the tower and determine the optimal temperature for the filament. The optimal temperature is the one that produces the highest quality print with the least amount of issues, such as stringing, layer adhesion, warping (overhang), and bridging.
-
-
-# Retraction test
-
-This test generates a retraction tower automatically. The retraction tower is a vertical structure with multiple notches, each printed at a different retraction length. After the print is complete, we can examine each section of the tower to determine the optimal retraction length for the filament. The optimal retraction length is the shortest one that produces the cleanest tower.
-
-In the dialog, you can select the start and end retraction length, as well as the retraction length increment step. The default values are 0mm for the start retraction length, 2mm for the end retraction length, and 0.1mm for the step. These values are suitable for most direct drive extruders. However, for Bowden extruders, you may want to increase the start and end retraction lengths to 1mm and 6mm, respectively, and set the step to 0.2mm.
-
-**Note**: When testing filaments such as PLA or ABS that have minimal oozing, the retraction settings can be highly effective. You may find that the retraction tower appears clean right from the start. In such situations, setting the retraction length to 0.2mm - 0.4mm using Orca Slicer should suffice.
-On the other hand, if there is still a lot of stringing at the top of the tower, it is recommended to dry your filament and ensure that your nozzle is properly installed without any leaks.
-
-
-# Orca Tolerance Test
-This tolerance test is specifically designed to assess the dimensional accuracy of your printer and filament. The model comprises a base and a hexagon tester. The base contains six hexagon hole, each with a different tolerance: 0.0mm, 0.05mm, 0.1mm, 0.2mm, 0.3mm, and 0.4mm. The dimensions of the hexagon tester are illustrated in the image.
-
-
-You can assess the tolerance using either an M6 Allen key or the printed hexagon tester.
-
-
-
-# Advanced Calibration
-
-## Max Volumetric speed
-This is a test designed to calibrate the maximum volumetric speed of the specific filament. The generic or 3rd party filament types may not have the correct volumetric flow rate set in the filament. This test will help you to find the maximum volumetric speed of the filament.
-
-You will be promted to enter the settings for the test: start volumetric speed, end volumentric speed, and step. It is recommended to use the default values (5mm³/s start, 20mm³/s end, with a step of 0.5), unless you already have an idea of the lower or upper limit for your filament. Select "OK", slice the plate, and send it to the printer.
-
-Once printed, take note of where the layers begin to fail and where the quality begins to suffer. Pay attention to changes from matte to shiny as well.
-
-
-
-Using calipers or a ruler, measure the height of the print at that point. Use the following calculation to determine the correct max flow value: `start + (height-measured * step)` . For example in the photo below, and using the default setting values, the print quality began to suffer at 19mm measured, so the calculation would be: `5 + (19 * 0.5)` , or `13mm³/s` using the default values. Enter your number into the "Max volumetric speed" value in the filament settings.
-
-
-
-You can also return to OrcaSlicer in the "Preview" tab, make sure the color scheme "flow" is selected. Scroll down to the layer height that you measured, and click on the toolhead slider. This will indicate the max flow level for your filmanet.
-
-
-
-> [!NOTE]
-> You may also choose to conservatively reduce the flow by 5-10% to ensure print quality.
-
-## Input Shaping
-
-During high-speed movements, vibrations can cause a phenomenon called "ringing," where periodic ripples appear on the print surface. Input Shaping provides an effective solution by counteracting these vibrations, improving print quality and reducing wear on components without needing to significantly lower print speeds.
-
-### Klipper
-
-### Resonance Compensation
-
-The Klipper Resonance Compensation is a set of Input Shaping modes that can be used to reduce ringing and improve print quality.
-Ussualy the recommended values modes are ``MZV`` or ``EI`` for Delta printers.
-
-1. Pre-requisites:
- 1. In OrcaSlicer, set:
- 1. Acceleration high enough to trigger ringing (e.g., 2000 mm/s²).
- 2. Speed high enough to trigger ringing (e.g., 200 mm/s).
- > [!NOTE]
- > These settings depend on your printer's motion ability and the filament's max volumetric speed. If you can't reach speeds that cause ringing, try increasing the filament's max volumetric speed (avoid materials below 10 mm³/s).
- 3. Jerk [Klipper Square Corner Velocity](https://www.klipper3d.org/Kinematics.html?h=square+corner+velocity#look-ahead) to 5 or a high value (e.g., 20).
- 2. In printer settigs:
- 1. Set the Shaper Type to ``MZV`` or ``EI``.
- ```
- SET_INPUT_SHAPER SHAPER_TYPE=MZV
- ```
- 2. Disable [Minimun Cruise Ratio](https://www.klipper3d.org/Kinematics.html#minimum-cruise-ratio) with:
- ```
- SET_VELOCITY_LIMIT MINIMUM_CRUISE_RATIO=0
- ```
- 3. Use an opaque, high-gloss filament to make the ringing more visible.
-2. Print the Input Shaping Frequency test with a range of frequencies.
-
- 
-
- 1. Measure the X and Y heights and read the frequency set at that point in Orca Slicer.
-
- 
- 
-
- 2. If not a clear result, you can measure a X and Y min and max acceptable heights and repeat the test with that min and max value.
-
- **Note**: There is a chance you will need to set higher than 60Hz frequencies. Some printers with very rigid frames and excellent mechanics may exhibit frequencies exceeding 100Hz.
-3. Print the Damping test setting your X and Y frequency to the value you found in the previous step.
-
- 
-
- 1. Measure the X and Y heights and read the damping set at that point in Orca Slicer.
-
- 
- 
-
- **Note**: Not all Resonance Compensation modes support damping
-4. Restore your 3D Printer settings to avoid keep using high acceleration and jerk values.
-5. Save the settings
- 1. You need to go to the printer settings and set the X and Y frequency and damp to the value you found in the previous step.
-
-### Marlin
-
-#### ZV Input Shaping
-
-ZV Input Shaping introduces an anti-vibration signal into the stepper motion for the X and Y axes. It works by splitting the step count into two halves: the first at half the frequency and the second as an "echo," delayed by half the ringing interval. This simple approach effectively reduces vibrations, improving print quality and allowing for higher speeds.
-
-1. Pre-requisites:
- 1. In OrcaSlicer, set:
- 1. Acceleration high enough to trigger ringing (e.g., 2000 mm/s²).
- 2. Speed high enough to trigger ringing (e.g., 200 mm/s).
- > [!NOTE]
- > These settings depend on your printer's motion ability and the filament's max volumetric speed. If you can't reach speeds that cause ringing, try increasing the filament's max volumetric speed (avoid materials below 10 mm³/s).
- 4. Jerk
- 1. If using [Classic Jerk](https://marlinfw.org/docs/configuration/configuration.html#jerk-) use a high value (e.g., 20).
- 2. If using [Junction Deviation](https://marlinfw.org/docs/features/junction_deviation.html) (new Marlin default mode) this test will use 0.25 (high enough to most printers).
- 2. Use an opaque, high-gloss filament to make the ringing more visible.
-2. Print the Input Shaping Frequency test with a range of frequencies.
-
- 
-
- 1. Measure the X and Y heights and read the frequency set at that point in Orca Slicer.
-
- 
- 
-
- 2. If not a clear result, you can measure a X and Y min and max acceptable heights and repeat the test with that min and max value.
-
- **Note**: There is a chance you will need to set higher than 60Hz frequencies. Some printers with very rigid frames and excellent mechanics may exhibit frequencies exceeding 100Hz.
-3. Print the Damping test setting your X and Y frequency to the value you found in the previous step.
-
- 
-
- 1. Measure the X and Y heights and read the damping set at that point in Orca Slicer.
-
- 
- 
-
-4. Restore your 3D Printer settings to avoid keep using high acceleration and jerk values.
- 1. Reboot your printer.
- 2. Use the following G-code to restore your printer settings:
- ```gcode
- M501
- ```
-5. Save the settings
- 1. You need to go to the printer settings and set the X and Y frequency and damp to the value you found in the previous step.
- 2. Use the following G-code to set the frequency:
- ```gcode
- M593 X F#Xfrequency D#XDamping
- M593 Y F#Yfrequency D#YDamping
- M500
- ```
- Example
- ```gcode
- M593 X F37.25 D0.16
- M593 Y F37.5 D0.06
- M500
- ```
-
-#### Fixed-Time Motion
-
-TODO This calibration test is currently under development. See the [Marlin documentation](https://marlinfw.org/docs/gcode/M493.html) for more information.
-
-### Junction Deviation
-
-Junction Deviation is the default method for controlling cornering speed in MarlinFW printers.
-Higher values result in more aggressive cornering speeds, while lower values produce smoother, more controlled cornering.
-The default value in Marlin is typically set to 0.08mm, which may be too high for some printers, potentially causing ringing. Consider lowering this value to reduce ringing, but avoid setting it too low, as this could lead to excessively slow cornering speeds.
-
-1. Pre-requisites:
- 1. Check if your printer has Junction Deviation enabled. You can do this by sending the command `M503` to your printer and looking for the line `Junction deviation: 0.25`.
- 2. In OrcaSlicer, set:
- 1. Acceleration high enough to trigger ringing (e.g., 2000 mm/s²).
- 2. Speed high enough to trigger ringing (e.g., 100 mm/s).
- 3. Use an opaque, high-gloss filament to make the ringing more visible.
-2. You need to print the Junction Deviation test.
-
- 
-
- 1. Measure the X and Y heights and read the frequency set at that point in Orca Slicer.
-
- 
- 
-
- 2. It’s very likely that you’ll need to set values lower than 0.08 mm, as shown in the previous example. To determine a more accurate maximum JD value, you can print a new calibration tower with a maximum value set at the point where the corners start losing sharpness.
- 3.
- 
-
- 4. Measure the X and Y heights and read the frequency set at that point in Orca Slicer.
-
- 
- 
-3. Save the settings
- 1. Set your Maximun Junction Deviation value in [Printer settings/Motion ability/Jerk limitation].
- 2. Use the following G-code to set the mm:
- ```gcode
- M205 J#JunctionDeviationValue
- M500
- ```
- Example
- ```gcode
- M205 J0.012
- M500
- ```
- 3. Recompile your MarlinFW
- 1. In Configuration.h uncomment and set:
- ```cpp
- #define JUNCTION_DEVIATION_MM 0.012 // (mm) Distance from real junction edge
- ```
- 2. Check Classic Jerk is disabled (commented).
- ```cpp
- //#define CLASSIC_JERK
- ```
-
-## VFA
-
-Vertical Fine Artifacts (VFA) are small artifacts that can occur on the surface of a 3D print, particularly in areas where there are sharp corners or changes in direction. These artifacts can be caused by a variety of factors, including mechanical vibrations, resonance, and other factors that can affect the quality of the print.
-Because of the nature of these artifacts the methods to reduce them can be mechanical such as changing motors, belts and pulleys or with advanced calibrations such as Jerk/[Juction Deviation](#junction-deviation) corrections or [Input Shaping](#input-shaping).
-
-
-***
-*Credits:*
-- *The Flowrate test and retraction test is inspired by [SuperSlicer](https://github.com/supermerill/SuperSlicer).*
-- *The PA Line method is inspired by [K-factor Calibration Pattern](https://marlinfw.org/tools/lin_advance/k-factor.html).*
-- *The PA Tower method is inspired by [Klipper](https://www.klipper3d.org/Pressure_Advance.html).*
-- *The temp tower model is remixed from [Smart compact temperature calibration tower](https://www.thingiverse.com/thing:2729076).*
-- *The max flowrate test was inspired by Stefan (CNC Kitchen), and the model used in the test is a remix of his [Extrusion Test Structure](https://www.printables.com/model/342075-extrusion-test-structure).*
-- *ZV Input Shaping is inspired by [Marlin Input Shaping](https://marlinfw.org/docs/features/input_shaping.html) and [Ringing Tower 3D STL](https://marlinfw.org/assets/stl/ringing_tower.stl).*
-- *ChatGPT* ;)
diff --git a/doc/Chamber-temperature.md b/doc/Chamber-temperature.md
index ea268532bf..52b81d7aa8 100644
--- a/doc/Chamber-temperature.md
+++ b/doc/Chamber-temperature.md
@@ -1,23 +1,38 @@
-OrcaSlicer use `M141/M191` command to control active chamber heater.
+# Chamber Temperature Control
-If `Activate temperature control` is checked, OrcaSlicer will insert `M191` command at the beginning of the gcode(before `Machine G-code`).
-
-*Note: If the machine is equipped with an auxiliary fan, OrcaSlicer will automatically activate the fan during the heating period to help circulate air in the chamber.*
+OrcaSlicer use `M141/M191` command to control active chamber heater.
+
+If your Filament's `Activate temperature control` and your printer `Support control chamber temperature` option are checked , OrcaSlicer will insert `M191` command at the beginning of the gcode (before `Machine G-code`).
+
+
+
-There are two chamber temperature variables available that we can use in `Machine G-code` to control the chamber temperature, if you prefer:
-To access the chamber temperature set in the first filament, use:
-`M191 S{chamber_temperature[0]}`
-To use the overall chamber temperature, which is the highest chamber temperature set across all filaments, use:
-`M191 S{overall_chamber_temperature}`
+> [!NOTE]
+> If the machine is equipped with an auxiliary fan, OrcaSlicer will automatically activate the fan during the heating period to help circulate air in the chamber.
+## Using Chamber Temperature Variables in Machine G-code
---------------------------Klipper--------------------------
-If you are using Klipper, you can define these macros to control the active chamber heater.
-Bellow is a reference configuration for Klipper.
-*Note: Don't forget to change the pin name/values to the actual values you are using in the configuration*
+You can use chamber temperature variables in your `Machine G-code` to control the chamber temperature manually, if desired:
-```
+- To set the chamber temperature to the value specified for the first filament:
+ ```gcode
+ M191 S{chamber_temperature[0]}
+ ```
+- To set the chamber temperature to the highest value specified across all filaments:
+ ```gcode
+ M191 S{overall_chamber_temperature}
+ ```
+
+## Klipper
+
+If you are using Klipper, you can define these macros to control the active chamber heater.
+Bellow is a reference configuration for Klipper.
+
+> [!IMPORTANT]
+> Don't forget to change the pin name/values to the actual values you are using in the configuration.
+
+```gcode
[heater_generic chamber_heater]
heater_pin:PB10
max_power:1.0
@@ -25,7 +40,7 @@ max_power:1.0
sensor_type:NTC 100K MGB18-104F39050L32
sensor_pin:PA1
control = pid
-pid_Kp = 63.418
+pid_Kp = 63.418
pid_ki = 0.960
pid_kd = 1244.716
min_temp:0
@@ -48,5 +63,4 @@ gcode:
TEMPERATURE_WAIT SENSOR="heater_generic chamber_heater" MINIMUM={s-1} MAXIMUM={s+1}
M117 Chamber at target temperature
{% endif %}
-
-```
\ No newline at end of file
+```
diff --git a/doc/Home.md b/doc/Home.md
index 6e98b91e1e..c0738b56dd 100644
--- a/doc/Home.md
+++ b/doc/Home.md
@@ -1,40 +1,68 @@
# Welcome to the OrcaSlicer WIKI!
-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.
+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.
-The Wiki is work in progress so bear with us while we get it up and running!
+- [Print Settings, Tips and Tricks](#print-settings-tips-and-tricks)
+ - [Quality Settings](#quality-settings)
+ - [Speed Settings](#speed-settings)
+ - [Multi material](#multi-material)
+ - [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!
+
+## Print Settings, Tips and Tricks
-## Print Settings, Tips and Tricks (Work In Progress)
The below sections provide a detailed settings explanation as well as tips and tricks in setting these for optimal print results.
### Quality Settings
+
- [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)
### Speed Settings
+
- [Extrusion rate smoothing](extrusion-rate-smoothing)
### Multi material
+
- [Single Extruder Multimaterial](semm)
-### Printer Settings:
+### Printer Settings
+
- [Air filtration/Exhaust fan handling](air-filtration)
- [Auxiliary fan handling](Auxiliary-fan)
- [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
-The guide below takes you through the key calibration tests in Orca - flow rate, pressure advance, print temperature, retraction, tolerances and maximum volumetric speed
-- [Calibration Guide](./Calibration)
-- [Adaptive Pressure Advance Guide](adaptive-pressure-advance)
+
+The [Calibration Guide](Calibration) outlines Orca’s key calibration tests and their suggested order of execution.
+
+- [Temperature](temp-calib)
+- [Flow Rate](flow-rate-calib)
+- [Pressure Advance](pressure-advance-calib)
+ - [Adaptive Pressure Advance Guide](adaptive-pressure-advance-calib)
+- [Retraction](retraction-calib)
+- [Tolerance](tolerance-calib)
+- Advanced:
+ - [Volumetric Speed](volumetric-speed-calib)
+ - [Cornering (Jerk & Junction Deviation)](cornering-calib)
+ - [Input Shaping](input-shaping-calib)
## Developer Section
-- [How to build Orca Slicer](./How-to-build)
+
+- [How to build Orca Slicer](How-to-build)
- [Localization and translation guide](Localization_guide)
-- [Developer Reference](https://github.com/SoftFever/OrcaSlicer/blob/main/doc/developer-reference/Home.md)
-- [How to create profiles](./How-to-create-profiles)
\ No newline at end of file
+- [Developer Reference](Developers-Home)
+- [How to create profiles](How-to-create-profiles)
+- [How to contribute to the wiki](How-to-wiki)
diff --git a/doc/How-to-build.md b/doc/How-to-build.md
index a7c05b0f5d..49553c039e 100644
--- a/doc/How-to-build.md
+++ b/doc/How-to-build.md
@@ -1,11 +1,193 @@
-# How to compile
-- Windows 64-bit
- - Tools needed: Visual Studio 2019, Cmake, git, Strawberry Perl.
- - Run `build_release.bat` in `x64 Native Tools Command Prompt for VS 2019`
+# How to Build
-- Mac 64-bit
- - Tools needed: Xcode, Cmake, git, gettext
- - run `build_release_macos.sh`
+## Windows 64-bit
-- Ubuntu
- - run `BuildLinux.sh -udisr`
\ No newline at end of file
+This guide is for building your Visual Studio 2022 solution for OrcaSlicer on Windows 64-bit.
+
+### Tools Required
+
+- [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) or Visual Studio 2019
+ ```shell
+ winget install --id=Microsoft.VisualStudio.2022.Professional -e
+ ```
+- [CMake (version 3.31)](https://cmake.org/) — **⚠️ version 3.31.x is mandatory**
+ ```shell
+ winget install --id=Kitware.CMake -v "3.31.6" -e
+ ```
+- [Strawberry Perl](https://strawberryperl.com/)
+ ```shell
+ winget install --id=StrawberryPerl.StrawberryPerl -e
+ ```
+- [Git](https://git-scm.com/)
+ ```shell
+ winget install --id=Git.Git -e
+ ```
+- [git-lfs](https://git-lfs.com/)
+ ```shell
+ winget install --id=GitHub.GitLFS -e
+ ```
+
+> [!TIP]
+> GitHub Desktop (optional): A GUI for Git and Git LFS, which already includes both tools.
+> ```shell
+> winget install --id=GitHub.GitHubDesktop -e
+> ```
+
+### Instructions
+
+1. Clone the repository:
+ - If using GitHub Desktop clone the repository from the GUI.
+ - If using the command line:
+ 1. Clone the repository:
+ ```shell
+ git clone https://github.com/SoftFever/OrcaSlicer
+ ```
+ 2. Run lfs to download tools on Windows:
+ ```shell
+ git lfs pull
+ ```
+2. Open the appropriate command prompt:
+ - For Visual Studio 2019:
+ Open **x64 Native Tools Command Prompt for VS 2019** and run:
+ ```shell
+ build_release.bat
+ ```
+ - For Visual Studio 2022:
+ Open **x64 Native Tools Command Prompt for VS 2022** and run:
+ ```shell
+ build_release_vs2022.bat
+ ```
+3. If successful, you will find the VS 2022 solution file in:
+ ```shell
+ build\OrcaSlicer.sln
+ ```
+
+> [!IMPORTANT]
+> Make sure that CMake version 3.31.x is actually being used. Run `cmake --version` and verify it returns a **3.31.x** version.
+> If you see an older version (e.g. 3.29), it's likely due to another copy in your system's PATH (e.g. from Strawberry Perl).
+> You can run where cmake to check the active paths and rearrange your System Environment Variables > PATH, ensuring the correct CMake (e.g. C:\Program Files\CMake\bin) appears before others like C:\Strawberry\c\bin.
+
+> [!NOTE]
+> If the build fails, try deleting the `build/` and `deps/build/` directories to clear any cached build data. Rebuilding after a clean-up is usually sufficient to resolve most issues.
+
+## macOS 64-bit
+
+### Tools Required
+
+- Xcode
+- CMake (version 3.31.x is mandatory)
+- Git
+- gettext
+- libtool
+- automake
+- autoconf
+- texinfo
+
+> [!TIP]
+> You can install most of them by running:
+> ```shell
+> brew install gettext libtool automake autoconf texinfo
+> ```
+
+Homebrew currently only offers the latest version of CMake (e.g. **4.X**), which is not compatible. To install the required version **3.31.X**, follow these steps:
+
+1. Download CMake **3.31.7** from: [https://cmake.org/download/](https://cmake.org/download/)
+2. Install the application (drag it to `/Applications`).
+3. Add the following line to your shell configuration file (`~/.zshrc` or `~/.bash_profile`):
+
+```sh
+export PATH="/Applications/CMake.app/Contents/bin:$PATH"
+```
+
+4. Restart the terminal and check the version:
+
+```sh
+cmake --version
+```
+
+5. Make sure it reports a **3.31.x** version.
+
+> [!IMPORTANT]
+> If you've recently upgraded Xcode, be sure to open Xcode at least once and install the required macOS build support.
+
+### Instructions
+
+1. Clone the repository:
+ ```shell
+ git clone https://github.com/SoftFever/OrcaSlicer
+ cd OrcaSlicer
+ ```
+2. Build the application:
+ ```shell
+ ./build_release_macos.sh
+ ```
+3. Open the application:
+ ```shell
+ open build/arm64/OrcaSlicer/OrcaSlicer.app
+ ```
+
+### Debugging in Xcode
+
+To build and debug directly in Xcode:
+
+1. Open the Xcode project:
+ ```shell
+ open build/arm64/OrcaSlicer.xcodeproj
+ ```
+2. In the menu bar:
+ - **Product > Scheme > OrcaSlicer**
+ - **Product > Scheme > Edit Scheme...**
+ - Under **Run > Info**, set **Build Configuration** to `RelWithDebInfo`
+ - Under **Run > Options**, uncheck **Allow debugging when browsing versions**
+ - **Product > Run**
+
+## Linux
+
+### Using Docker (Recommended)
+
+#### Dependencies
+
+- Docker
+- Git
+
+#### Instructions
+
+```shell
+git clone https://github.com/SoftFever/OrcaSlicer && cd OrcaSlicer && ./DockerBuild.sh && ./DockerRun.sh
+```
+
+> [!NOTE]
+> To troubleshoot common Docker-related errors, refer to the comments in
+> ```shell
+> DockerRun.sh
+> ```
+
+## Ubuntu
+
+### Dependencies
+
+All required dependencies will be installed automatically by the provided shell script, including:
+
+- libmspack-dev
+- libgstreamerd-3-dev
+- libsecret-1-dev
+- libwebkit2gtk-4.0-dev
+- libosmesa6-dev
+- libssl-dev
+- libcurl4-openssl-dev
+- eglexternalplatform-dev
+- libudev-dev
+- libdbus-1-dev
+- extra-cmake-modules
+- libgtk2.0-dev
+- libglew-dev
+- cmake
+- git
+- texinfo
+
+### Instructions
+
+```shell
+sudo ./BuildLinux.sh -u # Install dependencies
+./BuildLinux.sh -dsi # Build OrcaSlicer
+```
diff --git a/doc/How-to-create-profiles.md b/doc/How-to-create-profiles.md
index 3161a71633..c84ac037ff 100644
--- a/doc/How-to-create-profiles.md
+++ b/doc/How-to-create-profiles.md
@@ -1,10 +1,13 @@
# Guide: Develop Profiles for OrcaSlicer
## Introduction
+
This guide will help you develop profiles for OrcaSlicer.
## High-level Overview
+
OrcaSlicer uses JSON files to store profiles. There are four types of profiles:
+
1. Printer model (type `machine_model`). Example: `Orca 3D Fuse1.json`
2. Printer variant (type `machine`). Example: `Orca 3D Fuse1 0.2 nozzle.json`
3. Filament (type `filament`). Example: `Generic PLA @Orca 3D Fuse1@.json`
@@ -15,6 +18,7 @@ Additionally, there is an overall meta file for each vendor (`Orca 3D.json`).
For easier understanding, let's consider a scenario with a printer manufacturer called `Orca 3D`. The manufacturer offers one printer model called `Fuse 1`, which supports 0.2/0.4/0.6/0.8mm nozzles and common market filaments.
In this case:
+
- Vendor profile: `Orca 3D`
- Printer profile: `Orca 3D Fuse1`
- Printer variant profile: `Orca 3D Fuse1 0.4 nozzle`
@@ -23,39 +27,54 @@ In this case:
The profile name should be same as the filename without the `.json` extension in principal.
Naming conventions:
+
1. Vendor profile: `vendor_name.json`
2. Printer profile: `vendor_name` + `printer_name` + `.json`
3. Printer variant profile: `vendor_name` + `printer_variant_name` + `.json` (where `printer_variant_name` typically includes `printer_name` + `nozzle_diameter`)
4. Filament profile: `filament_vendor_name` + `filament_name` + " @" + `vendor_name` + `printer_name`/`printer_variant_name` + `.json`
5. Process profile: `layer_height` + `preset_name` + " @" + `vendor_name` + `printer_name`/`printer_variant_name` + `.json` (`preset_name` typically includes "standard," "fine," "fast," "draft," etc.)
+## File Structure and Templates
-A typical file structure for a vendor:
-```
+Profiles should be structured in the following way under the OrcaSlicer installation directory:
+
+```plaintext
resources\profiles\
- - Orca 3D.json
- - Orca 3D\
- - machine\
- - Orca 3D Fuse1.json
- - Orca 3D Fuse1 0.2 nozzle.json
- - Orca 3D Fuse1 0.4 nozzle.json
- - process\
- - 0.10mm Standard @Orca 3D Fuse1 0.2.json
- - 0.20mm Standard @Orca 3D Fuse1 0.4.json
- - filament\
- - Generic PLA @Orca 3D Fuse1@.json
+ ├── Orca 3D.json
+ └── Orca 3D\
+ ├── machine\
+ │ ├── Orca 3D Fuse1.json
+ │ ├── Orca 3D Fuse1 0.2 nozzle.json
+ │ └── Orca 3D Fuse1 0.4 nozzle.json
+ ├── process\
+ │ ├── 0.10mm Standard @Orca 3D Fuse1 0.2.json
+ │ └── 0.20mm Standard @Orca 3D Fuse1 0.4.json
+ └── filament\
+ └── Generic PLA @Orca 3D Fuse1@.json
```
+> [!TIP]
+> Use short vendor names in filenames to avoid excessive length.
-**NOTE 1**: Use short vendor names in filenames to avoid excessive length.
-**NOTE 2**: Filament profiles are **optional**. Create them only if the vendor has specifically tuned profiles for the given printer. See [Filament profiles](#filament-profiles) for details.
+> [!NOTE]
+> Filament profiles are **optional**. Create them only if the vendor has specifically tuned profiles for the given printer. See [Filament profiles](#filament-profiles) for details.
+
+Template files for profiles are available in:
+
+```shell
+OrcaSlicer\resources\profiles_template\Template
+```
+
+These templates can be used as a starting point for new printer, filament, and process profiles.
## Filament Profiles
+
OrcaSlicer features a global filament library called `OrcaFilamentLibrary`, which is automatically available for all printers. It includes generic filaments like `Generic PLA @System` and `Generic ABS @System` etc.
-Printer vendors can override specific filaments in the global library for certain printer models by creating new filament profiles.
+Printer vendors can override specific filaments in the global library for certain printer models by creating new filament profiles.
Relationship diagram:
+
```mermaid
graph TD;
OrcaFilamentLibrary-->Orca_3D_filament;
@@ -63,9 +82,11 @@ graph TD;
OrcaFilamentLibrary-->Vendor_B_filament;
```
-**NOTE**: Create new filament profiles only if you have truly specifically tuned the filament for the given printer. Otherwise, use the global library. The global library has a better chance to receive optimizations and updates from OrcaSlicer contributors, which will benefit users of all printers.
+> [!IMPORTANT]
+> Create new filament profiles only if you have truly specifically tuned the filament for the given printer. Otherwise, use the global library. The global library has a better chance to receive optimizations and updates from OrcaSlicer contributors, which will benefit users of all printers.
### Adding Filament Profiles to the Global Library
+
In this section, we will discuss how to add a new filament profile into the global library.
If you want to add a new generic profile into the global library, you need to create a new file in the `resources\profiles\OrcaFilamentLibrary\filament` folder. If a base type already exists in the global library, you can use this file as a base profile by inheriting it.
The following sample JSON file shows how to create a new generic filament profile `Generic PLA-GF @System` in the global library.
@@ -107,11 +128,13 @@ The following sample JSON file shows how to create a new generic filament profil
}
```
-3. The last step is to validate the newly added filament profiles. You can run OrcaSlicer to verify if the filament you just added is available and usable. You can also use the [Orca profile validator](https://github.com/SoftFever/Orca_tools/releases/tag/1) tool to help debug any errors. **NOTE**: You need to delete the `%appdata%/OrcaSlicer/system` folder to force OrcaSlicer to reload your lastest changes.
+3. The last step is to validate the newly added filament profiles see [Validate Profiles](#validate-profiles).
-The process is the same if you want to add a new brand filament profile into the global library. You need to create a new file in the `resources\profiles\OrcaFilamentLibrary\filament\brand_name` folder. The only difference is that you should put the file into the brand's own subfolder.`resources\profiles\OrcaFilamentLibrary\filament\brand_name`.
+> [!NOTE]
+> If the filament is compatible with AMS, ensure that the `filament_id` value **does not exceed 8 characters** to maintain AMS compatibility.
### Adding Filament Profiles to Printer Vendor Library
+
In this section, we will discuss how to add a new filament profile for a certain vendor.
If you want to add a new filament profile, whether it's a brand new profile or a specialized version of a global filament profile for a given printer, you need to create a new file in the `resources\profiles\vendor_name\filament` folder. If a base type already exists in the global library, you can use this file as a base profile by inheriting it.
Below is a sample JSON file showing how to create a specialized `Generic ABS` filament profile for the ToolChanger printer.
@@ -170,11 +193,224 @@ Please note that here we must leave the compatible_printers field non-empty, unl
}
```
-## Process Profiles
-WIP...
+> [!NOTE]
+> If the filament is compatible with AMS, ensure that the `filament_id` value **does not exceed 8 characters** to maintain AMS compatibility.
-## Printer Profiles
-WIP...
+## Process Profiles
+
+Process profiles define print quality and behavior. They follow a structure similar to filament profiles:
+
+- A common base file, e.g., `fdm_process_common.json`, acts as the parent.
+- Vendor-specific process profiles should inherit from the base using the `inherits` field.
+- Profiles are stored under:
+
+```shell
+resources\profiles\vendor_name\process\
+```
+
+- **There are no global process profiles**.
+- Each process profile includes a `"compatible_printers"` field with an array of compatible printer variant names.
+
+Example:
+
+```json
+{
+ "type": "process",
+ "name": "0.10mm Standard @ExampleVendor Printer 0.2",
+ "inherits": "fdm_process_common",
+ "from": "system",
+ "instantiation": "true",
+ "compatible_printers": [
+ "ExampleVendor Printer 0.2 nozzle"
+ ]
+}
+```
+
+## Printer Model Profiles
+
+- Printer model profiles (type `machine_model`) describe the general printer information.
+- Example fields: `nozzle_diameter`, `bed_model`, `bed_texture`, `model_id`, etc.
+- Stored in:
+
+```shell
+resources\profiles\vendor_name\machine\
+```
+
+- Each vendor's folder may contain an image named:
+
+```shell
+[machine_model_list.name]_cover.png
+```
+
+This image will be used in the UI.
+
+Example model profile:
+
+```json
+{
+ "type": "machine_model",
+ "name": "Example M5",
+ "nozzle_diameter": "0.2;0.25;0.4;0.6",
+ "bed_model": "M5-Example-bed.stl",
+ "bed_texture": "M5-Example-texture.svg",
+ "model_id": "V1234",
+ "family": "Example",
+ "machine_tech": "FFF",
+ "default_materials": "Example Generic PLA;Example Generic PETG"
+}
+```
## Printer Variant Profiles
-WIP...
\ No newline at end of file
+
+- Printer variants (type `machine`) define specific nozzle configurations and mechanical details.
+- Each variant must inherit from a common base like `fdm_machine_common.json`.
+- Must list the compatible nozzle diameter in the `nozzle_diameter` array.
+- Example fields include `printer_model`, `printer_variant`, `default_print_profile`, `printable_area`, etc.
+
+Example variant profile:
+
+```json
+{
+ "type": "machine",
+ "name": "Example M5 0.2 nozzle",
+ "inherits": "fdm_machine_common",
+ "from": "system",
+ "setting_id": "GM001",
+ "instantiation": "true",
+ "nozzle_diameter": ["0.2"],
+ "printer_model": "Example M5",
+ "printer_variant": "0.2",
+ "default_filament_profile": ["Example Generic PLA"],
+ "default_print_profile": "0.10mm Standard 0.2mm nozzle @Example",
+ "printable_area": ["0x0", "235x0", "235x235", "0x235"],
+ "nozzle_type": "brass"
+}
+```
+
+## Models
+
+- The `model` directory under the vendor folder is intended to behave similarly to `machine` profiles.
+- Used for additional printer-related 3D models or definitions, stored at:
+
+```
+resources\profiles\vendor_name\model\
+```
+
+## Vendor Meta File
+
+Each vendor must include a JSON file in the `resources\profiles` directory, named `vendor_name.json`. This file lists all available models, variants, processes, and filaments:
+
+Example:
+
+```json
+{
+ "name": "ExampleVendor",
+ "version": "01.00.00.00",
+ "force_update": "1",
+ "description": "Example configuration",
+ "machine_model_list": [
+ {
+ "name": "Example M5",
+ "sub_path": "machine/Example M5.json"
+ }
+ ],
+ "machine_list": [
+ {
+ "name": "fdm_machine_common",
+ "sub_path": "machine/fdm_machine_common.json"
+ }
+ ],
+ "process_list": [
+ {
+ "name": "fdm_process_common",
+ "sub_path": "process/fdm_process_common.json"
+ }
+ ],
+ "filament_list": [
+ {
+ "name": "fdm_filament_common",
+ "sub_path": "filament/fdm_filament_common.json"
+ }
+ ]
+}
+```
+
+## Validate Profiles
+
+You can validate your profiles using both the **OrcaSlicer profile validator** and the **Python validation script**. These tools are designed to check different aspects of the profiles, so both should be executed and pass without errors to ensure full compatibility.
+
+> [!NOTE]
+> **✅ Recommendation:** Always run **both** the OrcaSlicer validator and the Python script to ensure all aspects of the profiles are valid.
+
+### 1. OrcaSlicer Profile Validator
+
+You can run OrcaSlicer to verify if the filament you just added is available and usable. You can also use the [Orca profile validator](https://github.com/SoftFever/Orca_tools/releases/tag/1) tool to help debug any errors.
+
+> [!IMPORTANT]
+> You need to delete the `%appdata%/OrcaSlicer/system` folder to force OrcaSlicer to reload your lastest changes.
+
+The process is the same if you want to add a new brand filament profile into the global library. You need to create a new file in the `resources\profiles\OrcaFilamentLibrary\filament\brand_name` folder. The only difference is that you should put the file into the brand's own subfolder.
+
+#### Usage
+
+```shell
+-h [ --help ] help
+-p [ --path ] arg profile folder
+-v [ --vendor ] arg Vendor name. Optional, all profiles present in the folder will be validated if not specified
+-l [ --log_level ] arg (=2) Log level. Optional, default is 2 (warning). Higher values produce more detailed logs.
+```
+
+#### Example
+
+```shell
+./OrcaSlicer_profile_validator -p ~/codes/OrcaSlicer/resources/profiles -l 2 -v Custom
+```
+
+#### Sample result with errors
+
+```shell
+PS D:\codes\OrcaSlicer> ."D:/codes/OrcaSlicer/build/src/Release/OrcaSlicer_profile_validator.exe" --path d:\codes\OrcaSlicer\resources\profiles -l 2 -v Custom
+[2024-02-28 21:23:06.102138] [0x0000a4e8] [error] Slic3r::ConfigBase::load_from_json: parse d:\codes\OrcaSlicer\resources\profiles/Custom/machine/fdm_klipper_common.json got a nlohmann::detail::parse_error, reason = [json.exception.parse_error.101] parse error at line 9, column 38: syntax error while parsing object - unexpected string literal; expected '}'
+...
+Validation failed
+```
+
+#### Sample result with success
+
+```shell
+PS D:\codes\OrcaSlicer\build\src\RelWithDebInfo> ."D:/codes/OrcaSlicer/build/src/Release/OrcaSlicer_profile_validator.exe" --path d:\codes\OrcaSlicer\resources\profiles -l 2 -v Custom
+Validation completed successfully
+```
+
+> [!WARNING]
+> Use `OrcaSlicer_profile_validator` on Ubuntu and `OrcaSlicer_profile_validator.exe` on Windows.
+
+---
+
+### 2. Python Profile Validation Script
+
+In addition to the Orca validator, you should run the `orca_extra_profile_check.py` script. This script performs additional checks like:
+
+- Validation of `compatible_printers` in filament profiles
+- Consistency of filament names
+- Validation of default materials in machine profiles (optional)
+
+#### Example command
+
+```shell
+python ./orca_extra_profile_check.py
+```
+
+You can also enable or disable specific checks:
+
+- `--vendor` (optional): checks only the specified vendor. If omitted, all vendors are checked.
+- `--check-filaments` (enabled by default): checks `compatible_printers` fields in filament profiles
+- `--check-materials`: checks default material names in machine profiles
+
+#### Sample usage with all checks enabled
+
+```shell
+python ./orca_extra_profile_check.py --vendor="vendor_name" --check-filaments --check-materials
+```
+
+The script will output the number of errors found and exit with a non-zero status code if any issues are detected.
diff --git a/doc/How-to-wiki.md b/doc/How-to-wiki.md
new file mode 100644
index 0000000000..86f3779257
--- /dev/null
+++ b/doc/How-to-wiki.md
@@ -0,0 +1,246 @@
+# How to Contribute to the Wiki
+
+This guide explains how to contribute to the Orca Slicer wiki.
+
+Orca Slicer uses GitHub's wiki feature, which allows users and developers to create and edit documentation collaboratively.
+
+We encourage all developers and users to contribute to the wiki by updating existing pages and adding new content. This helps keep the documentation up-to-date and useful for everyone.
+
+When developing new features, please consider updating the wiki to reflect these changes. This ensures that users have access to the latest information and can make the most of the features.
+
+- [Wiki Structure](#wiki-structure)
+ - [Home](#home)
+ - [Index and Navigation](#index-and-navigation)
+ - [File Naming and Organization](#file-naming-and-organization)
+- [Formatting and Style](#formatting-and-style)
+ - [Markdown Formatting](#markdown-formatting)
+ - [Alerts and Callouts](#alerts-and-callouts)
+- [Images](#images)
+ - [Image Naming](#image-naming)
+ - [Image Placement](#image-placement)
+ - [Linking Images](#linking-images)
+ - [Examples](#examples)
+ - [Avoid the Following](#avoid-the-following)
+ - [Resize Images](#resize-images)
+ - [Image Cropping and Highlighting](#image-cropping-and-highlighting)
+ - [Recommended Formats](#recommended-formats)
+- [Structuring Content](#structuring-content)
+- [Commands and Code Blocks](#commands-and-code-blocks)
+- [External Links](#external-links)
+
+## Wiki Structure
+
+Each wiki page is a Markdown file located in the `doc` directory of the repository. The wiki is organized into various sections, each covering different areas of the project.
+
+### Home
+
+The starting point of the Orca Slicer wiki is the **Home** page. From there, you can navigate to different sections and topics related to the project.
+
+When creating a new page or section, be sure to link it from the Home page under the appropriate category.
+
+- **Print Settings:** Detailed explanations of print settings, tips, and tricks for optimizing print quality.
+- **Printer Calibration:** Step-by-step calibration tests in Orca Slicer, including how to interpret the results.
+- **Developer Section:** Information for developers and contributors on building Orca Slicer, localization, and developer resources.
+
+#### Index and Navigation
+
+Github Wiki uses the name of the files as identifiers for the pages. To link to a page, use the file name without the `.md` extension.
+If the file is inside a subdirectory, dont include the subdirectory in the link. Instead, link directly to the file from the Home page.
+
+For example, if you create a new page `doc/calibration/flow-rate-calib.md`, link it as follows:
+
+```markdown
+[Calibration Guide](Calibration)
+```
+
+For pages with extensive content, it's helpful to include a table of contents at the beginning. This allows users to quickly find and access different sections of the page.
+
+```markdown
+- [Wiki Structure](#wiki-structure)
+ - [Home](#home)
+ - [Index and Navigation](#index-and-navigation)
+ - [File Naming and Organization](#file-naming-and-organization)
+- [Formatting and Style](#formatting-and-style)
+```
+
+> [!NOTE]
+> If you're adding a new section, follow the existing structure and ensure it doesn't already fit within an existing category. Link it from the Home page accordingly.
+
+### File Naming and Organization
+
+When creating new pages, follow these file naming conventions:
+
+- Use unique file names to avoid conflicts.
+- Use descriptive names that reflect the page's content.
+- Use kebab-case for filenames (e.g., `How-to-wiki.md`).
+- If the page belongs to a specific section, include the section name in the file name. For example, calibration pages should end with `-calib.md` (e.g., `flow-rate-calib.md`, `pressure-advance-calib.md`).
+- Place files in the appropriate subdirectory when applicable (e.g., `doc/calibration/` for calibration-related content).
+
+## Formatting and Style
+
+Please adhere to the following style and formatting conventions when contributing to the wiki.
+
+### Markdown Formatting
+
+The wiki uses standard Markdown syntax for formatting and aims to maintain a consistent style across all pages. Avoid using raw HTML tags and prefer Markdown formatting instead.
+
+Ensure your indentation is consistent, especially for code blocks and lists.
+
+Refer to the [GitHub Markdown Guide](https://guides.github.com/features/mastering-markdown/) for more information on Markdown syntax.
+
+### Alerts and Callouts
+
+To add alerts or notes, use GitHub’s Markdown alert syntax:
+
+```markdown
+> [!NOTE]
+> Useful information that users should know, even when skimming content.
+
+> [!TIP]
+> Helpful advice for doing things better or more easily.
+
+> [!IMPORTANT]
+> Key information users need to know to achieve their goal.
+
+> [!WARNING]
+> Urgent info that needs immediate user attention to avoid problems.
+
+> [!CAUTION]
+> Advises about risks or negative outcomes of certain actions.
+```
+
+> [!NOTE]
+> Useful information that users should know, even when skimming content.
+
+> [!TIP]
+> Helpful advice for doing things better or more easily.
+
+> [!IMPORTANT]
+> Key information users need to know to achieve their goal.
+
+> [!WARNING]
+> Urgent info that needs immediate user attention to avoid problems.
+
+> [!CAUTION]
+> Advises about risks or negative outcomes of certain actions.
+
+Refer to the [GitHub Alert Guide](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts) for more details.
+
+## Images
+
+Images are encouraged to enhance the clarity and quality of the wiki content. They help illustrate concepts, provide examples, and improve readability.
+
+> [!CAUTION]
+> Do not use images from third-party sources unless you have the proper permissions.
+
+### Image Naming
+
+- Use clear, descriptive filenames that reflect the image content.
+- For section-specific images, include the section name or initials. For example, images related to Pressure Advance could be named `pa-[description].png`.
+
+### Image Placement
+
+- General images should be placed in the `doc/images/` directory.
+- Section-specific images should be stored in their corresponding subdirectories (e.g., `doc/images/calibration/` for calibration content).
+
+### Linking Images
+
+Always use raw GitHub URLs for image links to ensure correct display:
+
+Format = `![[filename]](` + Base URL + filename.extension + Raw tag + `)`
+
+- Base URL:
+ ```markdown
+ https://github.com/SoftFever/OrcaSlicer/blob/main/doc/images/
+ ```
+- Raw tag:
+ ```markdown
+ ?raw=true
+ ```
+
+#### Examples
+
+- For an image in `doc/images/` named `example.png`:
+
+ ```markdown
+ 
+ ```
+
+- For an image in a subdirectory like `doc/images/calibration/pa-example.svg`:
+ ```markdown
+ 
+ ```
+
+> [!IMPORTANT]
+> New or Moved Images will not appear in the preview until the Pull Request is merged. Double-check your paths.
+> If you are changing an image path, ensure all links to that image are updated accordingly.
+
+#### Avoid the Following
+
+- Relative paths
+- GitHub Assets, user content, or user-images URLs
+- External image links from unreliable or temporary platforms
+- Images containing personal or sensitive information
+- Using images for content that can be expressed in text, such as equations or code—use Markdown syntax or Mermaid/Math formatting instead.
+
+> [!NOTE]
+> When contributing section-specific images, follow the naming conventions and directory structure.
+
+#### Resize Images
+
+Avoid the resize of images and let the Wiki handle it automatically.
+
+If resizing is necessary (e.g., for thumbnails), use the following syntax:
+
+HTML Format = `
+
- `TYPE_FILAMENT`: As the name suggests this preset is for filaments
-
+
- `TYPE_PRINTER`: Preset for printers.
-
+
There are other preset types but some of them are for SLA. Which is legacy code, since SLA printers are no longer supported. Above 3 are the important types.
-## [`PresetBundle`](../../src/libslic3r/PresetBundle.hpp)
+## [`PresetBundle`](https://github.com/SoftFever/OrcaSlicer/blob/main/src/libslic3r/PresetBundle.hpp)
This is a bundle containing a few types of `PresetCollection`. One bundle has presets for some printers, filaments and some processes (TYPE_PRINT).
@@ -30,9 +31,10 @@ This is a bundle containing a few types of `PresetCollection`. One bundle has pr
each one of these contains a collection of processes, filaments and printers respectively.\
-#### Note: Printers, filaments and processes in the bundle don't all have to be compatible with each other. In fact all the saved presets are stored in one `PresetBundle`. The `PresetBundle` is loaded on start up. The list of filaments and processes shown for a particular printer is a subset of `filaments` and `prints` `PresetCollection`s.
+> [!IMPORTANT]
+> Printers, filaments and processes in the bundle don't all have to be compatible with each other. In fact all the saved presets are stored in one `PresetBundle`. The `PresetBundle` is loaded on start up. The list of filaments and processes shown for a particular printer is a subset of `filaments` and `prints` `PresetCollection`s.
-## [`PresetCollection`](../../src/libslic3r/Preset.hpp)
+## [`PresetCollection`](https://github.com/SoftFever/OrcaSlicer/blob/main/src/libslic3r/Preset.hpp)
`PrinterPresetCollection` is a class derived from `PresetCollection`.
diff --git a/doc/developer-reference/plater-sidebar-tab-combobox.md b/doc/developer-reference/plater-sidebar-tab-combobox.md
index a35ca6f8cf..1f01e7b5b6 100644
--- a/doc/developer-reference/plater-sidebar-tab-combobox.md
+++ b/doc/developer-reference/plater-sidebar-tab-combobox.md
@@ -1,23 +1,25 @@
+# Application Structure Overview
+
### !! incomplete, possibly inaccurate, being updated with new info !!
-## [`Plater`](../../src/slic3r/GUI/Plater.hpp)
+## [`Plater`](https://github.com/SoftFever/OrcaSlicer/blob/main/src/slic3r/GUI/Plater.hpp)
Refers to the entire application. The whole view, file loading, project saving and loading is all managed by this class. This class contains members for the model viewer, the sidebar, gcode viewer and everything else.
-## [`Sidebar`](../../src/slic3r/GUI/Plater.hpp)
+## [`Sidebar`](https://github.com/SoftFever/OrcaSlicer/blob/main/src/slic3r/GUI/Plater.hpp)
This is relating the the sidebar in the application window
-
+
-## [`ComboBox`](../../src/slic3r/GUI/Widgets/ComboBox.hpp)
+## [`ComboBox`](https://github.com/SoftFever/OrcaSlicer/blob/main/src/slic3r/GUI/Widgets/ComboBox.hpp)
The drop down menus where you can see and select presets
-
+
-## [`Tab`](../../src/slic3r/GUI/Tab.hpp)
+## [`Tab`](https://github.com/SoftFever/OrcaSlicer/blob/main/src/slic3r/GUI/Tab.hpp)
Refers to the various windows with settings. e.g. the Popup to edit printer or filament preset. Also the section to edit process preset and the object list. These 4 are managed by `TabPrinter`, `TabFilament`, `TabPrint` and `TabPrintModel` respectively.
-
+
\ No newline at end of file
diff --git a/doc/developer-reference/slicing-hierarchy.md b/doc/developer-reference/slicing-hierarchy.md
index 65d28e11aa..f703c75f15 100644
--- a/doc/developer-reference/slicing-hierarchy.md
+++ b/doc/developer-reference/slicing-hierarchy.md
@@ -2,4 +2,43 @@
The Slicing logic is not the easiest to locate in the code base. Below is a flow diagram of function calls that are made after clicking the `Slice Plate` button in the UI. Most of the processing happens in different threads. Note the calls after `BackgroundSlicingProcess::start()`, but this is how you can find the slicing logic.
-
+```mermaid
+flowchart TD
+ A["Slice plate"] --> B["void Plater::priv::on_action_slice_plate(SimpleEvent&)"]
+ B --> C["void Plater::reslice()"]
+ C --> D["bool Plater::priv::restart_background_process(unsigned int state)"]
+ D --> E["bool BackgroundSlicingProcess::start()"]
+ E --> F["void BackgroundSlicingProcess::thread_proc_safe_seh_throw()"]
+ F --> G["unsigned long BackgroundSlicingProcess::thread_proc_safe_seh()"]
+ G --> H["void BackgroundSlicingProcess::thread_proc_safe()"]
+ H --> I["void BackgroundSlicingProcess::thread_proc()"]
+ I --> J["void BackgroundSlicingProcess::call_process_seh_throw(std::exception_ptr &ex)"]
+ J --> K["unsigned long BackgroundSlicingProcess::call_process_seh(std::exception_ptr &ex)"]
+ K --> L["void BackgroundSlicingProcess::call_process(std::exception_ptr &ex)"]
+ L --> M["void BackgroundSlicingProcess::process_fff()"]
+ M --> N["void Print::process(long long *time_cost_with_cache, bool use_cache)"]
+ N --> O["void PrintObject::make_perimeters()"]
+ O --> P["void PrintObject::slice()"]
+
+ %% Labels for libraries
+ subgraph G1 [libSlic3r_gui]
+ B
+ C
+ D
+ E
+ F
+ G
+ H
+ I
+ J
+ K
+ L
+ M
+ end
+
+ subgraph G2 [libSlic3r]
+ N
+ O
+ P
+ end
+```
\ No newline at end of file
diff --git a/doc/fill-patterns.md b/doc/fill-patterns.md
new file mode 100644
index 0000000000..73a832b784
--- /dev/null
+++ b/doc/fill-patterns.md
@@ -0,0 +1,91 @@
+# Infill Patterns
+WIP...
+
+## Concentric
+
+
+
+## Rectilinear
+
+
+
+## Grid
+
+
+
+## 2D Lattice
+
+
+
+## Line
+
+
+
+## Cubic
+
+
+
+## Triangles
+
+
+
+## Tri-hexagon
+
+
+
+## Gyroid
+
+
+
+## Honeycomb
+
+
+
+## Adaptive Cubic
+
+
+
+## Aligned Rectilinear
+
+
+
+## 3D Honeycomb
+
+
+
+## Hilbert Curve
+
+
+
+## Archimedean Chords
+
+
+
+## Octagram Spiral
+
+
+
+## Support Cubic
+
+
+
+## Lightning
+
+
+
+## Cross Hatch
+
+
+
+## Quartered Cubic
+
+
+
+> [!NOTE]
+> Standard images are taken with:
+> - Primitive Cube: 66mm x 66mm x 66mm
+> - Layer Height: 0.2mm
+> - Infill Density: 15%
+> - Layer Count: 329
+> - Wall loops: 3 (Hide in isometric view)
+> - Anchor: Off
diff --git a/doc/images/Adaptative-Bed-Mesh/ABM-Machine-G-code.png b/doc/images/Adaptative-Bed-Mesh/ABM-Machine-G-code.png
new file mode 100644
index 0000000000..c0367a90c2
Binary files /dev/null and b/doc/images/Adaptative-Bed-Mesh/ABM-Machine-G-code.png differ
diff --git a/doc/images/Adaptative-Bed-Mesh/ABM-PrinterConfig.png b/doc/images/Adaptative-Bed-Mesh/ABM-PrinterConfig.png
new file mode 100644
index 0000000000..c2c691c0ae
Binary files /dev/null and b/doc/images/Adaptative-Bed-Mesh/ABM-PrinterConfig.png differ
diff --git a/doc/images/Chamber/Chamber-Temperature-Control-Material.png b/doc/images/Chamber/Chamber-Temperature-Control-Material.png
new file mode 100644
index 0000000000..66559a86a3
Binary files /dev/null and b/doc/images/Chamber/Chamber-Temperature-Control-Material.png differ
diff --git a/doc/images/Chamber/Chamber-Temperature-Control-Printer.png b/doc/images/Chamber/Chamber-Temperature-Control-Printer.png
new file mode 100644
index 0000000000..1d7429c925
Binary files /dev/null and b/doc/images/Chamber/Chamber-Temperature-Control-Printer.png differ
diff --git a/doc/images/ERS/equation1.jpeg b/doc/images/ERS/equation1.jpeg
deleted file mode 100644
index 9b8439862f..0000000000
Binary files a/doc/images/ERS/equation1.jpeg and /dev/null differ
diff --git a/doc/images/ERS/equation1terms.jpeg b/doc/images/ERS/equation1terms.jpeg
deleted file mode 100644
index 35f6c7dba2..0000000000
Binary files a/doc/images/ERS/equation1terms.jpeg and /dev/null differ
diff --git a/doc/images/ERS/equation2.jpeg b/doc/images/ERS/equation2.jpeg
deleted file mode 100644
index 2a4536bbdb..0000000000
Binary files a/doc/images/ERS/equation2.jpeg and /dev/null differ
diff --git a/doc/images/ERS/artefact.jpeg b/doc/images/ERS/ers-artefact.jpg
similarity index 100%
rename from doc/images/ERS/artefact.jpeg
rename to doc/images/ERS/ers-artefact.jpg
diff --git a/doc/images/ERS/intro.jpg b/doc/images/ERS/ers-intro.jpg
similarity index 100%
rename from doc/images/ERS/intro.jpg
rename to doc/images/ERS/ers-intro.jpg
diff --git a/doc/images/ERS/printspeed.jpeg b/doc/images/ERS/ers-printspeed.jpg
similarity index 100%
rename from doc/images/ERS/printspeed.jpeg
rename to doc/images/ERS/ers-printspeed.jpg
diff --git a/doc/images/flow-calibration.gif b/doc/images/Flow-Rate/flow-calibration.gif
similarity index 100%
rename from doc/images/flow-calibration.gif
rename to doc/images/Flow-Rate/flow-calibration.gif
diff --git a/doc/images/Flow-Rate/flowcalibration_update_flowrate.png b/doc/images/Flow-Rate/flowcalibration_update_flowrate.png
new file mode 100644
index 0000000000..6ac5024733
Binary files /dev/null and b/doc/images/Flow-Rate/flowcalibration_update_flowrate.png differ
diff --git a/doc/images/Flow-Rate/flowrate-0-5.jpg b/doc/images/Flow-Rate/flowrate-0-5.jpg
new file mode 100644
index 0000000000..364b67351a
Binary files /dev/null and b/doc/images/Flow-Rate/flowrate-0-5.jpg differ
diff --git a/doc/images/Flow-Rate/flowrate-6.jpg b/doc/images/Flow-Rate/flowrate-6.jpg
new file mode 100644
index 0000000000..d5f65683c9
Binary files /dev/null and b/doc/images/Flow-Rate/flowrate-6.jpg differ
diff --git a/doc/images/Flow-Rate/flowrate-Bambulab-uncheck.png b/doc/images/Flow-Rate/flowrate-Bambulab-uncheck.png
new file mode 100644
index 0000000000..b362a3d689
Binary files /dev/null and b/doc/images/Flow-Rate/flowrate-Bambulab-uncheck.png differ
diff --git a/doc/images/Flow-Rate/flowrate-pass1.jpg b/doc/images/Flow-Rate/flowrate-pass1.jpg
new file mode 100644
index 0000000000..8cbe342800
Binary files /dev/null and b/doc/images/Flow-Rate/flowrate-pass1.jpg differ
diff --git a/doc/images/Flow-Rate/flowrate-pass2.jpg b/doc/images/Flow-Rate/flowrate-pass2.jpg
new file mode 100644
index 0000000000..5d4197d143
Binary files /dev/null and b/doc/images/Flow-Rate/flowrate-pass2.jpg differ
diff --git a/doc/images/InputShaping/IS_damp_menu.png b/doc/images/InputShaping/IS_damp_menu.png
index 5f8fbeb59f..bb3674826d 100644
Binary files a/doc/images/InputShaping/IS_damp_menu.png and b/doc/images/InputShaping/IS_damp_menu.png differ
diff --git a/doc/images/InputShaping/IS_freq_menu.png b/doc/images/InputShaping/IS_freq_menu.png
index df51c0787f..e4764b50bf 100644
Binary files a/doc/images/InputShaping/IS_freq_menu.png and b/doc/images/InputShaping/IS_freq_menu.png differ
diff --git a/doc/images/JunctionDeviation/jd_first_menu.png b/doc/images/JunctionDeviation/jd_first_menu.png
index 263126143b..8888e401d7 100644
Binary files a/doc/images/JunctionDeviation/jd_first_menu.png and b/doc/images/JunctionDeviation/jd_first_menu.png differ
diff --git a/doc/images/JunctionDeviation/jd_second_menu.png b/doc/images/JunctionDeviation/jd_second_menu.png
index 016b2a4aaa..683b303f16 100644
Binary files a/doc/images/JunctionDeviation/jd_second_menu.png and b/doc/images/JunctionDeviation/jd_second_menu.png differ
diff --git a/doc/images/PreciseWall/PreciseWallOff.svg b/doc/images/PreciseWall/PreciseWallOff.svg
new file mode 100644
index 0000000000..f920f06f41
--- /dev/null
+++ b/doc/images/PreciseWall/PreciseWallOff.svg
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/doc/images/PreciseWall/PreciseWallOn.svg b/doc/images/PreciseWall/PreciseWallOn.svg
new file mode 100644
index 0000000000..5d27354d1e
--- /dev/null
+++ b/doc/images/PreciseWall/PreciseWallOn.svg
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/doc/images/PreciseZ/PreciseZOff.png b/doc/images/PreciseZ/PreciseZOff.png
new file mode 100644
index 0000000000..43b5d56cc6
Binary files /dev/null and b/doc/images/PreciseZ/PreciseZOff.png differ
diff --git a/doc/images/PreciseZ/PreciseZOn.png b/doc/images/PreciseZ/PreciseZOn.png
new file mode 100644
index 0000000000..861aec011c
Binary files /dev/null and b/doc/images/PreciseZ/PreciseZOn.png differ
diff --git a/doc/images/stl transformation/simplify-menu.png b/doc/images/STL-Transformation/simplify-menu.png
similarity index 100%
rename from doc/images/stl transformation/simplify-menu.png
rename to doc/images/STL-Transformation/simplify-menu.png
diff --git a/doc/images/stl transformation/stl-transformation-enable.png b/doc/images/STL-Transformation/stl-transformation-enable.png
similarity index 100%
rename from doc/images/stl transformation/stl-transformation-enable.png
rename to doc/images/STL-Transformation/stl-transformation-enable.png
diff --git a/doc/images/stl transformation/stl-transformation-params.png b/doc/images/STL-Transformation/stl-transformation-params.png
similarity index 100%
rename from doc/images/stl transformation/stl-transformation-params.png
rename to doc/images/STL-Transformation/stl-transformation-params.png
diff --git a/doc/images/stl transformation/stl-transformation-smooth-rough.png b/doc/images/STL-Transformation/stl-transformation-smooth-rough.png
similarity index 100%
rename from doc/images/stl transformation/stl-transformation-smooth-rough.png
rename to doc/images/STL-Transformation/stl-transformation-smooth-rough.png
diff --git a/doc/images/stl transformation/stl-transformation-split.png b/doc/images/STL-Transformation/stl-transformation-split.png
similarity index 100%
rename from doc/images/stl transformation/stl-transformation-split.png
rename to doc/images/STL-Transformation/stl-transformation-split.png
diff --git a/doc/images/stl transformation/stl-transformation.png b/doc/images/STL-Transformation/stl-transformation.png
similarity index 100%
rename from doc/images/stl transformation/stl-transformation.png
rename to doc/images/STL-Transformation/stl-transformation.png
diff --git a/doc/images/Temp-calib/temp-tower.jpg b/doc/images/Temp-calib/temp-tower.jpg
new file mode 100644
index 0000000000..5394d25420
Binary files /dev/null and b/doc/images/Temp-calib/temp-tower.jpg differ
diff --git a/doc/images/temp_tower_test.gif b/doc/images/Temp-calib/temp-tower_test.gif
similarity index 100%
rename from doc/images/temp_tower_test.gif
rename to doc/images/Temp-calib/temp-tower_test.gif
diff --git a/doc/images/Temp-calib/temp-tower_test_menu.png b/doc/images/Temp-calib/temp-tower_test_menu.png
new file mode 100644
index 0000000000..dfc074ebe9
Binary files /dev/null and b/doc/images/Temp-calib/temp-tower_test_menu.png differ
diff --git a/doc/images/Tolerance/FilamentShrinkageCompensation.png b/doc/images/Tolerance/FilamentShrinkageCompensation.png
new file mode 100644
index 0000000000..8da497eca0
Binary files /dev/null and b/doc/images/Tolerance/FilamentShrinkageCompensation.png differ
diff --git a/doc/images/OrcaToleranceTes_m6.jpg b/doc/images/Tolerance/OrcaToleranceTes_m6.jpg
similarity index 100%
rename from doc/images/OrcaToleranceTes_m6.jpg
rename to doc/images/Tolerance/OrcaToleranceTes_m6.jpg
diff --git a/doc/images/OrcaToleranceTest_print.jpg b/doc/images/Tolerance/OrcaToleranceTest_print.jpg
similarity index 100%
rename from doc/images/OrcaToleranceTest_print.jpg
rename to doc/images/Tolerance/OrcaToleranceTest_print.jpg
diff --git a/doc/images/Tolerance/QualityPrecision.png b/doc/images/Tolerance/QualityPrecision.png
new file mode 100644
index 0000000000..7b763ea67c
Binary files /dev/null and b/doc/images/Tolerance/QualityPrecision.png differ
diff --git a/doc/images/Tolerance/tolerance_hole.svg b/doc/images/Tolerance/tolerance_hole.svg
new file mode 100644
index 0000000000..927be09ae7
--- /dev/null
+++ b/doc/images/Tolerance/tolerance_hole.svg
@@ -0,0 +1,3 @@
+
+
+
\ No newline at end of file
diff --git a/doc/images/activate_chamber_heater.jpg b/doc/images/activate_chamber_heater.jpg
deleted file mode 100644
index c6c4f550ac..0000000000
Binary files a/doc/images/activate_chamber_heater.jpg and /dev/null differ
diff --git a/doc/images/calibration.png b/doc/images/calibration.png
new file mode 100644
index 0000000000..65632b2889
Binary files /dev/null and b/doc/images/calibration.png differ
diff --git a/doc/images/combobox.png b/doc/images/combobox.png
index 0b720e6622..ef2832cc9e 100644
Binary files a/doc/images/combobox.png and b/doc/images/combobox.png differ
diff --git a/doc/images/filament-preset.png b/doc/images/filament-preset.png
index 7ad4c1c52e..0aa6030adb 100644
Binary files a/doc/images/filament-preset.png and b/doc/images/filament-preset.png differ
diff --git a/doc/images/fill/infill-iso-2d-lattice.png b/doc/images/fill/infill-iso-2d-lattice.png
new file mode 100644
index 0000000000..12e0e83496
Binary files /dev/null and b/doc/images/fill/infill-iso-2d-lattice.png differ
diff --git a/doc/images/fill/infill-iso-3d-honeycomb.png b/doc/images/fill/infill-iso-3d-honeycomb.png
new file mode 100644
index 0000000000..67eb5e0d77
Binary files /dev/null and b/doc/images/fill/infill-iso-3d-honeycomb.png differ
diff --git a/doc/images/fill/infill-iso-adaptative-cubic.png b/doc/images/fill/infill-iso-adaptative-cubic.png
new file mode 100644
index 0000000000..4beb64c377
Binary files /dev/null and b/doc/images/fill/infill-iso-adaptative-cubic.png differ
diff --git a/doc/images/fill/infill-iso-aligned-rectilinear.png b/doc/images/fill/infill-iso-aligned-rectilinear.png
new file mode 100644
index 0000000000..e337e57353
Binary files /dev/null and b/doc/images/fill/infill-iso-aligned-rectilinear.png differ
diff --git a/doc/images/fill/infill-iso-archimedean-chords.png b/doc/images/fill/infill-iso-archimedean-chords.png
new file mode 100644
index 0000000000..6d189394dc
Binary files /dev/null and b/doc/images/fill/infill-iso-archimedean-chords.png differ
diff --git a/doc/images/fill/infill-iso-concentric.png b/doc/images/fill/infill-iso-concentric.png
new file mode 100644
index 0000000000..6886c1f7fb
Binary files /dev/null and b/doc/images/fill/infill-iso-concentric.png differ
diff --git a/doc/images/fill/infill-iso-cross-hatch.png b/doc/images/fill/infill-iso-cross-hatch.png
new file mode 100644
index 0000000000..218f2dd3e9
Binary files /dev/null and b/doc/images/fill/infill-iso-cross-hatch.png differ
diff --git a/doc/images/fill/infill-iso-cubic.png b/doc/images/fill/infill-iso-cubic.png
new file mode 100644
index 0000000000..f0b834f36b
Binary files /dev/null and b/doc/images/fill/infill-iso-cubic.png differ
diff --git a/doc/images/fill/infill-iso-grid.png b/doc/images/fill/infill-iso-grid.png
new file mode 100644
index 0000000000..bcb7757209
Binary files /dev/null and b/doc/images/fill/infill-iso-grid.png differ
diff --git a/doc/images/fill/infill-iso-gyroid.png b/doc/images/fill/infill-iso-gyroid.png
new file mode 100644
index 0000000000..601abac68a
Binary files /dev/null and b/doc/images/fill/infill-iso-gyroid.png differ
diff --git a/doc/images/fill/infill-iso-hilbert-curve.png b/doc/images/fill/infill-iso-hilbert-curve.png
new file mode 100644
index 0000000000..ffee09e220
Binary files /dev/null and b/doc/images/fill/infill-iso-hilbert-curve.png differ
diff --git a/doc/images/fill/infill-iso-honeycomb.png b/doc/images/fill/infill-iso-honeycomb.png
new file mode 100644
index 0000000000..e36b8c6002
Binary files /dev/null and b/doc/images/fill/infill-iso-honeycomb.png differ
diff --git a/doc/images/fill/infill-iso-lightning.png b/doc/images/fill/infill-iso-lightning.png
new file mode 100644
index 0000000000..7b40354b33
Binary files /dev/null and b/doc/images/fill/infill-iso-lightning.png differ
diff --git a/doc/images/fill/infill-iso-line.png b/doc/images/fill/infill-iso-line.png
new file mode 100644
index 0000000000..5ea5179eb4
Binary files /dev/null and b/doc/images/fill/infill-iso-line.png differ
diff --git a/doc/images/fill/infill-iso-octagram-spiral.png b/doc/images/fill/infill-iso-octagram-spiral.png
new file mode 100644
index 0000000000..32c185aa75
Binary files /dev/null and b/doc/images/fill/infill-iso-octagram-spiral.png differ
diff --git a/doc/images/fill/infill-iso-quarter-cubic.png b/doc/images/fill/infill-iso-quarter-cubic.png
new file mode 100644
index 0000000000..499406de54
Binary files /dev/null and b/doc/images/fill/infill-iso-quarter-cubic.png differ
diff --git a/doc/images/fill/infill-iso-rectilinear.png b/doc/images/fill/infill-iso-rectilinear.png
new file mode 100644
index 0000000000..41950f3b2a
Binary files /dev/null and b/doc/images/fill/infill-iso-rectilinear.png differ
diff --git a/doc/images/fill/infill-iso-support-cubic.png b/doc/images/fill/infill-iso-support-cubic.png
new file mode 100644
index 0000000000..c09a3c599a
Binary files /dev/null and b/doc/images/fill/infill-iso-support-cubic.png differ
diff --git a/doc/images/fill/infill-iso-tri-hexagon.png b/doc/images/fill/infill-iso-tri-hexagon.png
new file mode 100644
index 0000000000..4ac5baf9eb
Binary files /dev/null and b/doc/images/fill/infill-iso-tri-hexagon.png differ
diff --git a/doc/images/fill/infill-iso-triangles.png b/doc/images/fill/infill-iso-triangles.png
new file mode 100644
index 0000000000..005194feed
Binary files /dev/null and b/doc/images/fill/infill-iso-triangles.png differ
diff --git a/doc/images/fill/infill-top-2d-lacttice.png b/doc/images/fill/infill-top-2d-lacttice.png
new file mode 100644
index 0000000000..519d48083a
Binary files /dev/null and b/doc/images/fill/infill-top-2d-lacttice.png differ
diff --git a/doc/images/fill/infill-top-3d-honeycomb.png b/doc/images/fill/infill-top-3d-honeycomb.png
new file mode 100644
index 0000000000..1012797422
Binary files /dev/null and b/doc/images/fill/infill-top-3d-honeycomb.png differ
diff --git a/doc/images/fill/infill-top-adaptative-cubic.png b/doc/images/fill/infill-top-adaptative-cubic.png
new file mode 100644
index 0000000000..be4aa713fd
Binary files /dev/null and b/doc/images/fill/infill-top-adaptative-cubic.png differ
diff --git a/doc/images/fill/infill-top-aligned-rectilinear.png b/doc/images/fill/infill-top-aligned-rectilinear.png
new file mode 100644
index 0000000000..aef72519bc
Binary files /dev/null and b/doc/images/fill/infill-top-aligned-rectilinear.png differ
diff --git a/doc/images/fill/infill-top-archimedean-chords.png b/doc/images/fill/infill-top-archimedean-chords.png
new file mode 100644
index 0000000000..a9c1fd1d33
Binary files /dev/null and b/doc/images/fill/infill-top-archimedean-chords.png differ
diff --git a/doc/images/fill/infill-top-concentric.png b/doc/images/fill/infill-top-concentric.png
new file mode 100644
index 0000000000..3771afb438
Binary files /dev/null and b/doc/images/fill/infill-top-concentric.png differ
diff --git a/doc/images/fill/infill-top-cross-hatch.png b/doc/images/fill/infill-top-cross-hatch.png
new file mode 100644
index 0000000000..96b95e2f79
Binary files /dev/null and b/doc/images/fill/infill-top-cross-hatch.png differ
diff --git a/doc/images/fill/infill-top-cubic.png b/doc/images/fill/infill-top-cubic.png
new file mode 100644
index 0000000000..08f11ca01c
Binary files /dev/null and b/doc/images/fill/infill-top-cubic.png differ
diff --git a/doc/images/fill/infill-top-grid.png b/doc/images/fill/infill-top-grid.png
new file mode 100644
index 0000000000..b6b3460191
Binary files /dev/null and b/doc/images/fill/infill-top-grid.png differ
diff --git a/doc/images/fill/infill-top-gyroid.png b/doc/images/fill/infill-top-gyroid.png
new file mode 100644
index 0000000000..211a697767
Binary files /dev/null and b/doc/images/fill/infill-top-gyroid.png differ
diff --git a/doc/images/fill/infill-top-hilbert-curve.png b/doc/images/fill/infill-top-hilbert-curve.png
new file mode 100644
index 0000000000..86bcd58d45
Binary files /dev/null and b/doc/images/fill/infill-top-hilbert-curve.png differ
diff --git a/doc/images/fill/infill-top-honeycomb.png b/doc/images/fill/infill-top-honeycomb.png
new file mode 100644
index 0000000000..402d29b8f7
Binary files /dev/null and b/doc/images/fill/infill-top-honeycomb.png differ
diff --git a/doc/images/fill/infill-top-lightning.png b/doc/images/fill/infill-top-lightning.png
new file mode 100644
index 0000000000..e7c4a5a33d
Binary files /dev/null and b/doc/images/fill/infill-top-lightning.png differ
diff --git a/doc/images/fill/infill-top-line.png b/doc/images/fill/infill-top-line.png
new file mode 100644
index 0000000000..3aeaa82e78
Binary files /dev/null and b/doc/images/fill/infill-top-line.png differ
diff --git a/doc/images/fill/infill-top-octagram-spiral.png b/doc/images/fill/infill-top-octagram-spiral.png
new file mode 100644
index 0000000000..d384b213a6
Binary files /dev/null and b/doc/images/fill/infill-top-octagram-spiral.png differ
diff --git a/doc/images/fill/infill-top-quartered-cubic.png b/doc/images/fill/infill-top-quartered-cubic.png
new file mode 100644
index 0000000000..4d2fe6e673
Binary files /dev/null and b/doc/images/fill/infill-top-quartered-cubic.png differ
diff --git a/doc/images/fill/infill-top-rectilinear.png b/doc/images/fill/infill-top-rectilinear.png
new file mode 100644
index 0000000000..a77ce1343e
Binary files /dev/null and b/doc/images/fill/infill-top-rectilinear.png differ
diff --git a/doc/images/fill/infill-top-support-cubic.png b/doc/images/fill/infill-top-support-cubic.png
new file mode 100644
index 0000000000..8dfe1bf079
Binary files /dev/null and b/doc/images/fill/infill-top-support-cubic.png differ
diff --git a/doc/images/fill/infill-top-tri-hexagon.png b/doc/images/fill/infill-top-tri-hexagon.png
new file mode 100644
index 0000000000..43ad5b8675
Binary files /dev/null and b/doc/images/fill/infill-top-tri-hexagon.png differ
diff --git a/doc/images/fill/infill-top-triangles.png b/doc/images/fill/infill-top-triangles.png
new file mode 100644
index 0000000000..196758829b
Binary files /dev/null and b/doc/images/fill/infill-top-triangles.png differ
diff --git a/doc/images/flowcalibration_update_flowrate.jpg b/doc/images/flowcalibration_update_flowrate.jpg
deleted file mode 100644
index f52250be42..0000000000
Binary files a/doc/images/flowcalibration_update_flowrate.jpg and /dev/null differ
diff --git a/doc/images/full-sidebar.png b/doc/images/full-sidebar.png
index 316fd2e95f..2ee3f86cb1 100644
Binary files a/doc/images/full-sidebar.png and b/doc/images/full-sidebar.png differ
diff --git a/doc/images/pa/apa-expected-results.jpg b/doc/images/pa/apa-expected-results.jpg
new file mode 100644
index 0000000000..cc2a669a34
Binary files /dev/null and b/doc/images/pa/apa-expected-results.jpg differ
diff --git a/doc/images/pa/apa-expected-seam.jpg b/doc/images/pa/apa-expected-seam.jpg
new file mode 100644
index 0000000000..f16a522621
Binary files /dev/null and b/doc/images/pa/apa-expected-seam.jpg differ
diff --git a/doc/images/pa/apa-expected-solid-infill.jpg b/doc/images/pa/apa-expected-solid-infill.jpg
new file mode 100644
index 0000000000..e74a049f7d
Binary files /dev/null and b/doc/images/pa/apa-expected-solid-infill.jpg differ
diff --git a/doc/images/pa/apa-identify-optimal.jpg b/doc/images/pa/apa-identify-optimal.jpg
new file mode 100644
index 0000000000..29ccecf190
Binary files /dev/null and b/doc/images/pa/apa-identify-optimal.jpg differ
diff --git a/doc/images/pa/apa-identify-too-high.jpg b/doc/images/pa/apa-identify-too-high.jpg
new file mode 100644
index 0000000000..66a1ee9db2
Binary files /dev/null and b/doc/images/pa/apa-identify-too-high.jpg differ
diff --git a/doc/images/pa/apa-identify-too-low.jpg b/doc/images/pa/apa-identify-too-low.jpg
new file mode 100644
index 0000000000..0c7e720e91
Binary files /dev/null and b/doc/images/pa/apa-identify-too-low.jpg differ
diff --git a/doc/images/pa/apa-material-config.png b/doc/images/pa/apa-material-config.png
new file mode 100644
index 0000000000..2dfcb894e7
Binary files /dev/null and b/doc/images/pa/apa-material-config.png differ
diff --git a/doc/images/pa/apa-profile.png b/doc/images/pa/apa-profile.png
new file mode 100644
index 0000000000..a150316fb2
Binary files /dev/null and b/doc/images/pa/apa-profile.png differ
diff --git a/doc/images/pa/apa-setup-result-acceleration-jerk.png b/doc/images/pa/apa-setup-result-acceleration-jerk.png
new file mode 100644
index 0000000000..659d2dbd69
Binary files /dev/null and b/doc/images/pa/apa-setup-result-acceleration-jerk.png differ
diff --git a/doc/images/pa/apa-setup-result-speed.png b/doc/images/pa/apa-setup-result-speed.png
new file mode 100644
index 0000000000..4117c1337c
Binary files /dev/null and b/doc/images/pa/apa-setup-result-speed.png differ
diff --git a/doc/images/pa/apa-test.png b/doc/images/pa/apa-test.png
new file mode 100644
index 0000000000..5e5cf76dc6
Binary files /dev/null and b/doc/images/pa/apa-test.png differ
diff --git a/doc/images/pa/apa-test210.jpg b/doc/images/pa/apa-test210.jpg
new file mode 100644
index 0000000000..892c338c9d
Binary files /dev/null and b/doc/images/pa/apa-test210.jpg differ
diff --git a/doc/images/pa/apa-unexpected-solid-infill.jpg b/doc/images/pa/apa-unexpected-solid-infill.jpg
new file mode 100644
index 0000000000..a9ce880394
Binary files /dev/null and b/doc/images/pa/apa-unexpected-solid-infill.jpg differ
diff --git a/doc/images/pa/pa-line-0-016.jpg b/doc/images/pa/pa-line-0-016.jpg
new file mode 100644
index 0000000000..0b3f511838
Binary files /dev/null and b/doc/images/pa/pa-line-0-016.jpg differ
diff --git a/doc/images/pa/pa-line.gif b/doc/images/pa/pa-line.gif
new file mode 100644
index 0000000000..aace86d431
Binary files /dev/null and b/doc/images/pa/pa-line.gif differ
diff --git a/doc/images/pa/pa-lines.png b/doc/images/pa/pa-lines.png
new file mode 100644
index 0000000000..23c1a7a49f
Binary files /dev/null and b/doc/images/pa/pa-lines.png differ
diff --git a/doc/images/pa/pa-pattern-batch-objects.png b/doc/images/pa/pa-pattern-batch-objects.png
index aed9eab40f..d5d924d9e9 100644
Binary files a/doc/images/pa/pa-pattern-batch-objects.png and b/doc/images/pa/pa-pattern-batch-objects.png differ
diff --git a/doc/images/pa/pa-pattern-batch.png b/doc/images/pa/pa-pattern-batch.png
index 8a8fe6c18f..bdacef279b 100644
Binary files a/doc/images/pa/pa-pattern-batch.png and b/doc/images/pa/pa-pattern-batch.png differ
diff --git a/doc/images/pa/pa-pattern-general.png b/doc/images/pa/pa-pattern-general.png
new file mode 100644
index 0000000000..23c0141f55
Binary files /dev/null and b/doc/images/pa/pa-pattern-general.png differ
diff --git a/doc/images/pa/pa-pattern-single.png b/doc/images/pa/pa-pattern-single.png
index 9c45170281..e84e85c3b3 100644
Binary files a/doc/images/pa/pa-pattern-single.png and b/doc/images/pa/pa-pattern-single.png differ
diff --git a/doc/images/pa/pa-tower-measure.jpg b/doc/images/pa/pa-tower-measure.jpg
new file mode 100644
index 0000000000..d1fd3c49bc
Binary files /dev/null and b/doc/images/pa/pa-tower-measure.jpg differ
diff --git a/doc/images/pa/pa-tower.jpg b/doc/images/pa/pa-tower.jpg
new file mode 100644
index 0000000000..0a4c5b0edc
Binary files /dev/null and b/doc/images/pa/pa-tower.jpg differ
diff --git a/doc/images/pa/pressure_advance_enable.png b/doc/images/pa/pressure_advance_enable.png
new file mode 100644
index 0000000000..478061d9f6
Binary files /dev/null and b/doc/images/pa/pressure_advance_enable.png differ
diff --git a/doc/images/precise_wall.png b/doc/images/precise_wall.png
deleted file mode 100644
index e8f237a591..0000000000
Binary files a/doc/images/precise_wall.png and /dev/null differ
diff --git a/doc/images/printer-preset.png b/doc/images/printer-preset.png
index d4d73718a1..fc0d567c94 100644
Binary files a/doc/images/printer-preset.png and b/doc/images/printer-preset.png differ
diff --git a/doc/images/process-preset.png b/doc/images/process-preset.png
index 2a2fc53db3..02f8f3a7fd 100644
Binary files a/doc/images/process-preset.png and b/doc/images/process-preset.png differ
diff --git a/doc/images/retraction_test.gif b/doc/images/retraction/retraction_test.gif
similarity index 100%
rename from doc/images/retraction_test.gif
rename to doc/images/retraction/retraction_test.gif
diff --git a/doc/images/retraction/retraction_test_menu.png b/doc/images/retraction/retraction_test_menu.png
new file mode 100644
index 0000000000..dd2940de72
Binary files /dev/null and b/doc/images/retraction/retraction_test_menu.png differ
diff --git a/doc/images/retraction/retraction_test_print.jpg b/doc/images/retraction/retraction_test_print.jpg
new file mode 100644
index 0000000000..716496f483
Binary files /dev/null and b/doc/images/retraction/retraction_test_print.jpg differ
diff --git a/doc/images/retraction_test_dlg.png b/doc/images/retraction_test_dlg.png
deleted file mode 100644
index 85dcfdd2c1..0000000000
Binary files a/doc/images/retraction_test_dlg.png and /dev/null differ
diff --git a/doc/images/retraction_test_print.jpg b/doc/images/retraction_test_print.jpg
deleted file mode 100644
index b60eff8c91..0000000000
Binary files a/doc/images/retraction_test_print.jpg and /dev/null differ
diff --git a/doc/images/seam/seam-aligned.png b/doc/images/seam/seam-aligned.png
new file mode 100644
index 0000000000..824950f2dd
Binary files /dev/null and b/doc/images/seam/seam-aligned.png differ
diff --git a/doc/images/seam/seam-back.png b/doc/images/seam/seam-back.png
new file mode 100644
index 0000000000..7ff54e0551
Binary files /dev/null and b/doc/images/seam/seam-back.png differ
diff --git a/doc/images/seam/seam-gap.png b/doc/images/seam/seam-gap.png
new file mode 100644
index 0000000000..fcd8a631bf
Binary files /dev/null and b/doc/images/seam/seam-gap.png differ
diff --git a/doc/images/seam/seam-nearest.png b/doc/images/seam/seam-nearest.png
new file mode 100644
index 0000000000..7691edc5c4
Binary files /dev/null and b/doc/images/seam/seam-nearest.png differ
diff --git a/doc/images/seam/seam-quality.jpg b/doc/images/seam/seam-quality.jpg
new file mode 100644
index 0000000000..2e3d76195c
Binary files /dev/null and b/doc/images/seam/seam-quality.jpg differ
diff --git a/doc/images/seam/seam-random.png b/doc/images/seam/seam-random.png
new file mode 100644
index 0000000000..daba4a2c72
Binary files /dev/null and b/doc/images/seam/seam-random.png differ
diff --git a/doc/images/seam/seam-wipe-on-loop.png b/doc/images/seam/seam-wipe-on-loop.png
new file mode 100644
index 0000000000..6b10c051fb
Binary files /dev/null and b/doc/images/seam/seam-wipe-on-loop.png differ
diff --git a/doc/images/seam/seam-wipe-on-loops-options.png b/doc/images/seam/seam-wipe-on-loops-options.png
new file mode 100644
index 0000000000..3d6c900025
Binary files /dev/null and b/doc/images/seam/seam-wipe-on-loops-options.png differ
diff --git a/doc/images/slicing_call_heirarchy.svg b/doc/images/slicing_call_heirarchy.svg
deleted file mode 100644
index 2a2ffbf847..0000000000
--- a/doc/images/slicing_call_heirarchy.svg
+++ /dev/null
@@ -1,4 +0,0 @@
-
-
-
-
\ No newline at end of file
diff --git a/doc/images/tab-popup.png b/doc/images/tab-popup.png
index e31f47dc88..8a6f032887 100644
Binary files a/doc/images/tab-popup.png and b/doc/images/tab-popup.png differ
diff --git a/doc/images/tolerance_hole.jpg b/doc/images/tolerance_hole.jpg
deleted file mode 100644
index 041e271984..0000000000
Binary files a/doc/images/tolerance_hole.jpg and /dev/null differ
diff --git a/doc/pellet-flow-coefficient.md b/doc/pellet-flow-coefficient.md
index 8e91312ad6..a3be0bda40 100644
--- a/doc/pellet-flow-coefficient.md
+++ b/doc/pellet-flow-coefficient.md
@@ -1,3 +1,5 @@
+# Pellet Flow Coefficient
+
Large format printers with print volumes in the order of 1m^3 generally use pellets for printing.
The overall tech is very similar to FDM printing.
It is FDM printing, but instead of filaments, it uses pellets.
@@ -15,7 +17,9 @@ for your own pellets for a particular printer model.
We are translating the pellet_flow_coefficient into filament_diameter so that everything works just like it
does already with very minor adjustments.
-filament_diameter = sqrt( (4 \* pellet_flow_coefficient) / PI )
+```math
+\text{filament\_diameter} = \sqrt{\frac{4 \times \text{pellet\_flow\_coefficient}}{\pi}}
+```
sqrt just makes the relationship between flow_coefficient and volume linear.
diff --git a/doc/precise-z-height.md b/doc/precise-z-height.md
index d7905e8baf..fa862bf922 100644
--- a/doc/precise-z-height.md
+++ b/doc/precise-z-height.md
@@ -1,6 +1,15 @@
+# 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.
+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**
+
+ 
+
+- **Precise Z Height On**
+
+ 
diff --git a/doc/print_settings/calibration/Calibration.md b/doc/print_settings/calibration/Calibration.md
new file mode 100644
index 0000000000..5c4e6820cd
--- /dev/null
+++ b/doc/print_settings/calibration/Calibration.md
@@ -0,0 +1,65 @@
+# Calibration Guide
+
+This guide offers a structured and comprehensive overview of the calibration process for Orca Slicer.
+
+It covers key aspects such as flow rate, pressure advance, temperature towers, retraction tests, and advanced calibration techniques. Each section includes step-by-step instructions and visuals to help you better understand and carry out each calibration effectively.
+
+To access the calibration features, you can find them in the **Calibration** section of the Orca Slicer interface.
+
+
+
+> [!IMPORTANT]
+> After completing the calibration process, remember to create a new project in order to exit the calibration mode.
+
+The recommended order for calibration is as follows:
+
+1. **[Temperature](temp-calib):** Start by calibrating the temperature of the nozzle and the bed. This is crucial as it affects the viscosity of the filament, which in turn influences how well it flows through the nozzle and adheres to the print bed.
+
+ 
+
+2. **[Flow](flow-rate-calib):** Calibrate the flow rate to ensure that the correct amount of filament is being extruded. This is important for achieving accurate dimensions and good layer adhesion.
+
+ 
+
+1. **[Pressure Advance](pressure-advance-calib):** Calibrate the pressure advance settings to improve print quality and reduce artifacts caused by pressure fluctuations in the nozzle.
+
+ - **[Adaptative Pressure Advance](adaptive-pressure-advance-calib):** This is an advanced calibration technique that can be used to further optimize the pressure advance settings for different print speeds and geometries.
+
+ 
+
+2. **[Retraction](retraction-calib):** Calibrate the retraction settings to minimize stringing and improve print quality. Doing this after Flow and
+
+ 
+
+3. **[Tolerance](tolerance-calib):** Calibrate the tolerances of your printer to ensure that it can accurately reproduce the dimensions of the model being printed. This is important for achieving a good fit between parts and for ensuring that the final print meets the desired specifications.
+
+ 
+
+4. **[Max Volumetric Speed](volumetric-speed-calib):** Calibrate the maximum volumetric speed of the filament. This is important for ensuring that the printer can handle the flow rate of the filament without causing issues such as under-extrusion or over-extrusion.
+
+ 
+
+5. **[Cornering](cornering-calib):** Calibrate the Jerk/Junction Deviation settings to improve print quality and reduce artifacts caused by sharp corners and changes in direction.
+
+ 
+
+6. **[Input Shaping](input-shaping-calib):** This is an advanced calibration technique that can be used to reduce ringing and improve print quality by compensating for mechanical vibrations in the printer.
+
+ 
+
+### VFA
+
+Vertical Fine Artifacts (VFA) are small artifacts that can occur on the surface of a 3D print, particularly in areas where there are sharp corners or changes in direction. These artifacts can be caused by a variety of factors, including mechanical vibrations, resonance, and other factors that can affect the quality of the print.
+Because of the nature of these artifacts the methods to reduce them can be mechanical such as changing motors, belts and pulleys or with advanced calibrations such as Jerk/[Junction Deviation](junction-deviation) corrections or [Input Shaping](input-shaping).
+
+---
+
+_Credits:_
+
+- _The Flowrate test and retraction test is inspired by [SuperSlicer](https://github.com/supermerill/SuperSlicer)._
+- _The PA Line method is inspired by [K-factor Calibration Pattern](https://marlinfw.org/tools/lin_advance/k-factor.html)._
+- _The PA Tower method is inspired by [Klipper](https://www.klipper3d.org/Pressure_Advance.html)._
+- _The temp tower model is remixed from [Smart compact temperature calibration tower](https://www.thingiverse.com/thing:2729076)._
+- _The max flowrate test was inspired by Stefan (CNC Kitchen), and the model used in the test is a remix of his [Extrusion Test Structure](https://www.printables.com/model/342075-extrusion-test-structure)._
+- _ZV Input Shaping is inspired by [Marlin Input Shaping](https://marlinfw.org/docs/features/input_shaping.html) and [Ringing Tower 3D STL](https://marlinfw.org/assets/stl/ringing_tower.stl)._
+- _ChatGPT_ ;)
diff --git a/doc/adaptive-pressure-advance.md b/doc/print_settings/calibration/adaptive-pressure-advance-calib.md
similarity index 76%
rename from doc/adaptive-pressure-advance.md
rename to doc/print_settings/calibration/adaptive-pressure-advance-calib.md
index 6a589d6f1c..aa5add89e1 100644
--- a/doc/adaptive-pressure-advance.md
+++ b/doc/print_settings/calibration/adaptive-pressure-advance-calib.md
@@ -13,12 +13,11 @@ This feature introduces the below options under the filament settings:
4. **Adaptive pressure advance measurements:** This field contains the calibration values used to generate the pressure advance profile for the nozzle/printer. Input sets of pressure advance (PA) values and the corresponding volumetric flow speeds and accelerations they were measured at, separated by a comma. Add one set of values per line. More information on how to calibrate the model follows in the sections below.
5. **Pressure advance:** The old field is still needed and is required to be populated with a PA value. A “good enough” median PA value should be entered here, as this will act as a fallback value when performing tool changes, printing a purge/wipe tower for multi-color prints as well as a fallback in case the model fails to identify an appropriate value (unlikely but it’s the ultimate backstop).
-