Struct LifeField 

pub struct LifeField { /* private fields */ }

The Game of Life field state.

Implementations

impl LifeField

pub fn from_seed(prompt: &str, width: usize, height: usize) -> Self

Create a new LifeField seeded from a prompt

pub fn ensure_size(&mut self, width: usize, height: usize)

Ensures the field has the specified dimensions, reseeding if changed.

Arguments

• width - Desired width in cells
• height - Desired height in cells

pub fn step(&mut self)

Advances the simulation by one generation using Conway’s rules.

Rules:

• Live cell with 2-3 neighbors survives
• Dead cell with 3 or 6 neighbors becomes alive (highlife variant for 6)
• All other cells die or stay dead

The new heatmap-based injection system monitors activity across zones and injects patterns when activity falls below target levels.

pub fn live_neighbor_count(&self, x: usize, y: usize) -> u8

Counts the number of live neighbors for a cell.

Uses toroidal wrapping - edges connect to the opposite side.

Arguments

• x - X coordinate of the cell
• y - Y coordinate of the cell

Returns

Count of live neighbors (0-8)

pub fn index(&self, x: usize, y: usize) -> usize

Converts 2D coordinates to a 1D array index.

Arguments

• x - X coordinate
• y - Y coordinate

Returns

Index into the cells vector

pub fn update_heatmap(&mut self, old_cells: &[bool])

Update heatmap after a generation step heat = heat * decay + (changed ? 1.0 : 0.0)

pub fn update_zones(&mut self)

Update zone statistics based on current state

pub fn decay_cooldowns(&mut self)

Decrement all zone cooldowns by 1

pub fn choose_injection_zone(&mut self) -> Option<usize>

Choose a zone for injection using weighted randomness Prefers cold zones near warm zones

pub fn maybe_inject(&mut self)

Check if injection should happen and perform it

pub fn generation(&self) -> u64

Get the current generation counter

pub fn dimensions(&self) -> (usize, usize)

Get field dimensions

pub fn live_cells(&self) -> Vec<(usize, usize)>

Get all live cell positions

pub fn live_cell_count(&self) -> usize

Get the number of live cells

pub fn zone_stats(&self) -> Vec<((usize, usize), ZoneStats)>

Get zone statistics for debugging

pub fn config(&self) -> &LifeConfig

Get configuration

impl LifeField

pub fn render_lines( &self, char_width: usize, char_height: usize, ) -> Vec<Line<'static>>

Renders the field as a vector of ratatui Lines using Braille characters.

Each Braille character represents a 2x4 block of cells, allowing for compact display of the life field.

Arguments

• char_width - Width in characters (each char is 2 cells wide)
• char_height - Height in characters (each char is 4 cells tall)

Returns

Vector of Lines representing the rendered field

pub fn braille_char(&self, dot_x: usize, dot_y: usize) -> char

Generates a Braille character representing a 2x4 cell block.

Braille dots are mapped to cell positions:

• Dots 1-4 map to left column (top to bottom)
• Dots 5-8 map to right column (top to bottom)

Arguments

• dot_x - X coordinate of the left cell in the block
• dot_y - Y coordinate of the top cell in the block

Returns

A Braille Unicode character (U+2800 to U+28FF)

Trait Implementations

impl Debug for LifeField

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

Formats the value using the given formatter.

impl Default for LifeField

fn default() -> Self

Returns the “default value” for a type.