Struct three_d::renderer::object::Imposters

pub struct Imposters { /* private fields */ }

A level-of-detail technique to replace rendering of high-poly meshes. Should only be used where details cannot be seen, for example when the objects are far away. A set of objects are rendered from different angles into a set of textures and the textures are then rendered continuously instead of the expensive objects.

Implementations

impl Imposters

pub fn new( context: &Context, positions: &[Vec3], objects: impl IntoIterator<Item = impl Object> + Clone, lights: &[&dyn Light], max_texture_size: u32 ) -> Self

Constructs a new Imposters and render the imposter texture from the given objects with the given lights. The imposters are placed at the given positions.

pub fn set_positions(&mut self, positions: &[Vec3])

Set the positions of the imposters.

pub fn update_texture( &mut self, objects: impl IntoIterator<Item = impl Object> + Clone, lights: &[&dyn Light], max_texture_size: u32 )

Render the imposter texture from the given objects with the given lights. Use this if you want to update the look of the imposters.

Methods from Deref<Target = Sprites>

pub fn transformation(&self) -> Mat4

Returns the local to world transformation applied to all sprites.

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

Set the local to world transformation applied to all sprites.

pub fn set_direction(&mut self, direction: Option<Vec3>)

Set a direction the sprite normals are always orthogonal to.

pub fn set_centers(&mut self, centers: &[Vec3])

Set the centers of the sprites. The centers also determines the number of sprites.

Trait Implementations

impl Deref for Imposters

type Target = Sprites

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Imposters

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl Geometry for Imposters

fn draw( &self, camera: &Camera, program: &Program, render_states: RenderStates, attributes: FragmentAttributes )

Draw this geometry.

fn vertex_shader_source( &self, required_attributes: FragmentAttributes ) -> String

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

fn id(&self, required_attributes: FragmentAttributes) -> u16

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, camera: &Camera, 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, camera: &Camera, 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.

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.

impl<'a> IntoIterator for &'a Imposters

type Item = &'a dyn Object

The type of the elements being iterated over.

type IntoIter = Once<&'a dyn Object>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl Object for Imposters

fn render(&self, camera: &Camera, lights: &[&dyn Light])

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

fn material_type(&self) -> MaterialType

Returns the type of material applied to this object.