Skip to content

Libigl version tracking

Summary Table
VersionShort description
2.0.0Lighter, simpler CMake build, rewritten history
1.3.3Switched the build system from submodules to CMake external projects.
1.3.2After merging PRs in the 2018 hackaton
1.3.1Before merging PRs in the 2018 hackaton
1.3.0Modernized cmake build, multi-mesh viewer, replace nanogui with imgui
1.2.1Reorganization opengl-dependent functions: opengl and opengl2 extras
1.2.0Reorganization of “extras”, rm deprecated funcs, absorb boost & svd3x3
1.1.7Switch build for static library to cmake.
1.1.6Major boolean robustness fix, drop CGAL dependency for AABB/distances
1.1.5Bug fix in booleans
1.1.4Edge collapsing and linear program solving
1.1.3Bug fixes in active set and boundary_conditions
1.1.1PLY file format support
1.1.0Mesh boolean operations using CGAL and cork, implementing [Attene 14]
1.0.3Bone heat method
1.0.2Bug fix in winding number code
1.0.1Bug fixes and more CGAL support
1.0.0Major beta release: many renames, tutorial, triangle, org. build
0.4.6Generalized Winding Numbers
0.4.5CGAL extra: mesh selfintersection
0.4.4STL file format support
0.4.3ARAP implementation
0.4.1Migrated much of the FAST code including extra for Sifakis’ 3x3 svd
0.4.0Release under MPL2 license
0.3.7Embree2.0 support
0.3.6boost extra, patches, mosek 7 support, libiglbbw (mosek optional)
0.3.5More examples, naive primitive sorting
0.3.3Many more examples, ambient occlusion with Embree.
0.3.1Linearly dependent constraints in min_quad_with_fixed, SparseQR buggy
0.3.0Better active set method support
0.2.3More explicits, active set method, opengl/anttweakbar guards
0.2.2More explicit instantiations, faster sorts and uniques
0.2.1Bug fixes in barycenter and doublearea found by Martin Bisson
0.2.0XML serializer more stable and fixed bug in remove_duplicate_vertices
0.1.8Embree and xml (windows only) extras
0.1.5Compilation on windows, bug fix for compilation with cygwin
0.1.1Alpha release with core functions, extras, examples

Upcoming Changes

  • Fixed an issue with transparent window on macOS that was introduced in v2.0.0 (#953)
  • New Heat Geodesics feature (#988)
  • Fixed current python bindings (#1008)
  • Switched from Google Test to Catch2 (#961), and added various unit tests
  • Updated dependencies: Embree 3 (#947), GLFW (#977), ImGui (#1039)
  • Removed LIM tutorial (#1014, #1012)
  • Extended boundary_facets with outputs revealing which element facet comes from (#1067)
  • Various code cleanup and compilation fixes

Version 2.0.0 Changes

This release is a result of the 2018 libigl hackathon at NYU. The major changes are:

The major upshot is that the old git clone --recursive that resulted in a 1.8GB libigl/ directory is now a git clone that results in 16.5MB, more than a 100x reduction in size.

Name changes:

Old New
igl::components igl::vertex_components
igl::slice_tets igl::marching_tets

Version 1.3.2 Changes

  • First version after all pull requests were merged during the libigl hackaton, and before switching from submodules to CMake external projects.

Version 1.3.1 Changes

  • Last version before pull requests were merged during the libigl hackaton.
  • igl::components has been renamed to igl::vertex_components.
  • viewer.core.model matrix is gone (#700).

Version 1.3.0 Changes

List of changes related to this version:

  • The CMake build system has been rewritten to be more modular and modern. libigl modules are now available as CMake target, e.g. igl::triangle or igl::opengl. See the libigl-example-project for an example of typical usage.

  • igl/antweakbar and igl/opengl2 support has been removed from the CMake. The files are still available, but their use is discouraged.

  • The viewer has been refactored and now supports multiple meshes. See related tutorial entry for more information. The viewer files are now split according to their dependencies. E.g. igl::viewer::Viewer has been renamed igl::opengl::glfw::Viewer.

  • NanoGui has been replaced by ImGui, and is now available as a viewer plugin instead of #define

  • Polyvector code has been moved to libdirectional (#630).

Version 1.2 Changes

This change introduces better organization of dependencies and removes some deprecated/repeated functions. The 3x3 svd code and dependent functions (including ARAP) were absorbed into the main library. Similarly, the boost dependency extra was absorbed.

External libraries as git subrepos

The core functionality of libigl (still) just depends on stl, c++11 and Eigen. There are additional optional dependencies (e.g. CGAL, embree, glfw, tetgen, triangle). Libigl functions using these are located (still) in sub-folders of the include directory (e.g. include/igl/cgal/, include/igl/embree/). Prior to version 1.2 we included copies of the code for some of these dependencies in the external/ directory. As of version 1.2, these have been replaced with git sub-repos. If you have cloned libigl before version 1.2 then you should issue

git submodule update --init --recursive

Deprecated/repeated functions

Old New
igl::angles igl::internal_angles
igl::get_modifiers [deleted]
igl::nchoosek(offset,K,N,std::vector) igl::nchoosek(Eigen,K,Eigen)
#include <igl/boost/components.h> #include <igl/components.h>
#include <igl/boost/bfs_orient.h> #include <igl/bfs_orient.h>
#include <igl/boost/orientable_patches.h> #include <igl/orientable_patches.h>
#include <igl/svd3x3/arap.h> #include <igl/arap.h>
#include <igl/svd3x3/arap_dof.h> #include <igl/arap_dof.h>
#include <igl/svd3x3/fit_rotations.h> #include <igl/fit_rotations.h>
#include <igl/svd3x3/polar_svd3x3.h> #include <igl/polar_svd3x3.h>
#include <igl/svd3x3/svd3x3.h> #include <igl/svd3x3.h>
#include <igl/svd3x3/svd3x3_avx.h> #include <igl/svd3x3_avx.h>
#include <igl/svd3x3/svd3x3_sse.h> #include <igl/svd3x3_sse.h>

Version 1.0 Changes

Our beta release marks our confidence that this library can be used outside of casual experimenting. To maintain order, we have made a few changes which current users should read and adapt their code accordingly.

Renamed functions

The following table lists functions which have changed name as of version 1.0.0:

Old New
igl::add_barycenter igl::false_barycentric_subdivision
igl::areamatrix igl::vector_area_matrix
igl::barycentric2global igl::barycentric_to_global
igl::boundary_faces igl::boundary_facets
igl::boundary_vertices_sorted igl::boundary_loop
igl::cotangent igl::cotmatrix_entries
igl::edgetopology igl::edge_topology
igl::gradMat igl::grad
igl::is_manifold igl::is_edge_manifold
igl::mexStream igl::MexStream
igl::moveFV igl::average_onto_vertices
igl::moveVF igl::average_onto_faces
igl::plot_vector igl::print_vector
igl::pos igl::HalfEdgeIterator
igl::plane_project igl::project_isometrically_to_plane
igl::project_points_mesh igl::line_mesh_intersection
igl::read igl::read_triangle_mesh
igl::removeDuplicates.cpp igl::remove_duplicates
igl::removeUnreferenced igl::remove_unreferenced
igl::tt igl::triangle_triangle_adjacency
igl::vf igl::vertex_triangle_adjacency
igl::write igl::write_triangle_mesh
igl::manifold_patches igl::orientable_patches
igl::selfintersect igl::remesh_self_intersections
igl::project_mesh igl::line_mesh_intersection
igl::triangulate igl::polygon_mesh_to_triangle_mesh
igl::is_manifold igl::is_edge_manifold
igl::triangle_wrapper igl::triangulate

Miscellaneous

  • To match interfaces provided by (all) other quadratic optimization libraries, igl::min_quad_with_fixed and igl::active_set now expect as input twice the quadratic coefficients matrix, i.e. the Hessian. For example, igl::min_quad_with_fixed(H,B,...) minimizes \frac{1}{2}x^T H x+x^T B.
  • We have inverted the IGL_HEADER_ONLY macro to IGL_STATIC_LIBRARY. To compile using libigl as a header-only library, simply include headers and libigl in the header search path. To link to libigl, you must define the IGL_STATIC_LIBRARY macro at compile time and link to the libigl*.a libraries.
  • Building libigl as a static library is now more organized. There is a build/ directory with Makefiles for the main library (Makefile) and each dependency (e.g. Makefile_mosek for libiglmosek.a)
  • igl::polar_svd now always returns a rotation in R, never a reflection. This mirrors the behavior of igl::polar_svd3x3. Consequently the T part may have negative skews.
  • We have organized the static library build
  • The previous igl::grad function, which computed the per-triangle gradient of a per-vertex scalar function has been replaced. Now igl::grad computes the linear operator (previous computed using igl::gradMat). The gradient values can still be recovered by multiplying the operator against the scalar field as a vector and reshaping to have gradients per row.
  • MASSMATRIX_* has become MASSMATRIX_TYPE_*
  • The function igl::project_normals, which cast a line for each vertex of mesh A in the normal direction and found the closest intersection along these lines with mesh B, has been removed.