Enhance README and CMakeLists for OpenCV module customization (#355)

* Enhance README and CMakeLists for OpenCV module customization

- Added documentation on customizing OpenCV modules via `opencv_config.cmake` in both `opencv_core` and `opencv_dart` READMEs.
- Updated `CMakeLists.txt` in both packages to include user-defined configurations if `opencv_config.cmake` exists, falling back to default settings otherwise.

* Refactor OpenCV module customization to use pubspec.yaml

- Updated README files for both `opencv_core` and `opencv_dart` to reflect the new method of customizing OpenCV modules via the `pubspec.yaml` file instead of `opencv_config.cmake`.
- Introduced a Dart script to generate `dartcv_modules.cmake` based on the specified modules in `pubspec.yaml`.
- Modified `CMakeLists.txt` in both packages to include the generated `dartcv_modules.cmake`, ensuring proper module configuration during the build process.

* added default fallback incase target-platform is not set, and upgraded gradle versions

* Update Android Gradle plugin and Gradle wrapper versions

- Upgraded Android Gradle plugin from version 8.1.0 to 8.10.0.
- Updated Gradle wrapper distribution from version 8.5 to 8.11.1.

* add gen_cmake_vars.dart for dartcv4, make CMakeLists.txt run the script to get module configurations

* dart format ✅

* fix cmakelists.txt

* fix windows

* dart format ✅

* fix linux

* bump dartcv4 to 1.1.4, fix android

* update readme and changelog

---------

Co-authored-by: rainyl <[email protected]>
Co-authored-by: rainyl <[email protected]>

Author: abdelaziz-mahdy

packages/dartcv/CHANGELOG.md

@@ -4,6 +4,7 @@
 * add `MatType.elemSize` `MatType.elemSize1`
 * remove deprecated `(double x, double y, double z).asPoint3f`
   `(double x, double y).asPoint2f` `(int x, int y).asPoint` `VecPoint.toVecVecPoint`
+* add `bin/gen_cmake_vars.dart` for generating optional module vars for CMake
 
 ## 1.1.3
 

packages/dartcv/bin/gen_cmake_vars.dart

@@ -0,0 +1,89 @@
+// ignore_for_file: avoid_dynamic_calls, avoid_print
+
+import 'dart:io';
+
+import 'package:yaml/yaml.dart';
+
+const defaultModuleSettings = {
+  // "core": "ON", // not configurable
+  "calib3d": "ON",
+  "contrib": "ON",
+  "dnn": "ON",
+  "features2d": "ON",
+  "flann": "ON",
+  // "gapi", // disabled
+  "highgui": "OFF",
+  "imgproc": "ON",
+  "imgcodecs": "ON",
+  "objdetect": "ON",
+  "photo": "ON",
+  "stitching": "ON",
+  "video": "ON",
+  "videoio": "ON",
+};
+
+void main(List<String> args) {
+  final pubspecPath = Platform.script.resolve("../../../../pubspec.yaml");
+  final excludeModules = parseUserDefinedExcludeModules(pubspecPath.toFilePath());
+
+  final cmakeVars = StringBuffer("###DARTCV_GEN_CMAKE_VAR_BEGIN###\n");
+  for (final k in excludeModules.entries) {
+    cmakeVars.write("${k.key.toUpperCase()}=${k.value.toUpperCase()}\n");
+  }
+  cmakeVars.write("###DARTCV_GEN_CMAKE_VAR_END###");
+  print(cmakeVars);
+}
+
+/// Parse the user defined exclude modules from pubspec.yaml
+///
+/// Returns a list of excluded module names
+Map<String, String> parseUserDefinedExcludeModules(String pubspecPath, {bool excludeMode = true}) {
+  try {
+    print("Generating cmake vars from $pubspecPath");
+    // Read the pubspec.yaml file
+    final File file = File(pubspecPath);
+    if (!file.existsSync()) {
+      print("$pubspecPath not found");
+      return defaultModuleSettings;
+    }
+
+    // Parse the YAML content
+    final String yamlContent = file.readAsStringSync();
+    final dynamic yamlMap = loadYaml(yamlContent);
+
+    // Navigate to the hooks.user_defines.dartcv4.exclude_modules section
+    if (yamlMap is YamlMap &&
+        yamlMap['hooks'] is YamlMap &&
+        yamlMap['hooks']['user_defines'] is YamlMap &&
+        yamlMap['hooks']['user_defines']['dartcv4'] is YamlMap) {
+      final dartcvDefines = yamlMap['hooks']['user_defines']['dartcv4'] as YamlMap;
+
+      final excludeModules = dartcvDefines['exclude_modules'] as YamlList? ?? YamlList();
+      // include is priority over exclude
+      final includeModules = dartcvDefines['include_modules'] as YamlList? ?? YamlList();
+
+      final include = includeModules
+          .map((dynamic module) => module.toString().toLowerCase())
+          .where((e) => defaultModuleSettings.containsKey(e))
+          .toList();
+      final exclude = excludeModules
+          .map((dynamic module) => module.toString().toLowerCase())
+          .where((e) => defaultModuleSettings.containsKey(e) && !include.contains(e))
+          .toList();
+
+      final result = {
+        for (final e in defaultModuleSettings.keys)
+          e: exclude.contains(e) ? "OFF" : defaultModuleSettings[e]!,
+      };
+
+      return result;
+    }
+
+    print("parse error");
+    return defaultModuleSettings;
+  } catch (e) {
+    // Return empty list in case of any error
+    print('Error parsing exclude_modules: $e');
+    return defaultModuleSettings;
+  }
+}

packages/dartcv/lib/src/calib3d/fisheye.dart

@@ -107,25 +107,24 @@ class Fisheye {
     distorted ??= Mat.empty();
 
     cvRun(
-      () =>
-          Kundistorted == null
-              ? ccalib3d.cv_fisheye_distortPoints(
-                undistorted.ref,
-                distorted!.ref,
-                K.ref,
-                D.ref,
-                alpha,
-                ffi.nullptr,
-              )
-              : ccalib3d.cv_fisheye_distortPoints_1(
-                undistorted.ref,
-                distorted!.ref,
-                Kundistorted.ref,
-                K.ref,
-                D.ref,
-                alpha,
-                ffi.nullptr,
-              ),
+      () => Kundistorted == null
+          ? ccalib3d.cv_fisheye_distortPoints(
+              undistorted.ref,
+              distorted!.ref,
+              K.ref,
+              D.ref,
+              alpha,
+              ffi.nullptr,
+            )
+          : ccalib3d.cv_fisheye_distortPoints_1(
+              undistorted.ref,
+              distorted!.ref,
+              Kundistorted.ref,
+              K.ref,
+              D.ref,
+              alpha,
+              ffi.nullptr,
+            ),
     );
     return distorted;
   }
@@ -142,25 +141,17 @@ class Fisheye {
     distorted ??= Mat.empty();
 
     return cvRunAsync0(
-      (callback) =>
-          Kundistorted == null
-              ? ccalib3d.cv_fisheye_distortPoints(
-                undistorted.ref,
-                distorted!.ref,
-                K.ref,
-                D.ref,
-                alpha,
-                callback,
-              )
-              : ccalib3d.cv_fisheye_distortPoints_1(
-                undistorted.ref,
-                distorted!.ref,
-                Kundistorted.ref,
-                K.ref,
-                D.ref,
-                alpha,
-                callback,
-              ),
+      (callback) => Kundistorted == null
+          ? ccalib3d.cv_fisheye_distortPoints(undistorted.ref, distorted!.ref, K.ref, D.ref, alpha, callback)
+          : ccalib3d.cv_fisheye_distortPoints_1(
+              undistorted.ref,
+              distorted!.ref,
+              Kundistorted.ref,
+              K.ref,
+              D.ref,
+              alpha,
+              callback,
+            ),
       (c) => c.complete(distorted),
     );
   }

packages/dartcv/lib/src/calib3d/usac_params.dart

@@ -26,21 +26,20 @@ class UsacParams extends CvStruct<cvg.UsacParams> {
     int finalPolisher = NONE_POLISHER,
     int finalPolisherIterations = 0,
   }) {
-    final p =
-        calloc<cvg.UsacParams>()
-          ..ref.confidence = confidence
-          ..ref.isParallel = isParallel
-          ..ref.loIterations = loIterations
-          ..ref.loMethod = loMethod
-          ..ref.loSampleSize = loSampleSize
-          ..ref.maxIterations = maxIterations
-          ..ref.neighborsSearch = neighborsSearch
-          ..ref.randomGeneratorState = randomGeneratorState
-          ..ref.sampler = sampler
-          ..ref.score = score
-          ..ref.threshold = threshold
-          ..ref.final_polisher = finalPolisher
-          ..ref.final_polisher_iterations = finalPolisherIterations;
+    final p = calloc<cvg.UsacParams>()
+      ..ref.confidence = confidence
+      ..ref.isParallel = isParallel
+      ..ref.loIterations = loIterations
+      ..ref.loMethod = loMethod
+      ..ref.loSampleSize = loSampleSize
+      ..ref.maxIterations = maxIterations
+      ..ref.neighborsSearch = neighborsSearch
+      ..ref.randomGeneratorState = randomGeneratorState
+      ..ref.sampler = sampler
+      ..ref.score = score
+      ..ref.threshold = threshold
+      ..ref.final_polisher = finalPolisher
+      ..ref.final_polisher_iterations = finalPolisherIterations;
     return UsacParams.fromPointer(p);
   }
 

packages/dartcv/lib/src/contrib/ximgproc.dart

@@ -590,21 +590,20 @@ class EdgeDrawingParams extends CvStruct<cvg.EdgeDrawingParams> {
     double Sigma = 1.0,
     bool SumFlag = true,
   }) {
-    final p =
-        calloc<cvg.EdgeDrawingParams>()
-          ..ref.AnchorThresholdValue = AnchorThresholdValue
-          ..ref.EdgeDetectionOperator = EdgeDetectionOperator
-          ..ref.GradientThresholdValue = GradientThresholdValue
-          ..ref.LineFitErrorThreshold = LineFitErrorThreshold
-          ..ref.MaxDistanceBetweenTwoLines = MaxDistanceBetweenTwoLines
-          ..ref.MaxErrorThreshold = MaxErrorThreshold
-          ..ref.MinLineLength = MinLineLength
-          ..ref.MinPathLength = MinPathLength
-          ..ref.NFAValidation = NFAValidation
-          ..ref.PFmode = PFmode
-          ..ref.ScanInterval = ScanInterval
-          ..ref.Sigma = Sigma
-          ..ref.SumFlag = SumFlag;
+    final p = calloc<cvg.EdgeDrawingParams>()
+      ..ref.AnchorThresholdValue = AnchorThresholdValue
+      ..ref.EdgeDetectionOperator = EdgeDetectionOperator
+      ..ref.GradientThresholdValue = GradientThresholdValue
+      ..ref.LineFitErrorThreshold = LineFitErrorThreshold
+      ..ref.MaxDistanceBetweenTwoLines = MaxDistanceBetweenTwoLines
+      ..ref.MaxErrorThreshold = MaxErrorThreshold
+      ..ref.MinLineLength = MinLineLength
+      ..ref.MinPathLength = MinPathLength
+      ..ref.NFAValidation = NFAValidation
+      ..ref.PFmode = PFmode
+      ..ref.ScanInterval = ScanInterval
+      ..ref.Sigma = Sigma
+      ..ref.SumFlag = SumFlag;
     return EdgeDrawingParams.fromPointer(p);
   }
 

packages/dartcv/lib/src/core/core_async.dart

@@ -81,13 +81,13 @@ Future<Mat> bitwiseANDAsync(InputArray src1, InputArray src2, {OutputArray? dst,
   dst ??= Mat.empty();
   return mask == null
       ? cvRunAsync0((callback) => ccore.cv_bitwise_and(src1.ref, src2.ref, dst!.ref, callback), (c) {
-        return c.complete(dst);
-      })
+          return c.complete(dst);
+        })
       : cvRunAsync0((callback) => ccore.cv_bitwise_and_1(src1.ref, src2.ref, dst!.ref, mask.ref, callback), (
-        c,
-      ) {
-        return c.complete(dst);
-      });
+          c,
+        ) {
+          return c.complete(dst);
+        });
 }
 
 /// BitwiseNot inverts every bit of an array.
@@ -98,11 +98,11 @@ Future<Mat> bitwiseNOTAsync(InputArray src, {OutputArray? dst, InputArray? mask}
   dst ??= Mat.empty();
   return mask == null
       ? cvRunAsync0((callback) => ccore.cv_bitwise_not(src.ref, dst!.ref, callback), (c) {
-        return c.complete(dst);
-      })
+          return c.complete(dst);
+        })
       : cvRunAsync0((callback) => ccore.cv_bitwise_not_1(src.ref, dst!.ref, mask.ref, callback), (c) {
-        return c.complete(dst);
-      });
+          return c.complete(dst);
+        });
 }
 
 /// BitwiseOr calculates the per-element bit-wise disjunction of two arrays
@@ -114,13 +114,13 @@ Future<Mat> bitwiseORAsync(InputArray src1, InputArray src2, {OutputArray? dst,
   dst ??= Mat.empty();
   return mask == null
       ? cvRunAsync0((callback) => ccore.cv_bitwise_or(src1.ref, src2.ref, dst!.ref, callback), (c) {
-        return c.complete(dst);
-      })
+          return c.complete(dst);
+        })
       : cvRunAsync0((callback) => ccore.cv_bitwise_or_1(src1.ref, src2.ref, dst!.ref, mask.ref, callback), (
-        c,
-      ) {
-        return c.complete(dst);
-      });
+          c,
+        ) {
+          return c.complete(dst);
+        });
 }
 
 /// BitwiseXor calculates the per-element bit-wise "exclusive or" operation
@@ -132,13 +132,13 @@ Future<Mat> bitwiseXORAsync(InputArray src1, InputArray src2, {OutputArray? dst,
   dst ??= Mat.empty();
   return mask == null
       ? cvRunAsync0((callback) => ccore.cv_bitwise_xor(src1.ref, src2.ref, dst!.ref, callback), (c) {
-        return c.complete(dst);
-      })
+          return c.complete(dst);
+        })
       : cvRunAsync0((callback) => ccore.cv_bitwise_xor_1(src1.ref, src2.ref, dst!.ref, mask.ref, callback), (
-        c,
-      ) {
-        return c.complete(dst);
-      });
+          c,
+        ) {
+          return c.complete(dst);
+        });
 }
 
 /// BatchDistance is a naive nearest neighbor finder.
@@ -856,11 +856,11 @@ Future<(Scalar mean, Scalar stddev)> meanStdDevAsync(InputArray src, {InputArray
   final stddev = calloc<cvg.Scalar>();
   return mask == null
       ? cvRunAsync0((callback) => ccore.cv_meanStdDev(src.ref, mean, stddev, callback), (c) {
-        return c.complete((Scalar.fromPointer(mean), Scalar.fromPointer(stddev)));
-      })
+          return c.complete((Scalar.fromPointer(mean), Scalar.fromPointer(stddev)));
+        })
       : cvRunAsync0((callback) => ccore.cv_meanStdDev_1(src.ref, mean, stddev, mask.ref, callback), (c) {
-        return c.complete((Scalar.fromPointer(mean), Scalar.fromPointer(stddev)));
-      });
+          return c.complete((Scalar.fromPointer(mean), Scalar.fromPointer(stddev)));
+        });
 }
 
 /// Merge creates one multi-channel array out of several single-channel ones.