Version:

Add the FastNoise Gradient component to use one of the noise generation algorithms from the FastNoise library to generate a gradient. The noise generation algorithm is set in the component’s Noise Type property.

Fast Noise Gem

## Noise types

ValueGenerates a White Noise gradient based on interpolated values from XYZ-coordinates.
Value FractalResults from the Value algorithm are run through a fractal function.
PerlinGenerates values from the Perlin noise algorithm, a noise algorithm where visual features are all of similar size.
Perlin FractalResults from the Perlin noise algorithm are run through a fractal function.
SimplexGenerates values from the Simplex noise algorithm, a variation of Perlin noise with fewer directional artifacts.
Simplex FractalResults from the Simplex noise algorithm are run through a fractal function.
CellularGenerates values from a cellular noise algorithm, which assigns values based on randomly distributed feature points; each world position is assigned the value of the closest feature point.
White NoiseGenerates values from XYZ-coordinates, which produce extremely different values for adjacent samples.
CubicGenerates values directly from XYZ-coordinates that are then run through cubic interpolation with neighboring values. The results are similar to Perlin noise, but with fewer directional artifacts and with a higher occurrence of extreme values.
Cubic FractalResults from the Cubic noise algorithm are run through a fractal function.
Note:
Not all combinations of Noise Type and noise property settings have the same performance characteristics.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
FrequencySets the frequency of the generated noise. Smaller values result in noise that is dilated and larger values result in noise that is condensed.Float: 0.0001 - Infinity1.0
FastNoise Advanced Settings - InterpolationSets the function used to smooth between gradient values. Refer to the following section for Interpolation type descriptions and examples.Linear, Hermite, or QuinticQuintic
Generate Random SeedSets the Random Seed property to a random value.

### Value Interpolation type examples

LinearLinear interpolation produces angular artifacts.
HermiteHermite interpolation produces smooth blurred values.
QuinticQuintic interpolation produces more defined edges than Hermite without the angular artifacts of Linear.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
FrequencySets the frequency of the generated noise. Smaller values result in noise that is dilated and larger values result in noise that is condensed.Float: 0.0001 - Infinity1.0
OctavesSets the number of recursions of pattern generation. Higher values produce finer details. Values higher than 4 may not be perceptible.Integer: 0 - 84
LacunaritySets a frequency multiplier to apply to successive Octaves.Float 0.0 to Infinity2.0
GainSets a relative strength multiplier to apply to successive Octaves.Float: 0.0 to Infinity0.5
FastNoise Advanced Settings - InterpolationSets the function used to smooth between gradient values. Refer to the following section for Interpolation type descriptions and examples.Linear, Hermite, or QuinticQuintic
FastNoise Advanced Settings - Fractal TypeSets the method of fractal combination. Refer to the following section for Fractal Type descriptions and examples.FBM, Billow, or Rigid MultiFBM
Generate Random SeedSets the Random Seed property to a random value.

### Value Fractal Interpolation type examples

LinearLinear interpolation produces angular artifacts.
HermiteHermite interpolation produces smooth blurred values.
QuinticQuintic interpolation produces more defined edges than Hermite without the angular artifacts of Linear.

### Value Fractal Type examples

FBMFBM or fractional Brownian motion adds multiple frequencies and amplitudes of the noise signal together.
BillowA variant of FBM. Billow adds the absolute value of multiple frequencies and amplitudes of the noise signal together. This produces extreme lows in the gradient’s values.
Rigid MultiA variant of FBM. Rigid Multi subtracts the inverse of the absolute value of multiple frequencies and amplitudes of the noise signal from each other. This produces extreme highs in the gradient’s values.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
FrequencySets the frequency of the generated noise. Smaller values result in noise that is dilated and larger values result in noise that is condensed.Float: 0.0001 - Infinity1.0
FastNoise Advanced Settings - InterpolationSets the function used to smooth between gradient values. Refer to the following section for Interpolation type descriptions and examples.Linear, Hermite, or QuinticQuintic
Generate Random SeedSets the Random Seed property to a random value.

### Perlin Interpolation type examples

LinearLinear interpolation produces angular artifacts.
HermiteHermite interpolation produces smooth blurred values.
QuinticQuintic interpolation produces more defined edges than Hermite without the angular artifacts of Linear.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
FrequencySets the frequency of the generated noise. Smaller values result in noise that is dilated and larger values result in noise that is condensed.Float: 0.0001 - Infinity1.0
OctavesSets the number of recursions of pattern generation. Higher values produce finer details. Values higher than 4 may not be perceptible.Integer: 0 - 84
LacunaritySets a frequency multiplier to apply to successive Octaves.Float 0.0 to Infinity2.0
GainSets a relative strength multiplier to apply to successive Octaves.Float: 0.0 to Infinity0.5
FastNoise Advanced Settings - InterpolationSets the function used to smooth between gradient values. Refer to the following section for Interpolation type descriptions and examples.Linear, Hermite, or QuinticQuintic
FastNoise Advanced Settings - Fractal TypeSets the method of fractal combination. Refer to the following section for Fractal Type descriptions and examples.FBM, Billow, or Rigid MultiFBM
Generate Random SeedSets the Random Seed property to a random value.

### Perlin Fractal Interpolation type examples

LinearLinear interpolation produces angular artifacts.
HermiteHermite interpolation produces smooth blurred values.
QuinticQuintic interpolation produces more defined edges than Hermite without the angular artifacts of Linear.

### Perlin Fractal Type examples

FBMFBM or fractional Brownian motion adds multiple frequencies and amplitudes of the noise signal together.
BillowA variant of FBM. Billow adds the absolute value of multiple frequencies and amplitudes of the noise signal together. This produces extreme lows in the gradient’s values.
Rigid MultiA variant of FBM. Rigid Multi subtracts the inverse of the absolute value of multiple frequencies and amplitudes of the noise signal from each other. This produces extreme highs in the gradient’s values.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
FrequencySets the frequency of the generated noise. Smaller values result in noise that is dilated and larger values result in noise that is condensed.Float: 0.0001 - Infinity1.0
Generate Random SeedSets the Random Seed property to a random value.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
FrequencySets the frequency of the generated noise. Smaller values result in noise that is dilated and larger values result in noise that is condensed.Float: 0.0001 - Infinity1.0
OctavesSets the number of recursions of pattern generation. Higher values produce finer details. Values higher than 4 may not be perceptible.Integer: 0 - 84
LacunaritySets a frequency multiplier to apply to successive Octaves.Float 0.0 to Infinity2.0
GainSets a relative strength multiplier to apply to successive Octaves.Float: 0.0 to Infinity0.5
FastNoise Advanced Settings - Fractal TypeSets the method of fractal combination. Refer to the following section for Fractal Type descriptions and examples.FBM, Billow, or Rigid MultiFBM
Generate Random SeedSets the Random Seed property to a random value.

### Simplex Fractal Type examples

FBMFBM or fractional Brownian motion adds multiple frequencies and amplitudes of the noise signal together.
BillowA variant of FBM. Billow adds the absolute value of multiple frequencies and amplitudes of the noise signal together. This produces extreme lows in the gradient’s values.
Rigid MultiA variant of FBM. Rigid Multi subtracts the inverse of the absolute value of multiple frequencies and amplitudes of the noise signal from each other. This produces extreme highs in the gradient’s values.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
FrequencySets the frequency of the generated noise. Smaller values result in noise that is dilated and larger values result in noise that is condensed.Float: 0.0001 - Infinity1.0
Distance FunctionSets the distance function used to calculate the cell value for a given point. The distance functions produce different cell shapes. Refer to the following section for Distance Function examples and descriptions.Euclidean, Manhattan, or NaturalEuclidean
Return TypeSets the type of value that the cellular function returns. Refer to the following section for Return Type examples.CellValue, Distance, Distance2, Distance2Add, Distance2Sub, Distance2Mul, or Distance2DivCellValue
JitterSets the maximum distance that a cellular point can move from its original position. Values above 1.0 may produce artifacts from clamped multiplications.Float: 0.0 to Infinity0.45
Generate Random SeedSets the Random Seed property to a random value.

### Distance Function examples

Euclidean
Manhattan
Natural

### Return Type examples

CellValueReturns the value of the nearest feature point at any given world position.
DistanceReturns the distance to the nearest feature point at any given world position.
Distance2Returns the distance to the second-nearest feature point at any given world position.
Distance2AddReturns the distances of the two closest feature points added together.
Distance2SubReturns the distances of the two closest feature points subtracted from each other.
Distance2MulReturns the distances of the two closest feature points multiplied together.
Distance2DivReturns the distance of the closest feature point divided by the distance of the second-closest feature point.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
Generate Random SeedSets the Random Seed property to a random value.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
FrequencySets the frequency of the generated noise. Smaller values result in noise that is dilated and larger values result in noise that is condensed.Float: 0.0001 - Infinity1.0
Generate Random SeedSets the Random Seed property to a random value.

PropertyDescriptionValuesDefault
PreviewDisplays the output gradient of this component after all properties are applied. Click the previewer icon in the top of the preview image to show a larger preview of the gradient in a dockable window.
Pin Preview to ShapeSets an entity with a compatible Shape component to use as the bounds of the preview if Constrain to Shape is Enabled.EntityIdCurrent Entity
Preview PositionSets the world location of the preview.

This field is available only if there is no entity selected in Pin Preview to Shape.
Vector3: -Infinity to InfinityX:0.0, Y:0.0, Z:0.0
Preview SizeSets the dimensions of the preview.Vector3: 0.0 to InfinityX:1.0, Y:1.0, Z:1.0
Constrain to ShapeIf Enabled, the gradient preview uses the bounds of the entity selected in Pin Preview to Shape.

This field is available only if an entity is selected in Pin Preview to Shape.
BooleanDisabled
Noise TypeSets the noise generation algorithm used to generate the gradient.Value, Value Fractal, Perlin, Perlin Fractal, Simplex, Simplex Fractal, Cellular, White Noise, Cubic, or Cubic FractalPerlin Fractal
Random SeedSets the initialization value for the pseudorandom noise generation algorithm. Each value generates a different pattern of noise.Integer: 1 to Infinity1
FrequencySets the frequency of the generated noise. Smaller values result in noise that is dilated and larger values result in noise that is condensed.Float: 0.0001 - Infinity1.0
OctavesSets the number of recursions of pattern generation. Higher values produce finer details. Values higher than 4 may not be perceptible.Integer: 0 - 84
LacunaritySets a frequency multiplier to apply to successive Octaves.Float 0.0 to Infinity2.0
GainSets a relative strength multiplier to apply to successive Octaves.Float: 0.0 to Infinity0.5
FastNoise Advanced Settings - Fractal TypeSets the method of fractal combination. Refer to the following section for Fractal Type descriptions and examples.FBM, Billow, or Rigid MultiFBM
Generate Random SeedSets the Random Seed property to a random value.

### Cubic Fractal Type examples

FBMFBM or fractional Brownian motion adds multiple frequencies and amplitudes of the noise signal together.
BillowA variant of FBM. Billow adds the absolute value of multiple frequencies and amplitudes of the noise signal together. This produces extreme lows in the gradient’s values.
Rigid MultiA variant of FBM. Rigid Multi subtracts the inverse of the absolute value of multiple frequencies and amplitudes of the noise signal from each other. This produces extreme highs in the gradient’s values.

Use the following request functions with the FastNoiseGradientRequestBus EBus interface to communicate with FastNoise Gradient components in your game.

Request NameDescriptionParameterReturnScriptable
GetFractalTypeReturns the value of the FastNoise Advanced Settings - Fractal Type property.NoneFractal Type Index: IntegerYes
GetFrequencyReturns the value of the Frequency property.NoneFloatYes
GetGainReturns the value of the Gain property.NoneFloatYes
GetInterpolationReturns the value of the FastNoise Advanced Settings - Interpolation property.NoneInterpolation Index: IntegerYes
GetLacunarityReturns the value of the Lacunarity property.NoneFloatYes
GetNoiseTypeReturns the value of the Noise Type property.NoneNoise Type Index: IntegerYes
GetOctavesReturns the value of the Octaves property.NoneOctave Count: IntegerYes
GetRandomSeedReturns the value of the Random Seed property.NoneSeed: IntegerYes
SetFractalTypeSets the value of the FastNoise Advanced Settings - Fractal Type property.Fractal Type Index: IntegerNoneYes
SetFrequencySets the value of the Frequency property.FloatNoneYes
SetGainSets the value of the Gain property.FloatNoneYes
SetInterpolationSets the value of the FastNoise Advanced Settings - Interpolation property.Interpolation Index: IntegerNoneYes
SetLacunaritySets the value of the Lacunarity property.FloatNoneYes
SetNoiseTypeSets the value of the Noise Type property.Noise Type Index: IntegerNoneYes
SetOctavesSets the value of the Octaves property.Octave Count: IntegerNoneYes
SetRandomSeedSets the value of the Random Seed property.Seed: IntegerNoneYes