如何在“Microsoft Visual Studio”中使用OpenCV编译应用程序

返回目录：OpenCV系列文章目录（持续更新中......）

前一篇：OpenCV4.9.0在windows系统下的安装

后一篇：

警告：

本教程可以包含过时的信息。

我在这里描述的所有内容都将适用于 OpenCV 的C\C++接口。我首先假设您已经阅读并成功完成了 Windows 安装教程。因此，在继续操作之前，请确保您有一个包含 OpenCV 头文件和二进制文件的 OpenCV 目录，并且您已按照此处所述设置环境变量设置 OpenCV 环境变量并将其添加到系统路径。

我们在 Microsoft Windows 操作系统上分发的 OpenCV 库位于动态链接库（DLL）中。它们的优点是，库的所有内容仅在运行时按需加载，并且无数程序可能使用相同的库文件。这意味着，如果您有 10 个应用程序使用 OpenCV 库，则无需为每个应用程序设置一个版本。当然，您需要在要运行应用程序的所有系统上安装 OpenCV 的 dll。

另一种方法是使用具有 lib 扩展的静态库。您可以使用我们的源文件来构建这些文件，如在 Windows 中安装教程中所述。当您使用它时，该库将内置在您的 exe 文件中。因此，出于某种原因，用户不可能删除它们。作为一个缺点，您的应用程序会更大，并且在启动期间需要更多时间来加载它。

要使用 OpenCV 构建应用程序，您需要做两件事：

告诉编译器OpenCV库的外观。为此，您可以向其显示头文件。
当需要时，告诉链接器从哪里获取OpenCV的函数或数据结构。

如果使用 lib 系统，则必须设置库文件所在的路径，并指定要在哪个库文件中查找。在生成过程中，链接器将查看这些库，并将所有使用的函数和数据结构的定义和实现添加到可执行文件中。

如果您使用 DLL 系统，则必须再次指定所有这些，但现在出于不同的原因。这是特定于 Microsoft 操作系统的东西。链接器似乎需要知道在DLL中的哪个位置才能在运行时搜索数据结构或函数。此信息存储在 lib 文件中。然而，它们不是静态库。它们就是所谓的导入库。这就是为什么当您在 Windows 中制作一些 DLL 时，您最终也会得到一些 lib 扩展库。好的部分是在运行时只需要 DLL。

若要将所有这些信息传递给 Visual Studio IDE，可以全局执行此操作（以便所有将来的项目都将获得此信息），也可以在本地执行此操作（因此仅针对当前项目）。全局的优点是你只需要做一次;但是，将所有项目都与所有这些信息聚集在一起可能是不可取的。如果是全局的，你如何做取决于你使用的 Microsoft Visual Studio。有 2008 年和以前的版本以及 2010 年的方法。在本教程的全局部分中，我将展示主要区别是什么。

Visual Studio 中项目的基本项是解决方案。一个解决方案可以包含多个项目。项目是应用程序的构建基块。每个项目都会实现一些东西，您将有一个主要项目，您可以在其中将这个项目拼图放在一起。对于许多简单的应用程序（就像许多教程一样），您不需要将应用程序分解为模块。在这些情况下，您的主项目将是唯一现有的项目。现在，通过“文件”（File） –> “新建（New）–>项目”（Project）菜单选择，在 Visual Studio 中创建一个新解决方案。选择“Win32 控制台应用程序”作为类型。输入其名称并选择创建它的路径。然后，在即将到来的对话框中，确保创建一个空项目。

本地方法

每个项目都是与其他项目分开构建的。因此，每个项目都有自己的规则包。在此规则包中存储了 IDE 构建项目所需的所有信息。对于任何应用程序，至少有两种构建模式：发布模式和调试模式。Debug 具有许多功能，因此您可以查找并解决应用程序中更简单的错误。相比之下，Release 是一个优化版本，其目标是使应用程序运行得尽可能快或尽可能小。您可能会发现，这些模式还需要在构建过程中使用不同的规则。因此，每种生成模式都存在不同的规则包。这些规则包在 IDE 中作为项目属性调用，您可以使用“属性管理器”查看和修改它们。可以使用“查看”->“属性页”（对于 Visual Studio 2013 及更高版本，请转到“查看”->“其他窗口”-“>属性管理器”）。展开它，可以看到现有的规则包（称为属性表）。

这些真正有用的东西是，您可以创建一次规则包，然后可以将其添加到您的新项目中。创建一次，以后重复使用。我们想要创建一个新的属性表，其中包含编译器和链接器需要知道的所有规则。当然，我们需要一个单独的 Debug 和 Release Builds。使用调试启动，如下图所示：

例如，使用OpenCV_Debug名称。然后，通过选择工作表，右键单击 –> 属性。在下文中，我将演示如何在本地设置 OpenCV 规则，因为我发现没有必要使用我不使用它的自定义规则来污染项目。转到 C++ 组的常规条目，然后在 *“附加包含目录”* 下添加 OpenCV 包含的路径。如果没有 *“C/C++”* 组，则应将任何 .c/.cpp 文件添加到项目中。

$(OPENCV_DIR)\..\..\include

添加第三方库设置时，通常最好使用环境变量背后的强大功能。OpenCV 库的完整位置可能会在每个系统上更改。此外，由于某种原因，您甚至可能最终移动安装目录。如果您在属性表中提供显式路径，则当您将项目进一步传递给具有不同 OpenCV 安装路径的其他人时，您的项目最终将无法正常工作。此外，解决此问题需要手动修改每个显式路径。一个更优雅的解决方案是使用环境变量。在括号内以美元符号开头的任何内容都将在运行时替换为当前环境变量值。这里是我们在上一个教程中已经做的环境变量设置设置OpenCV环境变量并将其添加到系统路径中。

接下来转到 Linker –> General，然后在 *“Additional Library Directories”* 下添加 libs 目录：

$(OPENCV_DIR)\lib

然后，您需要指定链接器应在其中查看的库。为此，请转到链接器 –> 输入，并在 *“Additional Dependencies”* 条目下添加要使用的所有模块的名称：

库的名称如下：

opencv_（模块名称）（您使用的库的版本号）d.lib

最新版本的完整列表将包含：

opencv_calib3d300d.lib
opencv_core300d.lib
opencv_features2d300d.lib
opencv_flann300d.lib
opencv_highgui300d.lib
opencv_imgcodecs300d.lib
opencv_imgproc300d.lib
opencv_ml300d.lib
opencv_objdetect300d.lib
opencv_photo300d.lib
opencv_shape300d.lib
opencv_stitching300d.lib
opencv_superres300d.lib
opencv_ts300d.lib
opencv_video300d.lib
opencv_videoio300d.lib
opencv_videostab300d.lib

或者，您的 OpenCV 下载可能已内置到一个大型 .lib 文件中。通过查看 OpenCV\build\architecture\vc14\lib 进行检查。在这种情况下，对于版本 3.3.0，您只需添加：

opencv_world330.lib

末尾的字母 d 仅表示这些是调试所需的库。现在单击“确定”进行保存，并对“发布规则”部分中的新属性执行相同的操作。请确保省略库名称中的 d 个字母，并使用其上方的保存图标保存属性表。

您可以在项目目录中找到您的属性表。在这一点上，将它们备份到某个特殊的目录中是一个明智的决定，以便将来每当您创建 OpenCV 项目时，它们总是在手边。请注意，对于 Visual Studio 2010，文件扩展名是 props，而对于 2008，文件扩展名是 vsprops。

下次创建新的 OpenCV 项目时，只需使用“添加现有属性表...”属性管理器中的菜单条目，可轻松添加 OpenCV 构建规则。

全局方法

如果您发现将属性页添加到每个项目太麻烦，也可以将此规则添加到*“全局属性页”*。但是，这仅适用于其他 include 和 library 目录。要使用的库的名称仍需要手动指定，例如：属性页。

在 Visual Studio 2008 中，您可以在以下目录下找到它：工具 –> 选项 –> 项目和解决方案 –> VC++ 目录。

在 Visual Studio 2010 中，这已移动到全局属性表，该属性表会自动添加到您创建的每个项目中：

该过程与本地方法中描述的过程相同。只需使用环境变量 OPENCV_DIR 添加包含目录即可。

如下例子：

现在，要尝试一下，请下载我们的小测试源代码，或从 OpenCV 源代码的示例代码文件夹中获取它。将其添加到您的项目并生成它。以下是其内容：

#include <opencv2/core.hpp>
#include <opencv2/imgcodecs.hpp>
#include <opencv2/highgui.hpp>
#include <iostream>
using namespace cv;
using namespace std;
int main( int argc, char** argv )
{
if( argc != 2)
{
cout <<" Usage: " << argv[0] << " ImageToLoadAndDisplay" << endl;
return -1;
}
Mat image;
image = imread(argv[1], IMREAD_COLOR); // Read the file
if( image.empty() ) // Check for invalid input
{
cout << "Could not open or find the image" << std::endl ;
return -1;
}
namedWindow( "Display window", WINDOW_AUTOSIZE ); // Create a window for display.
imshow( "Display window", image ); // Show our image inside it.
waitKey(0); // Wait for a keystroke in the window
return 0;
}

可以从两个位置启动 Visual Studio 生成。无论是从 IDE（键盘组合：Control-F5）内部，还是导航到构建目录，然后双击启动应用程序。问题是这两者是不一样的。从 IDE 启动它时，它的当前工作目录是 projects 目录，否则它是应用程序文件当前所在的文件夹（因此通常是您的构建目录）。此外，如果从 IDE 启动，控制台窗口在完成后不会关闭。它将等待您的击键。

在代码中编写代码、打开和保存命令时，请务必记住这一点。您的资源将相对于您的工作目录进行保存（并在打开!!时查询）。除非您提供完整的显式路径作为 I/O 函数的参数。在上面的代码中，我们打开这个 OpenCV 徽标。在启动应用程序之前，请确保将图像文件放在当前工作目录中。修改代码中的图像文件名，以便在其他图像上也进行尝试。运行它并瞧 á

Visual Studio 的命令行参数

在我们未来的一些教程中，你会看到程序的主要输入法是通过给出运行时参数来实现的。为此，您只需启动一个命令窗口（开始菜单中的 cmd + Enter），导航到可执行文件并使用参数启动它。因此，例如，在我的上部项目中，这将看起来像：

D:
CD OpenCV\MySolutionName\Release
MySolutionName.exe exampleImage.jpg

H在这里，我首先更改了我的驱动器（如果您的项目不在操作系统本地驱动器上），导航到我的项目并使用示例图像参数启动它。虽然在Linux系统下，在Microsoft Windows上摆弄控制台窗口是很常见的，但许多人几乎从未使用它。此外，在测试应用程序时一次又一次地添加相同的参数在某种程度上是一项繁琐的任务。幸运的是，在 Visual Studio 中，有一个菜单可以自动执行所有这些操作：