00_install.md 1.6 KB

Tutorial 00 - Building and installing NICE-core

Dependencies

Linux

The following libraries and programs are required in order to build NICE-core.

  • GCC with C++ support (clang is not supported)
  • CMake 2.8.6 or later
  • Qt 4.x
  • OpenGL
  • GLUT 2.x

Mac OS X

Newer version of Mac OS X ship with clang as the default compiler. NICE depends on some GCC-only features, so you need to install homebrew from brew.sh first.

We recommend installing GCC 4.8 like this:

$ brew tap homebrew/versions
$ brew install gcc48

You also need to install Qt 4.8.5 for Mac. If you have Mac OS X 10.9, you also have to remove lines 330-332 from qtglobal.h:

#  if (MAC_OS_X_VERSION_MAX_ALLOWED > MAC_OS_X_VERSION_10_8)
#    warning "This version of Mac OS X is unsupported"
#  endif

And finally FreeGLUT:

$ brew install freeglut

Preparing the file system

Make a new working directory and clone the repository from GitHub:

$ mkdir nice
$ cd nice
$ git clone https://github.com/cvjena/nice-core.git

NICE needs to be built out-of-tree (in a separate directory next to nice-core):

$ cd nice
$ mkdir build
$ cd build

Building NICE-core

Navigate to the build directory and build NICE-core like this:

$ cmake ../nice-core
$ make

Mac OS X

Because we installed a different toolchain, we need to tell CMake about it. The STL headers in Mac OS X are also slightly different, so call CMake like this:

$ cmake -DCMAKE_CXX_FLAGS:STRING="-include sys/types.h" -DCMAKE_CXX_COMPILER=g++-4.8 -DCMAKE_C_COMPILER=gcc ../nice-core/
$ make