worldgen 0.5.3

Noisemap and world generation library
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

//////////////////////////////////////////////////////////////////////////////
//  File: rust-worldgen/noisemap/property.rs
//////////////////////////////////////////////////////////////////////////////
//  Copyright 2015 Samuel Sleight
//
//  Licensed under the Apache License, Version 2.0 (the "License");
//  you may not use this file except in compliance with the License.
//  You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
//  Unless required by applicable law or agreed to in writing, software
//  distributed under the License is distributed on an "AS IS" BASIS,
//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//  See the License for the specific language governing permissions and
//  limitations under the License.
//////////////////////////////////////////////////////////////////////////////

use super::NoiseMapGenerator;

use std::cmp::{PartialOrd, Ord, Ordering};
use std::default::Default;
use std::hash::{Hash, Hasher};
use std::collections::hash_map::DefaultHasher;

/// A property is an option that can be set on a noise map.
pub trait Property : Default + Copy {
    fn set_to<NM: NoiseMapGenerator>(self, nm: NM) -> NM;
}

/// Sets the seed that is used for generating the noise.
#[derive(Default, Copy, Clone, Debug, PartialEq, Eq)]
pub struct Seed {
    pub value: u64
}

impl Seed {
    /// Sets the seed to an exact integer value.
    pub fn of_value(value: u64) -> Seed {
        Seed {
            value
        }
    }

    /// Sets the seed to the hash of whatever is provided.
    pub fn of<T: Hash>(value: T) -> Seed {
        let mut hasher = DefaultHasher::new();
        value.hash(&mut hasher);

        Seed {
            value: hasher.finish()
        }
    }
}

impl Property for Seed {
    fn set_to<NM: NoiseMapGenerator>(self, nm: NM) -> NM {
        nm.set_seed(self)
    }
}

/// Sets the increment in x and y for each coordinate in the
/// noise map.
///
/// The default values of this are 0, so if you do not set this then
/// every value will be the same.
#[derive(Default, Copy, Clone, Debug, PartialEq)]
pub struct Step {
    pub x: f64,
    pub y: f64
}

impl Step {
    pub fn of(x: f64, y: f64) -> Step {
        Step {
            x,
            y
        }
    }
}

impl Property for Step {
    fn set_to<NM: NoiseMapGenerator>(self, nm: NM) -> NM {
        nm.set_step(self)
    }
}

/// Sets the size of the generated chunks.
///
/// The default values of this are 0, so if you do not set this then
/// nothing will be generated. In a combination it needs to be set for only
/// one of the member noisemaps, because the size will be set to whichever is
/// largest when the combination is created.
#[derive(Default, Copy, Clone, Debug, PartialEq, Eq)]
pub struct Size {
    pub w: i64,
    pub h: i64
}

impl Size {
    pub fn of(w: i64, h: i64) -> Size {
        Size {
            w,
            h
        }
    }
}

impl Property for Size {
    fn set_to<NM: NoiseMapGenerator>(self, nm: NM) -> NM {
        nm.set_size(self)
    }
}

impl PartialOrd for Size {
    fn partial_cmp(&self, other: &Size) -> Option<Ordering> {
        (self.w * self.h).partial_cmp(&(other.w * other.h))
    }
}

impl Ord for Size {
    fn cmp(&self, other: &Size) -> Ordering {
        self.partial_cmp(other).unwrap()
    }
}