A framework for Structured Light based 3D scanning projects

Engineering degree thesis/project for the title of "Ingeniero en Informatica", Universidad Nacional del Litoral (Santa Fe, Argentina).

Originally used two cameras + one DLP projector to get more precission, but I'm trying to add a calibration wizard to use it with one camera + one projector, to make it easier/simpler for home-use.

Camera support

There's a plugin for OpenCV, so any webcam that works with OpenCV should work too. On Linux & macOS you can also use the libgphoto2 plugin.

There are also a lot of plugins that (used to) make it work with a lot of different cameras, mostly industrial GigE or USB cameras, but since I don't have access to them anymore, they are not tested/enabled anymore.

The windows release should have working plugins for:

There are also some old plugins (might require fixes/changes) for:

Requirements

We assume you already have a suitable C++ compiler and Qt installed (at least version 5.12).

You'll also need some libraries:

OpenCV (mostly tested with version 4.1.x)

For the point cloud viewer you might also want to include, optionally (just to open PCD files):

PCL (tested with version 1.9.x)

Apple macOS

All the dependencies can be obtained via homebrew. A Brewfile is included so just run:

brew update && brew bundle

Windows 64 bits

Since there are no official binaries from VTK and PCL you can build everything using vcpkg. It greatly simplifies the task, trust me.

vcpkg install opencv:x64-windows
vcpkg install pcl:x64-windows

Linux

For Linux it should be easy, just use the official package manager to install the dependencies.

Building and running

For building you can simply run:

mkdir build
cd build
cmake ..
cmake --build .

Check the CI scripts for more details.

You can also open the CMake project with QtCreator (version 4.11 has good support for CMake projects) and just run the applications from there.

Notes for Windows users

To run the applications you also need to add the binaries (*.dll) to the PATH. Open the Projects tab in the left toolbar of QtCreator and go to the Build (or Run) configurations. In the environment variables, add to the PATH the folder where you have the third party binaries. You should use the Batch Edit button to make it easier. In that case:

for a release (or profile) build you would add:
- PATH=${PATH};C:\Tools\vcpkg\installed\x64-windows\bin;
for a debug build you would add:
- PATH=${PATH};C:\Tools\vcpkg\installed\x64-windows\debug\bin;

It's really important that you add only the ones corresponding to the build configuration you're currently trying to build/run!

xumingkun9806/neuvision