test OpenCV pre 4.9.0

.github/workflows/linux-x86_64.yml

@@ -70,8 +70,8 @@ jobs:
       - uses: actions/checkout@v3
       - name: Install system dependencies
         run: |
-          apk add cmake make python3 bash curl unzip gcc g++ ncurses-dev openssl-dev linux-headers perl git dpkg
-          curl -fSL "https://repo.uwucocoa.moe/pool/main/erlang_${OTP_VERSION}_musl-linux-amd64.deb" -o "erlang_${OTP_VERSION}_musl-linux-amd64.deb"
+          apk add cmake make python3 bash curl unzip gcc g++ ncurses-dev openssl-dev linux-headers perl git dpkg ca-certificates
+          curl -fSL -k "https://repo.uwucocoa.moe/pool/main/erlang_${OTP_VERSION}_musl-linux-amd64.deb" -o "erlang_${OTP_VERSION}_musl-linux-amd64.deb"
           dpkg -i "erlang_${OTP_VERSION}_musl-linux-amd64.deb"
 
       - name: Install elixir

Makefile

@@ -22,7 +22,7 @@ ifneq ($(OPENCV_USE_GIT_HEAD), false)
 	OPENCV_VER=$(OPENCV_USE_GIT_BRANCH)
 endif
 OPENCV_CONTRIB_USE_GIT_HEAD ?= false
-OPENCV_GIT_REPO ?= "https://github.com/opencv/opencv_contrib.git"
+OPENCV_CONTRIB_GIT_REPO ?= "https://github.com/opencv/opencv_contrib.git"
 OPENCV_CONTRIB_VER ?= 4.8.0
 ifneq ($(OPENCV_CONTRIB_USE_GIT_HEAD), false)
 	OPENCV_CONTRIB_VER=$(OPENCV_CONTRIB_USE_GIT_BRANCH)

README.md

@@ -659,6 +659,98 @@ config :evision, enabled_img_codecs: [
     export OPENCV_GIT_REPO="https://github.com/username/opencv.git"
     ```
 
+- How do I test for a new pre-release of OpenCV?
+
+    Suppose that OpenCV has a new pre-release (usually a new tagged version), 4.9.0, then you need
+    to do the following to test and maybe also add/change some lines so that the new version is
+    usable.
+
+    First of all, disable using precompiled binaries.
+
+    ```shell
+    export EVISION_PREFER_PRECOMPILED=false
+    ```
+
+    Then set to use source code from GitHub.
+
+    ```shell
+    export OPENCV_USE_GIT_HEAD=true
+    export OPENCV_USE_GIT_BRANCH=4.9.0
+
+    export OPENCV_CONTRIB_USE_GIT_HEAD=true
+    export OPENCV_CONTRIB_USE_GIT_BRANCH=4.9.0
+    ```
+
+    After that, we can try to build it. Usually, this is likely to fail without any changes to the source code
+    in the evision library. I'll mention possible fixes for that in a minute.
+
+    ```shell
+    rm -rf _build/test/lib/evision
+    export MIX_ENV=test
+    iex -S mix
+    ```
+
+- Troubleshooting pre-release versions of OpenCV
+
+    1. unknown type name 'XXXXXXXX_Params'
+
+        When you see error messages like:
+
+        ```
+        In file included from /home/runner/evision/c_src/evision.cpp:2373:
+        /home/runner/evision/c_src/evision_generated_funcs.h:3685:5: error: unknown type name 'TrackerVit_Params'
+            TrackerVit_Params parameters=TrackerVit::Params();
+        ```
+
+        That usually means we need to copy some headers from OpenCV's source code for compatibilties. You can find
+        them in 
+
+        ```
+        3rd_party/opencv/opencv-${OPENCV_VER}/modules/${MODULE_NAME}/misc/python/
+        ```
+
+        where `${OPENCV_VER}` is the version name and `${MODULE_NAME}` is the corresponding module of that `XXXXX_Params`. 
+        To find the corresponding module of `XXXXX_Params`, one good way is to search the OpenCV source code. In this example, `TrackerVit` is in the `video` module:
+
+        ```shell
+        $ cd 3rd_party/opencv/opencv-4.9.0/modules/
+        $ rg --no-ignore 'TrackerVit::Params'
+        video/src/tracking/tracker_vit.cpp
+        24:TrackerVit::Params::Params()
+        43:    TrackerVitImpl(const TrackerVit::Params& parameters)
+        60:    TrackerVit::Params params;
+        210:Ptr<TrackerVit> TrackerVit::create(const TrackerVit::Params& parameters)
+        216:Ptr<TrackerVit> TrackerVit::create(const TrackerVit::Params& parameters)
+
+        video/include/opencv2/video/tracking.hpp
+        914:    @param parameters vit tracker parameters TrackerVit::Params
+        917:    Ptr<TrackerVit> create(const TrackerVit::Params& parameters = TrackerVit::Params());
+
+        video/test/test_trackers.cpp
+        166:    cv::TrackerVit::Params params;
+        ```
+
+        However, as the time of writing, OpenCV's official source didn't add `TrackerVit::Params` to 
+
+        ```shell
+        3rd_party/opencv/opencv-4.9.0/modules/video/misc/python/pyopencv_video.hpp
+        ```
+
+        So we can either say this pre-release version is not ready for evision, or we can simply add
+        some lines in evision's codebase to fix it. For this particular issue, we can edit this file:
+
+        ```
+        c_src/evision_custom_headers/evision_video.hpp
+        ```
+
+        and add the following lines to it.
+
+        ```shell
+        #if (CV_VERSION_MAJOR >= 4 && CV_VERSION_MINOR >= 9)
+        typedef TrackerVit::Params TrackerVit_Params;
+        #endif
+        ```
+
 - How do I set the number of jobs for compiling?
 
     ```shell

c_src/evision_custom_headers/evision_video.hpp

@@ -7,4 +7,8 @@ typedef TrackerDaSiamRPN::Params TrackerDaSiamRPN_Params;
 typedef TrackerNano::Params TrackerNano_Params;
 #endif
 
+#if (CV_VERSION_MAJOR >= 4 && CV_VERSION_MINOR >= 9)
+typedef TrackerVit::Params TrackerVit_Params;
+#endif
+
 #endif

py_src/func_variant.py

@@ -564,7 +564,7 @@ def generate_spec_elixir(self, module_func_name: str, is_instance_method: bool,
                 _, struct_name = is_struct(self.spec_self, also_get='struct_name', classname=self.classname)
                 self.spec_self = f'{struct_name}.t()'
             else:
-                print(f'warning: {self.spec_self} should be a struct. classname={self.classname}')
+                print(f'warning: {self.spec_self} should be a struct. classname={self.classname}. possible fix: change function is_struct accordingly in helper.py.')
                 self.spec_self = f'Evision.{self.spec_self}.t()'
             in_args_spec.insert(0, self.spec_self)
 

py_src/helper.py

@@ -839,6 +839,8 @@ def is_struct(argtype: str, also_get: Optional[str] = None, classname: Optional[
         "mcc_CChecker": "Evision.MCC.CCheckerDetector",
         "dnn_Net": "Evision.DNN.Net",
 
+        "TrackerVit": "Evision.TrackerVit",
+
         "BinaryDescriptor": "Evision.LineDescriptor.BinaryDescriptor",
         "KeyLine": "Evision.LineDescriptor.BinaryDescriptor.KeyLine",
         "BinaryDescriptorMatcher": "Evision.LineDescriptor.BinaryDescriptorMatcher",
@@ -1202,6 +1204,8 @@ def map_argtype_in_spec_erlang(classname: str, argtype: str, is_in: bool, decl:
         return '#evision_ocl_device{}'
     elif argtype == 'Index' and classname == 'flann_Index':
          return '#evision_flann_index{}'
+    elif argtype == 'TrackerVit':
+        return '#evision_tracker_vit'
     elif argtype == 'QRCodeDetectorAruco':
         return '#evision_qrcode_detector_aruco{}'
     elif argtype == 'QRCodeDetectorAruco_Params':
@@ -1302,6 +1306,8 @@ def map_argtype_in_spec_elixir(classname: str, argtype: str, is_in: bool, decl:
         return 'Evision.OCL.Device.t()'
     elif argtype == 'Index' and classname == 'flann_Index':
          return 'Evision.Flann.Index.t()'
+    elif argtype == 'TrackerVit':
+        return 'Evision.TrackerVit'
     elif argtype == 'QRCodeDetectorAruco':
         return 'Evision.QRCodeDetectorAruco'
     elif argtype in ['QRCodeDetectorAruco_Params', 'QRCodeDetectorAruco::Params']: