Development on the project stopped in 2024

Java (11+) bindings to OpenCV library

Currently supported platforms:

• MacOS (Silicon)
• Windows (x64)
• Linux x64 (Debian 12, Ubuntu 22.04 tested)

The compiled libraries are deployed to Maven Central.

Usage with maven:

<dependency>
    <groupId>io.github.kamilszewc</groupId>
    <artifactId>opencv</artifactId>
    <version>4.7.0-2</version>
</dependency>

Usage with gradle:

implementation 'io.github.kamilszewc:opencv:4.7.0-2'

Before using the library, you need to call io.github.kamilszewc.opencv.OpenCV.loadLibrary() static function. Alternatively, you can simply call any other function from OpenCV library. The reason is that, during that stage, the operating system and cpu architectures are detected and the right native dynamic libraries of OpenCV are loaded.

Image reading example:

import com.computinglaboratory.opencv.OpenCV;
import org.opencv.core.Mat;
import org.opencv.imgcodecs.Imgcodecs;

public class ImageLoader {

    static {
        try {
            OpenCV.loadLibrary();
        } catch (SystemNotSupportedException | IOException e) {
            throw new RuntimeException(e);
        }
    }
    
    ImageLoader(String filename) {
        Mat mat = Imgcodecs.imread(filename);
    }
}