Skip to content


geometry-central uses CMake for to configure the build system. The basic workflow for downloading and compiling geometry-central via a terminal is:

git clone --recurse-submodules
cd geometry-central
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j4

However, since geometry-central is just a library, this does not build any executables, it merely compiles the library.

You can add geometry-central to an existing project’s CMakeLists.txt like

add_subdirectory("path/to/geometry-central") # wherever you put it
target_link_libraries(your-project-target geometry-central)


For a simple example project using geometry-central (with Polyscope for visualization), see gc-polyscope-project-template. This is a good starting point for new projects using geometry-central.

On Windows

When using Visual Studio on Windows, CMake can be used (either via the terminal or gui) to generate Visual Studio project and solution files. The project has been verified to compile out of the box with Visual Studio 2017 & 2019 (older versions not tested).

Compile flags & options

The library includes a few optional safety checks which are performed at runtime, even in release mode. Such checks are generally very cheap yet quite useful. Nonetheless, adding the NGC_SAFETY_CHECKS define will disable all optional safety checks, for a very small increase in performance.