Configure C++ Samples With CMake and Build Them in Visual Studio in Windows

Introduction

This tutorial shows how to configure the Zivid C++ Samples with CMake and then build them with Visual Studio in Windows.

Requirements

Required

Note

The CMake version that is tested is 3.15.3.

Optional

Some of the samples depend on external libraries, in particular:

Note

Cloning/installation is covered below.

Instructions

Step by step instructions is provided with screenshots below.

Install external dependencies

Install required dependencies based on the sample programs you want to run; see the table below.

Sample program

PCL

Eigen

OpenCV

OpenCV_Contrib

ReadPCLVis3D

YES

CaptureWritePCLVis3D

YES

MaskPointCloud

YES

YES

PoseConversions

YES

YES

UtilizeHandEyeCalibration

YES

YES

CaptureUndistort2D

YES

CreateDepthMap

YES

TransformPointCloudViaArucoMarker

YES

Clone 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 Run command

Navigate to a location where you want to clone the repository:

cd C:\Users\Public\Downloads

Then run the following command (install Git if necessary):

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

Navigate to eigen and checkout version 3.4.0.

cd eigen
git checkout tags/3.4.0
Screenshot of cloning Eigen with Git in cmd.

Install 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.

Screenshot of PCL installation wizard on Windows.

Install OpenCV

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

Screenshot of OpenCV zip-folder extraction on Windows.

Caution

The prebuilt OpenCV binaries are not sufficient for the samples that depend on OpenCV_Contrib. These samples require building OpenCV with extra modules.

Set PATH system variable for PCL and OpenCV

Some settings must be included in the PATH system variable before you can build Zivid C++ Samples.

On your PC, navigate to Control PanelSystem and SecuritySystemAdvanced System SettingsEnvironment Variables.

Screenshot of system information on Windows.

Under System variables (bottom of the window), select Path variable and click Edit.

Warning

It is important to click Edit and not New in order not to overwrite the existing value(s) of the PATH system variable!

Screenshot of system information on Windows.

In the Environment variables window, click New (top-right corner of the window, in the section for user variables) and add the following values:

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

Note

Make sure to have the correct path for your PCL and OpenCV installations.

Screenshot which shows how to add paths to the PATH variable.

Clone C++ Samples

This is our GitHub zivid-cpp-samples repository. To clone it, launch the Command Prompt by pressing Win + R keys on the keyboard, then type cmd and press Enter.

Windows Run command

Navigate to a location where you want to clone the repository (install Git if not already installed).

cd C:\Users\Public\Downloads

Then run the following command:

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

Configure the solution with CMake

Run CMake (cmake-gui.exe), then set the top two entries:

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

Screenshot of CMake GUI with configuration for Zivid C++ samples.

Click Configure. When prompted, click Yes to create a new build directory.

Screenshot of CMake GUI with a note about creation of build directory.

Set the top two entries:

Specify the generator for this project

Visual Studio 15 2017

Optional platform for generator

x64

Screenshot of CMake GUI where you specify generator.

Click Configure.

Screenshot of CMake GUI where you can configure dependencies.

Note

Some of the samples depend on external libraries, in particular, Eigen 3, PCL, or OpenCV. If you don’t want to configure those, uncheck USE_EIGEN, USE_OPENCV and USE_PCL, respectively.

Check USE_ARUCO to configure the samples that depend on ArUco library (OpenCV_Contrib).

Include Eigen

If you do want to use Eigen 3, click Add Entry to add the path of your Eigen3 installation.

Set the top three entries:

Name

EIGEN3_INCLUDE_DIR

Type

PATH

Value

path chosen in Clone Eigen

Screenshot of CMake GUI where you can enter Eigen 3 include directory. Screenshot of CMake GUI after EIGEN3_INCLUDE_DIR is added.

Click Configure again.

Screenshot of CMake GUI with warning about missing OpenCV installation.

Include OpenCV

If you want to use OpenCV, add the path from Install OpenCV to the value of OpenCV_DIR.

Screenshot of CMake GUI after OpenCV_DIR is added.

Click Configure again.

Screenshot of CMake GUI after configuration has completed successfully.

Click Generate.

Screenshot of CMake GUI generation.

Click Open Project.

Build the solution

Change the build configuration from Debug to Release.

Build the solution by pressing Ctrl + Shift + B.

Screenshot of Visual Studio build events for C++ samples.

Run the sample program

Navigate to the Release folder in File Explorer.

Screenshot of release folder for C++ samples.

Run a sample program, e.g. CaptureVis3D.exe.

Screenshot of CaptureVis3D sample.

Close the window.

Debug the sample program

In order to debug you must add C:Program FilesZividbin_debug to your PATH environment variable.

On your PC, navigate to Control PanelSystem and SecuritySystemAdvanced System SettingsEnvironment Variables.

Screenshot of system information on Windows.

Under System variables (bottom of the window), select Path variable and click Edit.

Warning

It is important to click Edit and not New in order not to overwrite the existing value(s) of the PATH system variable!

Screenshot of system information on Windows.

In the Environment variables window, click New (top-right corner of the window, in the section for user variables) and add the following value:

C:\Program Files\Zivid\bin_debug
Screenshot which shows how to add the :code:`C:\Program Files\Zivid\bin_debug` path to the PATH variable.

Note

Debug Program: If you want to debug a program that depends on an input file you must change Working Directory to ${TargetDir}.

GIF which shows how to set working directory for debug in Visual Studio.

Change the build configuration from Debug to Release. Then click F5 to build and run with debug.