Struct MetaballEntity 

pub struct MetaballEntity {
    pub sources: Vec<FieldSource>,
    pub threshold: f32,
    pub hp_ratio: f32,
    pub grid_resolution: u32,
    pub breath_phase: f32,
    pub breath_frequency: f32,
    pub center: Vec3,
    pub rotation: Vec3,
    pub scale: f32,
    pub bounds_half: Vec3,
    pub dirty: bool,
    pub name: String,
}

An entity defined by a scalar field from metaball sources.

The visible body is the isosurface at threshold. HP modulates all source strengths, so damage physically reshapes the body. Crits destroy individual sources, punching permanent holes.

Fields

sources: Vec<FieldSource>

All field sources making up this entity.

threshold: f32

Isosurface threshold. Surface exists where field(p) >= threshold.

hp_ratio: f32

Current HP ratio (0.0 = dead, 1.0 = full HP).

grid_resolution: u32

Grid resolution for marching cubes extraction. 32 for normal entities, 64 for bosses.

breath_phase: f32

Current breathing animation phase.

breath_frequency: f32

Breathing animation frequency (Hz).

center: Vec3

Entity center in world space.

rotation: Vec3

Entity rotation (euler angles for simplicity).

scale: f32

Entity scale.

bounds_half: Vec3

Bounding box half-extents (auto-computed from sources).

dirty: bool

Whether the mesh needs re-extraction this frame.

name: String

Name for debugging.

Implementations

impl MetaballEntity

pub fn new(threshold: f32, resolution: u32) -> Self

pub fn with_name(self, name: impl Into<String>) -> Self

pub fn add_source(&mut self, source: FieldSource) -> usize

Add a field source.

pub fn nearest_source(&self, point: Vec3) -> Option<usize>

Find the source nearest to a world-space point.

pub fn find_source(&self, tag: &str) -> Option<usize>

Find a source by tag.

pub fn update(&mut self, dt: f32, time: f32)

Update the entity for a new frame.

• Advances breathing animation
• Updates source positions from breathing offsets
• Decays damage reductions (spring-back)
• Marks as dirty if anything changed

pub fn evaluate(&self, point: Vec3) -> f32

Evaluate the scalar field at a world-space point.

pub fn evaluate_full(&self, point: Vec3) -> (f32, Vec4, f32)

Evaluate the scalar field and compute color/emission at a point.

pub fn gradient(&self, point: Vec3) -> Vec3

Compute the gradient (normal direction) at a point via central differences.

pub fn normal_at(&self, point: Vec3) -> Vec3

Normal at a point on the isosurface (normalized gradient, pointing outward).

pub fn set_hp(&mut self, ratio: f32)

Set HP ratio. Marks dirty.

pub fn set_center(&mut self, center: Vec3)

Move the entity center. Updates all source positions.

pub fn recompute_bounds(&mut self)

Recompute bounding box from source positions and radii.

pub fn bounds(&self) -> (Vec3, Vec3)

World-space bounding box (min, max).

pub fn active_source_count(&self) -> usize

Number of active (non-destroyed) sources.

pub fn source_count(&self) -> usize

Total active source count.

pub fn is_dead(&self) -> bool

Whether the entity is effectively dead (no visible surface).

pub fn take_dirty(&mut self) -> bool

Consume the dirty flag.

Trait Implementations

impl Clone for MetaballEntity

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 MetaballEntity

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

Formats the value using the given formatter.

impl Default for MetaballEntity

fn default() -> Self

Returns the “default value” for a type.