获取适当的 OpenCV
从版本 2.4.4 开始,OpenCV 包含桌面 Java 绑定。
下载
获取它的最简单方法是从 OpenCV SourceForge 存储库下载版本 2.4.4 或更高版本的相应软件包。
注意
Windows 用户可以在包内的文件夹中找到 Java 开发所需的预构建文件。对于其他操作系统,需要从源代码构建 OpenCV。opencv/build/java/
获取 OpenCV 源代码的另一种选择是克隆 OpenCV git 存储库。为了使用 Java 绑定构建 OpenCV,您需要安装 JDK(Java 开发工具包)(我们推荐 Oracle/Sun JDK 6 或 7)、Apache Ant 和 Python v2.6 或更高版本。
建
让我们构建 OpenCV:
git clone git://github.com/opencv/opencv.git
光盘opencv
git checkout 2.4
mkdir 构建
CD 构建
生成 Makefile 或 MS Visual Studio* 解决方案,或用于在系统中构建可执行文件的任何内容:
cmake -DBUILD_SHARED_LIBS=关闭 ..
或
cmake -DBUILD_SHARED_LIBS=OFF -G “Visual Studio 10” ..
注意
当 OpenCV 构建为一组静态库(-DBUILD_SHARED_LIBS=OFF 选项)时,Java 绑定动态库就足够了,即不依赖于其他 OpenCV 库,而是包含所有 OpenCV 代码。
检查 CMake 的输出,并确保 java 是“要构建”的模块之一。如果没有,则可能是缺少依赖项。您应该通过查看 CMake 输出中查找未找到的任何与 Java 相关的工具并安装它们来进行故障排除。
注意
如果 CMake 在系统中找不到 Java,请在运行之前将 JAVA_HOME 环境变量设置为已安装 JDK 的路径。例如:
导出JAVA_HOME=/usr/lib/jvm/java-6-oracle
cmake -DBUILD_SHARED_LIBS=关闭 ..
现在开始构建:
制造 -j8
或
msbuild /m OpenCV.sln /t:Build /p:Configuration=Release /v:m
除此之外,还将创建一个包含 Java 接口 () 的 jar 和一个包含 Java 绑定和所有 OpenCV 内容(或分别)的本机动态库。我们稍后会用到这些文件。bin/opencv-244.jar
lib/libopencv_java244.so
bin/Release/opencv_java244.dll
使用 Ant 的 Java 示例
注意
所描述的示例随文件夹中的 OpenCV 库一起提供。opencv/samples/java/ant
- 创建一个文件夹,您将在其中开发此示例应用程序。
- 在此文件夹中,使用任何文本编辑器创建包含以下内容的文件:
build.xml
注意
此 XML 文件可以重用于构建其他 Java 应用程序。它描述了第 3 - 12 行中的通用文件夹结构以及用于编译和运行应用程序的通用目标。重用此 XML 时,不要忘记修改第 1 行中的项目名称,这也是主类的名称(第 14 行)。OpenCV jar 和 jni lib 的路径应作为参数(第 5 行中的“${ocvJarDir}”和第 37 行中的“${ocvLibDir}”),但为方便起见,您可以对这些路径进行硬编码。有关其构建文件格式的详细说明,请参阅 Ant 文档。
- 在文件旁边创建一个文件夹,并在其中创建一个文件。
src
build.xml
SimpleSample.java
- 将以下 Java 代码放入该文件中:
SimpleSample.java
-
在控制台中包含以下内容的文件夹中运行以下命令:
build.xml
蚂蚁 -DocvJarDir=path/to/dir/containing/opencv-244.jar -DocvLibDir=path/to/dir/containing/opencv_java244/native/library
例如:
蚂蚁 -DocvJarDir=X:\opencv-2.4.4\bin -DocvLibDir=X:\opencv-2.4.4\bin\Release
该命令应启动 [re]build 并运行示例。您应该在屏幕上看到如下内容:
适用于 Java 和 Scala 的 SBT 项目
现在,我们将使用 SBT 创建一个简单的 Java 应用程序。这是对不熟悉此构建工具的人的简要介绍。我们之所以使用 SBT,是因为它特别简单和强大。
首先,按照 SBT 网站上的说明下载并安装 SBT。
接下来,导航到您希望应用程序源所在的新目录(在目录外部)。我们称它为“JavaSample”,并为它创建一个目录:opencv
CD<opencv 之外的某个地方>
mkdir JavaSample
现在,我们将创建必要的文件夹和一个 SBT 项目:
cd Java示例
mkdir -p src/main/java # 这是 SBT 希望找到 Java 源代码的地方
mkdir project # 这是构建定义所在的位置
现在在您喜欢的编辑器中打开并粘贴以下内容。它定义了您的项目:project/build.scala
现在编辑并粘贴以下内容。这将启用 Eclipse 项目的自动生成:project/plugins.sbt
addSbtPlugin(“com.typesafe.sbteclipse” % “sbteclipse-plugin” % “2.1.0”)
现在从根目录运行 sbt,然后从 SBT 中运行 eclipse 以生成一个 eclipse 项目:JavaSample
sbt # 启动 sbt 控制台
eclipse # 在 sbt 控制台中运行 “eclipse”
您应该看到如下内容:
现在,您可以使用 Import ... -> Existing projects into workspace 将 SBT 项目导入 Eclipse。对于指南来说,是否真的这样做是可选的;我们将使用 SBT 来构建项目,因此如果您选择使用 Eclipse,它将仅用作文本编辑器。
要测试一切是否正常,请创建一个简单的“Hello OpenCV”应用程序。为此,请创建一个包含以下内容的文件:src/main/java/HelloOpenCV.java
现在从 sbt 控制台执行 run,或者更简洁地说,从命令行运行 sbt run:
SBT 运行
您应该看到如下内容:
运行 SBT 示例
现在,我们将使用 OpenCV 创建一个简单的人脸检测应用程序。
首先,创建一个文件夹并将 OpenCV jar 复制到其中。缺省情况下,SBT 会将 lib 文件夹中的 jar 添加到 Java 库搜索路径中。您可以选择重新运行 sbt eclipse 来更新 Eclipse 项目。lib/
mkdir 库
cp <opencv_dir>/build/bin/opencv_<版本>.jar lib/
SBT 日食
接下来,创建目录并将此 Lena 映像下载到其中:src/main/resources
确保它被称为 .resources 目录中的项在运行时可供 Java 应用程序使用。"lena.png"
接下来,从以下目录复制:lbpcascade_frontalface.xml
opencv/data/lbpcascades/
resources
cp <opencv_dir>/data/lbpcascades/lbpcascade_frontalface.xml src/main/resources/
现在修改 src/main/java/HelloOpenCV.java,使其包含以下 Java 代码:
请注意对 System.loadLibrary(Core.NATIVE_LIBRARY_NAME) 的调用。在使用任何本机 OpenCV 方法之前,必须为每个 Java 进程执行一次此命令。如果不调用它,则会收到 UnsatisfiedLink 错误。如果在 OpenCV 已经加载时尝试加载它,您也会收到错误。
现在使用“sbt run”运行人脸检测应用程序:
SBT 运行
您应该看到如下内容:
它还应该将下图写入:faceDetection.png