feat: add Sobel function

Author: martinbooth

cpp/FOCV_Function.cpp

@@ -1151,6 +1151,19 @@ jsi::Object FOCV_Function::invoke(jsi::Runtime& runtime, const jsi::Value* argum
 
         cv::integral(*src, *dst);
       } break;
+      case hashString("Sobel", 5): {
+        auto src = args.asMatPtr(1);
+        auto dst = args.asMatPtr(2);
+        auto ddepth = args.asNumber(3);
+        auto dx = args.asNumber(4);
+        auto dy = args.asNumber(5);
+        auto ksize = args.asNumber(6);
+        auto scale = args.asNumber(7);
+        auto delta = args.asNumber(8);
+        auto borderType = args.asNumber(9);
+
+        cv::Sobel(*src, *dst, ddepth, dx, dy, ksize, scale, delta, borderType);
+      } break;
       case hashString("threshold", 9): {
         auto src = args.asMatPtr(1);
         auto dst = args.asMatPtr(2);

docs/pages/availablefunctions.md

@@ -1940,6 +1940,36 @@ Calculates the integral of an image
 invoke(name: 'integral', src: Mat, sum: Mat): void;
 ```
 
+### Sobel
+
+Calculates the first, second, third, or mixed image derivatives using an extended Sobel operator.
+
+- name Function name.
+- src input image.
+- dst output image of the same size and the same number of channels as src .
+- ddepth output image depth, see combinations; in the case of 8-bit input images it will result in truncated derivatives.
+- dx order of the derivative x.
+- dy order of the derivative y.
+- ksize size of the extended Sobel kernel; it must be 1, 3, 5, or 7.
+- scale scale factor for the computed derivative values; by default, no scaling is applied (see getDerivKernels for details).
+- delta delta value that is added to the results prior to storing them in dst.
+- borderType Pixel extrapolation method, see BorderTypes. BORDER_WRAP is not supported.
+
+```js
+invoke(
+  name: 'Sobel',
+  src: Mat,
+  dst: Mat,
+  ddepth: number,
+  dx: number,
+  dy: number,
+  ksize: 1 | 3 | 5 | 7,
+  scale: number,
+  delta: number,
+  borderType: Exclude<BorderTypes, BorderTypes.BORDER_WRAP>
+): void;
+```
+
 ### threshold
 Applies a fixed-level threshold to each array element
 - name Function name.

src/functions/ImageProcessing/ImageFiltering.ts

@@ -267,4 +267,30 @@ export type ImageFiltering = {
     borderType: BorderTypes,
     borderValue: Scalar
   ): void;
+
+  /**
+   * Calculates the first, second, third, or mixed image derivatives using an extended Sobel operator.
+   * @param name Function name.
+   * @param src input image.
+   * @param dst output image of the same size and the same number of channels as src .
+   * @param ddepth output image depth, see combinations; in the case of 8-bit input images it will result in truncated derivatives.
+   * @param dx order of the derivative x.
+   * @param dy order of the derivative y.
+   * @param ksize size of the extended Sobel kernel; it must be 1, 3, 5, or 7.
+   * @param scale scale factor for the computed derivative values; by default, no scaling is applied (see getDerivKernels for details).
+   * @param delta delta value that is added to the results prior to storing them in dst.
+   * @param borderType Pixel extrapolation method, see BorderTypes. BORDER_WRAP is not supported.
+   */
+  invoke(
+    name: 'Sobel',
+    src: Mat,
+    dst: Mat,
+    ddepth: number,
+    dx: number,
+    dy: number,
+    ksize: 1 | 3 | 5 | 7,
+    scale: number,
+    delta: number,
+    borderType: Exclude<BorderTypes, BorderTypes.BORDER_WRAP>
+  ): void;
 };