README

• OpenISS Depth Particles Apps

How do I get set up?

Simply clone the repository and build the source code using CMake.

The following dependencies are required:

• OpenISS (as a symlink or a copy or a git submodule)
• OpenGL
• GLUT
• GLEW
• GLFW
• GLM
• PCL
• Libfreenect

Setting up OpenISS

To set up OpenISS within the project, follow the following steps:

In the root directory of the repository (openiss-particles-app), run the following command:

$ git submodule update --init openiss

which will pull the OpenISS repo from the "Integration" branch. Then, to build it, run the following commands:

cd src/openiss/src/api/cpp
mkdir build
cd build
cmake -L ..
make openiss

Which should build the openiss dependency.

Building and running the apps

After building OpenISS and installing the other dependencies and required libraries, you must follow the following steps to build the application:

$ cd src
$ mkdir build
$ cd build
$ cmake -L ..
$ make

To run the apps run the following command(s) inside the build folder:

$ ./openiss-glpclview
$ ./openiss-particles-app

Note that, at present, the above apps use a placeholder device (OIDynamicNullDevice).

Currently, the third app does not showcase any sort of implementation/usage of OpenISS, but can be run if you have a compatible sensor/device:

$ ./oi-simple-openni-processor

If you need to run it using a pre-recorded RGBD sequence, you may use fakenect as follows:

$ LD_PRELOAD="/usr/local/lib/fakenect/libfakenect.so" FAKENECT_PATH="../path/to/recording/" ./openiss-glpclview