feat: find contours with hierarchy

Author: lukaszkurantdev

cpp/FOCV_Function.cpp

@@ -1396,6 +1396,21 @@ jsi::Object FOCV_Function::invoke(jsi::Runtime& runtime, const jsi::Value* argum
           cv::findContours(*src, *dst, mode, method);
         }
       } break;
+      case hashString("findContoursWithHierarchy", 25): {
+        auto src = args.asMatPtr(1);
+        auto hierarchy = args.asMatPtr(3);
+        auto mode = args.asNumber(4);
+        auto method = args.asNumber(5);
+        
+        if (args.isMatVector(2)) {
+          auto dst = args.asMatVectorPtr(2);
+          cv::findContours(*src, *dst, *hierarchy, mode, method);
+        } else {
+          auto dst = args.asPointVectorOfVectorsPtr(2);
+          cv::findContours(*src, *dst, *hierarchy, mode, method);
+        }
+        
+      } break;
       case hashString("fitLine", 7): {
         auto points = args.asMatPtr(1);
         auto line = args.asMatPtr(2);

docs/pages/availablefunctions.md

@@ -2364,6 +2364,27 @@ invoke(
 ): void;
 ```
 
+### findContoursWithHierarchy
+
+Finds contours in a binary image
+
+- image Source, an 8-bit single-channel image. Non-zero pixels are treated as 1s. Zero pixels remain 0s, so the image is treated as binary . You can use compare, inRange, threshold , adaptiveThreshold, Canny, and others to create a binary image out of a grayscale or color one. If mode equals to RETR_CCOMP or RETR_FLOODFILL, the input can also be a 32-bit integer image of labels (CV_32SC1).
+- contours Detected contours. Each contour is stored as a vector of points
+- hierarchy output vector, containing information about the image topology. It has as many elements as the number of contours.
+- mode Contour retrieval mode, @see RetrievalModes
+- method Contour approximation method, @see ContourApproximationModes
+
+```js
+invoke(
+  name: 'findContoursWithHierarchy',
+  image: Mat,
+  contours: MatVector | PointVectorOfVectors,
+  hierarchy: Mat,
+  mode: RetrievalModes,
+  method: ContourApproximationModes
+): void;
+```
+
 ### fitLine
 
 Fits a line to a 2D or 3D point set.

src/functions/ImageProcessing/Shape.ts

@@ -123,6 +123,23 @@ export type Shape = {
     method: ContourApproximationModes
   ): void;
 
+  /**
+   * Finds contours in a binary image
+   * @param image Source, an 8-bit single-channel image. Non-zero pixels are treated as 1's. Zero pixels remain 0's, so the image is treated as binary . You can use compare, inRange, threshold , adaptiveThreshold, Canny, and others to create a binary image out of a grayscale or color one. If mode equals to RETR_CCOMP or RETR_FLOODFILL, the input can also be a 32-bit integer image of labels (CV_32SC1).
+   * @param contours Detected contours. Each contour is stored as a vector of points
+   * @param hierarchy output vector, containing information about the image topology. It has as many elements as the number of contours.
+   * @param mode Contour retrieval mode, @see RetrievalModes
+   * @param method Contour approximation method, @see ContourApproximationModes
+   */
+  invoke(
+    name: 'findContoursWithHierarchy',
+    image: Mat,
+    contours: MatVector | PointVectorOfVectors,
+    hierarchy: Mat,
+    mode: RetrievalModes,
+    method: ContourApproximationModes
+  ): void;
+
   /**
    * Fits a line to a 2D or 3D point set.
    * @param points Input vector of 2D or 3D points, stored in a Mat.