Merge d9f3151be8 into 54c7b65d5d

docs/Bed_Mesh.md

@@ -344,14 +344,19 @@ are identified in green.
 
 ### Adaptive Meshes
 
-Adaptive bed meshing is a way to speed up the bed mesh generation by only probing
-the area of the bed used by the objects being printed. When used, the method will
-automatically adjust the mesh parameters based on the area occupied by the defined
-print objects.
+#### Concept:
+
+Adaptive bed meshing is a way to speed up the bed meshing process as well as waste less mesh information by only probing
+the area of the bed that will be used for printing. When used, this method will
+automatically adjust the mesh parameters based on the area occupied by objects defined by the `EXCLUDE_OBJECT` command. See the [exclude objects guide](Exclude_Object.md) and
+[command reference](G-Codes.md#excludeobject)
+for additional information.
+
+#### How it works:
 
 The adapted mesh area will be computed from the area defined by the boundaries of all
 the defined print objects so it covers every object, including any margins defined in
-the configuration. After the area is computed, the number of probe points will be
+the [configuration](Config_Reference.md#bed_mesh). After the area is computed, the number of probe points will be
 scaled down based on the ratio of the default mesh area and the adapted mesh area. To
 illustrate this consider the following example:
 
@@ -382,17 +387,34 @@ adaptive_margin: 5
 
   ![adaptive_bedmesh_margin](img/adaptive_bed_mesh_margin.svg)
 
-By nature, adaptive bed meshes use the objects defined by the Gcode file being printed.
-Therefore, it is expected that each Gcode file will generate a mesh that probes a different
-area of the print bed. Therefore, adapted bed meshes should not be re-used. The expectation
+#### Caveats:
+
+By nature, adaptive bed meshes use the objects defined by the [exclude_object](Exclude_Object.md) module
+in the Gcode file being printed, and it is expected that each Gcode file will generate a mesh that probes a different
+area of the print bed. Therefore, adapted bed meshes should **not** be re-used. The expectation
 is that a new mesh will be generated for each print if adaptive meshing is used.
 
-It is also important to consider that adaptive bed meshing is best used on machines that can
+It is important to consider that adaptive bed meshing is best used on machines that can
 normally probe the entire bed and achieve a maximum variance less than or equal to 1 layer
 height. Machines with mechanical issues that a full bed mesh normally compensates for may
-have undesirable results when attempting print moves **outside** of the probed area. If a
-full bed mesh has a variance greater than 1 layer height, caution must be taken when using
-adaptive bed meshes and attempting print moves outside of the meshed area.
+have undesirable results when attempting print moves **outside** of the probed area. If you
+normally have a variance greater than 1 layer height when generating a full bed mesh, greater caution
+must be taken when attempting print moves outside of the adapted mesh area.
+
+If there are no objects defined by the [exclude_object](Exclude_Object.md) module before the adaptive
+bed mesh is requested, the default method will be used instead. If you are requesting an adaptive bed mesh and
+the default method is still being used, check that you have [exclude_object](Exclude_Object.md) set up correctly, and
+that the objects are being defined before the adaptive bed mesh command is executed in your Gcode file.
+
+#### How to use Adaptive Meshes:
+
+- You must have the [exclude_object](Exclude_Object.md) module enabled by adding `[exclude_object]` to your `printer.cfg` file.
+- You must enable object labeling in your slicer.
+  - Certain slicers may do this by default, or do not provide an option because it is an "always-on" feature.
+  - More modern slicers provide a "Firmware-Specific" option for labeling objects. If you enable this, you'll need to verify that your slicer supports the `klipper` gcode flavor, and is generating `EXCLUDE_OBJECT_DEFINE` commands at the beginning of the sliced gcode file.
+- If your slicer does not support firmware-specific object labeling, or does not support the `klipper` gcode flavor, you will need to [configure Moonraker's file manager module](https://moonraker.readthedocs.io/en/latest/configuration/#file_manager) to enable object processing.
+- Finally, to generate an adaptive bed mesh, you must append the `ADAPTIVE=1` flag to `BED_MESH_CALIBRATE` wherever you normally call for a bed mesh to be generated.
+  - The command should be `BED_MESH_CALIBRATE ADAPTIVE=1` wherever you normally request it.
 
 ## Surface Scans