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).