WardBenjamin / SimplexNoise

C# Simplex Noise (1D, 2D, 3D). Supports arbitrary sizes and scales.
BSD 3-Clause "New" or "Revised" License
160 stars 38 forks source link

Simplex Noise

Simplex Noise implementation offering 1D, 2D, and 3D forms w/ values in the range of 0 to 255. Based on work by Heikki Törmälä (2012) and Stefan Gustavson (2006). Core algorithm designed by Ken Perlin (2001).

Nuget Nuget

What does this library provide?

This library provides 1D, 2D, and 3D simplex noise, which is useful for procedural content generation - for example, terrain and particles in game development or visual media in movies. Compared to classic Perlin noise, simplex noise has no noticable directional artefacts, and has a well-defined and continuous (coherent) gradient. This means content will be visually smoother, with a lower computational complexity especially at higher orders.

Computations use the following r^2 values to determine kernel contribution:

Order Value
1D 1.0
2D 0.5
3D 0.6

Why use simplex noise?

Classic noise has problems with non-uniformity throughout its domain of definition, particularly for 2D planar slices of 3D and 4D noise, it has visible axis-aligned artefacts, it is expensive to compute for 4D and up, and its derivative in 3D and 4D is a very complicated high order polynomial.

Simplex noise is several times faster to compute, particularly for 4D and up, it does not have nearly as many visual problems with non-uniformity and axis-aligned artefacts, and it has a simple polynomial derivative everywhere, even for higher dimensions.

Simplex noise looks better, but different, and is thus visually incompatible with classic Perlin noise. The difference in feature size and range of values can easily be compensated for by a few simple scaling multiplications, but the different visual character might change the visual result of shaders that depend heavily on one or two components of noise. (Fractal sums of several noise components should still look about the same, though.)

Example of implementation

using SimplexNoise;

Noise.Seed = 209323094; // Optional

int length = 10, width = 15; // The number of points to generate in the 1st and 2nd dimension
float scale = 0.10f; // The scale of the noise. The greater the scale, the denser the noise gets
float[,] noiseValues = Noise.Calc2D(length, width, scale); // Returns an array containing 2D Simplex noise

API

Noise.Seed

Arbitrary integer seed used to generate lookup table used internally. You can set the Seed property to get deterministic noise, otherwise, the Seed will default to 0.

Noise.Seed = 123456;

Noise.Calc1D

Creates 1D Simplex noise.

int width = 10; // The number of points to generate
float scale = 0.10f; // The scale of the noise. The greater the scale, the denser the noise gets // The scale of the noise. The greater the scale, the denser the noise gets
float[] noise = Noise.Calc1D(width, scale); // Returns an array containing 1D Simplex noise

Noise.Calc2D

Creates 2D Simplex noise.

int width = 10, height = 15; // The number of points to generate in the 1st and 2nd dimension
float scale = 0.10f; // The scale of the noise. The greater the scale, the denser the noise gets
float[,] noise = Noise.Calc2D(width, height, scale); // Returns an array containing 2D Simplex noise

Noise.Calc3D

Creates 3D Simplex noise.

int width = 10, height = 15, length = 20; // The number of points to generate in the 1st, 2nd and 3rd dimension
float scale = 0.10f; // The scale of the noise. The greater the scale, the denser the noise gets
float[,,] noise = Noise.Calc3D(width, height, length, scale); // Returns an array containing 3D Simplex noise

Noise.CalcPixel1D

Gets the value of an index of 1D simplex noise.

int x = 10; // Index
float scale = 0.10f; // The scale of the noise. The greater the scale, the denser the noise gets
float pixel = Noise.CalcPixel1D(x, scale); // Returns the value of an index of 1D simplex noise

Noise.CalcPixel2D

Gets the value of an index of 2D simplex noise.

int x = 10, y = 15; // Indexes for the 1st and 2nd dimension
float scale = 0.10f; // The scale of the noise. The greater the scale, the denser the noise gets
float pixel = Noise.CalcPixel2D(x, y, scale); // Returns the value of an index of 2D simplex noise

Noise.CalcPixel3D

Gets the value of an index of 3D simplex noise.

int x = 10, y = 15, z = 20; // Indexes for the 1st, 2nd and 3rd dimension
float scale = 0.10f; // The scale of the noise. The greater the scale, the denser the noise gets
float pixel = Noise.CalcPixel3D(x, y, z, scale);// Returns the value of an index of 3D simplex noise