Struct three_d::renderer::geometry::ParticleSystem

pub struct ParticleSystem {
    pub acceleration: Vec3,
    pub time: f32,
    /* 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::time variable is updated every frame.

Fields

acceleration: Vec3

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

time: f32

A time variable that should be updated each frame.

Implementations

impl ParticleSystem

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

Creates a new particle system with the given geometry and the given attributes for each particle.

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 texture_transform(&self) -> &Mat3

Get the texture transform applied to the uv coordinates of all of the particles.

pub fn set_texture_transform(&mut self, texture_transform: Mat3)

Set the texture transform applied to the uv coordinates of all of the particles. This is applied before the texture transform for each particle.

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

Set the particles attributes.

Trait Implementations

impl Geometry for ParticleSystem

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_post_material( &self, material: &dyn PostMaterial, camera: &Camera, lights: &[&dyn Light], color_texture: Option<ColorTexture<'_>>, depth_texture: Option<DepthTexture<'_>> )

Render the geometry with the given PostMaterial. 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 ParticleSystem

type Item = &'a (dyn Geometry + 'a)

The type of the elements being iterated over.

type IntoIter = Once<&'a (dyn Geometry + 'a)>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.