» Documentation

Overview


Installation / Compilation


After downloading our framework you have to uncompress the tarball and change into the directory:

$ tar xvfz latest_scivi_framework.tar.gz
$ cd scivi/

The first step will be to untar and compile the libpoisson, which is deliverd within our framework:

$ cd Data/Libraries/
$ tar xvfz libPoisson.tar.gz
$ cd libPoisson/
$ make

Next step is to untar the vcglib package within the libraries folder.
There is no need for make or install because this library consists of header files only.

$ cd ..
$ tar xvfz vcglib.tar.gz

After this step, you setup the paths of the libraries. Therefore we created a file out of the main Makefile. There is a template for this Personal.mk which can be easily set up for your personal issues. Here an example:

#
# personal include directories
# example: -I/path/to/include
#
MY_INCLUDE_PATHS    =    -I Data/Libraries/libPoisson/include \
                         -I Data/Libraries/vcglib \
                         -I path/to/AR/include
#
# personal library directories
# example: -L/path/to/lib
#
MY_LIBRARY_PATHS    =    -L Data/Libraries/libPoisson/lib \
                         -L path/to/AR/lib \
                         -L path/to/osglibs \
                         -L path/to/libfreenectlibs

Now you can compile the whole framework with

$ make

After these small steps, the framework can be used.

Using the Application based Interface


The Framework is a program which starts applications. You only have to specify which application you want to use:

$ ./scivi
Usage: ./scivi option [suboption] [arguments]
Options:
  -PoissonBench  Creating lots of example meshes with different poisson
                 reconstruction parameters.
   -generate      Run the application for generating a model.
                 -ds <duplicate_space>  max distance between duplicates
                 -nc <neighbor_count>   neighbor countfor normal calculation
                 -nf                    flip normals after calculation
                 -ptd <tree_depth>      octree depth for poisson reconstruction
                 -psd <solver_divide>   solver divide for poisson reconstruction
                 -psc <sample_count>    sample_count for poisson reconstruction
                 -pid <iso_divide>      iso_divide for poisson reconstruction
                 -pcn                   no confidence for poisson reconstruction
                 -pr <refine>           refine for poisson reconstruction
                 -po <offset>           offset for poisson reconstruction
                 -cnc <neighbor_count>  neighbor count for color mapping
                 -cf                    fast color mapping
                 -in <file>             input point cloud
                 -out <file>            output colored mesh
  -scan          Run the application for scanning a marked scene.
                 -tablet	bounding box values for scan tablet
                 -frame		bounding box values for scan frame
                 -footprint	save footprint to .gle-files (experimental)
  -test          Run the standard test application.
  -testColor     Run the mesh colorizing test application.
  -testKinect    Run the Kinect test application.
  -testOsg       Run the OpenSceneGraph test application.
  -testPoisson   Run the Poisson-Surface-Reconstruction test application.

The starter delivers all installed applications you can start with the framework. Just explore the applications on your own.


Documentation



Download the PDF file