Struct three_d::renderer::geometry::ParticleSystem

pub struct ParticleSystem {
    pub acceleration: Vec3,
    /* private fields */
}

Particle system that can be used to simulate effects such as fireworks, fire, smoke or water particles.

All particles are initialised with Particles::start_positions and Particles::start_velocities and a global ParticleSystem::acceleration. Then, when time passes, their position is updated based on

new_position = start_position + start_velocity * time + 0.5 * acceleration * time * time

The particles will only move if the ParticleSystem::animate is called every frame.

Fields

acceleration: Vec3

The acceleration applied to all particles defined in the world coordinate system.

Implementations

impl ParticleSystem

pub fn new( context: &Context, particles: &Particles, acceleration: Vec3, cpu_mesh: &CpuMesh ) -> Self

Creates a new particle system with the given geometry and the given attributes for each particle. The acceleration is applied to all particles defined in the world coordinate system.

pub fn transformation(&self) -> Mat4

Returns local to world transformation applied to the particle geometry before its position is updated as described in ParticleSystem.

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

Set the local to world transformation applied to the particle geometry before its position is updated as described in ParticleSystem.

pub fn set_particles(&mut self, particles: &Particles)

Set the particles attributes.

Trait Implementations

impl Geometry for ParticleSystem

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 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 draw( &self, camera: &Camera, program: &Program, render_states: RenderStates, attributes: FragmentAttributes )

Draw this geometry.

fn aabb(&self) -> AxisAlignedBoundingBox

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

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 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 ParticleSystem

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.