Struct Object

pub struct Object<'a> { /* private fields */ }

A named object in a Wavefront file.

Implementations

impl<'a> Object<'a>

pub fn name(&self) -> &str

Gets the name of the object.

Examples found in repository

examples/wavefront-lighthouse.rs (line 11)

fn main() {
    let wavefront = mash::load::wavefront::from_path("res/lighthouse.obj").unwrap();

    let pylon_obj = wavefront.objects().find(|o| o.name() == "pylon_rectangle").unwrap();
    let lights_obj = wavefront.objects().find(|o| o.name() == "rotating_lights_cylinder").unwrap();

    let pylon = Model::new(pylon_obj).unwrap();
    let lights = Model::new(lights_obj).unwrap();

    print_information("pylon", &pylon);
    print_information("lights", &lights);
}

examples/wavefront-texturing.rs (line 20)

fn main() {
    let wavefront = mash::load::wavefront::from_path("res/world.obj").unwrap();

    // Collect all doors from the model.
    let doors: Vec<_> = wavefront.objects().filter_map(|obj| {
        if obj.name().contains("door") {
            let ambient_color = {
                let material = obj.material().expect("object has no material");
                material.ambient_color()
            };

            Some(Door {
                ambient_color: ambient_color,
                name: obj.name().to_owned(),
                model: Model::new(obj).unwrap(),
            })
        } else {
            None
        }
    }).collect();

    for door in doors {
        println!("found door named '{}' with ambient color {:?} and {} triangles",
                 door.name, door.ambient_color, door.model.mesh.triangles().count());
    }
}

examples/wavefront-world.rs (line 15)

fn main() {
    // Load the shape into a wavefront-specific data structure.
    let world = load::wavefront::from_path("res/world.obj").unwrap();

    // Rather than converting the entire world into a single model, let's extract
    // every object labelled 'door'.
    let doors: Vec<Model> = world.objects().filter(|o| o.name().contains("door")).map(|object| {
        // Convert each object into its own mesh.
        Model::new(object).unwrap()
    }).collect();

    for door in doors {
        println!("door model: {:?}", door);
    }

    // We can also load the entire world into a single model if we wanted.
    let entire_world = Model::new(world).unwrap();

    // Skip every second triangle if that's your kind of thing.
    let half_triangles = entire_world.mesh.triangles().enumerate().filter(|&(idx,_)| idx%2 == 0).map(|(_,t)| t);
    let half_world: Model = Model { mesh: half_triangles.collect() };

    println!("half world: {:?}", half_world);
}

pub fn material(&self) -> Option<Material<'_>>

Gets the material associated with the object.

Examples found in repository

examples/wavefront-texturing.rs (line 22)

fn main() {
    let wavefront = mash::load::wavefront::from_path("res/world.obj").unwrap();

    // Collect all doors from the model.
    let doors: Vec<_> = wavefront.objects().filter_map(|obj| {
        if obj.name().contains("door") {
            let ambient_color = {
                let material = obj.material().expect("object has no material");
                material.ambient_color()
            };

            Some(Door {
                ambient_color: ambient_color,
                name: obj.name().to_owned(),
                model: Model::new(obj).unwrap(),
            })
        } else {
            None
        }
    }).collect();

    for door in doors {
        println!("found door named '{}' with ambient color {:?} and {} triangles",
                 door.name, door.ambient_color, door.model.mesh.triangles().count());
    }
}

Trait Implementations

impl<'a> BuildModel for Object<'a>

type Vertex = Vertex

The vertex type that we need to convert from.

fn build_model<V, I>(self) -> Result<Model<V, I>, Error>

where V: Vertex + From<Vertex>, I: Index,