You're viewing an old version of the documentation. Click here to see the latest release.

使用 CMake 配置 C++ 示例并在 Windows 的 Visual Studio 中构建它们

介绍

本教程展示了如何使用CMake配置Zivid C++示例,然后在Windows中使用Visual Studio构建它们。

要求

必需的

备注

The CMake version that is tested is 3.15.3.

可选的

一些示例依赖于外部库,特别是:

备注

下面介绍了克隆/安装。

说明

下面的屏幕截图提供了分步说明。

安装外部依赖项

根据您要运行的示例程序安装所需的依赖项,见下表。

示例程序

PCL

Eigen

OpenCV

OpenCV_Contrib

ReadPCLVis3D

YES

CaptureWritePCLVis3D

YES

MaskPointCloud

YES

YES

PoseConversions

YES

YES

UtilizeHandEyeCalibration

YES

YES

CaptureUndistortRGB

YES

CreateDepthMap

YES

TransformPointCloudViaArucoMarker

YES

克隆Eigen

The Eigen version that is tested is 3.4.0. This version can be downloaded or cloned from gitlab.com/libeigen/eigen. To clone it, launch the Command Prompt by pressing Win + R keys on the keyboard, then type cmd and press Enter.

在Windows中运行命令

导航到要克隆存储库的位置:

cd C:\Users\Public\Downloads

然后运行以下命令(如有必要请安 装 Git ):

git clone https://gitlab.com/libeigen/eigen

Navigate to eigen and checkout version 3.4.0.

cd eigen
git checkout tags/3.4.0
在 cmd 中使用 Git 克隆 Eigen 的屏幕截图。

安装PCL

The PCL version that is tested is 1.9.1. Download and install prebuilt PCL binaries: pcl_1.9.1. Check the option to install 3rd Party Libraries including OpenNI.

Windows 上 PCL 安装向导的屏幕截图。

安装OpenCV

The OpenCV version that is tested is 4.1.0. Download and install prebuilt OpenCV binaries: opencv_4.1.0.

在 Windows 上提取 OpenCV zip 文件夹的屏幕截图。

小心

预构建的OpenCV binaries对于需 要 OpenCV_Contrib 的示例来说是不够的。这些示例需要使用额外的模块构建OpenCV。

为PCL和OpenCV设置PATH 系统变量

在构建Zivid C++示例之前,必须对PATH系统变量进行一些设置。

在您的PC上,导航到 Control PanelSystem and SecuritySystemAdvanced System SettingsEnvironment Variables

Windows 系统信息截图。

在系统变量(窗口底部)下,选择 Path 变量并单击 Edit

警告

请注意是点击 Edit,而不是 New,以免覆盖PATH系统变量的现有值!

Windows 系统信息截图。

Environment variables 窗口中点击 New (窗口的右上角,在用户变量部分)并添加以下值:

C:\Program Files\PCL 1.9.1\bin
C:\Program Files\OpenNI2\Tools
C:\Users\Public\Downloads\opencv\build\x64\vc15\bin

备注

确保您的PCL和OpenCV安装路径是正确的。

显示如何将路径添加到 PATH 变量的屏幕截图。

克隆C++示例

这是我们 的 GitHub zivid-cpp-samples 存储库。如需克隆它,请通过按键盘上的 Win + R 键启动命令提示符,然后键入 cmd 并按 Enter 键。

在Windows中运行命令

导航到要克隆存储库的位置(如果尚未安装 Git,需要先安装它)。

cd C:\Users\Public\Downloads

然后运行以下命令:

git clone https://github.com/zivid/zivid-cpp-samples

使用CMake配置解决方案

运行CMake (cmake-gui.exe),然后设置前两个条目:

Where is the source code

C:/Users/Public/Downloads/zivid-cpp-samples/source

Where to build the binaries

C:/Users/Public/Downloads/zivid-cpp-samples/build

带有 Zivid C++ 示例配置的 CMake GUI 屏幕截图。

点击 Configure。出现提示时,单 击 Yes 创建一个新的构建目录。

CMake GUI 的屏幕截图,其中包含有关创建构建目录的说明。

设置前两个条目:

Specify the generator for this project

Visual Studio 15 2017

Optional platform for generator

x64

指定生成器的 CMake GUI 屏幕截图。

点击 Configure.

CMake GUI 的屏幕截图,您可以在其中配置依赖项。

备注

一些示例依赖于外部库,特别是Eigen 3、PCL或OpenCV。如果您不想配置它们,请不要勾选 USE_EIGEN, USE_OPENCVUSE_PCL

勾选 USE_ARUCO 配置依赖于ArUco库 (OpenCV_Contrib) 的示例。

添加Eigen

如果需要使用Eigen 3,请单击 Add Entry 添加 Eigen3的安装路径。

设置前三个条目:

Name

EIGEN3_INCLUDE_DIR

Type

PATH

Value

path chosen in 克隆Eigen

CMake GUI的屏幕截图,您可以在其中进入 Eigen 3 包含目录。 添加 EIGEN3_INCLUDE_DIR 后的 CMake GUI 截图。

再次点击 Configure

CMake GUI 的屏幕截图,其中包含有关缺少 OpenCV 安装的警告。

添加OpenCV

如果要使用OpenCV,请 将 安装OpenCV 中的路径添加 到 OpenCV_DIR 的*value*中。

添加 OpenCV_DIR 后 CMake GUI 的屏幕截图。

再次点击 Configure

配置成功完成后的 CMake GUI 屏幕截图。

点击 Generate

CMake GUI 生成的屏幕截图。

点击 Open Project

构建解决方案

更改构建配置 DebugRelease

点击 Ctrl + Shift + B 构建解决方案。

C++ 示例的 Visual Studio 生成事件的屏幕截图。

运行示例程序

导航到文件资源管理器中的*Release*文件夹。

C++ 示例的发布文件夹的屏幕截图。

运行示例程序,例如*CaptureVis3D.exe*。

CaptureVis3D示例的屏幕截图。

关闭窗口。

备注

调试程序:如果要调试依赖于输入文件的程序,必须将工作目录更改为 ${TargetDir}

展示了如何在 Visual Studio 中设置调试工作目录的GIF。