How wjakob/instant-meshes works
Project type and purpose
• This is a native C++ desktop application (an open-source tool) for interactive mesh retopology (“Instant Meshes”) developed for SIGGRAPH Asia 2015.
• It reads input 3D meshes, computes field-aligned quad meshes, and renders them interactively via a GUI.
File structure
• Top-level files: CMakeLists.txt (build), .travis.yml/.appveyor.yml (CI), README.md, LICENSE.txt.
• ext/ : third-party libraries (nanogui for the GUI, rply for PLY I/O, TBB for parallelism, pcg32 PRNG, etc.).
• src/ : core C++ modules grouped roughly by functionality:
• main.cpp, viewer.cpp/.h, widgets.cpp/.h, glutil.cpp/.h — application entry point, window + rendering, GUI widget wrappers, OpenGL utilities.
• meshio.cpp/.h, serializer.cpp/.h, gui_serializer.h — mesh file reading/writing and state persistence.
• adjacency.*, aabb.h, bvh.*, dedge.* — mesh data structures and acceleration structures.
• field.*, diff.cpp/.h, normal.cpp/.h — field computation modules (orientation, position fields, normals).
• extract.*, smoothcurve.*, subdivide.*, batch.cpp/.h — mesh processing pipeline steps (field to isolines, smoothing, subdivision).
• reorder.*, cleanup.* — post-processing and mesh cleanup.
• meshstats.* — mesh statistics and analysis utilities.
• hierarchy.* — multi-resolution or hierarchical processing support.
README for additional insights
• Confirms GUI workflow: “Open mesh” → solve orientation field → solve position field → export mesh.
• Mentions dependencies (X11 libs on Linux, Zenity), build instructions via CMake.
• Emphasizes interactive visualization, brushing tools, and advanced panels.
• Break the system into the six main components above.
• Blue for GUI,
• Green for Processing,
• Orange for Data Structures,
• Purple for External Libraries,
• Gray for Resources.