2D-Noise-Mixer

The 2D noise mixer is designed to make mixing different noise types quickly with only a few lines of code. Highly commented and easy to use, this system tries to be non-platform specific.

Description

This 2D noise mixer will let the user have a high degree of control over the different noise layers, and over the mixer itself. A list of noises are provided as well as a list of manipulations including masking between layers, shifting, scaling, and inverting. The noise is calculated on the CPU and can be off loaded onto a background thread as necessary. New noises are easy to implement with the INoise interface, and can be up and running in a short while.

A list of already added noises are

• Perlin Noise
• Simplex Noise
• Voronoi Noise
• Worley Noise
• OpenSimplex Noise
• OpenSimplex2S Noise
• Billow Noise
• Fractal Brownian Motion Noise (fBm)
• Multi-fractal Ridged Noise
• Ridged Noise

Some Example Output

Using Unity: 2D Mixed Noise applied as a texture to a plain on the left, 2D Mixed Noise applied to the terrain system on the right.

Getting Started

Dependencies

• Basic C# libraries such as System.
• My Utilities Repo.

Installing

• Download and add files to your project.
• If a library is not available on your platform it probable can be remove from being necessary with minimal code change.

Documentation

Please note: the classes themselves have more Documentation in their XML Docs.

• How to use the class

*The following creates a new Noise Mixer class.

using NoiseMixer;
NoiseMixer noiseMixer = new NoiseMixer.NoiseMixer((uint)resolution, (uint)resolution);

• To mix a new layer (in this case Perlin noise) with the current layer the following is shown. A new Perlin noise class is added in the INoise parameter, and float is added to scale it.

noiseMixer.NewCombineLayer(new PerlinNoise(seed), ScaleNoise);

• A list of different types of noise layers include:

noiseMixer.NewCombineLayer(INoise Noise, double NoiseScale);
noiseMixer.NewAddLayer(INoise Noise, double NoiseScale);
noiseMixer.NewDivideLayer(INoise Noise, double NoiseScale);
noiseMixer.NewMultiplyLayer(INoise Noise, double NoiseScale);
noiseMixer.NewOnlyHigherLayer(INoise Noise, double NoiseScale);
noiseMixer.NewOnlyLowerLayer(INoise Noise, double NoiseScale);
noiseMixer.NewSubtractLayer(INoise Noise, double NoiseScale);

• A list of effects can be added to each layer such as:

noiseMixer.NewCombineLayer(new PerlinNoise(seed), ScaleNoise).LayerMask(float MaskAmount);
noiseMixer.NewCombineLayer(new PerlinNoise(seed), ScaleNoise).Inverse();
noiseMixer.NewCombineLayer(new PerlinNoise(seed), ScaleNoise).Scale(float ScaleAmount);
noiseMixer.NewCombineLayer(new PerlinNoise(seed), ScaleNoise).Shift(float ShiftAmount);

• Or strung together:

noiseMixer.NewCombineLayer(new PerlinNoise(seed), ScaleNoise).LayerMask(float MaskAmount).Shift(float ShiftAmount).Scale(float ScaleAmount).Inverse();

• Instead of manipulating the layer, the Mixer class itself can be manipulated, which in turn manipulates every value in the mixer.

noiseMixer.Inverse();
noiseMixer.Scale(float ScaleAmount);
noiseMixer.Shift(float ScaleAmount);
noiseMixer.Tier(int AmountOfTiers);

• The Erosion effect can be added as well:

noiseMixer.HydraulicErosion(int Iterations);

• Once all of the layers have been setup, Apply() must be called to do the calculations (or ApplyF() if an array of floats is preferred). Both methods are run on the main thread.

noiseMixer.Apply(bool normalize); //For double array
//or
noiseMixer.ApplyF(bool normalize); //For float array

• If doing the calculations on a background thread is preferred, use

noiseMixer.ApplyOnOtherThreads(uint threadsAmount);

• If the calculations were done on a background thread, or the mixer was already computed and the user want to retrieve the values without doing the calculations again GetCalculations() can be called to retrieve the results.

noiseMixer. GetCalculations(out double[,] Results, bool normalize); // for double array
//or
noiseMixer. GetCalculationsF(out float[,] Results, bool normalize); // for float array

Help

Need help ask in the issues section.

Authors

Jay Van Schaick

Version History

• 0.1
  • Initial Release

License

This project is licensed under the MIT License - see https://opensource.org/licenses/MIT for details

Acknowledgments

Inspiration, code snippets, etc are in the classes themselves with a link to the originals.