rusty-systems 5.0.0

A library for procedurally generating content using L-Systems
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

use std::fmt::Debug;
use crate::prelude::{ProductionString, RunSettings, System};
use crate::symbols::SymbolStore;

pub mod abop;
pub mod svg;

pub trait Interpretation: Debug + Sync + Send + Default {
    type Item;

    /// Returns a default system that can handle symbols that this Interpretation
    /// understands.
    ///
    /// Note that an interpretation can [`Interpretation::interpret`] other
    /// systems not produced by this function. THIS FUNCTION IS ONLY A CONVENIENCE
    /// FUNCTION.
    fn system() -> crate::Result<System>;

    fn interpret<S: SymbolStore>(&self,
                                 symbols: &S,
                                 string: &ProductionString) -> crate::Result<Self::Item>;


    fn default_interpret<S: SymbolStore>(symbols: &S,
                                         string: &ProductionString) -> crate::Result<Self::Item> {
        let instance = Self::default();
        instance.interpret(symbols, string)
    }

    /// Returns default run settings for this interpretation.
    ///
    /// This defines how a system should be derived.
    fn run_settings(&self) -> RunSettings {
        RunSettings::default()
    }

}

/// An interpretation that does nothing except
#[derive(Debug, Clone, Default)]
pub struct NullInterpretation {
}

impl NullInterpretation {
}

impl Interpretation for NullInterpretation {
    type Item = ();

    #[inline]
    fn system() -> crate::Result<System> {
        Ok(System::default())
    }

    #[inline]
    fn interpret<S: SymbolStore>(&self, _: &S, _: &ProductionString) -> crate::Result<Self::Item> {
        Ok(())
    }
}