Type structure

[Hyeon Kim (김지현)]

Goals

• Ease of use
• Beauty
• SIMD aware

Low-level API

Low-level API provides one-to-one correspondent rust binding of obj format.

Obj
name ← String
required mtl files ← Vec

vertices ← Vec
texture coordinates ← Vec
normals ← Vec
parametric vertices ← Vec

points ← Vec
lines ← Vec
polygons ← Vec

groups ← HashMap<String, Group>
meshes ← HashMap<String, Group>
smoothing_groups ← VecMap
merging_groups ← VecMap

Other types

Point ← index of vertex

Line ← [(index of vertex); 2]
Line ← [(index of vertex, index of texture coordinate); 2]

Polygon ← Vec
Polygon ← Vec<(index of vertex, index of texture coordinate)>
Polygon ← Vec<(index of vertex, index of normal)>
Polygon ← Vec<(index of vertex, index of texture coordinate, index of normal)>

Group
points ← Vec
lines ← Vec
polygon ← Vec

Range
start ← uint
end ← uint

Current version of Rust doesn't support non-power-of-2 simd type

High-level API

High-level API wraps low-level API and makes it easy to interoperate with OpenGL. It triangulates polygons, normalizes indices, etc.