Polygon Mesh Processing Library
Loading...
Searching...
No Matches
Introduction

build Coverage Status Latest Release DOI

The Polygon Mesh Processing Library is a modern C++ open-source library for processing and visualizing polygon surface meshes. Its main features are:

  • An efficient and easy-to-use mesh data structure
  • Standard algorithms such as decimation, remeshing, subdivision, or smoothing
  • Ready-to-use visualization tools
  • Seamless cross-compilation to JavaScript (demo)

Get Started

Clone the repository:

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

Configure and build:

cd pmp-library && mkdir build && cd build && cmake .. && make

Run the mesh processing app:

./mpview ../data/off/bunny.off

Build your own tool:

#include <pmp/surface_mesh.h>
#include <pmp/io/io.h>
int main()
{
pmp::SurfaceMesh mesh;
pmp::read(mesh,"input.obj");
// .. do awesome things with your mesh
pmp::write(mesh,"output.obj");
}
pmp::SurfaceMesh
A class for representing polygon surface meshes.
Definition: surface_mesh.h:200
pmp::read
void read(SurfaceMesh &mesh, const std::filesystem::path &file)
Read into mesh from file.
Definition: io.cpp:17
pmp::write
void write(const SurfaceMesh &mesh, const std::filesystem::path &file, const IOFlags &flags)
Write mesh to file controlled by flags.
Definition: io.cpp:38

Read the Docs

The user guide contains all you need to get started using PMP, including a tutorial covering mesh processing basics.

Contribute

Contributions to PMP are welcome! There are many ways you can help: Report any issues you find, help to improve the documentation, join our discussions forum, or contribute new code.

Acknowledge

If you are using PMP for research projects, please acknowledge its use by referencing

@software{pmp23,
author = {Sieger, Daniel and Botsch, Mario},
title = {{The Polygon Mesh Processing Library}},
year = {2023},
month = aug,
version = {3.0.0},
doi = {10.5281/zenodo.10866532},
url = {https://github.com/pmp-library/pmp-library}
}

We acknowledge that PMP evolved from our previous work on Surface_mesh and OpenMesh.

License

PMP is provided under a simple and flexible MIT-style license allowing for both open-source and commercial usage.