terrain-forge 0.7.0

A modular procedural generation engine for terrain, dungeons, and maps
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

//! Procedural generation algorithms

mod agent;
mod bsp;
mod cellular;
mod diamond_square;
mod dla;
mod drunkard;
mod fractal;
mod glass_seam;
mod maze;
mod noise_fill;
mod percolation;
mod prefab;
mod room_accretion;
mod rooms;
mod voronoi;
mod wfc;

pub use agent::{AgentBased, AgentConfig};
pub use bsp::{Bsp, BspConfig};
pub use cellular::{CellularAutomata, CellularConfig};
pub use diamond_square::{DiamondSquare, DiamondSquareConfig};
pub use dla::{Dla, DlaConfig};
pub use drunkard::{DrunkardConfig, DrunkardWalk};
pub use fractal::{Fractal, FractalConfig, FractalType};
pub use glass_seam::{GlassSeam, GlassSeamConfig};
pub use maze::{Maze, MazeConfig};
pub use noise_fill::{NoiseFill, NoiseFillConfig, NoiseType};
pub use percolation::{Percolation, PercolationConfig};
pub use prefab::{
    Prefab, PrefabConfig, PrefabData, PrefabLegendEntry, PrefabLibrary, PrefabPlacementMode,
    PrefabPlacer, PrefabTransform,
};
pub use room_accretion::{RoomAccretion, RoomAccretionConfig, RoomTemplate};
pub use rooms::{SimpleRooms, SimpleRoomsConfig};
pub use voronoi::{Voronoi, VoronoiConfig};
pub use wfc::{Pattern, Wfc, WfcBacktracker, WfcConfig, WfcPatternExtractor};

use crate::{Algorithm, Tile};

/// Get algorithm by name
#[must_use]
pub fn get(name: &str) -> Option<Box<dyn Algorithm<Tile> + Send + Sync>> {
    match name {
        "bsp" => Some(Box::new(Bsp::default())),
        "cellular" | "cellular_automata" => Some(Box::new(CellularAutomata::default())),
        "drunkard" => Some(Box::new(DrunkardWalk::default())),
        "maze" => Some(Box::new(Maze::default())),
        "simple_rooms" | "rooms" => Some(Box::new(SimpleRooms::default())),
        "voronoi" => Some(Box::new(Voronoi::default())),
        "dla" => Some(Box::new(Dla::default())),
        "wfc" | "wave_function_collapse" => Some(Box::new(Wfc::default())),
        "percolation" => Some(Box::new(Percolation::default())),
        "diamond_square" => Some(Box::new(DiamondSquare::default())),
        "agent" => Some(Box::new(AgentBased::default())),
        "fractal" => Some(Box::new(Fractal::default())),
        "noise_fill" | "noise" => Some(Box::new(NoiseFill::default())),
        "glass_seam" | "gsb" => Some(Box::new(GlassSeam::default())),
        "room_accretion" | "accretion" => Some(Box::new(RoomAccretion::default())),
        _ => None,
    }
}

/// List all available algorithm names
#[must_use]
pub fn list() -> &'static [&'static str] {
    &[
        "bsp",
        "cellular",
        "drunkard",
        "maze",
        "rooms",
        "voronoi",
        "dla",
        "wfc",
        "percolation",
        "diamond_square",
        "agent",
        "fractal",
        "noise_fill",
        "glass_seam",
        "room_accretion",
    ]
}