Find file History

JavaCPP Presets for OpenCV


This directory contains the JavaCPP Presets module for:

Please refer to the parent file for more detailed information about the JavaCPP Presets.


Java API documentation is available here:

Sample Usage

Here is a simple example of OpenCV ported to Java from this C++ source file:

We can use Maven 3 to download and install automatically all the class files as well as the native binaries. To run this sample code, after creating the pom.xml and src/main/java/ source files below, simply execute on the command line:

 $ mvn compile exec:java -Dexec.args="img1 img2 [...imgN]"

The pom.xml build file


The src/main/java/ source file

// By downloading, copying, installing or using the software you agree to this license.
// If you do not agree to this license, do not download, install,
// copy or use the software.
// License Agreement
// For Open Source Computer Vision Library
// Copyright (C) 2000-2008, Intel Corporation, all rights reserved.
// Copyright (C) 2009, Willow Garage Inc., all rights reserved.
// Third party copyrights are property of their respective owners.
// Redistribution and use in source and binary forms, with or without modification,
// are permitted provided that the following conditions are met:
// * Redistribution's of source code must retain the above copyright notice,
// this list of conditions and the following disclaimer.
// * Redistribution's in binary form must reproduce the above copyright notice,
// this list of conditions and the following disclaimer in the documentation
// and/or other materials provided with the distribution.
// * The name of the copyright holders may not be used to endorse or promote products
// derived from this software without specific prior written permission.
// This software is provided by the copyright holders and contributors "as is" and
// any express or implied warranties, including, but not limited to, the implied
// warranties of merchantability and fitness for a particular purpose are disclaimed.
// In no event shall the Intel Corporation or contributors be liable for any direct,
// indirect, incidental, special, exemplary, or consequential damages
// (including, but not limited to, procurement of substitute goods or services;
// loss of use, data, or profits; or business interruption) however caused
// and on any theory of liability, whether in contract, strict liability,
// or tort (including negligence or otherwise) arising in any way out of
// the use of this software, even if advised of the possibility of such damage.

import org.bytedeco.javacpp.*;
import static org.bytedeco.javacpp.opencv_core.*;
import static org.bytedeco.javacpp.opencv_imgcodecs.*;
import static org.bytedeco.javacpp.opencv_stitching.*;

public class Stitching {
    static boolean try_use_gpu = false;
    static MatVector imgs = new MatVector();
    static String result_name = "result.jpg";

    public static void main(String[] args) {
        int retval = parseCmdArgs(args);
        if (retval != 0) {

        Mat pano = new Mat();
        Stitcher stitcher = Stitcher.createDefault(try_use_gpu);
        int status = stitcher.stitch(imgs, pano);

        if (status != Stitcher.OK) {
            System.out.println("Can't stitch images, error code = " + status);

        imwrite(result_name, pano);

    static void printUsage() {
            "Rotation model images stitcher.\n\n"
          + "stitching img1 img2 [...imgN]\n\n"
          + "Flags:\n"
          + "  --try_use_gpu (yes|no)\n"
          + "      Try to use GPU. The default value is 'no'. All default values\n"
          + "      are for CPU mode.\n"
          + "  --output <result_img>\n"
          + "      The default is 'result.jpg'.");

    static int parseCmdArgs(String[] args) {
        if (args.length == 0) {
            return -1;
        for (int i = 0; i < args.length; i++) {
            if (args[i].equals("--help") || args.equals("/?")) {
                return -1;
            } else if (args[i].equals("--try_use_gpu")) {
                if (args[i + 1].equals("no")) {
                    try_use_gpu = false;
                } else if (args[i + 1].equals("yes")) {
                    try_use_gpu = true;
                } else {
                    System.out.println("Bad --try_use_gpu flag value");
                    return -1;
            } else if (args[i].equals("--output")) {
                result_name = args[i + 1];
            } else {
                Mat img = imread(args[i]);
                if (img.empty()) {
                    System.out.println("Can't read image '" + args[i] + "'");
                    return -1;
                imgs.resize(imgs.size() + 1);
                imgs.put(imgs.size() - 1, img);
        return 0;