Customizable depth unit

cmake/Depthai/DepthaiDeviceSideConfig.cmake

@@ -2,7 +2,7 @@
 set(DEPTHAI_DEVICE_SIDE_MATURITY "snapshot")
 
 # "full commit hash of device side binary"
-set(DEPTHAI_DEVICE_SIDE_COMMIT "b3bbd4d5a9a8108b654e6e63e0beb21520c2beca")
+set(DEPTHAI_DEVICE_SIDE_COMMIT "df5e50e79532ddaa879a6ccf2928fbbe27adeef7")
 
 # "version if applicable"
 set(DEPTHAI_DEVICE_SIDE_VERSION "")

include/depthai/pipeline/datatype/StereoDepthConfig.hpp

@@ -95,6 +95,18 @@ class StereoDepthConfig : public Buffer {
      */
     StereoDepthConfig& setSubpixel(bool enable);
 
+    /**
+     * Set depth unit of depth map.
+     *
+     * Meter, centimeter, millimeter, inch, foot or custom unit is available.
+     */
+    StereoDepthConfig& setDepthUnit(AlgorithmControl::DepthUnit depthUnit);
+
+    /**
+     * Get depth unit of depth map.
+     */
+    AlgorithmControl::DepthUnit getDepthUnit();
+
     /**
      * Useful for normalization of the disparity map.
      * @returns Maximum disparity value that the node can return

include/depthai/pipeline/node/SpatialDetectionNetwork.hpp

@@ -78,13 +78,13 @@ class SpatialDetectionNetwork : public NodeCRTP<DetectionNetwork, SpatialDetecti
     void setBoundingBoxScaleFactor(float scaleFactor);
 
     /**
-     * Specifies lower threshold in millimeters for depth values which will used to calculate spatial data
+     * Specifies lower threshold in depth units (millimeter by default) for depth values which will used to calculate spatial data
      * @param lowerThreshold LowerThreshold must be in the interval [0,upperThreshold] and less than upperThreshold.
      */
     void setDepthLowerThreshold(uint32_t lowerThreshold);
 
     /**
-     * Specifies upper threshold in millimeters for depth values which will used to calculate spatial data
+     * Specifies upper threshold in depth units (millimeter by default) for depth values which will used to calculate spatial data
      * @param upperThreshold UpperThreshold must be in the interval (lowerThreshold,65535].
      */
     void setDepthUpperThreshold(uint32_t upperThreshold);

include/depthai/pipeline/node/StereoDepth.hpp

@@ -58,7 +58,7 @@ class StereoDepth : public NodeCRTP<Node, StereoDepth, StereoDepthProperties> {
     Input right{*this, "right", Input::Type::SReceiver, false, 8, true, {{DatatypeEnum::ImgFrame, true}}};
 
     /**
-     * Outputs ImgFrame message that carries RAW16 encoded (0..65535) depth data in millimeters.
+     * Outputs ImgFrame message that carries RAW16 encoded (0..65535) depth data in depth units (millimeter by default).
      *
      * Non-determined / invalid depth values are set to 0
      */

src/pipeline/datatype/StereoDepthConfig.cpp

@@ -66,6 +66,15 @@ StereoDepthConfig& StereoDepthConfig::setSubpixel(bool enable) {
     return *this;
 }
 
+StereoDepthConfig& StereoDepthConfig::setDepthUnit(AlgorithmControl::DepthUnit depthUnit) {
+    cfg.algorithmControl.depthUnit = depthUnit;
+    return *this;
+}
+
+dai::StereoDepthConfig::AlgorithmControl::DepthUnit StereoDepthConfig::getDepthUnit() {
+    return cfg.algorithmControl.depthUnit;
+}
+
 float StereoDepthConfig::getMaxDisparity() const {
     float maxDisp = 95.0;
     if(cfg.costMatching.disparityWidth == RawStereoDepthConfig::CostMatching::DisparityWidth::DISPARITY_64) {