Struct three_d::core::InstancedMesh[−][src]

pub struct InstancedMesh { /* fields omitted */ }

👎 Deprecated:

Use InstancedModel instead

Expand description

Similar to Mesh, except it is possible to render many instances of the same triangle mesh efficiently.

Implementations

[src]

impl InstancedMesh

[src]

pub fn new(
 context: &Context,
 transformations: &[Mat4 ],
 cpu_mesh: &CPUMesh
) -> ThreeDResult<Self>

Constructs a new InstancedMesh from the given CPUMesh. The mesh is rendered in as many instances as there are transformation matrices in the transformations parameter. Each instance is transformed with the given transformation before it is rendered. The transformations can be updated by the update_transformations function.

[src]

pub fn render(
 &self,
 render_states: RenderStates,
 program: &Program,
 camera_buffer: &UniformBuffer,
 viewport: Viewport
) -> ThreeDResult<()>

Render the instanced mesh with the given Program. Must be called in a render target render function, for example in the callback function of Screen::write.

Errors

Will return an error if the program requires a certain attribute and the instanced mesh does not have that attribute. For example if the program needs the normal to calculate lighting, but the mesh does not have per vertex normals, this function will return an error.

[src]

pub fn update_transformations(&mut self, transformations: &[Mat4 ])

Updates the transformations applied to each mesh instance before they are rendered. The mesh is rendered in as many instances as there are transformation matrices.

Methods from Deref<Target = Mesh>

[src]

pub fn transformation(&self) -> &Mat4

👎 Deprecated:

Use Model instead

Returns the local to world transformation of this mesh.

[src]

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

👎 Deprecated:

Use Model instead

Set the local to world transformation of this mesh.

[src]

pub fn render(
 &self,
 render_states: RenderStates,
 program: &Program,
 camera_buffer: &UniformBuffer,
 viewport: Viewport
) -> ThreeDResult<()>

👎 Deprecated:

Instead, use render_forward in Model or use Program and send attributes and uniforms self

Render the mesh with the given Program. Must be called in a render target render function, for example in the callback function of Screen::write.

Errors

Will return an error if the program requires a certain attribute and the mesh does not have that attribute data. For example if the program needs the normal to calculate lighting, but the mesh does not have per vertex normals, this function will return an error.

[src]