Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/meshinspector/meshlib

Mesh processing library
https://github.com/meshinspector/meshlib

3d cpp cross-platform distance-map geometry library mesh mesh-analysis mesh-boolean mesh-decimation mesh-processing mesh-registration mesh-segmentation mesh-smoothing point-cloud pointcloud pointcloud-triangulation python voxel voxel-segmentation

Last synced: 6 days ago
JSON representation

Mesh processing library

Awesome Lists containing this project

README

        

[![build-test-distribute](https://github.com/MeshInspector/MeshLib/actions/workflows/build-test-distribute.yml/badge.svg?branch=master)](https://github.com/MeshInspector/MeshLib/actions/workflows/build-test-distribute.yml?branch=master)
[![PyPI version](https://badge.fury.io/py/meshlib.svg)](https://badge.fury.io/py/meshlib)
[![Python](https://img.shields.io/pypi/pyversions/meshlib.svg?style=plastic)](https://badge.fury.io/py/meshlib)
[![Downloads](https://pepy.tech/badge/meshlib/month?style=flat-square)](https://pepy.tech/project/meshlib)



Shows a black logo in light color mode and a white one in dark color mode.

# **Welcome to MeshLib SDK**

The MeshLib SDK is an open-source, cross-platform library designed for efficient 3D geometry processing. MeshLib supports C++, Python, C, and C#, making it easy to integrate into your projects. It’s a versatile tool for industries such as medical devices, 3D printing, scanning, inspection, automation, robotics, and scientific visualization. With robust performance and accuracy, MeshLib excels at handling large datasets, including those used in AI and medical imaging. The repository is packed with clear code examples to help you start quickly and explore advanced features with ease.

## **The MeshLib Vision**

Our vision at MeshLib is to empower developers to quickly build practical and impactful 3D applications. Designed with simplicity and performance in mind, MeshLib provides a comprehensive set of tools and algorithms for processing 3D data. It supports essential data structures like point clouds, meshes, and volumes, commonly generated by modern sensors. MeshLib's robust half-edge data structure for mesh representation ensures manifold compliance, making it well-suited for real-world applications and helping developers bring their ideas to life more efficiently.

## **Key Features**

- File I/O: Supports meshes, voxels, and point clouds for creation, modification, and conversion.
- 3D Boolean: Fast, highly optimized mesh and voxel-based approaches.
- Mesh Repair: Includes removing self-intersections, filling holes, and component separation.
- Simplification & Subdivision: Optimize mesh complexity with decimation, remeshing, and subdivision.
- Offsets: Multiple modes for precise surface thickness control, ideal for 3D printing and machining.
- Triangulation: Accurate, fast conversion of point clouds to meshes with normal creation.
- ICP: Precise mesh alignment using point-to-point and point-to-plane transformations.
- Segmentation: Semi-automatic segmentation based on curvature for meshes and voxels.
- Deformations: Supports Laplacian, freeform, and relax smoothing for fine mesh adjustments.
- Distance Maps & Polylines: Generate distance maps, iso-lines, and perform projection and intersection.

Features illustration is available in [the features section](https://meshlib.io/features/) or in the sections of this documentation.

## Try MeshLib Easily with MeshInspector

[MeshInspector](https://meshinspector.com/) is a cross-platform application built on MeshLib that allows users to trial MeshLib’s algorithms directly. It exposes most of MeshLib's core algorithms in an intuitive interface, providing a hands-on way to evaluate MeshLib’s performance on various operations. For a closer look at MeshInspector’s features and performance, check out our [YouTube channel](https://www.youtube.com/@meshinspector) with videos demonstrating its capabilities.

**Note:** While MeshInspector includes many of MeshLib’s algorithms, it was designed with specific end-user scenarios in mind. MeshLib itself offers far greater customization and flexibility, allowing you to tailor its algorithms precisely to your unique needs.

## **Getting Started with MeshLib**

For Python users, install via pip:

```bash
pip install meshlib
```

For C++, C and C# integration, see the [Installation Guide](https://meshlib.io/documentation/InstallationGuide.html).

Explore [MeshLib's tutorials](https://meshlib.io/documentation/Tutorials.html) and [code samples](https://meshlib.io/documentation/Examples.html) to get started quickly and master advanced features.

## **License**

MeshLib offers [Non-Commercial Free License](https://github.com/MeshInspector/MeshLib?tab=License-1-ov-file#readme) with a Commercial License Requirement.
See details on [MeshLib license page](https://meshlib.io/license/).

## Reporting Issues

If you encounter an issue or have a bug to report, please use our [GitHub Issues Form](https://github.com/MeshInspector/MeshLib/issues/) to submit it. This ensures we can track and address problems efficiently.

Join the community discussions on our [GitHub Discussions page](https://github.com/MeshInspector/MeshLib/discussions) to connect with other developers, share ideas, and stay updated on the latest MeshLib developments.