Struct Mesh

pub struct Mesh { /* private fields */ }

A triangle mesh Geometry.

Implementations

impl Mesh

pub fn new(context: &Context, cpu_mesh: &CpuMesh) -> Self

Creates a new triangle mesh from the given CpuMesh. All data in the CpuMesh is transfered to the GPU, so make sure to remove all unnecessary data from the CpuMesh before calling this method.

pub fn transformation(&self) -> Mat4

Returns the local to world transformation applied to this mesh.

pub fn set_transformation(&mut self, transformation: Mat4)

Set the local to world transformation applied to this mesh. If any animation method is set using Self::set_animation, the transformation from that method is applied before this transformation.

pub fn set_animation( &mut self, animation: impl Fn(f32) -> Mat4 + Send + Sync + 'static, )

Specifies a function which takes a time parameter as input and returns a transformation that should be applied to this mesh at the given time. To actually animate this mesh, call Geometry::animate at each frame which in turn evaluates the animation function defined by this method. This transformation is applied first, then the local to world transformation defined by Self::set_transformation.

pub fn vertex_count(&self) -> u32

Returns the number of vertices in this mesh.

pub fn indices_mut(&mut self) -> &mut IndexBuffer

Used for editing the triangle indices. Note: Changing this will possibly ruin the mesh.

pub fn positions_mut(&mut self) -> &mut VertexBuffer<Vec3>

Used for editing the vertex positions. Note: Changing this will possibly ruin the mesh.

pub fn normals_mut(&mut self) -> &mut Option<VertexBuffer<Vec3>>

Used for editing the vertex normals. Note: Changing this will possibly ruin the mesh.

pub fn uvs_mut(&mut self) -> &mut Option<VertexBuffer<Vec2>>

Used for editing the vertex uvs. Note: Changing this will possibly ruin the mesh.

pub fn tangents_mut(&mut self) -> &mut Option<VertexBuffer<Vec4>>

Used for editing the vertex tangents. Note: Changing this will possibly ruin the mesh.

pub fn colors_mut(&mut self) -> &mut Option<VertexBuffer<Vec4>>

Used for editing the vertex colors. Note: Changing this will possibly ruin the mesh.

pub fn update_positions(&mut self, positions: &[Vector3<f32>])

👎Deprecated: use positions_mut instead

Updates the vertex positions of the mesh.

Panics

Panics if the number of positions does not match the number of vertices in the mesh.

pub fn update_normals(&mut self, normals: &[Vector3<f32>])

👎Deprecated: use normals_mut instead

Updates the vertex normals of the mesh.

Panics

Panics if the number of normals does not match the number of vertices in the mesh.

Trait Implementations

impl Geometry for Mesh

fn aabb(&self) -> AxisAlignedBoundingBox

Returns the AxisAlignedBoundingBox for this geometry in the global coordinate system.

fn animate(&mut self, time: f32)

For updating the animation of this geometry if it is animated, if not, this method does nothing. The time parameter should be some continious time, for example the time since start.

fn draw( &self, viewer: &dyn Viewer, program: &Program, render_states: RenderStates, )

Draw this geometry.

fn vertex_shader_source(&self) -> String

Returns the vertex shader source for this geometry given that the fragment shader needs the given vertex attributes.

fn id(&self) -> GeometryId

Returns a unique ID for each variation of the shader source returned from Geometry::vertex_shader_source.

fn render_with_material( &self, material: &dyn Material, viewer: &dyn Viewer, lights: &[&dyn Light], )

Render the geometry with the given Material. Must be called in the callback given as input to a RenderTarget, ColorTarget or DepthTarget write method. Use an empty array for the lights argument, if the material does not require lights to be rendered.

fn render_with_effect( &self, material: &dyn Effect, viewer: &dyn Viewer, lights: &[&dyn Light], color_texture: Option<ColorTexture<'_>>, depth_texture: Option<DepthTexture<'_>>, )

Render the geometry with the given Effect. Must be called in the callback given as input to a RenderTarget, ColorTarget or DepthTarget write method. Use an empty array for the lights argument, if the material does not require lights to be rendered.

impl<'a> IntoIterator for &'a Mesh

type Item = &'a dyn Geometry

The type of the elements being iterated over.

type IntoIter = Once<&'a dyn Geometry>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.