Struct wavefront::Obj

pub struct Obj { /* fields omitted */ }

A struct representing the contents of a parsed OBJ file.

Implementations

impl Obj

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self, Error>

Read an OBJ from a file.

pub fn from_reader<R: Read>(reader: R) -> Result<Self, Error>

Read an OBJ from a reader (something implementing std::io::Read).

pub fn from_lines<I: Iterator<Item = L>, L: AsRef<str>>(
    lines: I
) -> Result<Self, Error>

Read an OBJ from an iterator over its lines.

pub fn positions(&self) -> &[[f32; 3]]

Returns a reference to the position attributes contained within this Obj.

pub fn uvs(&self) -> &[[f32; 3]]

Returns a reference to the texture coordinate attributes contained within this Obj.

pub fn normals(&self) -> &[[f32; 3]]

Returns a reference to the normal attributes contained within this Obj.

pub fn object(&self, name: &str) -> Option<Object<'_>>

Returns a specific Object by name.

Note that if a name is not specified in the OBJ file, the name defaults to an empty string.

pub fn objects(
    &self
) -> impl ExactSizeIterator<Item = (&String, Object<'_>)> + Clone + '_

Returns an iterator over the Objects in this Obj.

pub fn groups(&self) -> impl Iterator<Item = (&String, Group<'_>)> + Clone + '_

Returns an iterator over the Groups in this Obj.

pub fn polygons(&self) -> impl Iterator<Item = Polygon<'_>> + Clone + '_

Returns an iterator over the Polygons in this Obj.

pub fn triangles(&self) -> impl Iterator<Item = [Vertex<'_>; 3]> + Clone + '_

Returns an iterator over the triangles in this Obj.

See Polygon::triangles for more information.

Trait Implementations

impl Clone for Obj

fn clone(&self) -> Obj

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Obj

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.