Noise Explained | ezEdits Wiki

Last updated 25 days ago

Noise can be a complex topic for anyone who has never read into it before, but in its simplest terms, noise is a way of getting a value out of some input (usually X,Y,Z coordinates).

The place you will likely be most familiar with noise is in Minecraft's terrain generation. At every point in the world, several noise functions are combined to determine if a block should be placed, and if so, which block.

This is pretty much what we do in ezEdits, using noise to generate shapes, terrain, and textures.

Within the plugin you will find several noise types, with each having different characteristics, and Cellular specifically coming with many additional parameters you can customise.

Some of the many features that use noise include:

//eznoisegen ... - Noisegen Commands
#eznoisemask - Masks
//ezbrush gradient ... - Brushes

Noise in ezEdits based on a modified version of FastNoiseLite, so we strongly recommend this website to experiment with noise parameters:

Noise Parameters

Each parameter and many values also has a shorthand, such as "Fractal" instead of "FractalType" or "Simplex" instead of "OpenSimplex2". Wherever this is possible, the shorthand will be shown in brackets. Red = Parameter Purple = Value

Noise Type

Setting the Noise Type

Sets the type of noise to be used. This is the start of any noise and will be in the format of Noise(), for example Perlin(), where all other parameters will go between the brackets.

Perlin (per)
OpenSimplex2 (simplex)
OpenSimplex2S (smooth)
Value (val)
ValueCubic (cubic)
White
Cellular (vor)
Shard

Basic Noise Parameters

Seed Sets the seed value for the noise. -1 or no value will result in a random noise seed.
Frequency (Freq) Sets the frequency for the noise. A higher frequency will lead to steeper noise, a lower value will lead to smoother noise.
Inverted (Invert) Whether to invert the noise value or not. Default is false.
- True
- False
ValueMapping (Map) Whether to ignore or override the value mapping. By default noise is sampled to map between 0 and 1.
- Default (Def)
- None (No)
- Override (OR) If Overridden:
  - LowerBound (Min)
  - UpperBound (Max)
XScaling (X) This can be used to stretch or squish the X axis.
YScaling (Y) When using 3D noises this can be used to stretch or squish the Y axis.
ZScaling (Z) This can be used to stretch or squish the Z axis.

Cellular Noise Parameters

Additional Cellular Noise Parameters

CellularJitterModifier (Jitter) Usually 0..1.0 Controls the random jitter or distribution of cellular noise nodes, with 0 being a perfect grid, and 1 being maximally "random", without overlap. Values above 1 will start to overlap their neighbours.
CellularDistanceFunction (Distance) Controls the mathematical method used to determine the distance value for each point to its node.
- Euclidean
- EuclideanSq (sq)
- Manhattan (man)
- Hybrid
- Minkovski1 (m1)
- Minkowvki4 (m4)
- Minkowski99 (m99)
- Rounded (round)
CellularReturnType (DistReturn) Controls how the distance value is modified prior to being returned. All Distance2* values refer to the 2nd closest node instead of the closest.
- CellValue (cell)
- Distance (1)
- DistanceSquared (sq)
- DistanceInverse (inv)
- DistanceLog (log)
- DistanceExp (exp)
- Distance2 (2)
- Distance2Add (2add)
- Distance2Add (2sub)
- Distance2Add (2mul)
- Distance2Add (2div)
- Distance2Sq (2sq)
- Distance2Inv (2inv)
- Distance2Log (2log)
- Distance2Exp (2exp)
- Edge
- Rounded (round)
- NoiseLookup (noise) Additional Noise Lookup Parameters:
  - CellularNoiseLookup (Lookup) When using the NoiseLookup return type, this controls the underlying noise to overlay the cellular noise upon.
    Perlin (per)
    OpenSimplex2 (simplex)
    OpenSimplex2S (smooth)
    Value (val)
    ValueCubic (cubic)
    White
    Cellular (vor)
  - CellularNoiseLookupFrequency (DistReturn) Controls the frequency of the underlying noise.

Shard Noise Parameters

Additional Shard Noise Parameters

Sharpness (Sharp) Usually 0..1.0 Controls the pattern sharpness for Shard noise. Higher values have more defined edges within the pattern, whereas low values will appear more blurry.

Fractal Noise Parameters

FractalType (Fractal) Sets the type of fractal noise to be used.
- None (No)
- FBm
- Ridged
- PingPong (PP) Additional PingPong Fractal Parameter:
  - PingPongStrength (PPStr)

If Fractal Type other than None selected:

Octaves (Oct) Sets the number of layers of fractal noise to be used.
Lacunarity (Lac) Sets the scale of each fractal layer. Values >1 will effectively increase the frequency for each layer, values <1 will effectively reduce the frequency for each layer.
Gain Sets the relative strength of each fractal layer. Values <1 will decrease in strength for each layer, values >1 will increase.
WeightedStrength (Weighted) Sets the responsiveness of each layer's strength to the noise value.

Domain Warp Parameters

DomainWarpType (Warp) Sets the type of domain warping to be used.
- None (No)
- BasicGrid (Grid)
- OpenSimplex2 (Simplex)
- OpenSimplex2Reduced (Reduced)
- Flow
- Turbulence (Turb)

If Domain Warp Type other than None selected:

DomainWarpFreq (WarpFreq) Sets the frequency for the domain warp.
DomainWarpOct (WarpOct) Sets the number of layers for the domain warp.
DomainWarpGain (WarpGain) Sets the relative strength of each domain warp layer.
DomainWarpAmp (WarpAmp) Sets the overall amplitude (strength) of the domain warp.
DomainWarpFrac (WarpFrac) Sets the domain warp specific fractal type to be used.
- None (No)
- DomainWarpIndependent (ind)
- DomainWarpProgressive (prog)
DomainWarpLacunarity (WarpLac) Sets the scale of each domain warp layer.

Examples

Value(Seed:123,Freq:0.04)

Cellular(Distance:Euclidean,DistReturn:NoiseLookup,Lookup:Perlin,LookupFreq:0.2,Freq:0.1)