Struct Formation 

pub struct Formation {
    pub positions: Vec<Vec3>,
    pub chars: Vec<char>,
}

A formation: a list of 3D offsets from the entity center with per-slot characters.

Fields

positions: Vec<Vec3>

chars: Vec<char>

Implementations

impl Formation

pub fn single(ch: char) -> Self

A single glyph at the origin.

pub fn grid_3x3() -> Self

A 3×3 grid (9 glyphs).

pub fn grid(cols: i32, rows: i32, spacing: f32) -> Self

An N×M grid with given spacing.

pub fn circle(n: usize, radius: f32) -> Self

A circle of N glyphs at the given radius.

pub fn rings(spec: &[(usize, f32)]) -> Self

Concentric rings. Each entry is (glyph_count, radius).

pub fn diamond(size: i32) -> Self

Diamond shape (all integer (x,y) within Manhattan distance ≤ size).

pub fn cross(arm_length: i32) -> Self

Cross / plus sign with arm_length glyphs per arm (center + 4 arms).

pub fn star(points: usize, inner_r: f32, outer_r: f32) -> Self

N-pointed star with inner_r and outer_r radii.

pub fn hex_cluster(radius: f32) -> Self

Hexagonal close-pack: all hex centers within radius.

pub fn spiral(turns: f32, density: usize) -> Self

Archimedean spiral: r = a * θ.

pub fn fibonacci_spiral(n: usize, scale: f32) -> Self

Fibonacci (golden-ratio) phyllotaxis spiral — N points.

pub fn dna_helix(height: f32, turns: f32, n: usize) -> Self

Double helix (DNA-like): two interleaved spirals winding vertically.

pub fn triangle(size: f32) -> Self

Triangle (equilateral) of side length size.

pub fn lissajous(n: usize, a: f32, b: f32, delta: f32, scale: f32) -> Self

Lissajous figure: parametric (sin(a·t+δ), sin(b·t)) for n points.

pub fn lorenz_trace(n: usize, scale: f32) -> Self

Lorenz attractor sample: step the attractor n times and record positions.

pub fn arrow(length: usize, direction: Vec3) -> Self

Arrow pointing in a direction (normalized), length glyphs long.

pub fn scatter(n: usize, radius: f32, seed: u64) -> Self

Random scatter within radius, seeded for reproducibility.

pub fn rune_sigma() -> Self

Rune: Sigma / S-curve.

pub fn rune_infinity() -> Self

Rune: Infinity / ∞ shape.

pub fn rune_chaos() -> Self

Rune: Chaos — a 3-armed triskelion.

pub fn sierpinski(depth: u32, size: f32) -> Self

Boss formation: Sierpinski triangle approximation (2 levels deep).

pub fn mandala(layers: usize, base_n: usize, base_r: f32) -> Self

Boss formation: Mandala (multiple concentric rings with rotational symmetry).

pub fn scaled(self, s: f32) -> Self

Scale all positions by a scalar.

pub fn rotated_z(self, angle: f32) -> Self

Rotate the entire formation around the Z axis by angle radians.

pub fn translated(self, offset: Vec3) -> Self

Translate all positions by an offset.

pub fn mirrored_x(self) -> Self

Reflect across the Y axis (mirror left-right).

pub fn join(self, other: Formation) -> Self

Combine two formations into one.

pub fn with_char(self, ch: char) -> Self

Replace all characters with a single glyph.

pub fn len(&self) -> usize

Number of glyphs.

pub fn is_empty(&self) -> bool

True if empty.

pub fn centroid(&self) -> Vec3

Compute the centroid of all positions.

pub fn bounding_radius(&self) -> f32

Compute bounding radius (max distance from centroid).

pub fn normalized(self) -> Self

Normalize so bounding_radius == 1.0.

Trait Implementations

impl Clone for Formation

fn clone(&self) -> Formation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Formation

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

Formats the value using the given formatter.