This is the OpenCV Java API, repackaged into an AAR that you can add as a Gradle dependency to your Android Studio project. This is exactly the same thing that is in the /sdk/java
folder of the OpenCV Android bundle.
To avoid the pain of having to download the OpenCV Android bundle, extract the Java library, and import it as a module in Android Studio. This bloats your git repository and makes it a pain to upgrade to a newer OpenCV version. However, that's not even the biggest benefit of using this library! To decrease the final APK size (and thus decreasing deployment time to your robot each time you make a code change), this library loads the C++ library required by OpenCV (more than 10MB!) dynamically from the internal storage instead of shipping it inside the APK.
Unfortunately, due to a known bug with OpenCV 4.x, OpenCV-Repackaged is only compatible with devices that run Andorid 5.0 or higher. For FTC, this means that it is incompatible with the ZTE Speed. OpenCV-Repackaged will work fine on all other FTC-legal devices (including the new Control Hub).
-
Open your FTC SDK Android Studio project
-
Open the
build.common.gradle
file: -
Add
jcenter()
to therepositories
block at the bottom: -
Open the
build.gradle
file for the TeamCode module: -
At the bottom, add this:
dependencies { implementation 'org.openftc:opencv-repackaged:4.1.0-C' }
-
Copy
libOpenCvNative.so
from the/doc
folder of this repo into theFIRST
folder on the USB storage of the Robot Controller (i.e. connect the Robot Controller to your computer with a USB cable, put it into MTP mode, and drag 'n drop the file). -
You can now use OpenCV just as you would as if you had manually imported the module, with one minor difference being you do not need to call any methods such as
OpenCVLoader.initDebug()
because the native library is automatically loaded in the background when the SDK boots.
- Specifically handle error case of failure to load 32-bit library when FTC Robot Controller app has already loaded another native library as 64-bit
- Drastically improve error handling when loading native library
- Initial release, based on OpenCV Android SDK v4.1.0