adds validation for nozzle offsets

Author: Mitchwich

docs/misc/auto-toolchanger/index.md

@@ -16,7 +16,7 @@ If your job requires more than three nozzle tips, by default OpenPnP will pause
 
 1. Insert the labeled nozzle tips into the holder in their respectively labeled slots.
 
-2. Apply some lubricant to the end of your nozzle holder with the lubrication packet included with your nozzles. This is important for repeatably fully attaching the nozzles without damaging the rubber O-rings around the holder.
+1. Apply some lubricant to the end of your nozzle holder with the lubrication packet included with your nozzles. This is important for repeatably fully attaching the nozzles without damaging the rubber O-rings around the holder.
   ![Apply Lubricant to holder](images/apply-super-lube.webp)
 
 1. Click on the `Machine Setup` tab in the top right pane.

docs/misc/calibration/2-connect-to-machine/index.md

@@ -223,7 +223,7 @@ Before calibration, the bottom camera and exposure must be set up properly. **We
      ![Selecting the correct device for the Bottom Camera](../../../openpnp/v4/calibration/2-connect-to-machine/images/21-choose-lumenpnp-bottom-from-dropdown.webp)<br/><br/>
 
     !!! info "Duplicate Camera Names"
-        If two cameras appear with the same name, select one—if incorrect, choose the other. This is a bug within OpenPnP.
+        If two cameras appear with the same name, select one. If incorrect, choose the other. This is a bug within OpenPnP.
 <br/><br/>
 
 1. **Set Resolution and Frame Rate**
@@ -279,14 +279,14 @@ Before calibration, the bottom camera and exposure must be set up properly. **We
       ![Make the jog controls more precise](../../../openpnp/v4/calibration/2-connect-to-machine/images/distance-slider-machine-controls.webp)<br/><br/>
     * Right click on the bottom camera's feed and select `Show Image Info?` to enable the image info card. This will give you the brightness histogram of the image.<br/><br/>
      ![enable the image histogram](../../../openpnp/v4/calibration/2-connect-to-machine/images/31-show-histograph-gif.gif)<br/><br/>
-    * Use the histogram as a general guide rather than a precise measurement—it’s a helpful tool but not exact. For the best results, refer to the comparison photos below, which show examples of 'too bright,' 'too dark,' and 'good exposure' to help you fine-tune your settings after using the histogram.
+    * Use the histogram as a general guide rather than a precise measurement. It’s a helpful tool but not exact. For the best results, refer to the comparison photos below, which show examples of 'too bright,' 'too dark,' and 'good exposure' to help you fine-tune your settings after using the histogram.
     * In the next step, we'll be aiming for a **sharp peak on the right side** and a larger **cluster to the left** in the histogram. See the image below for reference.<br/><br/>
      ![a good histogram](../../../openpnp/v4/calibration/2-connect-to-machine/images/32-good-exposure-with-histogram.webp)<br/><br/>
     !!! Warning "🚨 Important 🚨"
-        The reference image above is just an example—**your histogram may look very different** depending on lighting conditions, camera placement, and other environmental factors. **Do not try to match it exactly.** Instead, focus on achieving the key characteristics: a distinct peak on the right and a noticeable cluster, or peak, to the left. Adjust gradually until the image is clear and well-exposed.
+        The reference image above is just an example. **Your histogram may look very different** depending on lighting conditions, camera placement, and other environmental factors. **Do not try to match it exactly.** Instead, focus on achieving the key characteristics: a distinct peak on the right and a noticeable cluster, or peak, to the left. Adjust gradually until the image is clear and well-exposed.
 
 1. **Set the Correct Exposure**.
-    * Adjust the exposure slider, or enter varying manual exposure values, to ensure the camera can clearly detect the dark hole in the nozzle tip for calibration. The exposure should be balanced—bright enough to distinguish the nozzle tip from the background but not so bright that the hole becomes difficult to detect. Aim for a setting where the brightest areas are visible but do not appear completely white, and the darker areas remain well-defined. Use the following images as a reference for adjusting exposure:<br/><br/>
+    * Adjust the exposure slider, or enter varying manual exposure values, to ensure the camera can clearly detect the dark hole in the nozzle tip for calibration. The exposure should be balanced. Meaning, sbright enough to distinguish the nozzle tip from the background but not so bright that the hole becomes difficult to detect. Aim for a setting where the brightest areas are visible but do not appear completely white, and the darker areas remain well-defined. Use the following images as a reference for adjusting exposure:<br/><br/>
      ![exposure too high](../../../openpnp/v4/calibration/2-connect-to-machine/images/33-exposure-too-high.webp)<br/><br/>
      ![exposure too low](../../../openpnp/v4/calibration/2-connect-to-machine/images/34-exposure-too-low.webp)<br/><br/>
      ![exposure correct](../../../openpnp/v4/calibration/2-connect-to-machine/images/35-good-exposure.webp)<br/><br/>

docs/misc/calibration/4-homing-fiducial/index.md

@@ -146,15 +146,15 @@ We also detail this process in our [setup video](https://youtu.be/h3mtEQfGMlM?t=
 <br/><br/>
 
 1. Right click on the top camera's feed and select `Show Image Info?` to enable the image info card. This will give you the brightness histogram of the image.
-    * Use the histogram as a general guide rather than a precise measurement—it’s a helpful tool but not exact. For the best results, refer to the comparison photos below, which show examples of 'too bright,' 'too dark,' and 'good exposure' to help you fine-tune your settings after using the histogram.<br/><br/>
+    * Use the histogram as a general guide rather than a precise measurement. It’s a helpful tool but not exact. For the best results, refer to the comparison photos below, which show examples of 'too bright,' 'too dark,' and 'good exposure' to help you fine-tune your settings after using the histogram.<br/><br/>
       ![enable the image histogram](../../../openpnp/v4/calibration/4-homing-fiducial/images/24-show-histogram-for-top-cam.webp)
 <br/><br/>
 
 1. Adjust the Top Camera exposure using the slider or entering an exposure value.
     * 🚨 **Keep all other camera settings at their default value, and only adjust the exposure slider**.
     * Aim for a **sharp peak on the right side** and a larger **cluster to the left** in the histogram. See the image below for reference.<br/><br/>
     !!! Warning "🚨 Important 🚨"
-        The reference image below is just an example—**your histogram may look very different** depending on lighting conditions, camera placement, and other environmental factors. **Do not try to match it exactly.** Instead, focus on achieving the key characteristics: a distinct peak on the right and a noticeable cluster to the left. Adjust gradually until the image is clear and well-exposed.<br/><br/>
+        The reference image below is just an example. **Your histogram may look very different** depending on lighting conditions, camera placement, and other environmental factors. **Do not try to match it exactly.** Instead, focus on achieving the key characteristics: a distinct peak on the right and a noticeable cluster to the left. Adjust gradually until the image is clear and well-exposed.<br/><br/>
         ![a good histogram](../../../openpnp/v4/calibration/4-homing-fiducial/images/25-good-histogram.webp)<br/><br/>
     * Locate and adjust the `Exposure` slider, or manually enter varying exposure values, until the Datum Board is easy to see.<br/><br/>
        ![exposure too high](../../../openpnp/v4/calibration/4-homing-fiducial/images/26-exposure-too-high.webp)<br/><br/>

docs/openpnp/v4/calibration/2-connect-to-machine/index.md

@@ -123,7 +123,7 @@ Follow these steps in order:
 1. **Level the nozzles before homing**.
 
     !!! danger "🚨 Critical Warning: Level Nozzles Before Homing 🚨"
-        **Before pressing the homing button**—now and every time in the future—**you must ensure that your nozzles are level**.<br/><br/>
+        **Before pressing the homing button**-now and every time in the future-**you must ensure that your nozzles are level**.<br/><br/>
         ⚠️ **Failure to do this can cause crashes and potentially damage your machine.**<br/><br/>
         OpenPnP **does not** remember the previous nozzle positions from the last homing sequence, meaning it **cannot adjust movements based on past alignment**. If the nozzles are not level before homing, they may collide with the machine, leading to misalignment or serious hardware damage.
          ![level nozzles](images/level-nozzles-gif.gif)
@@ -210,7 +210,7 @@ Before calibration, the bottom camera and exposure must be set up properly. **We
      ![Selecting the correct device for the Bottom Camera](images/21-choose-lumenpnp-bottom-from-dropdown.webp)<br/><br/>
 
     !!! info "Duplicate Camera Names"
-        If two cameras appear with the same name, select one—if incorrect, choose the other. This is a bug within OpenPnP.
+        If two cameras appear with the same name, select one. If incorrect, choose the other. This is a bug within OpenPnP.
 <br/><br/>
 
 1. **Set Resolution and Frame Rate**
@@ -259,14 +259,14 @@ Before calibration, the bottom camera and exposure must be set up properly. **We
      ![Align over center of bottom camera](images/30-align-over-center-of-bottom-camera-gif.gif)<br/><br/>
     * Right click on the bottom camera's feed and select `Show Image Info?` to enable the image info card. This will give you the brightness histogram of the image.<br/><br/>
      ![enable the image histogram](images/31-show-histograph-gif.gif)<br/><br/>
-    * Use the histogram as a general guide rather than a precise measurement—it’s a helpful tool but not exact. For the best results, refer to the comparison photos below, which show examples of 'too bright,' 'too dark,' and 'good exposure' to help you fine-tune your settings after using the histogram.
+    * Use the histogram as a general guide rather than a precise measurement. It’s a helpful tool but not exact. For the best results, refer to the comparison photos below, which show examples of 'too bright,' 'too dark,' and 'good exposure' to help you fine-tune your settings after using the histogram.
     * In the next step, we'll be aiming for a **sharp peak on the right side** and a larger **cluster to the left** in the histogram. See the image below for reference.<br/><br/>
      ![a good histogram](images/32-good-exposure-with-histogram.webp)<br/><br/>
     !!! Warning "🚨 Important 🚨"
-        The reference image above is just an example—**your histogram may look very different** depending on lighting conditions, camera placement, and other environmental factors. **Do not try to match it exactly.** Instead, focus on achieving the key characteristics: a distinct peak on the right and a noticeable cluster, or peak, to the left. Adjust gradually until the image is clear and well-exposed.
+        The reference image above is just an example. **Your histogram may look very different** depending on lighting conditions, camera placement, and other environmental factors. **Do not try to match it exactly.** Instead, focus on achieving the key characteristics: a distinct peak on the right and a noticeable cluster, or peak, to the left. Adjust gradually until the image is clear and well-exposed.
 
 1. **Set the Correct Exposure**.
-    * Adjust the exposure slider, or enter varying manual exposure values, to ensure the camera can clearly detect the dark hole in the nozzle tip for calibration. The exposure should be balanced—bright enough to distinguish the nozzle tip from the background but not so bright that the hole becomes difficult to detect. Aim for a setting where the brightest areas are visible but do not appear completely white, and the darker areas remain well-defined. Use the following images as a reference for adjusting exposure:<br/><br/>
+    * Adjust the exposure slider, or enter varying manual exposure values, to ensure the camera can clearly detect the dark hole in the nozzle tip for calibration. The exposure should be balanced. Meaning, bright enough to distinguish the nozzle tip from the background but not so bright that the hole becomes difficult to detect. Aim for a setting where the brightest areas are visible but do not appear completely white, and the darker areas remain well-defined. Use the following images as a reference for adjusting exposure:<br/><br/>
      ![exposure too high](images/33-exposure-too-high.webp)<br/><br/>
      ![exposure too low](images/34-exposure-too-low.webp)<br/><br/>
      ![exposure correct](images/35-good-exposure.webp)<br/><br/>

docs/openpnp/v4/calibration/4-homing-fiducial/index.md

@@ -146,15 +146,15 @@ We also detail this process in our [setup video](https://youtu.be/h3mtEQfGMlM?t=
 <br/><br/>
 
 1. Right click on the top camera's feed and select `Show Image Info?` to enable the image info card. This will give you the brightness histogram of the image.
-    * Use the histogram as a general guide rather than a precise measurement—it’s a helpful tool but not exact. For the best results, refer to the comparison photos below, which show examples of 'too bright,' 'too dark,' and 'good exposure' to help you fine-tune your settings after using the histogram.<br/><br/>
+    * Use the histogram as a general guide rather than a precise measurement. It’s a helpful tool but not exact. For the best results, refer to the comparison photos below, which show examples of 'too bright,' 'too dark,' and 'good exposure' to help you fine-tune your settings after using the histogram.<br/><br/>
       ![enable the image histogram](images/24-show-histogram-for-top-cam.webp)
 <br/><br/>
 
 1. Adjust the Top Camera exposure using the slider or entering an exposure value.
     * 🚨 **Keep all other camera settings at their default value, and only adjust the exposure slider**.
     * Aim for a **sharp peak on the right side** and a larger **cluster to the left** in the histogram. See the image below for reference.<br/><br/>
     !!! Warning "🚨 Important 🚨"
-        The reference image below is just an example—**your histogram may look very different** depending on lighting conditions, camera placement, and other environmental factors. **Do not try to match it exactly.** Instead, focus on achieving the key characteristics: a distinct peak on the right and a noticeable cluster to the left. Adjust gradually until the image is clear and well-exposed.<br/><br/>
+        The reference image below is just an example. **Your histogram may look very different** depending on lighting conditions, camera placement, and other environmental factors. **Do not try to match it exactly.** Instead, focus on achieving the key characteristics: a distinct peak on the right and a noticeable cluster to the left. Adjust gradually until the image is clear and well-exposed.<br/><br/>
         ![a good histogram](images/25-good-histogram.webp)<br/><br/>
     * Locate and adjust the `Exposure` slider, or manually enter varying exposure values, until the Datum Board is easy to see.<br/><br/>
        ![exposure too high](images/26-exposure-too-high.webp)<br/><br/>