Compile And Install¶
libccd contains several mechanisms for compiling and installing. Using a simple Makefile, using autotools, and using CMake.
1. Using Makefile¶
Directory src/
contains Makefile that should contain everything needed for compilation and installation:
$ cd src/
$ make
$ make install
Library libccd is by default compiled in double precision of floating point
numbers - you can change this by options USE_SINGLE
/USE_DOUBLE
, i.e.:
$ make USE_SINGLE=yes
will compile library in single precision.
Installation directory can be changed by options PREFIX
, INCLUDEDIR
and LIBDIR
.
For more info type ‘make help
’.
2. Using Autotools¶
libccd also contains support for autotools: Generate configure script etc.:
$ ./bootstrap
Create new build/
directory:
$ mkdir build && cd build
Run configure script:
$ ../configure
Run make and make install:
$ make && make install
configure script can change the way libccd is compiled and installed, most
significant option is --enable-double-precision
which enables double
precision (single is default in this case).
3. Using CMake¶
To build using make
:
$ mkdir build && cd build
$ cmake -G "Unix Makefiles" ..
$ make && make install
To build using ninja
:
$ mkdir build && cd build
$ cmake -G Ninja ..
$ ninja && ninja install
Other build tools may be using by specifying a different generator. For example:
$ cmake -G Xcode ..
> cmake -G "Visual Studio 14 2015" ..
To compile using double precision, set the ENABLE_DOUBLE_PRECISION
option:
$ mkdir build && cd build
$ cmake -G "Unix Makefiles" -DENABLE_DOUBLE_PRECISION=ON ..
$ make && make install
To build libccd as a shared library, set the BUILD_SHARED_LIBS
option:
$ mkdir build && cd build
$ cmake -G "Unix Makefiles" -DBUILD_SHARED_LIBS=ON ..
$ make && make install
To build the test suite, set the BUILD_TESTING
option:
$ mkdir build && cd build
$ cmake -G "Unix Makefiles" -DBUILD_TESTING=ON ..
$ make && make test
The installation directory may be changed by specifying the CMAKE_INSTALL_PREFIX
variable:
$ mkdir build && cd build
$ cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX=/path/to/install ..
$ make && make install