diff --git a/doc/tutorials/definitions/tocDefinitions.rst b/doc/tutorials/definitions/tocDefinitions.rst index 3faef9dfb..ddd83f036 100644 --- a/doc/tutorials/definitions/tocDefinitions.rst +++ b/doc/tutorials/definitions/tocDefinitions.rst @@ -8,4 +8,4 @@ .. |Author_FernandoI| unicode:: Fernando U+0020 Iglesias U+0020 Garc U+00ED a .. |Author_EduardF| unicode:: Eduard U+0020 Feicho .. |Author_AlexB| unicode:: Alexandre U+0020 Benoit - +.. |Author_EricCh| unicode:: Eric U+0020 Christiansen diff --git a/doc/tutorials/introduction/desktop_java/images/ant_output.png b/doc/tutorials/introduction/desktop_java/images/ant_output.png new file mode 100644 index 000000000..a658fd785 Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/ant_output.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/cmake_output.png b/doc/tutorials/introduction/desktop_java/images/cmake_output.png new file mode 100644 index 000000000..bab140d6a Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/cmake_output.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_main_class.png b/doc/tutorials/introduction/desktop_java/images/eclipse_main_class.png new file mode 100644 index 000000000..84c152e6d Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_main_class.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_new_java_prj.png b/doc/tutorials/introduction/desktop_java/images/eclipse_new_java_prj.png new file mode 100644 index 000000000..34e03972e Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_new_java_prj.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_run.png b/doc/tutorials/introduction/desktop_java/images/eclipse_run.png new file mode 100644 index 000000000..2efc8e671 Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_run.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib.png b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib.png new file mode 100644 index 000000000..11694526a Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib2.png b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib2.png new file mode 100644 index 000000000..2b9ec5c3c Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib2.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib3.png b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib3.png new file mode 100644 index 000000000..4bf83ee03 Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib3.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib4.png b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib4.png new file mode 100644 index 000000000..c3f353155 Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib4.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib5.png b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib5.png new file mode 100644 index 000000000..ed79d92d4 Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib5.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib6.png b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib6.png new file mode 100644 index 000000000..3a98e38b1 Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib6.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib7.png b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib7.png new file mode 100644 index 000000000..019432016 Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib7.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib8.png b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib8.png new file mode 100644 index 000000000..5650aa79a Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/eclipse_user_lib8.png differ diff --git a/doc/tutorials/introduction/desktop_java/images/lena.bmp b/doc/tutorials/introduction/desktop_java/images/lena.bmp deleted file mode 100644 index 901034d04..000000000 Binary files a/doc/tutorials/introduction/desktop_java/images/lena.bmp and /dev/null differ diff --git a/doc/tutorials/introduction/desktop_java/images/lena.png b/doc/tutorials/introduction/desktop_java/images/lena.png new file mode 100644 index 000000000..68342fae5 Binary files /dev/null and b/doc/tutorials/introduction/desktop_java/images/lena.png differ diff --git a/doc/tutorials/introduction/desktop_java/java_dev_intro.rst b/doc/tutorials/introduction/desktop_java/java_dev_intro.rst index 66150ddc9..c41405c6c 100644 --- a/doc/tutorials/introduction/desktop_java/java_dev_intro.rst +++ b/doc/tutorials/introduction/desktop_java/java_dev_intro.rst @@ -5,78 +5,323 @@ Introduction to Java Development ******************************** -Last updated: 20 January, 2013. +Last updated: 12 February, 2013. -As of OpenCV 2.4.4, OpenCV supports desktop Java development using nearly the same interface as for Android development. -This guide will take you from the raw OpenCV source to a working Java application. -We will use the `Simple Build Tool (SBT) `_ to build our Java application and to generate an Eclipse project. +As of OpenCV 2.4.4, OpenCV supports desktop Java development using nearly the same interface as for +Android development. This guide will help you to create your first Java (or Scala) application using OpenCV. +We will use either `Eclipse `_, `Apache Ant `_ or the +`Simple Build Tool (SBT) `_ to build the application. -For further reading after this guide, look at the Android tutorials. The interfaces for desktop Java and Android are nearly identical. You may also consult the `Java wiki page `_. +For further reading after this guide, look at the :ref:`Android_Dev_Intro` tutorials. +The interfaces for desktop Java and Android are nearly identical. You may also consult the +`Java wiki page `_. What we'll do in this guide *************************** In this guide, we will: -* Download the OpenCV source from Github +* Get OpenCV with desktop Java support -* Build OpenCV and the Java wrappers and install OpenCV +* Create an ``Ant``, ``Eclipse`` or ``SBT`` project -* Create an SBT project and use it to generate an Eclipse project +* Write a simple OpenCV application in Java or Scala -* Copy the generated OpenCV jar into the SBT project and write a simple OpenCV application +The same process was used to create the samples in the :file:`samples/java` folder of the OpenCV repository, +so consult those files if you get lost. -The same process was used to create the samples in the samples/java folder of the OpenCV repository, so consult those files if you get lost. +Get OpenCV with desktop Java support +************************************ -Download the OpenCV source from Github -************************************** +Starting from version 2.4.4 OpenCV includes desktop Java bindings. +The most simple way to get it is downloading the appropriate package of **version 2.4.4 or higher** from the +`OpenCV SourceForge repository `_. -The OpenCV repository is hosted on `Github `_. +.. note:: Windows users can find the prebuilt files needed for Java development in the + :file:`opencv/build/java/` folder inside the package. + Other OSes users (and Windows ones optionally) can build OpenCV from sources locally. -To download the repository, enter the following in a terminal: - - .. code-block:: bash - - git clone https://github.com/Itseez/opencv.git - -This will create a directory "opencv". Enter it. - -Build OpenCV and the Java wrappers and install OpenCV -***************************************************** - -Java is currently only supported on the 2.4 git branch. This may change in the future, but for now you must switch to that branch: +Another option to get OpenCV sources is to clone OpenCV git repository, +either the primary one at ``git://code.opencv.org/opencv.git`` or +its `Github mirror `_. +Be aware that Java is currently only supported on the ``2.4`` git branch and not yet merged to the ``master``. +In order to build OpenCV with Java bindings you need :abbr:`JDK (Java Development Kit)` +(we recommend `Oracle/Sun JDK 6 or 7 `_), +`Apache Ant `_ and ``Python`` v2.6 or higher to be installed. + +Build OpenCV +############ + +Let's build OpenCV: .. code-block:: bash + git clone git://github.com/Itseez/opencv.git + cd opencv git checkout 2.4 - -To build the Java wrapper, first make sure you have Java 1.6+ and Apache Ant installed. Then invoke cmake with the DBUILD_opencv_java flag turned ON: - - .. code-block:: bash - mkdir build cd build - cmake .. -DBUILD_opencv_java=ON -Examine the output of CMake and ensure "java" is one of the modules "To be built". If not, it's likely you're missing a dependency. You should troubleshoot by looking through the CMake output for any Java-related tools that aren't found and installing them. +Generate a Makefile or a MS Visual Studio* solution, or whatever you use for +building executables in your system: -Now build and install everything: + .. code-block:: bash + + cmake -DBUILD_SHARED_LIBS=OFF .. + +or + + .. code-block:: bat + + cmake -DBUILD_SHARED_LIBS=OFF -G "Visual Studio 10" .. + +.. note:: When OpenCV is built as a set of **static** libraries (``-DBUILD_SHARED_LIBS=OFF`` option) + the Java bindings dynamic library is all-sufficient, + i.e. doesn't depend on other OpenCV libs, but includes all the OpenCV code inside. + +Examine the output of CMake and ensure ``java`` is one of the modules "To be built". +If not, it's likely you're missing a dependency. You should troubleshoot by looking +through the CMake output for any Java-related tools that aren't found and installing them. + + .. image:: images/cmake_output.png + :alt: CMake output + :align: center + +Now start the build: .. code-block:: bash make -j8 - sudo make install -In addition to building and installing C++ libraries to your system, this will write a jar containing the Java interface to bin/opencv_.jar. We'll use this jar later. +or -Create an SBT project and use it to generate an Eclipse project -***************************************************************** + .. code-block:: bat -Now we'll create a simple Java application using SBT. This serves as a brief introduction to those unfamiliar with this build tool. We're using SBT because it is particularly easy and powerful. + msbuild /m OpenCV.sln /t:Build /p:Configuration=Release /v:m -First, download and install SBT using the instructions `here `_. +Besides all this will create a ``jar`` containing the Java interface (:file:`bin/opencv_2.4.4.jar`) +and a native dynamic library containing Java bindings and all the OpenCV stuff +(:file:`bin/Release/opencv_java244.dll` or :file:`bin/libopencv_java244.so` respectively). +We'll use these files later. -Next, navigate to a new directory where you'd like the application source to live (outside opencv). Let's call it "JavaSample" and create a directory for it: +Create a simple Java sample and an Ant build file for it +******************************************************** + +.. note:: + The described sample is provided with OpenCV library in the :file:`opencv/samples/java/ant` folder. + +* Create a folder where you'll create this sample application. + +* In this folder create an XML file with the following content using any text editor: + + .. code-block:: xml + :linenos: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + .. note:: + This XML file can be reused for building other Java applications. + It describes a common folder structure in the lines 3 - 12 and common targets + for compiling and running the application. + + When reusing this XML don't forget to modify the project name in the line 1, + that is also the name of the `main` class (line 14). + The paths to OpenCV `jar` and `jni lib` are expected as parameters + (``"${ocvJarDir}"`` in line 5 and ``"${ocvLibDir}"`` in line 37), but + you can hardcode these paths for your convenience. + See `Ant documentation `_ for detailed description + of its build file format. + +* Create an :file:`src` folder nect to the :file:`build.xml` file and a :file:`SimpleSample.java` file in it. + +* Put the following Java code into the :file:`SimpleSample.java` file: + .. code-block:: java + + import org.opencv.core.Mat; + import org.opencv.core.CvType; + import org.opencv.core.Scalar; + + class SimpleSample { + + static{ System.loadLibrary("opencv_java244"); } + + public static void main(String[] args) { + Mat m = new Mat(5, 10, CvType.CV_8UC1, new Scalar(0)); + System.out.println("OpenCV Mat: " + m); + Mat mr1 = m.row(1); + mr1.setTo(new Scalar(1)); + Mat mc5 = m.col(5); + mc5.setTo(new Scalar(5)); + System.out.println("OpenCV Mat data:\n" + m.dump()); + } + + } + +* run the following command in console in the folder containing :file:`build.xml`: + .. code-block:: bash + + ant -DocvJarDir=path/to/dir/containing/opencv-244.jar -DocvLibDir=path/to/dir/containing/opencv_java244/native/library + + For example: + + .. code-block:: bat + + ant -DocvJarDir=X:\opencv-2.4.4\bin -DocvLibDir=X:\opencv-2.4.4\bin\Release + + The command should initiate [re]building and running the sample. + You should see on the screen something like this: + + .. image:: images/ant_output.png + :alt: run app with Ant + :align: center + +Create a simple Java project in Eclipse +*************************************** + +* Create a new Eclipse workspace +* Create a new Java project via :guilabel:`File --> New --> Java Project` + + .. image:: images/eclipse_new_java_prj.png + :alt: Eclipse: new Java project + :align: center + + Call it say "HelloCV". + +* Open :guilabel:`Java Build Path` tab on :guilabel:`Project Properties` dialog + and configure additional library (OpenCV) reference (jar and native library location): + + .. image:: images/eclipse_user_lib.png + :alt: Eclipse: external JAR + :align: center + + ` ` + + .. image:: images/eclipse_user_lib2.png + :alt: Eclipse: external JAR + :align: center + + ` ` + + .. image:: images/eclipse_user_lib3.png + :alt: Eclipse: external JAR + :align: center + + ` ` + + .. image:: images/eclipse_user_lib4.png + :alt: Eclipse: external JAR + :align: center + + ` ` + + .. image:: images/eclipse_user_lib5.png + :alt: Eclipse: external JAR + :align: center + + ` ` + + .. image:: images/eclipse_user_lib6.png + :alt: Eclipse: external JAR + :align: center + + ` ` + + .. image:: images/eclipse_user_lib7.png + :alt: Eclipse: external JAR + :align: center + + ` ` + + .. image:: images/eclipse_user_lib8.png + :alt: Eclipse: external JAR + :align: center + + ` ` + +* Add a new Java class (say ``Main``) containing the application entry: + + .. image:: images/eclipse_main_class.png + :alt: Eclipse: Main class + :align: center + +* Put a simple OpenCV calls there, e.g.: + .. code-block:: java + + import org.opencv.core.CvType; + import org.opencv.core.Mat; + + public class Main { + public static void main(String[] args) { + System.loadLibrary("opencv_java244"); + Mat m = Mat.eye(3, 3, CvType.CV_8UC1); + System.out.println("m = " + m.dump()); + } + } + +* Press :guilabel:`Run` button and see the identity matrix content in the Eclipse ``Console`` window. + + .. image:: images/eclipse_run.png + :alt: Eclipse: run + :align: center + +Create an SBT project and samples in Java and Scala +*************************************************** + +Now we'll create a simple Java application using SBT. This serves as a brief introduction to +those unfamiliar with this build tool. We're using SBT because it is particularly easy and powerful. + +First, download and install `SBT `_ using the instructions on its `web site `_. + +Next, navigate to a new directory where you'd like the application source to live (outside opencv). +Let's call it "JavaSample" and create a directory for it: .. code-block:: bash @@ -91,40 +336,42 @@ Now we will create the necessary folders and an SBT project: mkdir -p src/main/java # This is where SBT expects to find Java sources mkdir project # This is where the build definitions live -Now open project/build.scala in your favorite editor and paste the following. It defines your project: +Now open :file:`project/build.scala` in your favorite editor and paste the following. +It defines your project: .. code-block:: scala - import sbt._ - import Keys._ + import sbt._ + import Keys._ - object JavaSampleBuild extends Build { - def scalaSettings = Seq( - scalaVersion := "2.10.0", - scalacOptions ++= Seq( - "-optimize", - "-unchecked", - "-deprecation" - ) - ) + object JavaSampleBuild extends Build { + def scalaSettings = Seq( + scalaVersion := "2.10.0", + scalacOptions ++= Seq( + "-optimize", + "-unchecked", + "-deprecation" + ) + ) - def buildSettings = - Project.defaultSettings ++ - scalaSettings + def buildSettings = + Project.defaultSettings ++ + scalaSettings - lazy val root = { - val settings = buildSettings ++ Seq(name := "JavaSample") - Project(id = "JavaSample", base = file("."), settings = settings) - } - } + lazy val root = { + val settings = buildSettings ++ Seq(name := "JavaSample") + Project(id = "JavaSample", base = file("."), settings = settings) + } + } -Now edit project/plugins.sbt and paste the following. This will enable auto-generation of an Eclipse project: +Now edit :file:`project/plugins.sbt` and paste the following. +This will enable auto-generation of an Eclipse project: .. code-block:: scala addSbtPlugin("com.typesafe.sbteclipse" % "sbteclipse-plugin" % "2.1.0") -Now run sbt from the JavaSample root and from within SBT run "eclipse" to generate an eclipse project: +Now run ``sbt`` from the :file:`JavaSample` root and from within SBT run ``eclipse`` to generate an eclipse project: .. code-block:: bash @@ -137,19 +384,22 @@ You should see something like this: :alt: SBT output :align: center -You can now import the SBT project using "Import ... -> Existing projects into workspace" from Eclipse. Whether you actually do this is optional for the guide; we'll be using SBT to build the project, so if you choose to use Eclipse it will just be as a text editor. +You can now import the SBT project using :guilabel:`Import ... -> Existing projects into workspace` from Eclipse. +Whether you actually do this is optional for the guide; +we'll be using SBT to build the project, so if you choose to use Eclipse it will just be as a text editor. -To test everything is working, create a simple "Hello OpenCV" application. Do this by creating a file "src/main/java/HelloOpenCV.java" with the following contents: +To test everything is working, create a simple "Hello OpenCV" application. +Do this by creating a file :file:`src/main/java/HelloOpenCV.java` with the following contents: .. code-block:: java - public class HelloOpenCV { - public static void main(String[] args) { - System.out.println("Hello, OpenCV"); - } - } + public class HelloOpenCV { + public static void main(String[] args) { + System.out.println("Hello, OpenCV"); + } + } -Now execute "run" from the sbt console, or more concisely, run "sbt run" from the command line: +Now execute ``run`` from the sbt console, or more concisely, run ``sbt run`` from the command line: .. code-block:: bash @@ -166,7 +416,9 @@ Copy the OpenCV jar and write a simple application Now we'll create a simple face detection application using OpenCV. -First, create a "lib/" folder and copy the OpenCV jar into it. By default, SBT adds jars in the lib folder to the Java library search path. You can optionally rerun "sbt eclipse" to update your Eclipse project. +First, create a :file:`lib/` folder and copy the OpenCV jar into it. +By default, SBT adds jars in the lib folder to the Java library search path. +You can optionally rerun ``sbt eclipse`` to update your Eclipse project. .. code-block:: bash @@ -176,13 +428,14 @@ First, create a "lib/" folder and copy the OpenCV jar into it. By default, SBT a Next, create the directory src/main/resources and download this Lena image into it: - .. image:: images/lena.bmp + .. image:: images/lena.png :alt: Lena :align: center -Make sure it's called "lena.bmp". Items in the resources directory are available to the Java application at runtime. +Make sure it's called :file:`"lena.bmp"`. +Items in the resources directory are available to the Java application at runtime. -Next, copy lbpcascade_frontalface.xml into the resources directory: +Next, copy :file:`lbpcascade_frontalface.xml` into the resources directory: .. code-block:: bash @@ -200,7 +453,7 @@ Now modify src/main/java/HelloOpenCV.java so it contains the following Java code import org.opencv.core.Scalar; import org.opencv.highgui.Highgui; import org.opencv.objdetect.CascadeClassifier; - + // // Detects faces in an image, draws boxes around them, and writes the results // to "faceDetection.png". @@ -238,14 +491,17 @@ Now modify src/main/java/HelloOpenCV.java so it contains the following Java code System.out.println("Hello, OpenCV"); // Load the native library. - System.loadLibrary("opencv_java"); + System.loadLibrary("opencv_java244"); new DetectFaceDemo().run(); } - } + } -Note the call to "System.loadLibrary("opencv_java")". This command must be executed exactly once per Java process prior to using any native OpenCV methods. If you don't call it, you will get UnsatisfiedLink errors. You will also get errors if you try to load OpenCV when it has already been loaded. +Note the call to ``System.loadLibrary("opencv_java244")``. +This command must be executed exactly once per Java process prior to using any native OpenCV methods. +If you don't call it, you will get ``UnsatisfiedLink errors``. +You will also get errors if you try to load OpenCV when it has already been loaded. -Now run the face detection app using "sbt run": +Now run the face detection app using ``sbt run``: .. code-block:: bash @@ -257,7 +513,7 @@ You should see something like this: :alt: SBT run :align: center -It should also write the following image to faceDetection.png: +It should also write the following image to :file:`faceDetection.png`: .. image:: images/faceDetection.png :alt: Detected face diff --git a/doc/tutorials/introduction/table_of_content_introduction/table_of_content_introduction.rst b/doc/tutorials/introduction/table_of_content_introduction/table_of_content_introduction.rst index 5f29f743e..97e1db099 100644 --- a/doc/tutorials/introduction/table_of_content_introduction/table_of_content_introduction.rst +++ b/doc/tutorials/introduction/table_of_content_introduction/table_of_content_introduction.rst @@ -111,9 +111,9 @@ Here you can read tutorials about how to set up your computer to work with the O *Compatibility:* > OpenCV 2.4.4 - *Author:* |Author_VsevolodG| + *Author:* |Author_EricCh| - Explains how to build and run a simple desktop Java application using Eclipse and the Simple Build Tool (SBT). + Explains how to build and run a simple desktop Java application using Eclipse, Ant or the Simple Build Tool (SBT). ================ ================================================= @@ -258,7 +258,7 @@ Here you can read tutorials about how to set up your computer to work with the O ../linux_eclipse/linux_eclipse ../windows_install/windows_install ../windows_visual_studio_Opencv/windows_visual_studio_Opencv - ../android_binary_package/java_dev_intro + ../desktop_java/java_dev_intro ../android_binary_package/android_dev_intro ../android_binary_package/O4A_SDK ../android_binary_package/dev_with_OCV_on_Android diff --git a/samples/java/ant/build.xml b/samples/java/ant/build.xml new file mode 100644 index 000000000..924af1f13 --- /dev/null +++ b/samples/java/ant/build.xml @@ -0,0 +1,49 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/samples/java/ant/src/SimpleSample.java b/samples/java/ant/src/SimpleSample.java new file mode 100644 index 000000000..990536f2b --- /dev/null +++ b/samples/java/ant/src/SimpleSample.java @@ -0,0 +1,19 @@ +import org.opencv.core.Mat; +import org.opencv.core.CvType; +import org.opencv.core.Scalar; + +class SimpleSample { + + static{ System.loadLibrary("opencv_java244"); } + + public static void main(String[] args) { + Mat m = new Mat(5, 10, CvType.CV_8UC1, new Scalar(0)); + System.out.println("OpenCV Mat: " + m); + Mat mr1 = m.row(1); + mr1.setTo(new Scalar(1)); + Mat mc5 = m.col(5); + mc5.setTo(new Scalar(5)); + System.out.println("OpenCV Mat data:\n" + m.dump()); + } + +} diff --git a/samples/java/eclipse/HelloCV/.classpath b/samples/java/eclipse/HelloCV/.classpath new file mode 100644 index 000000000..645263d83 --- /dev/null +++ b/samples/java/eclipse/HelloCV/.classpath @@ -0,0 +1,7 @@ + + + + + + + diff --git a/samples/java/eclipse/HelloCV/.project b/samples/java/eclipse/HelloCV/.project new file mode 100644 index 000000000..b1df1de5e --- /dev/null +++ b/samples/java/eclipse/HelloCV/.project @@ -0,0 +1,17 @@ + + + HelloCV + + + + + + org.eclipse.jdt.core.javabuilder + + + + + + org.eclipse.jdt.core.javanature + + diff --git a/samples/java/eclipse/HelloCV/.settings/org.eclipse.jdt.core.prefs b/samples/java/eclipse/HelloCV/.settings/org.eclipse.jdt.core.prefs new file mode 100644 index 000000000..7341ab168 --- /dev/null +++ b/samples/java/eclipse/HelloCV/.settings/org.eclipse.jdt.core.prefs @@ -0,0 +1,11 @@ +eclipse.preferences.version=1 +org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode=enabled +org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.7 +org.eclipse.jdt.core.compiler.codegen.unusedLocal=preserve +org.eclipse.jdt.core.compiler.compliance=1.7 +org.eclipse.jdt.core.compiler.debug.lineNumber=generate +org.eclipse.jdt.core.compiler.debug.localVariable=generate +org.eclipse.jdt.core.compiler.debug.sourceFile=generate +org.eclipse.jdt.core.compiler.problem.assertIdentifier=error +org.eclipse.jdt.core.compiler.problem.enumIdentifier=error +org.eclipse.jdt.core.compiler.source=1.7 diff --git a/samples/java/eclipse/HelloCV/src/Main.java b/samples/java/eclipse/HelloCV/src/Main.java new file mode 100644 index 000000000..0e9bb5898 --- /dev/null +++ b/samples/java/eclipse/HelloCV/src/Main.java @@ -0,0 +1,12 @@ +import org.opencv.core.CvType; +import org.opencv.core.Mat; + +public class Main { + + public static void main(String[] args) { + System.loadLibrary("opencv_java244"); + Mat m = Mat.eye(3, 3, CvType.CV_8UC1); + System.out.println("m = " + m.dump()); + } + +} diff --git a/samples/java/README b/samples/java/sbt/README similarity index 98% rename from samples/java/README rename to samples/java/sbt/README index dcadba5a7..58ac8c6ad 100644 --- a/samples/java/README +++ b/samples/java/sbt/README @@ -4,5 +4,3 @@ To run the examples: 1) Install OpenCV and copy the OpenCV jar to lib/. This jar must match the native libraries installed in your system. If this isn't the case, you may get a java.lang.UnsatisfiedLinkError at runtime. 3) Go to the root directory and type "sbt/sbt run". This should generate images in your current directory. - -MIT License \ No newline at end of file diff --git a/samples/java/lib/copy_opencv_jar_here b/samples/java/sbt/lib/copy_opencv_jar_here similarity index 100% rename from samples/java/lib/copy_opencv_jar_here rename to samples/java/sbt/lib/copy_opencv_jar_here diff --git a/samples/java/project/build.scala b/samples/java/sbt/project/build.scala similarity index 88% rename from samples/java/project/build.scala rename to samples/java/sbt/project/build.scala index 7b09415c5..5a7380b96 100644 --- a/samples/java/project/build.scala +++ b/samples/java/sbt/project/build.scala @@ -11,8 +11,8 @@ object OpenCVJavaDemoBuild extends Build { ) ) - def buildSettings = - Project.defaultSettings ++ + def buildSettings = + Project.defaultSettings ++ scalaSettings lazy val root = { diff --git a/samples/java/project/plugins.sbt b/samples/java/sbt/project/plugins.sbt similarity index 98% rename from samples/java/project/plugins.sbt rename to samples/java/sbt/project/plugins.sbt index 46478b051..c2371be43 100644 --- a/samples/java/project/plugins.sbt +++ b/samples/java/sbt/project/plugins.sbt @@ -1,2 +1 @@ addSbtPlugin("com.typesafe.sbteclipse" % "sbteclipse-plugin" % "2.1.0") - diff --git a/samples/java/sbt/sbt b/samples/java/sbt/sbt/sbt old mode 100755 new mode 100644 similarity index 100% rename from samples/java/sbt/sbt rename to samples/java/sbt/sbt/sbt diff --git a/samples/java/sbt/sbt-launch.jar b/samples/java/sbt/sbt/sbt-launch.jar similarity index 100% rename from samples/java/sbt/sbt-launch.jar rename to samples/java/sbt/sbt/sbt-launch.jar diff --git a/samples/java/sbt/src/main/java/DetectFaceDemo.java b/samples/java/sbt/src/main/java/DetectFaceDemo.java new file mode 100644 index 000000000..fb0856723 --- /dev/null +++ b/samples/java/sbt/src/main/java/DetectFaceDemo.java @@ -0,0 +1,44 @@ +import org.opencv.core.Core; +import org.opencv.core.Mat; +import org.opencv.core.MatOfRect; +import org.opencv.core.Point; +import org.opencv.core.Rect; +import org.opencv.core.Scalar; +import org.opencv.highgui.Highgui; +import org.opencv.objdetect.CascadeClassifier; + +/* + * Detects faces in an image, draws boxes around them, and writes the results + * to "faceDetection.png". + */ +public class DetectFaceDemo { + public void run() { + System.out.println("\nRunning DetectFaceDemo"); + + // Create a face detector from the cascade file in the resources + // directory. + CascadeClassifier faceDetector = new CascadeClassifier(getClass() + .getResource("/lbpcascade_frontalface.xml").getPath()); + Mat image = Highgui.imread(getClass().getResource( + "/AverageMaleFace.jpg").getPath()); + + // Detect faces in the image. + // MatOfRect is a special container class for Rect. + MatOfRect faceDetections = new MatOfRect(); + faceDetector.detectMultiScale(image, faceDetections); + + System.out.println(String.format("Detected %s faces", + faceDetections.toArray().length)); + + // Draw a bounding box around each face. + for (Rect rect : faceDetections.toArray()) { + Core.rectangle(image, new Point(rect.x, rect.y), new Point(rect.x + + rect.width, rect.y + rect.height), new Scalar(0, 255, 0)); + } + + // Save the visualized detection. + String filename = "faceDetection.png"; + System.out.println(String.format("Writing %s", filename)); + Highgui.imwrite(filename, image); + } +} \ No newline at end of file diff --git a/samples/java/src/main/resources/AverageMaleFace.jpg b/samples/java/sbt/src/main/resources/AverageMaleFace.jpg similarity index 100% rename from samples/java/src/main/resources/AverageMaleFace.jpg rename to samples/java/sbt/src/main/resources/AverageMaleFace.jpg diff --git a/samples/java/src/main/resources/img1.bmp b/samples/java/sbt/src/main/resources/img1.bmp similarity index 100% rename from samples/java/src/main/resources/img1.bmp rename to samples/java/sbt/src/main/resources/img1.bmp diff --git a/samples/java/src/main/resources/img2.bmp b/samples/java/sbt/src/main/resources/img2.bmp similarity index 100% rename from samples/java/src/main/resources/img2.bmp rename to samples/java/sbt/src/main/resources/img2.bmp diff --git a/samples/java/src/main/resources/lbpcascade_frontalface.xml b/samples/java/sbt/src/main/resources/lbpcascade_frontalface.xml similarity index 100% rename from samples/java/src/main/resources/lbpcascade_frontalface.xml rename to samples/java/sbt/src/main/resources/lbpcascade_frontalface.xml diff --git a/samples/java/src/main/scala/Main.scala b/samples/java/sbt/src/main/scala/Main.scala similarity index 92% rename from samples/java/src/main/scala/Main.scala rename to samples/java/sbt/src/main/scala/Main.scala index 7c2fc67df..4a68d144a 100644 --- a/samples/java/src/main/scala/Main.scala +++ b/samples/java/sbt/src/main/scala/Main.scala @@ -4,9 +4,9 @@ * demonstrating the generic nature of the interface. * The other demos are in Java. * Currently, all demos are run, sequentially. - * + * * You're invited to submit your own examples, in any JVM language of - * your choosing so long as you can get them to build. + * your choosing so long as you can get them to build. */ object Main extends App { // We must load the native library before using any OpenCV functions. diff --git a/samples/java/src/main/scala/ScalaCorrespondenceMatchingDemo.scala b/samples/java/sbt/src/main/scala/ScalaCorrespondenceMatchingDemo.scala similarity index 96% rename from samples/java/src/main/scala/ScalaCorrespondenceMatchingDemo.scala rename to samples/java/sbt/src/main/scala/ScalaCorrespondenceMatchingDemo.scala index 969410780..da455e5c2 100644 --- a/samples/java/src/main/scala/ScalaCorrespondenceMatchingDemo.scala +++ b/samples/java/sbt/src/main/scala/ScalaCorrespondenceMatchingDemo.scala @@ -16,7 +16,7 @@ import reflect._ object ScalaCorrespondenceMatchingDemo { def run() { println(s"\nRunning ${classTag[this.type].toString.replace("$", "")}") - + // Detects keypoints and extracts descriptors in a given image of type Mat. def detectAndExtract(mat: Mat) = { // A special container class for KeyPoint. @@ -27,7 +27,7 @@ object ScalaCorrespondenceMatchingDemo { println(s"There were ${keyPoints.toArray.size} KeyPoints detected") - // Let's just use the best KeyPoints. + // Let's just use the best KeyPoints. val sorted = keyPoints.toArray.sortBy(_.response).reverse.take(50) // There isn't a constructor that takes Array[KeyPoint], so we unpack // the array and use the constructor that can take any number of @@ -44,7 +44,7 @@ object ScalaCorrespondenceMatchingDemo { (bestKeyPoints, descriptors) } - // Load the images from the |resources| directory. + // Load the images from the |resources| directory. val leftImage = Highgui.imread(getClass.getResource("/img1.bmp").getPath) val rightImage = Highgui.imread(getClass.getResource("/img2.bmp").getPath) diff --git a/samples/java/src/main/scala/ScalaDetectFaceDemo.scala b/samples/java/sbt/src/main/scala/ScalaDetectFaceDemo.scala similarity index 100% rename from samples/java/src/main/scala/ScalaDetectFaceDemo.scala rename to samples/java/sbt/src/main/scala/ScalaDetectFaceDemo.scala diff --git a/samples/java/src/main/java/DetectFaceDemo.java b/samples/java/src/main/java/DetectFaceDemo.java deleted file mode 100644 index c2cc77ee4..000000000 --- a/samples/java/src/main/java/DetectFaceDemo.java +++ /dev/null @@ -1,44 +0,0 @@ -import org.opencv.core.Core; -import org.opencv.core.Mat; -import org.opencv.core.MatOfRect; -import org.opencv.core.Point; -import org.opencv.core.Rect; -import org.opencv.core.Scalar; -import org.opencv.highgui.Highgui; -import org.opencv.objdetect.CascadeClassifier; - -/* - * Detects faces in an image, draws boxes around them, and writes the results - * to "faceDetection.png". - */ -public class DetectFaceDemo { - public void run() { - System.out.println("\nRunning DetectFaceDemo"); - - // Create a face detector from the cascade file in the resources - // directory. - CascadeClassifier faceDetector = new CascadeClassifier(getClass() - .getResource("/lbpcascade_frontalface.xml").getPath()); - Mat image = Highgui.imread(getClass().getResource( - "/AverageMaleFace.jpg").getPath()); - - // Detect faces in the image. - // MatOfRect is a special container class for Rect. - MatOfRect faceDetections = new MatOfRect(); - faceDetector.detectMultiScale(image, faceDetections); - - System.out.println(String.format("Detected %s faces", - faceDetections.toArray().length)); - - // Draw a bounding box around each face. - for (Rect rect : faceDetections.toArray()) { - Core.rectangle(image, new Point(rect.x, rect.y), new Point(rect.x - + rect.width, rect.y + rect.height), new Scalar(0, 255, 0)); - } - - // Save the visualized detection. - String filename = "faceDetection.png"; - System.out.println(String.format("Writing %s", filename)); - Highgui.imwrite(filename, image); - } -} \ No newline at end of file