Struct FieldManager 

pub struct FieldManager {
    pub blend_mode: FieldBlend,
    pub global_scale: f32,
    /* private fields */
}

Manages all active force fields in a scene.

Fields

blend_mode: FieldBlend

global_scale: f32

Global force multiplier applied to all fields.

Implementations

impl FieldManager

pub fn new() -> Self

pub fn add(&mut self, field: ForceField) -> FieldId

Add a permanent force field. Returns its ID.

pub fn add_timed(&mut self, field: ForceField, ttl: f32) -> FieldId

Add a field with a time-to-live in seconds. Returns its ID.

pub fn add_faded( &mut self, field: ForceField, ttl: f32, fade_in: f32, fade_out: f32, ) -> FieldId

Add a field with a TTL and optional fade in/out durations.

pub fn add_tagged( &mut self, field: ForceField, ttl: Option<f32>, tags: Vec<String>, ) -> FieldId

Add a tagged field.

pub fn remove(&mut self, id: FieldId) -> bool

Remove a field by ID. Returns true if removed.

pub fn remove_tagged(&mut self, tag: &str)

Remove all fields with a specific tag.

pub fn clear(&mut self)

Remove all fields.

pub fn get(&self, id: FieldId) -> Option<&ManagedField>

Get a reference to a field by ID.

pub fn get_mut(&mut self, id: FieldId) -> Option<&mut ManagedField>

Get a mutable reference to a field by ID.

pub fn tick(&mut self, dt: f32)

Advance all fields by dt seconds and prune expired ones.

pub fn sample(&self, pos: Vec3, mass: f32, charge: f32, t: f32) -> FieldSample

Sample all field effects at a world position.

pub fn sample_tagged( &self, pos: Vec3, tag: &str, mass: f32, charge: f32, t: f32, ) -> FieldSample

Sample only fields with a specific tag.

pub fn force_at(&self, pos: Vec3, mass: f32, charge: f32, t: f32) -> Vec3

Returns the pure force vector at a position (no temperature/entropy).

pub fn fields_near(&self, pos: Vec3, radius: f32) -> Vec<FieldId>

Returns all field IDs whose bounding region overlaps pos within radius.

pub fn len(&self) -> usize

Number of active fields.

pub fn is_empty(&self) -> bool

True if no fields are active.

pub fn iter(&self) -> impl Iterator<Item = &ManagedField>

Iterator over all active managed fields.

pub fn interference_at(&self, pos: Vec3, t: f32) -> f32

Compute field interference pattern at pos — how fields amplify/cancel each other. Returns a scalar in [-1, 1] representing constructive (+) or destructive (-) interference.

pub fn resonance_at(&self, pos: Vec3, t: f32) -> f32

Resonance score at pos — how much fields oscillate in phase. Uses the variance of field force magnitudes.

Trait Implementations

impl Default for FieldManager

fn default() -> Self

Returns the “default value” for a type.