Cellular automata 2D. More...

Inherits Node2D.

Public Member Functions
	CellularAutomata2D ()
	Create a default cellular automata with a cell scale of 20. More...

	CellularAutomata2D (int scale)
	Create a default cellular automata with a custom cell scale. More...

virtual void	RandomizeGrid ()
	Randomize grid. More...

Protected Member Functions
virtual Vector2	GetAutomataBounds ()
	Get automata bounds. More...

virtual void	InitializeGrid ()
	Initialize grid. More...

virtual void	InitializeCell (TCell cell, int i, int j)
	Initialize cell. More...

virtual void	ReviveCellAtScreenPos (Vector2 pos)
	Revive cell at screen position. More...

virtual int	GetAliveNeighborsFromCell (int x, int y)
	Get alive neighbors from cell position. More...

virtual T	ApplyRules (int x, int y)
	Apply rules on cell and return next state. More...

virtual void	Generate ()
	Create a new generation. More...

Protected Attributes
TCell[]	_grid
	Grid nodes More...

int	_scale
	Cell scale More...

int	_rows
	Row count More...

int	_cols
	Cols count More...

int	_generation
	Current generation More...

Node2D	_gridContainer
	Grid container More...

Properties
float	WaitTime `[get, set]`
	Wait time More...

Color	CellColor = Colors.LightBlue `[get, set]`
	Cell color More...

bool	Paused `[get, set]`
	Paused More...

bool	HighlightTransitions `[get, set]`
	Highlight when a cell is transitioning from life to death More...

bool	CenterAlignedGrid `[get, set]`
	Align grid to the center More...

bool	HideGUI `[get, set]`
	Hide GUI More...

TouchBehaviorEnum	TouchBehavior `[get, set]`
	Touch behavior More...

WrapBehaviorEnum	WrapBehavior `[get, set]`
	Wrap behavior More...

Detailed Description

Cellular automata 2D.

Type Constraints

TCell	:	Cell<T>
TCell	:	new()
T	:	System.IEquatable<T>

Definition at line 160 of file CellularAutomata2D.cs.

Constructor & Destructor Documentation

◆ CellularAutomata2D() [1/2]

Automata.CellularAutomata2D< TCell, T >.CellularAutomata2D ( )

inline

Create a default cellular automata with a cell scale of 20.

Definition at line 235 of file CellularAutomata2D.cs.

235 : this(20) { }

◆ CellularAutomata2D() [2/2]

Automata.CellularAutomata2D< TCell, T >.CellularAutomata2D ( int scale )

inline

Create a default cellular automata with a custom cell scale.

Parameters

scale Scale

Definition at line 241 of file CellularAutomata2D.cs.

         {
             Name = "CellularAutomata2D";
             _scale = scale;
             _gridContainer = new Node2D()
             {
                 Name = "GridContainer"
             };
         }

Member Function Documentation

◆ ApplyRules()

virtual T Automata.CellularAutomata2D< TCell, T >.ApplyRules	(	int	x,
		int	y
	)

inlineprotectedvirtual

Apply rules on cell and return next state.

Parameters

x	X position
y	Y position

Returns: Next state

Definition at line 464 of file CellularAutomata2D.cs.

         {
             var neighbors = GetAliveNeighborsFromCell(x, y);
             var cell = _grid[x + (y * _cols)];
             var state = cell.State;
             var isAlive = cell.IsAlive();
  
             if (isAlive && (neighbors < 2 || neighbors > 3))
             {
                 return cell.GetDeadValue();
             }
             else if (!isAlive && neighbors == 3)
             {
                 return cell.GetAliveValue();
             }
             else
             {
                 return state;
             }
         }

◆ Generate()

virtual void Automata.CellularAutomata2D< TCell, T >.Generate ( )

inlineprotectedvirtual

Create a new generation.

Definition at line 488 of file CellularAutomata2D.cs.

         {
             int offset = (WrapBehavior == WrapBehaviorEnum.Wrap) ? 0 : 1;
  
             for (int j = offset; j < _rows - offset; ++j)
             {
                 for (int i = offset; i < _cols - offset; ++i)
                 {
                     _grid[i + (j * _cols)].PreviousState = _grid[i + (j * _cols)].State;
                 }
             }
  
             for (int j = offset; j < _rows - offset; ++j)
             {
                 for (int i = offset; i < _cols - offset; ++i)
                 {
                     _grid[i + (j * _cols)].State = ApplyRules(i, j);
                 }
             }
         }

◆ GetAliveNeighborsFromCell()

virtual int Automata.CellularAutomata2D< TCell, T >.GetAliveNeighborsFromCell	(	int	x,
		int	y
	)

inlineprotectedvirtual

Get alive neighbors from cell position.

Parameters

x	X position
y	Y position

Returns: Alive neighbors count

Definition at line 441 of file CellularAutomata2D.cs.

         {
             int count = 0;
  
             for (int j = -1; j <= 1; ++j)
             {
                 for (int i = -1; i <= 1; ++i)
                 {
                     int cellX = (WrapBehavior == WrapBehaviorEnum.Wrap) ? Mathf.PosMod(x + i, _cols) : x + i;
                     int cellY = (WrapBehavior == WrapBehaviorEnum.Wrap) ? Mathf.PosMod(y + j, _rows) : y + j;
                     count += (_grid[cellX + (cellY * _cols)].WasAlive()) ? 1 : 0;
                 }
             }
  
             return count - ((_grid[x + (y * _cols)].WasAlive()) ? 1 : 0);
         }

◆ GetAutomataBounds()

virtual Vector2 Automata.CellularAutomata2D< TCell, T >.GetAutomataBounds ( )

inlineprotectedvirtual

Get automata bounds.

Returns: Bounds

Definition at line 364 of file CellularAutomata2D.cs.

         {
             return GetViewportRect().Size;
         }

◆ InitializeCell()

virtual void Automata.CellularAutomata2D< TCell, T >.InitializeCell	(	TCell	cell,
		int	i,
		int	j
	)

inlineprotectedvirtual

Initialize cell.

Parameters

cell	Cell
i	X position
j	Y position

Definition at line 404 of file CellularAutomata2D.cs.

         {
             cell.State = cell.PreviousState = cell.GetDeadValue();
         }

◆ InitializeGrid()

virtual void Automata.CellularAutomata2D< TCell, T >.InitializeGrid ( )

inlineprotectedvirtual

Initialize grid.

Definition at line 372 of file CellularAutomata2D.cs.

         {
             var size = GetAutomataBounds();
             _cols = (int)size.x / _scale;
             _rows = (int)size.y / _scale;
             _grid = new TCell[_cols * _rows];
  
             for (int j = 0; j < _rows; ++j)
             {
                 for (int i = 0; i < _cols; ++i)
                 {
                     var currPos = i + (j * _cols);
                     var cell = new TCell()
                     {
                         Position = new Vector2(i * _scale, j * _scale),
                         Size = new Vector2(_scale, _scale),
                         CellColor = CellColor,
                         HighlightTransitions = HighlightTransitions
                     };
                     InitializeCell(cell, i, j);
                     _gridContainer.AddChild(cell);
                     _grid[currPos] = cell;
                 }
             }
         }

◆ RandomizeGrid()

virtual void Automata.CellularAutomata2D< TCell, T >.RandomizeGrid ( )

inlinevirtual

Randomize grid.

Definition at line 254 of file CellularAutomata2D.cs.

         {
             _generation = 0;
             int offset = (WrapBehavior == WrapBehaviorEnum.Wrap) ? 0 : 1;
  
             for (int j = offset; j < _rows - offset; ++j)
             {
                 for (int i = offset; i < _cols - offset; ++i)
                 {
                     var currPos = i + (j * _cols);
                     var cell = _grid[currPos];
                     cell.State = cell.PreviousState = cell.RandomizeState();
                 }
             }
         }

◆ ReviveCellAtScreenPos()

virtual void Automata.CellularAutomata2D< TCell, T >.ReviveCellAtScreenPos ( Vector2 pos )

inlineprotectedvirtual

Revive cell at screen position.

Parameters

pos	Screen position

Definition at line 413 of file CellularAutomata2D.cs.

         {
             // Split position depending on scale
             var bounds = GetAutomataBounds();
             var gridPosition = _gridContainer.Position;
             var automataRect = new Rect2(gridPosition, bounds);
             if (!automataRect.HasPoint(pos))
             {
                 return;
             }
  
             // Get index
             var idx = (pos - gridPosition) / _scale;
             int offset = (WrapBehavior == WrapBehaviorEnum.Wrap) ? 0 : 1;
             int x = Mathf.Min(Mathf.Max(offset, (int)idx.x), _cols - 1 - offset);
             int y = Mathf.Min(Mathf.Max(offset, (int)idx.y), _rows - 1 - offset);
  
             var cell = _grid[x + (y * _cols)];
             cell.PreviousState = cell.GetDeadValue();
             cell.State = cell.GetAliveValue();
         }

Member Data Documentation

◆ _cols

int Automata.CellularAutomata2D< TCell, T >._cols

protected

Cols count

Definition at line 217 of file CellularAutomata2D.cs.

◆ _generation

int Automata.CellularAutomata2D< TCell, T >._generation

protected

Current generation

Definition at line 220 of file CellularAutomata2D.cs.

◆ _grid

TCell [] Automata.CellularAutomata2D< TCell, T >._grid

protected

Grid nodes

Definition at line 208 of file CellularAutomata2D.cs.

◆ _gridContainer

Node2D Automata.CellularAutomata2D< TCell, T >._gridContainer

protected

Grid container

Definition at line 223 of file CellularAutomata2D.cs.

◆ _rows

int Automata.CellularAutomata2D< TCell, T >._rows

protected

Row count

Definition at line 214 of file CellularAutomata2D.cs.

◆ _scale

int Automata.CellularAutomata2D< TCell, T >._scale

protected

Cell scale

Definition at line 211 of file CellularAutomata2D.cs.

Property Documentation

◆ CellColor

Color Automata.CellularAutomata2D< TCell, T >.CellColor = Colors.LightBlue

getset

Cell color

Definition at line 179 of file CellularAutomata2D.cs.

179 { get; set; } = Colors.LightBlue;

◆ CenterAlignedGrid

bool Automata.CellularAutomata2D< TCell, T >.CenterAlignedGrid

getset

Align grid to the center

Definition at line 188 of file CellularAutomata2D.cs.

188 { get; set; }

◆ HideGUI

bool Automata.CellularAutomata2D< TCell, T >.HideGUI

getset

Hide GUI

Definition at line 191 of file CellularAutomata2D.cs.

         {
             get => _hideGui;
             set
             {
                 _hideGui = value;
                 SetGUIVisibility(!value);
             }
         }

◆ HighlightTransitions

bool Automata.CellularAutomata2D< TCell, T >.HighlightTransitions

getset

Highlight when a cell is transitioning from life to death

Definition at line 185 of file CellularAutomata2D.cs.

185 { set; get; }

◆ Paused

bool Automata.CellularAutomata2D< TCell, T >.Paused

getset

Paused

Definition at line 182 of file CellularAutomata2D.cs.

182 { get; set; }

◆ TouchBehavior

TouchBehaviorEnum Automata.CellularAutomata2D< TCell, T >.TouchBehavior

getset

Touch behavior

Definition at line 202 of file CellularAutomata2D.cs.

202 { get; set; }

◆ WaitTime

float Automata.CellularAutomata2D< TCell, T >.WaitTime

getset

Wait time

Definition at line 165 of file CellularAutomata2D.cs.

         {
             get => _waitTime;
             set
             {
                 _waitTime = value;
                 if (_timer != null)
                 {
                     _timer.WaitTime = value;
                 }
             }
         }

◆ WrapBehavior

WrapBehaviorEnum Automata.CellularAutomata2D< TCell, T >.WrapBehavior

getset

Wrap behavior

Definition at line 205 of file CellularAutomata2D.cs.

205 { get; set; }

The documentation for this class was generated from the following file:

scripts/automata/CellularAutomata2D.cs

Public Member Functions

Protected Member Functions

Protected Attributes

Properties

Detailed Description

Constructor & Destructor Documentation

◆ CellularAutomata2D() [1/2]

◆ CellularAutomata2D() [2/2]

Member Function Documentation

◆ ApplyRules()

◆ Generate()

◆ GetAliveNeighborsFromCell()

◆ GetAutomataBounds()

◆ InitializeCell()

◆ InitializeGrid()

◆ RandomizeGrid()

◆ ReviveCellAtScreenPos()

Member Data Documentation

◆ _cols

◆ _generation

◆ _grid

◆ _gridContainer

◆ _rows

◆ _scale

Property Documentation

◆ CellColor

◆ CenterAlignedGrid

◆ HideGUI

◆ HighlightTransitions

◆ Paused

◆ TouchBehavior

◆ WaitTime

◆ WrapBehavior