Deploying to gh-pages from @ 5e3daa6 🚀

Bed_Mesh.html

@@ -712,6 +712,13 @@
     Faulty Regions
   </a>
 
+</li>
+
+          <li class="md-nav__item">
+  <a href="#adaptive-meshes" class="md-nav__link">
+    Adaptive Meshes
+  </a>
+
 </li>
 
       </ul>
@@ -1534,6 +1541,13 @@
     Faulty Regions
   </a>
 
+</li>
+
+          <li class="md-nav__item">
+  <a href="#adaptive-meshes" class="md-nav__link">
+    Adaptive Meshes
+  </a>
+
 </li>
 
       </ul>
@@ -1968,12 +1982,59 @@ <h3 id="faulty-regions">Faulty Regions<a class="headerlink" href="#faulty-region
 in the sample config above.  The replacement points and their coordinates
 are identified in green.</p>
 <p><img alt="bedmesh_interpolated" src="img/bedmesh_faulty_regions.svg" /></p>
+<h3 id="adaptive-meshes">Adaptive Meshes<a class="headerlink" href="#adaptive-meshes" title="Permanent link">&para;</a></h3>
+<p>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.</p>
+<p>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
+scaled down based on the ratio of the default mesh area and the adapted mesh area. To
+illustrate this consider the following example:</p>
+<p>For a 150mmx150mm bed with <code>mesh_min</code> set to <code>25,25</code> and <code>mesh_max</code> set to <code>125,125</code>,
+the default mesh area is a 100mmx100mm square. An adapted mesh area of <code>50,50</code>
+means a ratio of <code>0.5x0.5</code> between the adapted area and default mesh area.</p>
+<p>If the <code>bed_mesh</code> configuration specified <code>probe_count</code> as <code>7x7</code>, the adapted bed
+mesh will use 4x4 probe points (7 * 0.5 rounded up).</p>
+<p><img alt="adaptive_bedmesh" src="img/adaptive_bed_mesh.svg" /></p>
+<div class="highlight"><pre><span></span><code>[bed_mesh]
+speed: 120
+horizontal_move_z: 5
+mesh_min: 35, 6
+mesh_max: 240, 198
+probe_count: 5, 3
+adaptive_margin: 5
+</code></pre></div>
+
+<ul>
+<li>
+<p><code>adaptive_margin</code> <br>
+  <em>Default Value: 0</em> <br>
+  Margin (in mm) to add around the area of the bed used by the defined objects. The diagram
+  below shows the adapted bed mesh area with an <code>adaptive_margin</code> of 5mm. The adapted mesh
+  area (area in green) is computed as the used bed area (area in blue) plus the defined margin.</p>
+<p><img alt="adaptive_bedmesh_margin" src="img/adaptive_bed_mesh_margin.svg" /></p>
+</li>
+</ul>
+<p>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
+is that a new mesh will be generated for each print if adaptive meshing is used.</p>
+<p>It is also 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 <strong>outside</strong> 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.</p>
 <h2 id="bed-mesh-gcodes">Bed Mesh Gcodes<a class="headerlink" href="#bed-mesh-gcodes" title="Permanent link">&para;</a></h2>
 <h3 id="calibration">Calibration<a class="headerlink" href="#calibration" title="Permanent link">&para;</a></h3>
 <p><code>BED_MESH_CALIBRATE PROFILE=&lt;name&gt; METHOD=[manual | automatic] [&lt;probe_parameter&gt;=&lt;value&gt;]
- [&lt;mesh_parameter&gt;=&lt;value&gt;]</code><br>
+ [&lt;mesh_parameter&gt;=&lt;value&gt;] [ADAPTIVE=[0|1] [ADAPTIVE_MARGIN=&lt;value&gt;]</code><br>
 <em>Default Profile:  default</em><br>
-<em>Default Method:  automatic if a probe is detected, otherwise manual</em></p>
+<em>Default Method:  automatic if a probe is detected, otherwise manual</em> <br>
+<em>Default Adaptive: 0</em> <br>
+<em>Default Adaptive Margin: 0</em></p>
 <p>Initiates the probing procedure for Bed Mesh Calibration.</p>
 <p>The mesh will be saved into a profile specified by the <code>PROFILE</code> parameter,
 or <code>default</code> if unspecified. If <code>METHOD=manual</code> is selected then manual probing
@@ -1996,6 +2057,8 @@ <h3 id="calibration">Calibration<a class="headerlink" href="#calibration" title=
 </li>
 <li>All beds:<ul>
 <li><code>ALGORITHM</code></li>
+<li><code>ADAPTIVE</code></li>
+<li><code>ADAPTIVE_MARGIN</code></li>
 </ul>
 </li>
 </ul>

Config_Reference.html

@@ -4618,6 +4618,9 @@ <h3 id="bed_mesh">[bed_mesh]<a class="headerlink" href="#bed_mesh" title="Perman
 #   Optional points that define a faulty region.  See docs/Bed_Mesh.md
 #   for details on faulty regions.  Up to 99 faulty regions may be added.
 #   By default no faulty regions are set.
+#adaptive_margin:
+#   An optional margin (in mm) to be added around the bed area used by
+#   the defined print objects when generating an adaptive mesh.
 </code></pre></div>
 
 <h3 id="bed_tilt">[bed_tilt]<a class="headerlink" href="#bed_tilt" title="Permanent link">&para;</a></h3>