Struct ParticleSettings3D 

pub struct ParticleSettings3D {

    pub rate: f32,
    pub burst: usize,
    pub duration: f32,
    pub looping: bool,
    pub lifetime: (f32, f32),
    pub speed: (f32, f32),
    pub shape: ParticleShape3D,
    pub gravity: Vec3,
    pub drag: f32,
    pub size: (f32, f32),
    pub rotation: (f32, f32),
    pub size_over_life: ParticleCurve,
    pub color_over_life: ParticleGradient,
    pub texture: Option<Texture>,
    pub sheet: (u32, u32),
    pub blend: ParticleBlend3D,
    pub max_particles: usize,
    pub space: ParticleSpace3D,
    pub seed: u64,
}

Settings copied into an emitter. Change settings by creating a new emitter. All numeric inputs must be finite; ranges must be ordered and nonnegative (rotation may be negative). Invalid settings panic in ParticleEmitter3D::new.

use ponko::*;
let settings = ParticleSettings3D { rate: 40.0, blend: ParticleBlend3D::Additive, ..Default::default() };
let emitter = ParticleEmitter3D::new(settings);
assert_eq!(emitter.live_count(), 0);

Fields

rate: f32

Continuous particles per second. Zero emits only bursts.

burst: usize

Initial burst, emitted on the first frame (also for non-looping emitters).

duration: f32

Seconds of continuous emission before stopping or looping.

looping: bool

Repeat continuous emission after duration; initial burst does not repeat.

lifetime: (f32, f32)

Particle lifetime in seconds, minimum strictly positive.

speed: (f32, f32)

Initial speed in units per second.

shape: ParticleShape3D

Spawn shape in emitter coordinates.

gravity: Vec3

Acceleration in simulation coordinates.

drag: f32

Exponential velocity damping per second.

size: (f32, f32)

Initial billboard width and height in world units (before local scale).

rotation: (f32, f32)

Initial rotation around the billboard normal, in radians.

size_over_life: ParticleCurve

Size multiplier over normalized lifetime.

color_over_life: ParticleGradient

RGBA tint over normalized lifetime.

texture: Option<Texture>

Optional image; absent uses white.

sheet: (u32, u32)

Sprite sheet (columns, rows); frames advance row-major over lifetime.

blend: ParticleBlend3D

How billboards combine with the scene.

max_particles: usize

Hard live-particle limit. Storage is allocated when the emitter is made.

space: ParticleSpace3D

World or entity coordinates.

seed: u64

Independent RNG seed; equal seeds and frame steps give equal simulation.

Trait Implementations

impl Clone for ParticleSettings3D

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ParticleSettings3D

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ParticleSettings3D

fn default() -> Self

Returns the “default value” for a type.