Struct easy_gltf::Model

pub struct Model { /* fields omitted */ }

Geometry to be rendered with the given material.

Examples

Classic rendering

In most cases you want to use triangles(), lines() and points() to get the geometry of the model.

match model.mode() {
  Mode::Triangles | Mode::TriangleFan | Mode::TriangleStrip => {
    let triangles = model.triangles().unwrap();
    // Render triangles...
  },
  Mode::Lines | Mode::LineLoop | Mode::LineStrip => {
    let lines = model.lines().unwrap();
    // Render lines...
  }
  Mode::Points => {
    let points = model.points().unwrap();
    // Render points...
  }
}

OpenGL style rendering

You will need the vertices and the indices if existing.

let vertices = model. vertices();
let indices = model.indices();
match model.mode() {
  Mode::Triangles => {
    if let Some(indices) = indices.as_ref() {
      // glDrawElements(GL_TRIANGLES, indices.len(), GL_UNSIGNED_INT, 0);
    } else {
      // glDrawArrays(GL_TRIANGLES, 0, vertices.len());
    }
  },
  // ...
}

Implementations

impl Model

pub fn material(&self) -> Arc<Material>

Material to apply to the whole model.

pub fn vertices(&self) -> &Vec<Vertex>

List of raw vertices of the model. You might have to use the indices to render the model.

Note: If you're not rendering with OpenGL you probably want to use triangles(), lines() or points() instead.

pub fn indices(&self) -> Option<&Vec<usize>>

Potential list of indices to render the model using raw vertices.

Note: If you're not rendering with OpenGL you probably want to use triangles(), lines() or points() instead.

pub fn mode(&self) -> Mode

The type of primitive to render. You have to check the mode to render the model correctly.

Then you can either use:

• vertices() and indices() to arrange the data yourself (useful for OpenGL).
• triangles() or lines() or points() according to the returned mode.

pub fn triangles(&self) -> Result<Vec<Triangle>, BadMode>

List of triangles ready to be rendered.

Note: This function will return an error if the mode isn't Triangles, TriangleFan or TriangleStrip.

pub fn lines(&self) -> Result<Vec<Line>, BadMode>

List of lines ready to be rendered.

Note: This function will return an error if the mode isn't Lines, LineLoop or LineStrip.

pub fn points(&self) -> Result<&Vec<Vertex>, BadMode>

List of points ready to be renderer.

Note: This function will return an error if the mode isn't Points.

pub fn has_normals(&self) -> bool

Indicate if the vertices contains normal information.

Note: If this function return false all vertices has a normal field initialized to zero.

pub fn has_tangents(&self) -> bool

Indicate if the vertices contains tangents information.

Note: If this function return false all vertices has a tangent field initialized to zero.

pub fn has_tex_coords(&self) -> bool

Indicate if the vertices contains texture coordinates information.

Note: If this function return false all vertices has a tex_coord field initialized to zero.

Trait Implementations

impl Clone for Model

pub fn clone(&self) -> Model

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Model

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

Formats the value using the given formatter.

impl Default for Model

pub fn default() -> Model

Returns the "default value" for a type.