Meshfile is a simple C library for reading and writing 3D mesh file formats. It reads/writes:
- Indexed triangle meshes, multiple objects per file, with a number of optional pre-defined vertex attributes. No quads, n-gons, strips, or fans.
- Materials with a number of common pre-defined material attributes, each optionally combined with a texture map (filename/path).
- Optional transformation node hierarchy.
Animations are explicitly outside of the scope of this library.
Meshfile is very simple to use, and comes with two example programs:
- meshview: an OpenGL 3D model viewer
- meshconv: a converter between any of the supported 3D file formats
Here's a list of currently supported file formats, and any caveats for each one.
- Wavefront OBJ
- JTF (Just Triangle Faces): http://runtimeterror.com/tech/jtf
- GLTF (OpenGL Transmission Format): currently read-only
- 3DS (3D Studio)
- STL (Stereolithography): binary only
Project website: http://nuclear.mutantstargoat.com/sw/meshfile Github source code repo: https://github.com/jtsiomb/meshfile
You can find all the meshfile releases at the project website, and the github releases page:
You can also obtain the latest source code directly from the git repo:
git clone https://github.com/jtsiomb/meshfile.git
There are two ways to use meshfile:
- build and install it system-wide (
make && make install). Then just includemeshfile.hin your program and link with-lmeshfile. - drop the contents of
srcandincludedirectories into a subdir of your program and build it as part of your own build. It has no dependencies, so it should be as easy as just adding the list of.cfiles to your build.
Meshfile being released under the terms of the GNU LGPL, the second method is only possible if your program is free software.
Please note that before v1.0 is released, there is no guarantee for API/ABI stability.
Copyright (C) 2025 John Tsiombikas [email protected]
This program is free software. Feel free to run, modify and/or redistribute under the terms of the GNU Lesser General Public License v3, or at your option any later version published by the Free Software Foundation. See COPYING and COPYING.LESSER for details.
To build meshfile on UNIX, simply run make. The meshfile library has zero
dependencies other than libc. Run make install as root to install it under the
/usr/local prefix. You can change the prefix by editing the first line of the
Makefile.
There's also an example mesh viewer program as part of the meshfile
distribution. To build and install that change into meshview and run make
and make install again. For the meshview dependencies and build instructions,
refer to the meshview/README.md file.