Implement 4D noise

Author: monkstone

src/main/java/monkstone/noise/Noise.java

@@ -42,6 +42,40 @@ default float noise(float x, float y) {
 
  /**
  * <p>
+ * Returns the Perlin noise value at specified coordinates.Perlin noise is
+ a random sequence generator producing a more natural ordered, harmonic
+ succession of numbers compared to the standard <b>random()</b> function. It was invented by Ken Perlin in the 1980s and been used since in
+ graphical applications to produce procedural textures, natural motion,
+ shapes, terrains etc. The main difference to the
+ <b>random()</b> function is that Perlin noise is defined in an infinite
+ * n-dimensional space where each pair of coordinates corresponds to a fixed
+ * semi-random value (fixed only for the lifespan of the program). The
+ * resulting value will always be between 0.0 and 1.0. Processing can
+ * compute 1D, 2D and 3D noise, depending on the number of coordinates
+ * given. The noise value can be animated by moving through the noise space
+ * as demonstrated in the example above. The 2nd and 3rd dimension can also
+ * be interpreted as time.The actual noise is structured similar to an audio
+ * signal, in respect to the function's use of frequencies. Similar to the
+ * concept of harmonics in physics, perlin noise is computed over several
+ * octaves which are added together for the final result. Another way to
+ * adjust the character of the resulting sequence is the scale of the input
+ * coordinates. As the function works within an infinite space the value of
+ * the coordinates doesn't matter as such, only the distance between
+ * successive coordinates does (eg. when using <b>noise()</b> within a
+ * loop). As a general rule the smaller the difference between coordinates,
+ * the smoother the resulting noise sequence will be. Steps of 0.005-0.03
+ * work best for most applications, but this will differ depending on use.
+ * <p>
+ * @param x x-coordinate in noise space
+ * @param y y-coordinate in noise space
+ * @param z z-coordinate in noise space
+ * @param w w-coordinate typically time
+ * @return
+ */
+ float noise(float x, float y, float z);
+
+ /**
+ * <p>
  * Returns the Perlin noise value at specified coordinates. Perlin noise is
  * a random sequence generator producing a more natural ordered, harmonic
  * succession of numbers compared to the standard <b>random()</b> function.
@@ -72,7 +106,7 @@ default float noise(float x, float y) {
  * @param z z-coordinate in noise space
  * @return
  */
- float noise(float x, float y, float z);
+ float noise(float x, float y, float z, float w);
 
  /**
  * Adjusts the character and level of detail produced by the Perlin noise

src/main/java/monkstone/noise/NoiseGenerator.java

@@ -26,6 +26,11 @@ public NoiseGenerator(Noise implementation){
  public float noise(float x, float y, float z) {
  return implementation.noise(x, y, z);
  }
+ 
+ @Override
+ public float noise(float x, float y, float z, float w) {
+ return implementation.noise(x, y, z, w);
+ }
 
  @Override
  public void noiseDetail(int lod) {

src/main/java/monkstone/noise/SimplexNoise.java

@@ -274,7 +274,17 @@ else if (x0 < z0) {
  }
 
  // 4D simplex noise, better simplex rank ordering method 2012-03-09
- public static float noise(float x, float y, float z, float w) {
+
+ /**
+ *
+ * @param x
+ * @param y
+ * @param z
+ * @param w
+ * @return
+ */
+ @Override
+ public float noise(float x, float y, float z, float w) {
 
  float n0, n1, n2, n3, n4; // Noise contributions from the five corners
  // Skew the (x,y,z,w) space to determine which cell of 24 simplices we're in

src/main/java/monkstone/noise/ValueNoise.java

@@ -131,6 +131,8 @@ public float noise(float x, float y, float z) {
  }
  return r;
  }
+ 
+
 
  @Override
  public void noiseDetail(int lod) {
@@ -157,4 +159,10 @@ public void noiseSeed(long seed) {
  perlinRandom.setSeed(seed);
  perlin = null;
  }
+
+ @Override
+ public float noise(float x, float y, float z, float w) {
+ String message = "Use Simplex Noise for 4D noise";
+ throw new UnsupportedOperationException(message); 
+ }
 }

src/main/java/processing/core/PApplet.java

@@ -4932,13 +4932,12 @@ public float noise(float x, float y) {
  /**
  * ( begin auto-generated from noise.xml )
  *
- * Returns the Perlin noise value at specified coordinates. Perlin noise is
- * a random sequence generator producing a more natural ordered, harmonic
- * succession of numbers compared to the standard <b>random()</b> function.
- * It was invented by Ken Perlin in the 1980s and been used since in
- * graphical applications to produce procedural textures, natural motion,
- * shapes, terrains etc. The main difference to the
- * <b>random()</b> function is that Perlin noise is defined in an infinite
+ * Returns the Perlin noise value at specified coordinates.Perlin noise is
+ a random sequence generator producing a more natural ordered, harmonic
+ succession of numbers compared to the standard <b>random()</b> function. It was invented by Ken Perlin in the 1980s and been used since in
+ graphical applications to produce procedural textures, natural motion,
+ shapes, terrains etc. The main difference to the
+ <b>random()</b> function is that Perlin noise is defined in an infinite
  * n-dimensional space where each pair of coordinates corresponds to a fixed
  * semi-random value (fixed only for the lifespan of the program). The
  * resulting value will always be between 0.0 and 1.0. Processing can
@@ -4959,6 +4958,7 @@ public float noise(float x, float y) {
  *
  * ( end auto-generated )
  *
+ * @return 
  * @webref math:random
  * @param x x-coordinate in noise space
  * @param y y-coordinate in noise space
@@ -4971,6 +4971,17 @@ public float noise(float x, float y, float z) {
  return noiseGenerator.noise(x, y, z);
  }
 
+ /**
+ *
+ * @param x
+ * @param y
+ * @param z
+ * @param w
+ * @return
+ */
+ public float noise(float x, float y, float z, float w) {
+ return noiseGenerator.noise(x, y, z, w);
+ }
 
 
  // [toxi 040903]