Struct three_d::renderer::geometry::Particles

pub struct Particles {
    pub acceleration: Vec3,
    pub time: f32,
    /* private fields */
}

Particle effect that can be rendered with any material.

Each particle is initialised with a position and velocity using the update function and a global acceleration. Then when time passes, their position is updated based on new_position = start_position + start_velocity * time + 0.5 * acceleration * time * time

Fields

acceleration: Vec3

The acceleration applied to all particles. Default is gravity.

time: f32

A time variable that should be updated each frame.

Implementations

impl Particles

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

Creates a new set of particles with geometry defined by the given cpu mesh.

pub fn transformation(&self) -> Mat4

Returns the local to world transformation applied to all particles.

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

Set the local to world transformation applied to all particles.

pub fn update(&mut self, data: &[ParticleData]) -> ThreeDResult<()>

Updates the particles with the given initial data. The list contain one entry for each particle.

Trait Implementations

impl Geometry for Particles

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]
) -> ThreeDResult<()>

Render the geometry with the given material. Must be called in a render target render function, for example in the callback function of Screen::write. You can use an empty array for the lights argument, if you know the object does not require lights to be rendered.