Polygon Mesh Processing Library
Loading...
Searching...
No Matches
Version 1.2 Released

Mar 15, 2020

We are proud to announce the release of version 1.2 of the Polygon Mesh Processing Library! This minor release includes a couple of new features, enhancements, bug fixes, and updates to third-party libraries. Highlights include:

  • Improved rendering of general polygons, avoiding erroneous tessellation into overlapping/flipped triangles in case of non-convex polygons.
  • Added support for rendering using matcaps.
  • Eigen interoperability: Matrix and vector classes can now be assigned and cast from Eigen matrices and vectors.
  • Matrix and vector classes can now be constructed using initializer lists.

You can find a full summary of changes in the changelog.

Matcap Rendering

The new matcap rendering is demonstrated in our mesh viewer application. mview now takes an optional -m argument specifying the matcap to be used. We included several example files in the pmp-data repository. See below for an example using the following command line:

./mview -m ../external/pmp-data/matcap/metal_shiny.jpg ../external/pmp-data/off/bunny.off
matcap

Improved Polygon Rendering

The improved polygon rendering is demonstrated best by an example. Before the improvements the rendering of a mesh containing non-convex polygons could lead to undesirable overlapping/flipped triangles:

before

The improved version now renders the same mesh correctly:

before

Eigen Interoperability

This release also improves interoperability with the Eigen library. We added support to construct/assign pmp::Matrix and pmp::Vector classes from Eigen as well as support to cast the pmp::Matrix and pmp::Vector class to Eigen. Example for construction:

// construction from Eigen
Eigen::Vector3d eigenVec(1.0, 2.0, 3.0);
pmp::dvec3 pmpVec = eigenVec;
Generic class for matrices.
Definition: mat_vec.h:27

Example for assignment:

// assignment from Eigen
Eigen::Vector3d eigenVec(1.0, 2.0, 3.0);
pmp::dvec3 pmpVec;
pmpVec = eigenVec;

Example for cast:

// cast to Eigen
pmp::vec3 pmpVec(1.0, 2.0, 3.0);
Eigen::Vector3f eigenVec = static_cast<Eigen::Vector3f>(pmpVec);

Obtaining the pmp-library

Get your own copy by cloning:

git clone --recursive https://github.com/pmp-library/pmp-library.git

Checkout the 1.2 release tag:

cd pmp-library && git checkout 1.2.0

Configure and build:

mkdir build && cd build && cmake .. && make

Run the mesh processing app

./mpview ../external/pmp-data/off/bunny.off

Reporting Bugs or Problems

If you encounter any glitches or problems please report the issue on our GitHub issue tracker.