cellular_maps 1.0.1

A simple library to generate 2D procedural bitmaps using the cellular automata technique.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107

# Cellular Map [![Build Status](https://travis-ci.org/THeK3nger/CellularMaps-Rust.svg?branch=master)](https://travis-ci.org/THeK3nger/CellularMaps-Rust)

### What is it?

**Cellular Map** is a simple implementation of a procedural map generator in *Rust*. It uses the [Cellular Automata][1] technique in order to create structures similar to caves or natural environments.

## An Example

	##################################################
	####.....###...###...#############################
	###.......#...........#..#########################
	###.......................##################...###
	###........................################.....##
	####........................##############.......#
	#####.................#.....##############.......#
	######...............###....########..####......##
	######...............####..########.....##.....###
	######..............##############............####
	#######..###......################.............###
	#############.....#########..######............###
	#############.....#######.....######...........###
	##############...#######........####...##......###
	#############.....#####..........####..##.......##
	##########.......................####............#
	#########........................###.............#
	#########...........##............##............##
	########............##..........................##
	######..........................................##
	#####...........................................##
	#####..........................#.........####..###
	######........................###.......######..##
	#######.....................#####.......#####....#
	######......................####.........#.......#
	######...........................................#
	######..........##..................##...........#
	#####....#####..##.................###...........#
	###.....######...##...#............##...........##
	##......#####....########......................###
	#.......####......########..##..................##
	#........###......########..##...................#
	#........###......########.......................#
	##.........#.......######......#.................#
	##..........#......######.....###...............##
	#..........###.....######.....####..............##
	#..........##.......######.....###...............#
	##.........##........######.....###.....##.......#
	###...................#####......###...###......##
	####...................#####.....###....#.......##
	####....................######.................###
	###......................#####...............#####
	###................##....###......##........######
	##................###.............###......#######
	##...............####.............####....########
	###..............#####............######..########
	#######...#......########.........################
	############.....#########....#..#################
	##############..###########..#####################
	##################################################

## Usage

The usage for the class is shown in the example main provided in the source:

```rust
extern crate cellular_maps;

use cellular_maps::CellularMap;

fn main() {
	let mut cm = CellularMap::new(30u,30u);
	cm.random_fill(40u);
	print_map(&cm);
	cm.evolve();
	cm.evolve();
	cm.evolve();
	print_map(&cm);
}
```

Easy. The result is stored in the class and can be accessed how shown in the print function.

```rust
fn print_map(map: &CellularMap) {
	let mut res_string = "".to_string();
	for c in range(0u,(map.get_width())) {
		for r in range(0u,map.get_height()) {
			if map.get_element(r,c) == 0 {
				res_string.push_str(".");
			} else if map.get_element(r,c) == 1 {
				res_string.push_str("#");
			} else {
				res_string.push_str("@")
			}
		}
		res_string.push_str("\n");
	}
	println!("{}",res_string);
}
```

## Running the Example

You can run the basic example with the command:

    cargo run --example base

[1]: https://en.wikipedia.org/wiki/Cellular_automaton