Struct rlifesrc_lib::Config

pub struct Config {
    pub width: i32,
    pub height: i32,
    pub period: i32,
    pub dx: i32,
    pub dy: i32,
    pub transform: Transform,
    pub symmetry: Symmetry,
    pub search_order: Option<SearchOrder>,
    pub new_state: NewState,
    pub max_cell_count: Option<u32>,
    pub reduce_max: bool,
    pub rule_string: String,
    pub diagonal_width: Option<i32>,
    pub skip_subperiod: bool,
    pub skip_subsymmetry: bool,
    pub known_cells: Vec<KnownCell>,
    pub backjump: bool,
}

World configuration.

The world will be generated from this configuration.

Fields

width: i32

Width.

height: i32

Height.

period: i32

Period.

dx: i32

Horizontal translation.

dy: i32

Vertical translation.

transform: Transform

Transformations (rotations and reflections) after the last generation in a period.

After the last generation in a period, the pattern will return to the first generation, applying this transformation first, and then the translation defined by dx and dy.

symmetry: Symmetry

Symmetries of the pattern.

search_order: Option<SearchOrder>

The order to find a new unknown cell.

It will always search all generations of one cell before going to another cell.

None means that it will automatically choose a search order according to the width and height of the world.

new_state: NewState

How to choose a state for an unknown cell.

max_cell_count: Option<u32>

The number of minimum living cells in all generations must not exceed this number.

None means that there is no limit for the cell count.

reduce_max: bool

Whether to automatically reduce the max_cell_count when a result is found.

The max_cell_count will be set to the cell count of the current result minus one.

rule_string: String

The rule string of the cellular automaton.

diagonal_width: Option<i32>

Diagonal width.

If the diagonal width is n, the cells at position (x, y) where abs(x - y) >= n are assumed to be dead.

skip_subperiod: bool

Whether to skip patterns whose fundamental period are smaller than the given period.

skip_subsymmetry: bool

Whether to skip patterns which are invariant under more transformations than required by the given symmetry.

In another word, whether to skip patterns whose symmetry group properly contains the given symmetry group.

known_cells: Vec<KnownCell>

Cells whose states are known before the search.

backjump: bool

(Experimental) Whether to enable backjumping.

Backjumping will reduce the number of steps, but each step will takes a much longer time. The current implementation is slower for most search, only useful for large (e.g., 64x64) still lifes.

Currently it is only supported for non-generations rules. Generations rules will ignore this option.

Implementations

impl Config

pub fn new(width: i32, height: i32, period: i32) -> Self

Sets up a new configuration with given size.

pub fn set_translate(self, dx: i32, dy: i32) -> Self

Sets the translations (dx, dy).

pub fn set_transform(self, transform: Transform) -> Self

Sets the transformation.

pub fn set_symmetry(self, symmetry: Symmetry) -> Self

Sets the symmetry.

pub fn set_search_order<T: Into<Option<SearchOrder>>>(
    self,
    search_order: T
) -> Self

Sets the search order.

pub fn set_new_state(self, new_state: NewState) -> Self

Sets how to choose a state for an unknown cell.

pub fn set_max_cell_count<T: Into<Option<u32>>>(self, max_cell_count: T) -> Self

Sets the maximal number of living cells.

pub fn set_reduce_max(self, reduce_max: bool) -> Self

Sets whether to automatically reduce the max_cell_count when a result is found.

pub fn set_rule_string<S: ToString>(self, rule_string: S) -> Self

Sets the rule string.

pub fn set_diagonal_width<T: Into<Option<i32>>>(self, diagonal_width: T) -> Self

Sets the diagonal width.

pub fn set_skip_subperiod(self, skip_subperiod: bool) -> Self

Sets whether to skip patterns whose fundamental period is smaller than the given period.

pub fn set_skip_subsymmetry(self, skip_subsymmetry: bool) -> Self

Sets whether to skip patterns which are invariant under more transformations than required by the given symmetry.

pub fn set_known_cells<T: Into<Vec<KnownCell>>>(self, known_cells: T) -> Self

Sets cells whose states are known before the search.

pub fn set_backjump(self, backjump: bool) -> Self

Sets whether to enable backjumping.

pub fn require_square_world(&self) -> bool

Whether the configuration requires the world to be square.

pub fn require_no_diagonal_width(&self) -> bool

Whether the configuration requires the world to have no diagonal width.

pub fn world(&self) -> Result<Box<dyn Search>, Error>

Creates a new world from the configuration. Returns an error if the rule string is invalid.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Self

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Eq for Config

impl Hash for Config

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Config> for Config

fn eq(&self, other: &Config) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Config) -> bool

This method tests for !=.

impl Serialize for Config

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralEq for Config

impl StructuralPartialEq for Config