TurtleLSystemBuilder

dcc_lsystem::turtle

Struct TurtleLSystemBuilder 

Source 
pub struct TurtleLSystemBuilder { /* private fields */ }
Expand description

A TurtleLSystemBuilder is used to generate an L-system and a turtle based renderer based don this L-system.

Implementations§

Source§

impl TurtleLSystemBuilder

Source

pub fn new() -> Self

Create a new TurtleLSystemBuilder instance.

Examples found in repository?
examples/dragon_curve_data.rs (line 6)
5fn main() {
6    let mut builder = TurtleLSystemBuilder::new();
7
8    builder
9        .token("X", TurtleAction::Nothing)
10        .token("Y", TurtleAction::Nothing)
11        .token("F", TurtleAction::Forward(30))
12        .token("+", TurtleAction::Rotate(-90))
13        .token("-", TurtleAction::Rotate(90))
14        .axiom("F X")
15        .rule("X => X + Y F +")
16        .rule("Y => - F X - Y");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(15);
20
21    let rv = renderer.render(&system, &DataRendererOptions::default());
22    println!("Dragon curve builder generated {} lines", rv.len());
23}
More examples
Hide additional examples
examples/koch_curve.rs (line 7)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(7);
18
19    let options = ImageRendererOptionsBuilder::new()
20        .padding(10)
21        .thickness(4.0)
22        .fill_color(Rgb([255u8, 255u8, 255u8]))
23        .line_color(Rgb([0u8, 0u8, 100u8]))
24        .build();
25
26    renderer
27        .render(&system, &options)
28        .save("koch_curve.png")
29        .expect("Failed to save koch_curve.png");
30}
examples/koch_curve_video.rs (line 7)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(4);
18
19    let options = VideoRendererOptionsBuilder::new()
20        .filename("koch_curve.gif")
21        .fps(20)
22        .skip_by(5)
23        .padding(10)
24        .thickness(4.0)
25        .fill_color(Rgb([255u8, 255u8, 255u8]))
26        .line_color(Rgb([0u8, 0u8, 100u8]))
27        .progress_bar(true)
28        .build();
29
30    renderer.render(&system, &options);
31}
examples/sierpinski_arrowhead.rs (line 7)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("A", TurtleAction::Forward(200))
11        .token("B", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(60))
13        .token("-", TurtleAction::Rotate(-60))
14        .axiom("A")
15        .rule("A => B - A - B")
16        .rule("B => A + B + A");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(15.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_arrowhead.png")
31        .expect("Failed to save to sierpinski_arrowhead.png");
32}
examples/sierpinski_triangle.rs (line 7)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(200))
11        .token("G", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(120))
13        .token("-", TurtleAction::Rotate(-120))
14        .axiom("F - G - G")
15        .rule("F => F - G + F + G - F")
16        .rule("G => G G");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(8.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_triangle.png")
31        .expect("Failed to save to sierpinski_triangle.png");
32}
examples/dragon_curve.rs (line 8)
7fn main() {
8    let mut builder = TurtleLSystemBuilder::new();
9
10    builder
11        .token("X", TurtleAction::Nothing)
12        .token("Y", TurtleAction::Nothing)
13        .token("F", TurtleAction::Forward(30))
14        .token("+", TurtleAction::Rotate(-90))
15        .token("-", TurtleAction::Rotate(90))
16        .axiom("F X")
17        .rule("X => X + Y F +")
18        .rule("Y => - F X - Y");
19
20    let (mut system, renderer) = builder.finish();
21    system.step_by(15);
22
23    let options = ImageRendererOptionsBuilder::new()
24        .padding(10)
25        .thickness(8.0)
26        .fill_color(Rgb([255u8, 255u8, 255u8]))
27        .line_color(Rgb([100u8, 0u8, 0u8]))
28        .build();
29
30    renderer
31        .render(&system, &options)
32        .save("dragon_curve.png")
33        .expect("Failed to save to dragon_curve.png");
34}
Additional examples can be found in:
Source

pub fn rotate(&mut self, angle: i32) -> &mut Self

Apply a global rotation to the builder. This is useful for modifying the orientation of the data passed to a Renderer.

Examples found in repository?
examples/fractal_binary_tree.rs (line 21)
8fn main() {
9    let mut builder = TurtleLSystemBuilder::new();
10
11    builder
12        .token("0", TurtleAction::Forward(50))
13        .token("1", TurtleAction::Forward(50))
14        .token("L", TurtleAction::Rotate(45))
15        .token("R", TurtleAction::Rotate(-45))
16        .token("[", TurtleAction::Push)
17        .token("]", TurtleAction::Pop)
18        .axiom("0")
19        .rule("1 => 1 1")
20        .rule("0 => 1 [ L 0 ] R 0")
21        .rotate(90);
22
23    let (mut system, renderer) = builder.finish();
24    system.step_by(9);
25
26    let options = ImageRendererOptionsBuilder::new()
27        .padding(20)
28        .thickness(5.5)
29        .fill_color(Rgb([255u8, 255u8, 255u8]))
30        .line_color(Rgb([0u8, 100u8, 100u8]))
31        .build();
32
33    renderer
34        .render(&system, &options)
35        .save("fractal_binary_tree.png")
36        .expect("Failed to save to fractal_binary_tree.png");
37}
More examples
Hide additional examples
examples/fractal_plant.rs (line 19)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("X", TurtleAction::Nothing)
11        .token("F", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(25))
13        .token("-", TurtleAction::Rotate(-25))
14        .token("[", TurtleAction::Push)
15        .token("]", TurtleAction::Pop)
16        .axiom("X")
17        .rule("X => F + [ [ X ] - X ] - F [ - F X ] + X")
18        .rule("F => F F")
19        .rotate(70);
20
21    let (mut system, renderer) = builder.finish();
22    system.step_by(6);
23
24    let options = ImageRendererOptionsBuilder::new()
25        .padding(20)
26        .thickness(18.0)
27        .fill_color(Rgb([255u8, 255u8, 255u8]))
28        .line_color(Rgb([0u8, 100u8, 0u8]))
29        .build();
30
31    renderer
32        .render(&system, &options)
33        .save("fractal_plant.png")
34        .expect("Failed to save fractal_plant.png");
35}
Source

pub fn token<S: Into<String>>( &mut self, token: S, action: TurtleAction, ) -> &mut Self

Associate a token and corresponding action to this builder.

Examples found in repository?
examples/dragon_curve_data.rs (line 9)
5fn main() {
6    let mut builder = TurtleLSystemBuilder::new();
7
8    builder
9        .token("X", TurtleAction::Nothing)
10        .token("Y", TurtleAction::Nothing)
11        .token("F", TurtleAction::Forward(30))
12        .token("+", TurtleAction::Rotate(-90))
13        .token("-", TurtleAction::Rotate(90))
14        .axiom("F X")
15        .rule("X => X + Y F +")
16        .rule("Y => - F X - Y");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(15);
20
21    let rv = renderer.render(&system, &DataRendererOptions::default());
22    println!("Dragon curve builder generated {} lines", rv.len());
23}
More examples
Hide additional examples
examples/koch_curve.rs (line 10)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(7);
18
19    let options = ImageRendererOptionsBuilder::new()
20        .padding(10)
21        .thickness(4.0)
22        .fill_color(Rgb([255u8, 255u8, 255u8]))
23        .line_color(Rgb([0u8, 0u8, 100u8]))
24        .build();
25
26    renderer
27        .render(&system, &options)
28        .save("koch_curve.png")
29        .expect("Failed to save koch_curve.png");
30}
examples/koch_curve_video.rs (line 10)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(4);
18
19    let options = VideoRendererOptionsBuilder::new()
20        .filename("koch_curve.gif")
21        .fps(20)
22        .skip_by(5)
23        .padding(10)
24        .thickness(4.0)
25        .fill_color(Rgb([255u8, 255u8, 255u8]))
26        .line_color(Rgb([0u8, 0u8, 100u8]))
27        .progress_bar(true)
28        .build();
29
30    renderer.render(&system, &options);
31}
examples/sierpinski_arrowhead.rs (line 10)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("A", TurtleAction::Forward(200))
11        .token("B", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(60))
13        .token("-", TurtleAction::Rotate(-60))
14        .axiom("A")
15        .rule("A => B - A - B")
16        .rule("B => A + B + A");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(15.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_arrowhead.png")
31        .expect("Failed to save to sierpinski_arrowhead.png");
32}
examples/sierpinski_triangle.rs (line 10)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(200))
11        .token("G", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(120))
13        .token("-", TurtleAction::Rotate(-120))
14        .axiom("F - G - G")
15        .rule("F => F - G + F + G - F")
16        .rule("G => G G");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(8.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_triangle.png")
31        .expect("Failed to save to sierpinski_triangle.png");
32}
examples/dragon_curve.rs (line 11)
7fn main() {
8    let mut builder = TurtleLSystemBuilder::new();
9
10    builder
11        .token("X", TurtleAction::Nothing)
12        .token("Y", TurtleAction::Nothing)
13        .token("F", TurtleAction::Forward(30))
14        .token("+", TurtleAction::Rotate(-90))
15        .token("-", TurtleAction::Rotate(90))
16        .axiom("F X")
17        .rule("X => X + Y F +")
18        .rule("Y => - F X - Y");
19
20    let (mut system, renderer) = builder.finish();
21    system.step_by(15);
22
23    let options = ImageRendererOptionsBuilder::new()
24        .padding(10)
25        .thickness(8.0)
26        .fill_color(Rgb([255u8, 255u8, 255u8]))
27        .line_color(Rgb([100u8, 0u8, 0u8]))
28        .build();
29
30    renderer
31        .render(&system, &options)
32        .save("dragon_curve.png")
33        .expect("Failed to save to dragon_curve.png");
34}
Additional examples can be found in:
Source

pub fn axiom(&mut self, ident: &str) -> &mut Self

Set the axiom for this builder.

Examples found in repository?
examples/dragon_curve_data.rs (line 14)
5fn main() {
6    let mut builder = TurtleLSystemBuilder::new();
7
8    builder
9        .token("X", TurtleAction::Nothing)
10        .token("Y", TurtleAction::Nothing)
11        .token("F", TurtleAction::Forward(30))
12        .token("+", TurtleAction::Rotate(-90))
13        .token("-", TurtleAction::Rotate(90))
14        .axiom("F X")
15        .rule("X => X + Y F +")
16        .rule("Y => - F X - Y");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(15);
20
21    let rv = renderer.render(&system, &DataRendererOptions::default());
22    println!("Dragon curve builder generated {} lines", rv.len());
23}
More examples
Hide additional examples
examples/koch_curve.rs (line 13)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(7);
18
19    let options = ImageRendererOptionsBuilder::new()
20        .padding(10)
21        .thickness(4.0)
22        .fill_color(Rgb([255u8, 255u8, 255u8]))
23        .line_color(Rgb([0u8, 0u8, 100u8]))
24        .build();
25
26    renderer
27        .render(&system, &options)
28        .save("koch_curve.png")
29        .expect("Failed to save koch_curve.png");
30}
examples/koch_curve_video.rs (line 13)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(4);
18
19    let options = VideoRendererOptionsBuilder::new()
20        .filename("koch_curve.gif")
21        .fps(20)
22        .skip_by(5)
23        .padding(10)
24        .thickness(4.0)
25        .fill_color(Rgb([255u8, 255u8, 255u8]))
26        .line_color(Rgb([0u8, 0u8, 100u8]))
27        .progress_bar(true)
28        .build();
29
30    renderer.render(&system, &options);
31}
examples/sierpinski_arrowhead.rs (line 14)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("A", TurtleAction::Forward(200))
11        .token("B", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(60))
13        .token("-", TurtleAction::Rotate(-60))
14        .axiom("A")
15        .rule("A => B - A - B")
16        .rule("B => A + B + A");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(15.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_arrowhead.png")
31        .expect("Failed to save to sierpinski_arrowhead.png");
32}
examples/sierpinski_triangle.rs (line 14)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(200))
11        .token("G", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(120))
13        .token("-", TurtleAction::Rotate(-120))
14        .axiom("F - G - G")
15        .rule("F => F - G + F + G - F")
16        .rule("G => G G");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(8.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_triangle.png")
31        .expect("Failed to save to sierpinski_triangle.png");
32}
examples/dragon_curve.rs (line 16)
7fn main() {
8    let mut builder = TurtleLSystemBuilder::new();
9
10    builder
11        .token("X", TurtleAction::Nothing)
12        .token("Y", TurtleAction::Nothing)
13        .token("F", TurtleAction::Forward(30))
14        .token("+", TurtleAction::Rotate(-90))
15        .token("-", TurtleAction::Rotate(90))
16        .axiom("F X")
17        .rule("X => X + Y F +")
18        .rule("Y => - F X - Y");
19
20    let (mut system, renderer) = builder.finish();
21    system.step_by(15);
22
23    let options = ImageRendererOptionsBuilder::new()
24        .padding(10)
25        .thickness(8.0)
26        .fill_color(Rgb([255u8, 255u8, 255u8]))
27        .line_color(Rgb([100u8, 0u8, 0u8]))
28        .build();
29
30    renderer
31        .render(&system, &options)
32        .save("dragon_curve.png")
33        .expect("Failed to save to dragon_curve.png");
34}
Additional examples can be found in:
Source

pub fn rule<'a, S: Into<&'a str>>(&mut self, rule: S) -> &mut Self

Add a transformation rule to the builder.

Examples found in repository?
examples/dragon_curve_data.rs (line 15)
5fn main() {
6    let mut builder = TurtleLSystemBuilder::new();
7
8    builder
9        .token("X", TurtleAction::Nothing)
10        .token("Y", TurtleAction::Nothing)
11        .token("F", TurtleAction::Forward(30))
12        .token("+", TurtleAction::Rotate(-90))
13        .token("-", TurtleAction::Rotate(90))
14        .axiom("F X")
15        .rule("X => X + Y F +")
16        .rule("Y => - F X - Y");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(15);
20
21    let rv = renderer.render(&system, &DataRendererOptions::default());
22    println!("Dragon curve builder generated {} lines", rv.len());
23}
More examples
Hide additional examples
examples/koch_curve.rs (line 14)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(7);
18
19    let options = ImageRendererOptionsBuilder::new()
20        .padding(10)
21        .thickness(4.0)
22        .fill_color(Rgb([255u8, 255u8, 255u8]))
23        .line_color(Rgb([0u8, 0u8, 100u8]))
24        .build();
25
26    renderer
27        .render(&system, &options)
28        .save("koch_curve.png")
29        .expect("Failed to save koch_curve.png");
30}
examples/koch_curve_video.rs (line 14)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(4);
18
19    let options = VideoRendererOptionsBuilder::new()
20        .filename("koch_curve.gif")
21        .fps(20)
22        .skip_by(5)
23        .padding(10)
24        .thickness(4.0)
25        .fill_color(Rgb([255u8, 255u8, 255u8]))
26        .line_color(Rgb([0u8, 0u8, 100u8]))
27        .progress_bar(true)
28        .build();
29
30    renderer.render(&system, &options);
31}
examples/sierpinski_arrowhead.rs (line 15)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("A", TurtleAction::Forward(200))
11        .token("B", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(60))
13        .token("-", TurtleAction::Rotate(-60))
14        .axiom("A")
15        .rule("A => B - A - B")
16        .rule("B => A + B + A");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(15.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_arrowhead.png")
31        .expect("Failed to save to sierpinski_arrowhead.png");
32}
examples/sierpinski_triangle.rs (line 15)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(200))
11        .token("G", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(120))
13        .token("-", TurtleAction::Rotate(-120))
14        .axiom("F - G - G")
15        .rule("F => F - G + F + G - F")
16        .rule("G => G G");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(8.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_triangle.png")
31        .expect("Failed to save to sierpinski_triangle.png");
32}
examples/dragon_curve.rs (line 17)
7fn main() {
8    let mut builder = TurtleLSystemBuilder::new();
9
10    builder
11        .token("X", TurtleAction::Nothing)
12        .token("Y", TurtleAction::Nothing)
13        .token("F", TurtleAction::Forward(30))
14        .token("+", TurtleAction::Rotate(-90))
15        .token("-", TurtleAction::Rotate(90))
16        .axiom("F X")
17        .rule("X => X + Y F +")
18        .rule("Y => - F X - Y");
19
20    let (mut system, renderer) = builder.finish();
21    system.step_by(15);
22
23    let options = ImageRendererOptionsBuilder::new()
24        .padding(10)
25        .thickness(8.0)
26        .fill_color(Rgb([255u8, 255u8, 255u8]))
27        .line_color(Rgb([100u8, 0u8, 0u8]))
28        .build();
29
30    renderer
31        .render(&system, &options)
32        .save("dragon_curve.png")
33        .expect("Failed to save to dragon_curve.png");
34}
Additional examples can be found in:
Source

pub fn finish(self) -> (LSystem, TurtleRenderer<TurtleLSystemState>)

Consumes the builder, returning the generated LSystem and a Renderer which can associate tokens in the LSystem to turtle actions.

Examples found in repository?
examples/dragon_curve_data.rs (line 18)
5fn main() {
6    let mut builder = TurtleLSystemBuilder::new();
7
8    builder
9        .token("X", TurtleAction::Nothing)
10        .token("Y", TurtleAction::Nothing)
11        .token("F", TurtleAction::Forward(30))
12        .token("+", TurtleAction::Rotate(-90))
13        .token("-", TurtleAction::Rotate(90))
14        .axiom("F X")
15        .rule("X => X + Y F +")
16        .rule("Y => - F X - Y");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(15);
20
21    let rv = renderer.render(&system, &DataRendererOptions::default());
22    println!("Dragon curve builder generated {} lines", rv.len());
23}
More examples
Hide additional examples
examples/koch_curve.rs (line 16)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(7);
18
19    let options = ImageRendererOptionsBuilder::new()
20        .padding(10)
21        .thickness(4.0)
22        .fill_color(Rgb([255u8, 255u8, 255u8]))
23        .line_color(Rgb([0u8, 0u8, 100u8]))
24        .build();
25
26    renderer
27        .render(&system, &options)
28        .save("koch_curve.png")
29        .expect("Failed to save koch_curve.png");
30}
examples/koch_curve_video.rs (line 16)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(30))
11        .token("+", TurtleAction::Rotate(90))
12        .token("-", TurtleAction::Rotate(-90))
13        .axiom("F")
14        .rule("F => F + F - F - F + F");
15
16    let (mut system, renderer) = builder.finish();
17    system.step_by(4);
18
19    let options = VideoRendererOptionsBuilder::new()
20        .filename("koch_curve.gif")
21        .fps(20)
22        .skip_by(5)
23        .padding(10)
24        .thickness(4.0)
25        .fill_color(Rgb([255u8, 255u8, 255u8]))
26        .line_color(Rgb([0u8, 0u8, 100u8]))
27        .progress_bar(true)
28        .build();
29
30    renderer.render(&system, &options);
31}
examples/sierpinski_arrowhead.rs (line 18)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("A", TurtleAction::Forward(200))
11        .token("B", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(60))
13        .token("-", TurtleAction::Rotate(-60))
14        .axiom("A")
15        .rule("A => B - A - B")
16        .rule("B => A + B + A");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(15.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_arrowhead.png")
31        .expect("Failed to save to sierpinski_arrowhead.png");
32}
examples/sierpinski_triangle.rs (line 18)
6fn main() {
7    let mut builder = TurtleLSystemBuilder::new();
8
9    builder
10        .token("F", TurtleAction::Forward(200))
11        .token("G", TurtleAction::Forward(200))
12        .token("+", TurtleAction::Rotate(120))
13        .token("-", TurtleAction::Rotate(-120))
14        .axiom("F - G - G")
15        .rule("F => F - G + F + G - F")
16        .rule("G => G G");
17
18    let (mut system, renderer) = builder.finish();
19    system.step_by(7);
20
21    let options = ImageRendererOptionsBuilder::new()
22        .padding(20)
23        .thickness(8.0)
24        .fill_color(Rgb([255u8, 255u8, 255u8]))
25        .line_color(Rgb([0u8, 100u8, 0u8]))
26        .build();
27
28    renderer
29        .render(&system, &options)
30        .save("sierpinski_triangle.png")
31        .expect("Failed to save to sierpinski_triangle.png");
32}
examples/dragon_curve.rs (line 20)
7fn main() {
8    let mut builder = TurtleLSystemBuilder::new();
9
10    builder
11        .token("X", TurtleAction::Nothing)
12        .token("Y", TurtleAction::Nothing)
13        .token("F", TurtleAction::Forward(30))
14        .token("+", TurtleAction::Rotate(-90))
15        .token("-", TurtleAction::Rotate(90))
16        .axiom("F X")
17        .rule("X => X + Y F +")
18        .rule("Y => - F X - Y");
19
20    let (mut system, renderer) = builder.finish();
21    system.step_by(15);
22
23    let options = ImageRendererOptionsBuilder::new()
24        .padding(10)
25        .thickness(8.0)
26        .fill_color(Rgb([255u8, 255u8, 255u8]))
27        .line_color(Rgb([100u8, 0u8, 0u8]))
28        .build();
29
30    renderer
31        .render(&system, &options)
32        .save("dragon_curve.png")
33        .expect("Failed to save to dragon_curve.png");
34}
Additional examples can be found in:

Trait Implementations§

Source§

impl Clone for TurtleLSystemBuilder

Source§

fn clone(&self) -> TurtleLSystemBuilder

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Default for TurtleLSystemBuilder

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<Src, Scheme> ApproxFrom<Src, Scheme> for Src
where Scheme: ApproxScheme,

Source§

type Err = NoError

The error type produced by a failed conversion.
Source§

fn approx_from(src: Src) -> Result<Src, <Src as ApproxFrom<Src, Scheme>>::Err>

Convert the given value into an approximately equivalent representation.
Source§

impl<Dst, Src, Scheme> ApproxInto<Dst, Scheme> for Src
where Dst: ApproxFrom<Src, Scheme>, Scheme: ApproxScheme,

Source§

type Err = <Dst as ApproxFrom<Src, Scheme>>::Err

The error type produced by a failed conversion.
Source§

fn approx_into(self) -> Result<Dst, <Src as ApproxInto<Dst, Scheme>>::Err>

Convert the subject into an approximately equivalent representation.
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T, Dst> ConvAsUtil<Dst> for T

Source§

fn approx(self) -> Result<Dst, Self::Err>
where Self: Sized + ApproxInto<Dst>,

Approximate the subject with the default scheme.
Source§

fn approx_by<Scheme>(self) -> Result<Dst, Self::Err>
where Self: Sized + ApproxInto<Dst, Scheme>, Scheme: ApproxScheme,

Approximate the subject with a specific scheme.
Source§

impl<T> ConvUtil for T

Source§

fn approx_as<Dst>(self) -> Result<Dst, Self::Err>
where Self: Sized + ApproxInto<Dst>,

Approximate the subject to a given type with the default scheme.
Source§

fn approx_as_by<Dst, Scheme>(self) -> Result<Dst, Self::Err>
where Self: Sized + ApproxInto<Dst, Scheme>, Scheme: ApproxScheme,

Approximate the subject to a given type with a specific scheme.
Source§

fn into_as<Dst>(self) -> Dst
where Self: Sized + Into<Dst>,

Convert the subject to a given type.
Source§

fn try_as<Dst>(self) -> Result<Dst, Self::Err>
where Self: Sized + TryInto<Dst>,

Attempt to convert the subject to a given type.
Source§

fn value_as<Dst>(self) -> Result<Dst, Self::Err>
where Self: Sized + ValueInto<Dst>,

Attempt a value conversion of the subject to a given type.
Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<Src> TryFrom<Src> for Src

Source§

type Err = NoError

The error type produced by a failed conversion.
Source§

fn try_from(src: Src) -> Result<Src, <Src as TryFrom<Src>>::Err>

Convert the given value into the subject type.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<Src, Dst> TryInto<Dst> for Src
where Dst: TryFrom<Src>,

Source§

type Err = <Dst as TryFrom<Src>>::Err

The error type produced by a failed conversion.
Source§

fn try_into(self) -> Result<Dst, <Src as TryInto<Dst>>::Err>

Convert the subject into the destination type.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<Src> ValueFrom<Src> for Src

Source§

type Err = NoError

The error type produced by a failed conversion.
Source§

fn value_from(src: Src) -> Result<Src, <Src as ValueFrom<Src>>::Err>

Convert the given value into an exactly equivalent representation.
Source§

impl<Src, Dst> ValueInto<Dst> for Src
where Dst: ValueFrom<Src>,

Source§

type Err = <Dst as ValueFrom<Src>>::Err

The error type produced by a failed conversion.
Source§

fn value_into(self) -> Result<Dst, <Src as ValueInto<Dst>>::Err>

Convert the subject into an exactly equivalent representation.