Struct LayeredEntity 

pub struct LayeredEntity {

    pub density_layer: Option<DensityEntity>,
    pub metaball_opacity: f32,
    pub metaball_emission: f32,
    pub curve_layer: Option<CurveEntity>,
    pub glyph_layer: Vec<Glyph3DInstance>,
    pub position: Vec3,
    pub hp: f32,
    pub max_hp: f32,
    pub layer_visibility: LayerVisibility,
    pub dissolution: DissolutionState,
    pub alive: bool,
    pub name: String,
    pub id: u32,
    pub time: f32,
    pub base_color: Vec4,
}

A multi-layered entity with four visual systems that peel away as HP drops.

Fields

density_layer: Option<DensityEntity>

Layer 4 (outermost): particle density aura.

metaball_opacity: f32

Layer 3: metaball/isosurface primary form. (Stored as opacity + emission parameters; actual metaball rendering would use the metaball module when the GPU pipeline supports it.)

metaball_emission: f32

curve_layer: Option<CurveEntity>

Layer 2: mathematical curve skeleton.

glyph_layer: Vec<Glyph3DInstance>

Layer 1 (innermost): identity glyph markers.

position: Vec3

World position.

hp: f32

Current HP.

max_hp: f32

Maximum HP.

layer_visibility: LayerVisibility

Computed layer visibility.

dissolution: DissolutionState

Death dissolution state.

alive: bool

Whether the entity is alive.

name: String

Entity name.

id: u32

Unique ID.

time: f32

Accumulated time.

base_color: Vec4

Base color (propagated to all layers).

Implementations

impl LayeredEntity

pub fn new(name: &str, position: Vec3, max_hp: f32) -> Self

pub fn with_density(self, density: DensityEntity) -> Self

Set the density (particle cloud) layer.

pub fn with_curves(self, curves: CurveEntity) -> Self

Set the curve (mathematical skeleton) layer.

pub fn with_glyph(self, glyph: Glyph3DInstance) -> Self

Add a glyph identity marker.

pub fn with_glyphs(self, glyphs: Vec<Glyph3DInstance>) -> Self

Add multiple glyph markers at once.

pub fn with_color(self, color: Vec4) -> Self

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

Main update: advance all layers, compute visibility, handle dissolution.

pub fn take_damage( &mut self, amount: f32, impact_point: Vec2, impact_direction: Vec2, )

Take damage at an impact point.

pub fn take_crit( &mut self, amount: f32, impact_point: Vec2, impact_direction: Vec2, )

Apply a critical hit: permanent particle loss + curve break.

pub fn apply_force(&mut self, force: Vec2)

Apply an external force to all layers.

pub fn render( &self, spawn_fn: &mut dyn FnMut(Glyph) -> GlyphId, dt: f32, ) -> usize

Render all visible layers by spawning glyphs. Returns glyph count.

pub fn hp_ratio(&self) -> f32

pub fn is_dissolved(&self) -> bool

pub fn get_bounds(&self) -> (Vec2, Vec2)

Combined bounding box from all layers.

pub fn total_particle_count(&self) -> u32

Total alive particle count across all layers.