feat: crop function

Author: lukaszkurantdev

cpp/FOCV_Function.cpp

@@ -276,6 +276,13 @@ jsi::Object FOCV_Function::invoke(jsi::Runtime& runtime, const jsi::Value* argum
           value.setProperty(runtime, "value", result);
         }
       } break;
+      case hashString("crop", 4): {
+        auto src = args.asMatPtr(1);
+        auto dst = args.asMatPtr(2);
+        auto rect = args.asRectPtr(3);
+        
+        (*src)(*rect).copyTo(*dst);
+      } break;
       case hashString("dct", 3): {
         auto src = args.asMatPtr(1);
         auto dst = args.asMatPtr(2);

docs/pages/availablefunctions.md

@@ -347,6 +347,18 @@ Counts non-zero array elements.
 invoke(name: 'countNonZero', src: MatVector | Mat): { value: number };
 ```
 
+### crop
+
+This functions allows to crop Mat to selected size using Rect.
+
+- src Source matrix
+- dst Destination matrix
+- roi Rectangle as ROI
+
+```js
+invoke(name: 'crop', src: Mat, dst: Mat, roi: Rect): void;
+```
+
 ### dct
 
 Performs a forward or inverse discrete Cosine transform of 1D or 2D array.

src/functions/Core.ts

@@ -16,6 +16,7 @@ import type {
   MatVector,
   Point,
   PointVector,
+  Rect,
   Scalar,
 } from '../objects/Objects';
 
@@ -297,6 +298,15 @@ export type Core = {
    */
   invoke(name: 'countNonZero', src: MatVector | Mat): { value: number };
 
+  /**
+   * This functions allows to crop Mat to selected size using Rect.
+   * @param name Function name.
+   * @param src Source matrix
+   * @param dst Destination matrix. If it does not have a proper size or type before the operation, it is reallocated
+   * @param roi Rectangle as ROI
+   */
+  invoke(name: 'crop', src: Mat, dst: Mat, roi: Rect): void;
+
   /**
    * Performs a forward or inverse discrete Cosine transform of 1D or 2D array.
    * @param name Function name.