Installing OpenCV for Java

Introduction to OpenCV for Java.

As of OpenCV 2.4.4, OpenCV supports desktop Java development. This tutorial will help you install OpenCV on your desktop SO.

Install the latest Java version.

Download the latest Java JDK at the Oracle link. Now you should be able to install the last Java JDK by open the file just downloaded.

Install the latest Eclispe version.

Download the latest Eclipse version at the Eclipse Download page choosing the Eclipse IDE for Java Developers version (suggested). Put the downloaded folder wherever you want to. You don’t need to install anything.

Install Open CV 2.4.6 under Windows.

First of all you should download the OpenCV library (version 2.4.6) from here. Once you get the folder opencv put in wherever you prefer. Now the only two things you will need are: the opencv-246.jar file located at \opencv\build\java and the dll library located at \opencv\build\java\x64 (for 64-bit systems) or \opencv\build\java\x86 (for 32-bit systems). If not present create a data folder under \opencv.

Install Open CV 2.4.6 under Linux or Mac.

The following instructions are useful if you wan to compile OpenCV under Windows. As first step, if you don’t have these already, download and install CMake and Apache Ant. Extract the downloaded OpenCV file in a location of your choice and open CMake ( cmake-gui ). Put the location of the extracted OpenCV library in the Where is the source code field (e.g., /opencv2.4.6.1/) and put the destination directory of your build in the Where to build the binaries field (e.g., /opencv2.4.6.1/build), at last, check the Grouped and Advanced checkboxes.


Now press Configure and use the default compilers for Unix Makefiles. In the Ungrouped Entries group, insert the path to the Apache Ant executable (e.g., /apacheant1.9.2/bin/ant). In the BUILD group, unselect: * BUILD_PERF_TESTS. * BUILD_SHARED_LIBRARY to make the Java bindings dynamic library all-sufficient. * BUILD_TESTS. * BUILD_opencv_python.

In the CMAKE group, set to Debug (or Release) the CMAKE_BUILD_TYPE In the JAVA group: insert the Java AWT include path (e.g., /usr/lib/jvm/java7oracle/include/) insert the Java include path (e.g., /usr/lib/jvm/java7oracle/include/) insert the alternative Java include path (e.g., /usr/lib/jvm/java7oracle/include/linux) Once we have pressed Generate twice the CMake window should appear with a white background. Now close CMake.


Now open the terminal , go to the build folder of OpenCV and build everything with the command: make -j8 (wait for the process to be completed...). If everything went well you should have opencv-246.jar and files in the /opencv- directory and the data folder in the /opencv- directory.

Set up OpenCV for Java in Eclipse

Open Eclipse and select a workspace of your choice. Create a User Library, ready to be used on all the next projects: go to Window > Preferences....


From the menu navigate under Java > Build Path > User Libraries and choose New.... Enter a name for the library (e.g., opencv246) and select the newly created user library. Choose Add External JARs..., browse to select opencv246.jar. After adding the jar, extend it and select Native library location and press Edit....


Select External Folder... and browse to select the folder containing the OpenCV libraries (e.g., C:\opencv\build\java\x64 under Windows).