File: README.md

package info (click to toggle)
fastobj 1.2%2Bgit20230610.1a80602-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 204 kB
  • sloc: cpp: 2,152; ansic: 1,087; makefile: 9
file content (24 lines) | stat: -rw-r--r-- 891 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 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](https://github.com/syoyo/tinyobjloader) and
check output matches.