This is a reference implementation of the following publication:
Compatible Intrinsic Triangulations
Kenshi Takayama
ACM Transactions on Graphics 41(4), Article No. 57 (August 2022)
https://doi.org/10.1145/3528223.3530175
See build.yml for steps to build the executable.
The build process generates a few executables under <BUILD_DIR>/bin/
, and cit_demo
is the main executable implementing the CIT algorithm.
The executable expects the two input triangle meshes of the same surface genus, A
and B
, to be placed in a common directory (called data directory) and be named as either A-orig.obj, B-orig.obj
or A-orig-refined.obj, B-orig-refined.obj
.
The executable takes as input the vertex images from A to B and from B to A as AtoB.txt
and BtoA.txt
.
These vertex images can be generated using https://github.com/kenshi84/cit-hot and https://github.com/kenshi84/seamlesssurfmap for genus zero and high genus surfaces, respectively.
With the required files in place, run the following command:
cit_demo --dataDir /path/to/data/directory --interactive
(With --dataDir
omitted, the data directory is set to the current directory.)
This opens up an interactive OpenGL window where you can perform various kind of optimization operations as well as inspect various kind of information (e.g., individual compatible edges/faces).
While the above interactive mode is useful for debugging, you can let the executable perform optimization from the start without creating the OpenGL window, by simply not passing the --interactive
flag.
The executable generates a directory named results
under the data directory, and within that directory, generates a log file named <SESSION_ID>.log
where <SESSION_ID>
is just a number representing the time since the epoch in seconds at launch, as well as a directory <SESSION_ID>
under which all the intermediate files during optimization are written.
TODO...
TODO...
TODO...
TODO...