在 Windows 中安装OpenCV

使用预构建的库进行安装

1. 启动所选的 Web 浏览器并转到我们在?Sourceforge 上的页面。
2. 选择要使用的内部版本并下载它。
3. 确保您具有管理员权限。解压缩自解压存档。

4. 您可以在所选路径检查安装，如下所示。

   

5. 要完成安装，请转到设置 OpenCV 环境变量并将其添加到系统路径部分。

使用 git-bash（版本>=2.14.1）和 cmake（版本 >=3.9.1）安装

1. 您必须下载?cmake（版本 >=3.9.1）并安装它。您必须在安装过程中将 cmake 添加到 PATH 变量中
2. 您必须安装?git-bash （version>=2.14.1）。不要在安装过程中将 git 添加到 PATH 变量中
3. 运行 git-bash。您将看到一个命令行窗口。假设你想在 c：/lib 中构建 opencv 和 opencv_contrib
4. 在 git 命令行中，输入以下命令（如果文件夹不存在）：

   mkdir /c/库

   cd /c/库

5. 在 c：/lib 中使用名称 installOCV.sh 保存此脚本

   #！/bin/bash -e

   myRepo=$（pwd）

   CMAKE_GENERATOR_OPTIONS=-G“Visual Studio 16 2019”

   #CMAKE_GENERATOR_OPTIONS=-G“Visual Studio 15 2017 Win64”

   #CMAKE_GENERATOR_OPTIONS=（-G“Visual Studio 16 2019” -A x64） # CMake 3.14+ 是必需的

   如果 [ ！ -d “$myRepo/opencv” ];然后

   echo “克隆 opencv”

   git clone https://github.com/opencv/opencv.git

   还

   光盘opencv

   git pull --rebase

   cd ..

   fi

   如果 [ ！ -d “$myRepo/opencv_contrib” ];然后

   Echo “克隆opencv_contrib”

   git clone https://github.com/opencv/opencv_contrib.git

   还

   光盘opencv_contrib

   git pull --rebase

   cd ..

   fi

   存储库 = opencv

   mkdir -p build_opencv

   推build_opencv

   CMAKE_OPTIONS=（-DBUILD_PERF_TESTS：BOOL=OFF -DBUILD_TESTS：BOOL=OFF -DBUILD_DOCS：BOOL=OFF -DWITH_CUDA：BOOL=OFF -DBUILD_EXAMPLES：BOOL=OFF -DINSTALL_CREATE_DISTRIB=ON）

   设置 -x

   cmake “${CMAKE_GENERATOR_OPTIONS[@]}”： “${CMAKE_OPTIONS[@]}”， -DOPENCV_EXTRA_MODULES_PATH=“$myRepo”/opencv_contrib/modules -DCMAKE_INSTALL_PREFIX=“$myRepo/install/$RepoSource”， “$myRepo/$RepoSource”

   echo “************************* $Source_DIR -->调试”

   cmake --构建。--config 调试

   echo “************************* $Source_DIR -->发布”

   cmake --构建。--config 发布

   cmake --构建。--target install --config 发布

   cmake --构建。--target install --config 调试

   啪

   在此脚本中，我假设您使用 2015 位的 VS 64
   CMAKE_GENERATOR_OPTIONS=-G“Visual Studio 14 2015 Win64”
   opencv 将安装在 c：/lib/install/opencv 中

   -DCMAKE_INSTALL_PREFIX=“$myRepo/安装/$RepoSource”

   没有 Perf 测试，没有测试，没有文档，没有 CUDA 也没有示例

   CMAKE_OPTIONS=（-DBUILD_PERF_TESTS：BOOL=OFF -DBUILD_TESTS：BOOL=OFF -DBUILD_DOCS：BOOL=OFF -DBUILD_EXAMPLES：BOOL=OFF）

6. 在 git 命令行中，输入以下命令：

   ./installOCV.sh

7. 喝一两杯咖啡......opencv 已准备就绪：仅此而已！
8. 下次运行此脚本时，opencv 和 opencv_contrib 将更新并重新生成

通过从源文件创建自己的库进行安装

如果您正在构建自己的库，则可以从我们的?Git 存储库中获取源文件。

从头开始构建 OpenCV 库需要事先安装几个工具：

• 选择的 IDE（最好），或者只是一个实际生成二进制文件的 CC++ 编译器。在这里，我们将使用?Microsoft Visual Studio。但是，您可以使用具有有效 CC++ 编译器的任何其他 IDE。
• CMake，这是一个简洁的工具，用于从 OpenCV 源文件创建项目文件（对于您选择的 IDE）。它还允许轻松配置 OpenCV 构建文件，以便制作完全适合您需求的二进制文件。
• Git 获取 OpenCV 源文件。一个很好的工具是?TortoiseGit。或者，您可以从我们在?Sourceforge 上的页面下载源文件的存档版本

OpenCV 可能有多种风格。有一个“核心”部分可以独立工作。尽管如此，还是有一些工具，由第三方制作的库，它们提供的服务是OpenCV可以利用的。这些将在许多方面提高其能力。为了使用其中任何一个，您需要在系统上下载并安装它们。

• 构建 OpenCV 的 Python?接口需要?Python 库。现在使用版本 .如果您想构建?OpenCV 文档，这也是必须的。2.7.{x}
• Numpy?是 Python 的科学计算包。对于 Python 接口是必需的。
• 英特尔线程构建模块 （TBB）?在 OpenCV 中用于并行代码片段。使用此选项将确保 OpenCV 库将利用系统 CPU 中的所有内核。
• Intel Integrated Performance Primitives （IPP）?可用于提高 OpenCV 库的颜色转换、Haar 训练和 DFT 函数的性能。请注意，因为这不是一项免费服务。
• OpenCV提供了一个更漂亮、更有用的图形用户界面，而不是使用Qt框架的默认用户界面。要快速了解它所提供的功能，请查看?Qt New Functions?部分下的文档?highgui?模块。需要 4.6 或更高版本的框架。
• Eigen是线性代数的C++模板库。
• 最新的?CUDA 工具包将允许您使用 GPU 内部的强大功能。这将大大提高某些算法（例如 HOG 描述符）的性能。让越来越多的算法在 GPU 上运行是 OpenCV 团队的不懈努力。
• 库需要?OpenEXR?源文件才能使用这种高动态范围 （HDR） 图像文件格式。
• OpenNI 框架 包含 了 一 组 开放 源 API， 可 通过 语音 命令 识别、 手势 和 身体 运动 跟踪 等 方法 支持 与 设备 进行 自然 交互。可以在此处找到预构建的二进制文件。OpenNI 和?OpenNI2?的源代码也可在 Github 上找到。
• Doxygen?是一个文档生成器，是实际创建?OpenCV 文档的工具。

现在，我们将介绍完整构建（使用上述所有框架、工具和库）要遵循的步骤。如果您不需要对其中一些的支持，则可以自由地跳过此部分。

构建库

1. 确保您有一个具有有效编译器的工作 IDE。如果是Microsoft Visual Studio，只需安装它并确保它启动。
2. 安装?CMake。只需按照向导操作，无需将其添加到路径中。默认安装选项为 OK。
3. 从其官方网站下载并安装最新版本的 msysgit。还有便携版本，您只需解压缩即可访问 Git 的控制台版本。假设对于我们中的一些人来说，这可能就足够了。
4. 安装?TortoiseGit。根据您使用的操作系统类型选择 32 位或 64 位版本。安装时，找到您的 msysgit（如果它没有自动执行此操作）。按照向导操作 - 默认选项在大多数情况下是可以的。
5. 在文件系统中选择一个目录，将 OpenCV 库下载到该目录。我建议创建一个具有短路径且没有特殊字符的新路径，例如 .在本教程中，我建议您这样做。如果你使用自己的道路并知道你在做什么——没关系。D:/OpenCV
   1. 将存储库克隆到所选目录。单击“克隆”按钮后，将出现一个窗口，您可以在其中选择要下载源文件 （GitHub - opencv/opencv: Open Source Computer Vision Library） 的存储库以及下载到哪个目录 （）。D:/OpenCV
   2. 按下 OK 按钮并耐心等待，因为存储库的下载量相当大。这将需要一些时间，具体取决于您的 Internet 连接。
6. 在本节中，我将介绍如何安装第三方库。
   1. 下载?Python 库并使用默认选项进行安装。您将需要其他几个 python 扩展。幸运的是，所有这些的安装都可以通过一个名为?Setuptools?的好工具自动完成。下载并重新安装。
   2. 安装 Numpy 的最简单方法是从?sourceforge 页面下载其二进制文件。确保您下载并安装的二进制文件完全适用于您的 python 版本（因此对于版本 ）。2.7

   3. 对于英特尔线程构建模块 （TBB），请下载源文件并将其解压缩到系统上的目录中。例如，让有 .对于安装英特尔集成性能基元 （IPP），情况是一样的。为了提取档案，我建议使用?7-Zip?应用程序。D:/OpenCV/dep

      

   4. 对于?Eigen?库，它又是下载并提取到目录的情况。D:/OpenCV/dep
   5. 与上述?OpenEXR?相同。
   6. 对于OpenNI框架，您需要安装开发版本和PrimeSensor模块。
   7. 对于 CUDA，您还需要两个模块：最新的?CUDA 工具包和?CUDA 工具 SDK。根据您的操作系统使用 32 位或 64 位设置下载并安装带有完整选项的它们。

   8. 对于Qt框架，您需要自己构建二进制文件（除非您使用带有32位编译器的Microsoft Visual Studio 2008）。为此，请转到Qt下载页面。下载源文件（不是安装程序!!）：

      

      将其解压缩到一个漂亮且简短的命名目录中，例如 .然后你需要构建它。使用“开始”菜单搜索启动 Visual Studio 命令提示符 （2010）（或浏览“开始”菜单“所有程序”> Microsoft Visual Studio 2010“>”Visual Studio 工具“>”Visual?Studio?命令提示符 （2010）“）。D:/OpenCV/dep/qt/

      

      现在导航到提取的文件夹，然后使用此控制台窗口进入其中。您应该有一个包含?Install、Make?等文件的文件夹。使用?dir?命令列出当前目录中的文件。到达此目录后，输入以下命令：

      配置.exe -release -no-webkit -no-phonon -no-phonon-backend -no-script -no-scripttools

      -no-qt3support -no-multimedia -no-ltcg

      完成此操作大约需要 10-20 分钟。然后输入下一个命令，这将花费更长的时间（很容易花费超过一个小时）：

      nmake

      在此之后，在 Windows 7 上使用以下命令设置 Qt 环境变量：

      setx -m QTDIR D：/OpenCV/dep/qt/qt-everywhere-opensource-src-4.7.3

      此外，使用?PathEditor?将生成的二进制文件路径添加到系统路径中。在我们的例子中，这是 .D:/OpenCV/dep/qt/qt-everywhere-opensource-src-4.7.3/bin

      注意

      如果您计划进行Qt应用程序开发，此时还可以安装Qt Visual Studio插件。在此之后，您可以在不使用Qt Creator的情况下制作和构建Qt应用程序。一切都很好地集成到 Visual Studio 中。

7. 现在启动?CMake （cmake-gui）。您可以再次在开始菜单搜索中输入它，也可以从所有程序 –> CMake 2.8 –> CMake （cmake-gui） 中获取它。首先，选择 OpenCV 库 （1） 的源文件的目录。然后，指定一个目录，您将在其中构建 OpenCV 的二进制文件 （2）。

   

   按“配置”按钮指定要使用的编译器（和?IDE）。请注意，您可以在不同的编译器之间进行选择以创建 64 位或 32 位库。选择您在应用程序开发中使用的那个。

   

   CMake 将启动，并根据您的系统变量尝试自动定位尽可能多的包。您可以在 WITH –> WITH_X 菜单点（其中?X?是包缩写）中修改要用于生成的包。以下是您可以打开或关闭的当前软件包列表：

   

   选择要使用的所有包，然后再次按“配置”按钮。为了更轻松地概述生成选项，请确保二进制目录选择下的“分组”选项处于打开状态。对于某些包，CMake 可能无法找到所有必需的文件或目录。在这种情况下，CMake 将在其输出窗口（位于 GUI 底部）中抛出错误，并将其字段值设置为未找到常量。例如：

   

   

   对于这些，您需要手动设置查询的目录或文件路径。在此之后，再次按下“配置”按钮，查看您输入的值是否被接受。执行此操作，直到所有条目都正确，并且您在 GUI 的字段/值或输出部分看不到错误。现在我想强调一个你一定会喜欢的选项：ENABLE –> ENABLE_SOLUTION_FOLDERS。OpenCV 将创建多个项目，转动此选项将确保它们被归类在解决方案资源管理器的目录中。如果你问我，这是一个必须具备的功能。

   

   此外，您需要选择要构建的 OpenCV 部分。

   • BUILD_DOCS?-> 它创建了两个用于构建 OpenCV 文档的项目（将有一个单独的项目用于构建 HTML 和 PDF 文件）。请注意，这些不是与解决方案一起构建的。为此，您需要在这些项目上发出显式的构建项目命令。
   • BUILD_EXAMPLES?-> OpenCV 附带了许多示例应用程序，您可以从中学习大多数库功能。这也将派上用场，可以轻松尝试 OpenCV 是否在您的计算机上完全正常运行。
   • BUILD_PACKAGE?-> 在版本 2.3 之前，您可以使用它构建一个项目来构建 OpenCV 安装程序。有了这个，您可以轻松地在其他系统上安装 OpenCV 风格。对于 OpenCV 的最新源文件，它会生成一个新项目，该项目只是使用 OpenCV 源代码创建一个 zip 存档。
   • BUILD_SHARED_LIBS?-> 有了这个，你可以控制构建DLL文件（打开时）或静态库文件（*.lib）。
   • BUILD_TESTS?-> OpenCV 的每个模块都有一个分配给它的测试项目。构建这些测试项目也是一种很好的尝试方式，这些模块在您的系统上也按预期工作。
   • BUILD_PERF_TESTS?-> 还有许多 OpenCV 函数的性能测试。如果您担心性能，请构建它们并运行。
   • BUILD_opencv_python?-> 不言自明。创建二进制文件以使用 Python 语言中的 OpenCV。
   • BUILD_opencv_world?-> 生成一个包含所有模块的“opencv_world”二进制文件（共享或静态库，取决于BUILD_SHARED_LIBS），而不是单独的二进制文件的集合，每个模块一个二进制文件。

   再次按下“配置”按钮，确保未报告任何错误。如果是这种情况，您可以通过按“生成”按钮来告诉 CMake 创建项目文件。进入构建目录，打开创建的OpenCV解决方案。根据您选择的上述选项的数量，解决方案可能包含相当多的项目，因此在启动时要对 IDE 持宽容态度。现在，您需要同时生成?Release?和?Debug?二进制文件。使用 IDE 上的下拉菜单，在为其中一个生成后更改为另一个。

   

   最后，您可以观察到 bin 目录下构建的二进制文件：

   

   对于文档，您需要在 HTML 文档的?doxygen?项目上显式发出 build 命令。它会召唤?Doxygen?来完成所有艰苦的工作。您可以在 .build/doc/doxygen/html

   若要将头文件和二进制文件（将在自己的项目期间使用）收集到单独的目录中（类似于预构建二进制文件的交付方式），需要显式生成?Install?项目。

   

   这将在?Build?one 中创建一个?Install?目录，将所有构建的二进制文件收集到一个位置。只有在生成?Release?和?Debug?版本后，才使用此选项。

   要测试您的构建，只需进入 or 目录并启动几个应用程序，例如轮廓 .exe。如果他们跑了，你就完成了。否则，肯定出了什么大问题。在这种情况下，您应该在我们的问答论坛上与我们联系。如果一切正常，轮廓.exe输出应类似于下图（如果在Qt支持下构建）：Build/bin/DebugBuild/bin/Release

   

注意

如果您使用 GPU 模块（CUDA 库），请确保同时升级到 GPU 的最新驱动程序。包含 nvcuda.dll 中（或找不到）无效条目的错误消息主要是由旧的视频卡驱动程序引起的。若要测试 GPU（如果已构建），请运行?performance_gpu.exe?示例应用程序。

设置 OpenCV 环境变量并将其添加到系统路径中

首先，我们设置一个环境变量，使我们的工作更轻松。这将保存我们在项目中使用的 OpenCV 库的构建目录。启动命令窗口并输入：

在这里，目录是您拥有 OpenCV 二进制文件（提取或构建）的地方。您可以有不同的平台（例如 x64 而不是 x86）或编译器类型，因此请替换适当的值。其中，您应该有两个名为?lib?和?bin?的文件夹。

如果你构建了静态库，那么你就完成了。否则，您需要将?bin?文件夹路径添加到系统路径中。这是因为您将以 *“动态链接 库“*（也称为?DLL）。其中存储了 OpenCV 库包含的所有算法和信息。在运行时，操作系统将仅按需加载它们。但是，要做到这一点，操作系统需要知道它们在哪里。系统?PATH?包含可在其中找到 DLL 的文件夹列表。将 OpenCV 库路径添加到此路径，如果他需要 OpenCV 二进制文件，操作系统将知道在哪里查找。否则，您需要将使用的 DLL 复制到应用程序可执行文件 （exe） 旁边，以便操作系统找到它，如果您从事许多项目，这是非常不愉快的。为此，请再次启动?PathEditor?并添加以下新条目（在应用程序中单击鼠标右键以显示菜单）：

将其保存到注册表中，您就完成了。如果您更改了构建目录的位置，或者想要使用不同的构建来试用您的应用程序，您需要做的就是通过命令窗口中的?setx?命令更新 OPENCV_DIR 变量。