Parses .off (Object File Format) files.
This implementation follows this spec from the Princeton Shape Benchmark.
Sample .off file:
# this file header has to be the first instruction
OFF
# cube.off
# A cube
# 8 vertices, 6 faces, 12 edges
8 6 12
# vetex coordinates: x, y, z
1.632993 0.000000 1.154701
0.000000 1.632993 1.154701
-1.632993 0.000000 1.154701
0.000000 -1.632993 1.154701
1.632993 0.000000 -1.154701
0.000000 1.632993 -1.154701
-1.632993 0.000000 -1.154701
0.000000 -1.632993 -1.154701
# face indicies & RGBA color data: n, v1, v2, v3, v4, r, g, b, a
4 0 1 2 3 1.000 0.000 0.000 0.75
4 7 4 0 3 0.300 0.400 0.000 0.75
4 4 5 1 0 0.200 0.500 0.100 0.75
4 5 6 2 1 0.100 0.600 0.200 0.75
4 3 2 6 7 0.000 0.700 0.300 0.75
4 6 5 4 7 0.000 1.000 0.000 0.75
This cube.off file is parsed using off-rs in this example.
let off_string = r#"
OFF
3 1
1.0 0.0 0.0
0.0 1.0 0.0
0.0 0.0 1.0
3 0 1 2 255 0 0 # red
"#;
let mesh = off_rs::parse(
off_string,
Default::default() // optional ParserOptions
);
println!("{:#?}", mesh);Will return a structure like this:
Mesh { vertices: [ Vertex { position: Position { x: 1.0, y: 0.0, z: 0.0, }, color: None, }, ... faces: [ Face { vertices: [ 0, 1, 2, 3, ], color: Some( Color { red: 1.0, green: 0.0, blue: 0.0, alpha: 1.0, }, ), }, ...