8 releases
0.2.3 | Sep 12, 2022 |
---|---|
0.2.2 | Mar 1, 2021 |
0.2.1 | Feb 24, 2021 |
0.1.3 | Dec 19, 2020 |
0.1.2 | Sep 11, 2020 |
#1616 in Parser implementations
543 downloads per month
26KB
498 lines
Wavefront
A Wavefront OBJ parser and utility crate.
[dependencies]
wavefront = "x.y.z"
Example
let model = wavefront::Obj::from_file("tests/ship.obj").unwrap();
for [a, b, c] in model.triangles() {
// No index lookup required: wavefront handles this for you!
println!("{:?} {:?} {:?}", a.position(), b.position(), c.position());
}
Features
-
Ergonomic API for parsing OBJs from files and readers.
-
Wrapper types that automatically perform indexing and hide the annoyances of the OBJ format if you just want to grab some triangles...
-
...but allows you to dip into the nitty-gritty details of OBJ if you want to do that too.
-
Correct handling of complex polygons.
-
No dependencies
Roadmap
-
Materials and the MTL support.
-
Object, group, polygon, vertex and vertex attribute insertion
-
Saving
-
Arbitrary geometry support.
Why not [alternative]?
wavefront
was born of a general feeling that the API of existing OBJ parsers
were either unnecessarily verbose or didn't properly handle the heirarchical
structure of the OBJ format. wavefront
aims to couple correct handling of the
format's features with a clean, terse API that allows you to jump straight to
the thing you want to do: rendering your model.
License
wavefront
is distributed under either of:
-
Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
-
MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at the disgression of the user.
Dependencies
~1MB
~13K SLoC