Merge pull request #23 from lukaszkurantdev/feat/floodfill-function

feat: floodfill function support

Author: lukaszkurantdev

cpp/FOCV_Function.cpp

@@ -356,6 +356,19 @@ jsi::Object FOCV_Function::invoke(jsi::Runtime& runtime, const jsi::Value* argum
 
         cv::flip(*src, *dst, flipCode);
       } break;
+      case hashString("floodFill", 9): {
+        auto src = args.asMatPtr(1);
+        auto mask = args.asMatPtr(2);
+        auto seedPoint = args.asPointPtr(3);
+        auto newVal = args.asScalarPtr(4);
+        auto rect = args.asRectPtr(5);
+        auto loDiff = args.asScalarPtr(6);
+        auto upDiff = args.asScalarPtr(7);
+        auto flags = args.asNumber(8);
+        
+        int area = floodFill(*src, *mask, *seedPoint, *newVal, &(*rect), *loDiff, *upDiff, flags);
+        value.setProperty(runtime, "value", area);
+      } break;
       case hashString("gemm", 4): {
         auto src1 = args.asMatPtr(1);
         auto src2 = args.asMatPtr(2);

docs/pages/availablefunctions.md

@@ -486,6 +486,33 @@ Flips a 2D array around vertical, horizontal, or both axes
 invoke(name: 'flip', src: Mat, dst: Mat, flipCode: number): void;
 ```
 
+### floodFill
+
+Fills a connected component with the given color. The function cv::floodFill fills a connected component starting from the seed point with the specified color. The connectivity is determined by the color/brightness closeness of the neighbor pixels. Use these functions to either mark a connected component with the specified color in-place, or build a mask and then extract the contour, or copy the region to another image, and so on.
+
+- image Input/output 1- or 3-channel, 8-bit, or floating-point image. It is modified by the function unless the #FLOODFILL_MASK_ONLY flag is set in the second variant of the function. See the details below.
+- mask Operation mask that should be a single-channel 8-bit image, 2 pixels wider and 2 pixels taller than image. Since this is both an input and output parameter, you must take responsibility of initializing it. Flood-filling cannot go across non-zero pixels in the input mask. For example, an edge detector output can be used as a mask to stop filling at edges. On output, pixels in the mask corresponding to filled pixels in the image are set to 1 or to the a value specified in flags as described below. Additionally, the function fills the border of the mask with ones to simplify internal processing. It is therefore possible to use the same mask in multiple calls to the function to make sure the filled areas do not overlap.
+- seedPoint Starting point.
+- newVal New value of the repainted domain pixels.
+- rect Optional output parameter set by the function to the minimum bounding rectangle of the repainted domain.
+- loDiff Maximal lower brightness/color difference between the currently observed pixel and one of its neighbors belonging to the component, or a seed pixel being added to the component.
+- upDiff Maximal upper brightness/color difference between the currently observed pixel and one of its neighbors belonging to the component, or a seed pixel being added to the component.
+- flags Operation flags. The first 8 bits contain a connectivity value. The default value of 4 means that only the four nearest neighbor pixels (those that share an edge) are considered. A connectivity value of 8 means that the eight nearest neighbor pixels (those that share a corner) will be considered. The next 8 bits (8-16) contain a value between 1 and 255 with which to fill the mask (the default value is 1). For example, 4 | ( 255 \<\< 8 ) will consider 4 nearest neighbours and fill the mask with a value of 255. The following additional options occupy higher bits and therefore may be further combined with the connectivity and mask fill values using bit-wise or (|), see #FloodFillFlags.
+
+```js
+invoke(
+  name: 'floodFill',
+  image: Mat,
+  mask: Mat,
+  seedPoint: Point,
+  newVal: Scalar,
+  rect: Rect,
+  loDiff: Scalar,
+  upDiff: Scalar,
+  flags: FloodFillFlags | number
+): { value: number };
+```
+
 ### gemm
 
 Performs generalized matrix multiplication

example/ios/Podfile.lock

@@ -936,7 +936,7 @@ PODS:
   - React-Mapbuffer (0.74.4):
     - glog
     - React-debug
-  - react-native-fast-opencv (0.2.7):
+  - react-native-fast-opencv (0.2.9):
     - DoubleConversion
     - glog
     - hermes-engine
@@ -1594,7 +1594,7 @@ SPEC CHECKSUMS:
   React-jsitracing: 4e9c99e73a6269b27b0d4cbab277dd90df3e5ac0
   React-logger: fbfb50e2a2b1b46ee087f0a52739fadecc5e81a4
   React-Mapbuffer: d39610dff659d8cf1fea485abae08bbf6f9c8279
-  react-native-fast-opencv: 8e853bb378f92221c4b47fe98fc9283aedcf95fb
+  react-native-fast-opencv: dd72ca1a7a247326ffd83daa46a9c17487c3948b
   react-native-image-picker: c3afe5472ef870d98a4b28415fc0b928161ee5f7
   react-native-safe-area-context: 851c62c48dce80ccaa5637b6aa5991a1bc36eca9
   react-native-skia: 8da84ea9410504bf27f0db229539a43f6caabb6a

src/functions/ImageProcessing/Misc.ts

@@ -2,9 +2,10 @@ import type {
   AdaptiveThresholdTypes,
   DistanceTransformMasks,
   DistanceTypes,
+  FloodFillFlags,
   ThresholdTypes,
 } from '../../constants/ImageProcessing';
-import type { Mat } from '../../objects/Objects';
+import type { Mat, Point, Rect, Scalar } from '../../objects/Objects';
 
 export type Misc = {
   /**
@@ -47,6 +48,31 @@ export type Misc = {
     maskSize: DistanceTransformMasks
   ): void;
 
+  /** @Fills a connected component with the given color.
+   * The function cv::floodFill fills a connected component starting from the seed point with the specified color. The connectivity is determined by the color/brightness closeness of the neighbor pixels.
+   * Use these functions to either mark a connected component with the specified color in-place, or build a mask and then extract the contour, or copy the region to another image, and so on.
+   * @param name Function name.
+   * @param image Input/output 1- or 3-channel, 8-bit, or floating-point image. It is modified by the function unless the #FLOODFILL_MASK_ONLY flag is set in the second variant of the function. See the details below.
+   * @param mask Operation mask that should be a single-channel 8-bit image, 2 pixels wider and 2 pixels taller than image. Since this is both an input and output parameter, you must take responsibility of initializing it. Flood-filling cannot go across non-zero pixels in the input mask. For example, an edge detector output can be used as a mask to stop filling at edges. On output, pixels in the mask corresponding to filled pixels in the image are set to 1 or to the a value specified in flags as described below. Additionally, the function fills the border of the mask with ones to simplify internal processing. It is therefore possible to use the same mask in multiple calls to the function to make sure the filled areas do not overlap.
+   * @param seedPoint Starting point.
+   * @param newVal New value of the repainted domain pixels.
+   * @param rect Optional output parameter set by the function to the minimum bounding rectangle of the repainted domain.
+   * @param loDiff Maximal lower brightness/color difference between the currently observed pixel and one of its neighbors belonging to the component, or a seed pixel being added to the component.
+   * @param upDiff Maximal upper brightness/color difference between the currently observed pixel and one of its neighbors belonging to the component, or a seed pixel being added to the component.
+   * @param flags Operation flags. The first 8 bits contain a connectivity value. The default value of 4 means that only the four nearest neighbor pixels (those that share an edge) are considered. A connectivity value of 8 means that the eight nearest neighbor pixels (those that share a corner) will be considered. The next 8 bits (8-16) contain a value between 1 and 255 with which to fill the mask (the default value is 1). For example, 4 | ( 255 \<\< 8 ) will consider 4 nearest neighbours and fill the mask with a value of 255. The following additional options occupy higher bits and therefore may be further combined with the connectivity and mask fill values using bit-wise or (|), see #FloodFillFlags.
+   **/
+  invoke(
+    name: 'floodFill',
+    image: Mat,
+    mask: Mat,
+    seedPoint: Point,
+    newVal: Scalar,
+    rect: Rect,
+    loDiff: Scalar,
+    upDiff: Scalar,
+    flags: FloodFillFlags | number
+  ): { value: number };
+
   /**
    * Calculates the integral of an image
    * @param name Function name.