How hjwdzh/manifoldplus works
Project type and purpose
• This is a C++ command-line computational geometry tool (“ManifoldPlus”) that ingests arbitrary triangle soup models (OBJ/OFF), processes them through a pipeline of spatial data structures and geometric operations, and outputs a watertight manifold mesh in OBJ format.
• It is neither a web service nor a full-stack app—it is a native executable with a clear linear processing flow.
File structure
• Top level
• 3rd_party/ – Embedded Eigen (linear algebra) and LibIGL (geometry utilities) submodules
• CMakeLists.txt, compile.sh, examples.sh – Build and example drivers
• data/, res/ – Sample input meshes and result teaser images
• src/ – Core pipeline code files:
– main.cc – Entry point and orchestration
– Parser.{h,cc} – Command-line argument parsing
– IO.{h,cc} – Model file import/export
– Octree.{h,cc} – Spatial subdivision
– MeshProjector.{h,cc} – Plane-fitting per cell
– Intersection.{h,cc} – Compute cell boundary intersections
– Manifold.{h,cc} – Surface reconstruction onto a watertight mesh
– types.h – Shared data types
• Patterns
• Modular pipeline: each module handles one stage of the geometry workflow
• CMake-driven build, single executable output
README for additional insights
• Dependencies: Eigen & LibIGL (submodule init required)
• Usage: “./ManifoldPlus --input input.obj --output output.obj --depth 8”
• Example scripts that loop over data/ to generate results/
Detail
• Where Eigen and LibIGL are invoked
• Build system and scripts as part of the development-to-run workflow (compile.sh → build/ → executable)