Introduction

This is a guideline how to compile and use FSSR, the Floating Scale Surface Reconstruction software accompanying the following paper:

Floating Scale Surface Reconstruction
Simon Fuhrmann and Michael Goesele
In: ACM ToG (Proceedings of ACM SIGGRAPH 2014).
http://tinyurl.com/floating-scale-surface-recon

This software is based on MVE, the Multi-View Environment. See the link below for details on MVE, and the next section for downloading and building MVE.

http://www.gris.tu-darmstadt.de/projects/multiview-environment/

Downlaoding and Building MVE and FSSR

MVE requires libjpeg, libpng and libtiff as dependencies, which can be obtained using the package system of your distribution.

The following commands should get you started:

# Download and compile MVE
git clone https://github.com/simonfuhrmann/mve.git
make -j8 -C mve

# Download and compile FSSR
git clone https://github.com/simonfuhrmann/fssr.git
make -j8 -C fssr

The binaries will be located and ready for execution here:

fssr/apps/fssr_octree
fssr/apps/fssr_surface

FSSR Input Data

FSSR requires as input a point set which contains several required and some optional attributes per sample. Currently, only PLY is supported as input format. All required and optional attributes are listed below:

Name           PLY Attribute(s)   Type                 Required?
------------------------------------------------------------------
3D positions   x, y, z            float 3-vector       required
normals        nx, ny, nz         float 3-vector       required
scale values   value              single float value   required
confidence     confidence         single float value   optional
color          red, green, blue   uchar 3-vector       optional

A typical PLY header (without color) then looks like this:

format binary_little_endian 1.0
element vertex 36228
property float x
property float y
property float z
property float nx
property float ny
property float nz
property float confidence
property float value
end_header

If you are using MVE and want to create a surface from a set of depth maps, you can use the 'scene2pset' tools, which is included in the MVE distribution.

Usage: scene2pset [ OPTS ] SCENE_DIR MESH_OUT

Make sure the parameters --depth and --image specify the correct depth map and corresponding image. Also enable normals, scale and confidence with the parameters --with-normals, --with-scale and --with-conf.

Running FSSR

First, the implicit function defined by the input points is sampled and stored in an octree. This is done with the 'fssr_octree' tool.

Usage: fssr_octree [ OPTS ] IN_PLY [ IN_PLY ... ] OUT_OCTREE

It takes one or more PLY files as input (connectivity information is ignored) and samples the implicit function over an octree hierarchy. The result is stored in a binary format. (Check the code for details.)

Second, the sampling of the implicit function must be converted to a surface mesh. This is done with a second 'fssr_surface' tool.

Usage: fssr_surface [ OPTS ] IN_OCTREE OUT_PLY_MESH

The tool takes as input the octree and produces a mesh. Several options can control the resulting mesh. See the tools output for details.

Trouble? Contact!

Contact information can be found on the FSSR and MVE websites.