rw802/trimesh2

C++ library and set of utilities for input, output, and basic manipulation of 3D triangle meshes

TriMesh2

A C++ library and set of utilities for input, output, and basic manipulation of 3D triangle meshes.

This is a fork of the TriMesh2 library (originally by Szymon Rusinkiewicz), which I use a lot in my other graphics projects. I like TriMesh2 because of the low setup costs required to do model loading and manipulation, as well as the robust and powerful implementation of model manipulation.

Getting started

• Download a prebuilt release of trimesh2 (coming soon!) or build the library yourself. The static library will be called trimesh.lib, the debug version is trimeshd.lib.
  • For Windows, Visual Studio CE 2015 and 2017 solutions are in the mscv folder. The built library will be placed in a folder named lib.(architecture).(visual studio version). For example, for a 64-bit Visual Studio 2017 build, it will be lib.win64.vs141.
  • For Linux, a makefile is provided
• In your own project, make sure you include the header include/TriMesh.h, and make sure the static library is in your build path. All Trimesh2 functions will be in the TriMesh namespace.
• For inspiration on how to use the library, check out the utilities in the utilsrc folder, or just start by loading a model : TriMesh* themesh = TriMesh::read(filename);

News

• mesh_view tool now builds in Win64 without external dependencies!

Info

Legacy:

• For the original TriMesh2 project, see the Trimesh2 homepage.
• Original MSVC 2012 project by Bengt Rosenberger.

Features:

• Support for reading/writing PLY, OFF, OBJ files. Read-only: 3DS, SM, RAY.
• Vec: a templated C++ class for constant-length vectors, with support for the usual arithmetic operations and XForm: a class for rigid-body transformations.
• An OpenGL trackball/arcball implementation, with automatic selection of rotation center.
• Algorithms for subdivision, smoothing, curvature estimation, triangle stripping, and various other simple mesh manipulations.

The following utility programs are included:

• mesh_view: A simple 3D mesh viewer
• mesh_make: Create arbitrarily-tessellated meshes of various simple shapes
• mesh_filter: Applies a variety of simple transformations to a mesh, such as converting formats, flipping faces, subdivision, smoothing, rigid-body transformations, etc.
• mesh_cc: List and/or extract connected components from a mesh
• mesh_cat: Combine several meshes into a single file
• mesh_align: Align 2 meshes using ICP
• mesh_shade: A few procedural shaders for adding per-vertex color
• mesh_check: Check for some kinds of topological oddities (e.g., more than 2 faces at an edge) in a mesh file.
• mesh_crunch: Quick-n-dirty mesh decimation using the Rossignac-Borrel method of vertex collapse
• mesh_info: Print out some information about a mesh
• xf: Create or compose transformations in .xf files

Fork Details

The original TriMesh2 project was very Linux/GCC-oriented, and only had limited Win32 support. The primary aim of this fork is to provide a stable MSVC solution, for both x86 and x64 targets. For several tools, TriMesh2 depends on a custom-cherrypicked freeglut version - dragging this kicking and screaming into the new century is also part of the challenge.

Notable changes/additions to vanilla trimesh2

• Fixes for MSVC 12.0 / 14.0 compilation
• MSVC project for Visual Studio 2013 professional
• MSVC project for Visual Studio Community Edition 2015
• Fixes for OpenMP compilation in VS 2015
• Fixes for FreeGlut / Gluit compilation in VS 2015
• Added (experimental) 64-bit MSVC compilation support

For todo/planned features, see todo.txt.