aboutsummaryrefslogtreecommitdiffstats
path: root/src/libnoiseforjava/module/ScaleBias.java
blob: 66daea497d908bfa12bc60421dafc3c85a84c12e (plain)
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
/*
 * Copyright (C) 2003, 2004 Jason Bevins (original libnoise code)
 * Copyright  2010 Thomas J. Hodge (java port of libnoise)
 * 
 * This file is part of libnoiseforjava.
 * 
 * libnoiseforjava is a Java port of the C++ library libnoise, which may be found at 
 * http://libnoise.sourceforge.net/.  libnoise was developed by Jason Bevins, who may be 
 * contacted at jlbezigvins@gmzigail.com (for great email, take off every 'zig').
 * Porting to Java was done by Thomas Hodge, who may be contacted at
 * libnoisezagforjava@gzagmail.com (remove every 'zag').
 * 
 * libnoiseforjava is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the Free Software
 * Foundation, either version 3 of the License, or (at your option) any later version.
 * 
 * libnoiseforjava is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License along with
 * libnoiseforjava.  If not, see <http://www.gnu.org/licenses/>.
 * 
 */

package libnoiseforjava.module;

import libnoiseforjava.exception.ExceptionInvalidParam;

public class ScaleBias extends ModuleBase
{

   /// Noise module that applies a scaling factor and a bias to the output
   /// value from a source module.
   ///
   /// The getValue() method retrieves the output value from the source
   /// module, multiplies it with a scaling factor, adds a bias to it, then
   /// outputs the value.
   ///
   /// This noise module requires one source module.

   /// Default bias for the ScaleBias noise module.
   static final double DEFAULT_BIAS = 0.0;

   /// Default scale for the ScaleBias noise module.
   static final double DEFAULT_SCALE = 1.0;

   /// Bias to apply to the scaled output value from the source module.
   double bias;

   /// Scaling factor to apply to the output value from the source
   /// module.
   double scale;

   
   public ScaleBias (ModuleBase sourceModule) throws ExceptionInvalidParam
   {
      super(1);
      setSourceModule(0, sourceModule);
      bias = DEFAULT_BIAS;
      scale = DEFAULT_SCALE;
   }

   public double getValue (double x, double y, double z)
   {
      assert (sourceModules[0] != null);

      return sourceModules[0].getValue (x, y, z) * scale + bias;
   }

   /// Returns the bias to apply to the scaled output value from the
   /// source module.
   ///
   /// @returns The bias to apply.
   ///
   /// The getValue() method retrieves the output value from the source
   /// module, multiplies it with the scaling factor, adds the bias to
   /// it, then outputs the value.
   public double getBias ()
   {
      return bias;
   }

   /// Returns the scaling factor to apply to the output value from the
   /// source module.
   ///
   /// @returns The scaling factor to apply.
   ///
   /// The getValue() method retrieves the output value from the source
   /// module, multiplies it with the scaling factor, adds the bias to
   /// it, then outputs the value.
   public double getScale ()
   {
      return scale;
   }


   /// Sets the bias to apply to the scaled output value from the source
   /// module.
   ///
   /// @param bias The bias to apply.
   ///
   /// The getValue() method retrieves the output value from the source
   /// module, multiplies it with the scaling factor, adds the bias to
   /// it, then outputs the value.
   public void setBias (double bias)
   {
      this.bias = bias;
   }

   /// Sets the scaling factor to apply to the output value from the
   /// source module.
   ///
   /// @param scale The scaling factor to apply.
   ///
   /// The getValue() method retrieves the output value from the source
   /// module, multiplies it with the scaling factor, adds the bias to
   /// it, then outputs the value.
   public void setScale (double scale)
   {
      this.scale = scale;
   }

}