To get started, clone the repo:
git clone --recursive https://github.com/SGI-2023/linkages.git
Create your own branch, then switch to the newly created branch:
git branch <your-new-branch-name>
git checkout <your-new-branch-name>
Later, if you would like to merge changes from the main branch into your own branch, run
git merge origin/main
from your branch.
Compile this project using the standard cmake routine:
mkdir build
cd build
cmake ..
make -j4 ## replace 4 with however many cores you want to use
This should find and build the dependencies and create a main binary.
From within the build directory, run:
./main [path/to/mesh]
A glfw app should launch. The second argument (the path to an external mesh) is optional.
The program currently uses libigl's built-in implementation of ARAP. When you launch the program, you will initially be in "anchor selection mode". The bottom of the left-hand-side menu will read "Mode: Anchor selection". You can select "anchor points" simply by clicking vertices; blue dots will appear over vertices that have been selected as anchors.
If you press the "space" key, you will switch to "deformation mode". The text at the bottom of the left-hand-side menu should now read "Mode: ARAP deformation". You should now be able to click and drag any of the previously selected anchor vertices. Afer dragging, the mesh positions should update to reflect the resulting ARAP deformation. The deformation can be slow; I recommend trying the small_disk.obj mesh in the /data directory.
The libigl tutorial.
The only dependencies are STL, Eigen, libigl and the dependencies
of the igl::opengl::glfw::Viewer (OpenGL, glad and GLFW).
The CMake build system will automatically download libigl and its dependencies using
CMake FetchContent,
thus requiring no setup on your part.
To use a local copy of libigl rather than downloading the repository via FetchContent, you can use
the CMake cache variable FETCHCONTENT_SOURCE_DIR_LIBIGL when configuring your CMake project for
the first time:
cmake -DFETCHCONTENT_SOURCE_DIR_LIBIGL=<path-to-libigl> ..
When changing this value, do not forget to clear your CMakeCache.txt, or to update the cache variable
via cmake-gui or ccmake.