misc/noise.h

   1 /*
   2 Minetest-c55
   3 Copyright (C) 2010-2011 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU General Public License as published by
   7 the Free Software Foundation; either version 2 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU General Public License for more details.
  14
  15 You should have received a copy of the GNU General Public License along
  16 with this program; if not, write to the Free Software Foundation, Inc.,
  17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20 #ifndef NOISE_HEADER
  21 #define NOISE_HEADER
  22
  23 double easeCurve(double t);
  24
  25 // Return value: -1 ... 1
  26 double noise2d(int x, int y, int seed);
  27 double noise3d(int x, int y, int z, int seed);
  28
  29 double noise2d_gradient(double x, double y, int seed);
  30 double noise3d_gradient(double x, double y, double z, int seed);
  31
  32 double noise2d_perlin(double x, double y, int seed,
  33                 int octaves, double persistence);
  34
  35 double noise2d_perlin_abs(double x, double y, int seed,
  36                 int octaves, double persistence);
  37
  38 double noise3d_perlin(double x, double y, double z, int seed,
  39                 int octaves, double persistence);
  40
  41 double noise3d_perlin_abs(double x, double y, double z, int seed,
  42                 int octaves, double persistence);
  43
  44 enum NoiseType
  45 {
  46         NOISE_PERLIN,
  47         NOISE_PERLIN_ABS,
  48         NOISE_PERLIN_CONTOUR,
  49         NOISE_PERLIN_CONTOUR_FLIP_YZ
  50 };
  51
  52 struct NoiseParams
  53 {
  54         NoiseType type;
  55         int seed;
  56         int octaves;
  57         double persistence;
  58         double pos_scale;
  59         double noise_scale; // Useful for contour noises
  60
  61         NoiseParams(NoiseType type_=NOISE_PERLIN, int seed_=0,
  62                         int octaves_=3, double persistence_=0.5,
  63                         double pos_scale_=100.0, double noise_scale_=1.0):
  64                 type(type_),
  65                 seed(seed_),
  66                 octaves(octaves_),
  67                 persistence(persistence_),
  68                 pos_scale(pos_scale_),
  69                 noise_scale(noise_scale_)
  70         {
  71         }
  72 };
  73
  74 double noise3d_param(const NoiseParams &param, double x, double y, double z);
  75
  76 class NoiseBuffer
  77 {
  78 public:
  79         NoiseBuffer();
  80         ~NoiseBuffer();
  81
  82         void clear();
  83         void create(const NoiseParams &param,
  84                         double first_x, double first_y, double first_z,
  85                         double last_x, double last_y, double last_z,
  86                         double samplelength_x, double samplelength_y, double samplelength_z);
  87         void multiply(const NoiseParams &param);
  88         // Deprecated
  89         void create(int seed, int octaves, double persistence,
  90                         bool abs,
  91                         double first_x, double first_y, double first_z,
  92                         double last_x, double last_y, double last_z,
  93                         double samplelength_x, double samplelength_y, double samplelength_z);
  94
  95         void intSet(int x, int y, int z, double d);
  96         void intMultiply(int x, int y, int z, double d);
  97         double intGet(int x, int y, int z);
  98         double get(double x, double y, double z);
  99
 100 private:
 101         double *m_data;
 102         double m_start_x, m_start_y, m_start_z;
 103         double m_samplelength_x, m_samplelength_y, m_samplelength_z;
 104         int m_size_x, m_size_y, m_size_z;
 105 };
 106
 107 #endif
 108