organicmaps/fast_obj
13
Fork 0
mirror of https://github.com/thisistherk/fast_obj.git synced 2025-04-04 13:05:02 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions
Fast C OBJ parser
82 commits 1 branch 4 tags 142 KiB
C++ 72%
C 27.3%
CMake 0.4%
Dockerfile 0.2%
Shell 0.1%
Find a file
Arseny Kapoulkine b827219dbf Mark materials that weren't loaded from mtllib as fallback 
This can happen when mtllib is absent, points to a non-existing file, or
material names are incorrect. In either case it helps the reader
differentiate between materials that are actually specified in the file,
even if their definition happens to match the default, from materials
that were never loaded in the first place.
2023-12-15 11:29:56 -08:00
test Merge all face/index arrays together 2019-06-11 07:35:30 -07:00
.gitignore Add .gitignore file 2019-05-19 09:51:43 +01:00
CMakeLists.txt Update CMake file so it can be used with FetchContent in other projects 2021-08-01 14:06:21 +01:00
fast_obj.c Add fast_obj.c to allow compilation as standalone library if required 2020-05-23 16:25:05 +01:00
fast_obj.h Mark materials that weren't loaded from mtllib as fallback 2023-12-15 11:29:56 -08:00
LICENSE Initial commit 2018-07-29 13:31:09 +01:00
README.md Attempt to clarify use of dummy entry in position/normal/texture coordinate arrays 2020-02-29 15:01:22 +00:00

README.md

fast_obj

Because the world needs another OBJ loader. Single header library, should compile without warnings in both C89 or C++. Much faster (5-10x) than other libraries tested.

To use:

 fastObjMesh* mesh = fast_obj_read("path/to/objfile.obj");

 ...do stuff with mesh...

 fast_obj_destroy(mesh);

Note that valid indices in the fastObjMesh::indices array start from 1. A dummy position, normal and texture coordinate are added to the corresponding fastObjMesh arrays at element 0 and then an index of 0 is used to indicate that attribute is not present at the vertex. This means that users can avoid the need to test for non-present data if required as the vertices will still reference a valid entry in the mesh arrays.

A simple test app is provided to compare speed against tinyobjloader and check output matches.