A helper repository to use Qhull in CMake-based C++ projects
This repository has been created to make it as easy as possible to use Qhull functionality in CMake-based C++ projects.
The specific goal is to allow users to use it simply by git submodule add ... and add_subdirectory(...).
This repository currently uses Qhull 7.3.0.
The CMakeLists.txt in this repository defines a target for building Qhull, named qhull.
Specifically, qhull builds a static library that combines together the two libraries in the original Qhull repository, libqhullstatic_r and libqhullcpp.
Suppose that you have a C++ project that looks like
$ ls -a
.git
CMakeLists.txt
main.cpp
To use Qhull, add easy-qhull as a git submodule:
$ git submodule add https://github.com/yuki-koyama/easy-qhull.git ./external/easy-qhull
$ git submodule update --init --recursive
Then, edit CMakeLists.txt:
...
add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/external/easy-qhull)
...
add_executable(my-program ${CMAKE_CURRENT_SOURCE_DIR}/main.cpp)
target_link_libraries(my-program qhull)
...Now you can use Qhull functionality in main.cpp:
#include <libqhullcpp/Qhull.h>
int main()
{
orgQhull::Qhull qhull;
qhull.run(...);
...
return 0;
}Finally, this project can be built by a typical CMake cycle, for example,
$ cmake . && make
(TODO)
(TODO)
- Add utility functions to further wrap the Qhull functionality