pluginbase.Helpers.Computative.Algorithms.Perlin Class Reference

Perlin noise implementation More...

Inheritance diagram for pluginbase.Helpers.Computative.Algorithms.Perlin:

Public Member Functions
	Perlin (IPseudoRandom provider, int frequency, int levels)
	Initializes a perlin noise generator More...
	Perlin (int seed, int frequency, int levels)
	Initialize an instance of perlin noise More...
override float	GetValue (int x, int y, int z)
	Get a value between 0-1 More...
override float	GetValue (int x, int y)
	Get a 2D value between 0-1 More...
Public Member Functions inherited from pluginbase.Helpers.Computative.ValuePoint3D
ValuePoint3D	Mix (ValuePoint3D with, float sourceOpacity)
	Mix this value with another one at a certain ratio More...
ValuePoint3D	Lighten (ValuePoint3D with)
	Lighten this value by another one More...
ValuePoint3D	Darken (ValuePoint3D with)
	Darken this value by another one More...
ValuePoint3D	CustomCombine (ValuePoint3D with, Combiner3D.CombinerOperator func)
	Combine two values using a custom combiner More...
ValuePoint3D	CustomManipulator (Manip3D.ManipOperator func)
	Manipulate this value with a custom manipulator More...
ValuePoint3D	Abs ()
	Absolute value More...
ValuePoint3D	Invert ()
	Invert the value from a 0-1 range More...
ValuePoint3D	Brightness (float amount)
	Adjust brightness. Takes in -1 to 1f More...
ValuePoint3D	Contrast (float amount)
	Adjusts contract from -1 to 1 More...
ValuePoint3D	Scale (float factor)
	Scale the specified factor and clamp More...
ValuePoint3D	LinearBounds (float min, float max)
	Linearly interpolates to squish between the bounds More...
ValuePoint3D	Threshold (float threshold)
	Threshold the specified threshold. Returns 0 if below, otherwise 1f More...
ValuePoint3D	Gamma (float gamma)
	Gamma the specified gamma. Range 0f - 2f More...
ValuePoint3D	Clamp ()
	Clamp this value between 0 and 1 More...
ValuePoint3D	Clamp (float min, float max)
	Clamp this value between a min and max More...

Public Attributes
readonly int	Frequency
	Frequency of the perlin noise More...
readonly int	Levels
	Number of levels incorporated into perlin noise More...

Additional Inherited Members
Static Public Member Functions inherited from pluginbase.Helpers.Computative.ValuePoint3D
static ValuePoint3D	operator+ (ValuePoint3D a, ValuePoint3D b)
	Add two value points together More...
static ValuePoint3D	operator- (ValuePoint3D a, ValuePoint3D b)
	Subtract two value points More...
static ValuePoint3D	operator* (ValuePoint3D a, ValuePoint3D b)
	Multiply two value points More...
static ValuePoint3D	operator/ (ValuePoint3D a, ValuePoint3D b)
	Divide one value by another More...

Detailed Description

Perlin noise implementation

Constructor & Destructor Documentation

Perlin() [1/2]

pluginbase.Helpers.Computative.Algorithms.Perlin.Perlin	(	IPseudoRandom	provider,
		int	frequency,
		int	levels
	)

Initializes a perlin noise generator

Parameters

provider	Random Provider.
frequency	Frequency.
levels	Levels.

Attribute: levels

;

Attribute: levels

;

Attribute: level

= (int)(Frequency / (float)Math.Pow(2, level));

Attribute: level

= (1f / (float)Math.Pow(2, level)) / (float)maxWeight;

        {
            random = new Random3D(provider);
            Frequency = frequency;
            Levels = levels;

            double maxWeight = 2.0 * (1.0 - Math.Pow(0.5, levels)); //Sum of halves to determine max weight value to scale
            _sizeTable = new int[levels];
            _weightTable = new float[levels];
            for (int level = 0; level < Levels; ++level)
            {
                _sizeTable[level] = (int)(Frequency / (float)Math.Pow(2, level));
                _weightTable[level] = (1f / (float)Math.Pow(2, level)) / (float)maxWeight;
            }
        }

Perlin() [2/2]

pluginbase.Helpers.Computative.Algorithms.Perlin.Perlin	(	int	seed,
		int	frequency,
		int	levels
	)

Initialize an instance of perlin noise

Parameters

seed	Seed.
frequency	Frequency.
levels	Levels.

            :this(new PseudoRandom(seed), frequency, levels)
        {}

Member Function Documentation

GetValue() [1/2]

override float pluginbase.Helpers.Computative.Algorithms.Perlin.GetValue ( int  x, int  y, int  z  )

virtual

Get a value between 0-1

Parameters

x	A System.Int32
y	A System.Int32
z	A System.Int32

Returns

A System.Int32

Attribute: level

;

Attribute: level

;

Implements pluginbase.Helpers.Computative.ValuePoint3D.

        {
            int levelSize;
            int bX, bY, bZ;
            float dX, dY, dZ;
            float val = 0f;
            for (int level = 0; level < Levels; ++level)
            {
                levelSize = _sizeTable[level];
                if (levelSize <= 0){
                    break;
                }
                
                bX = x - MExt.mmod(x, levelSize);
                bY = y - MExt.mmod(y, levelSize);
                bZ = z - MExt.mmod(z, levelSize);
                
                dX = (x - bX) / (float)levelSize;
                dY = (y - bY) / (float)levelSize;
                dZ = (z - bZ) / (float)levelSize;

                val += (
                    ((random.Rand(bX, bY, bZ) * (1f - dX) + random.Rand(bX + levelSize, bY, bZ) * dX) * (1f - dY)
                + (random.Rand(bX, bY + levelSize, bZ) * (1f - dX) + random.Rand(bX + levelSize, bY + levelSize, bZ) * dX) * dY) * (1f - dZ)
                + ((random.Rand(bX, bY, bZ + levelSize) * (1f - dX) + random.Rand(bX + levelSize, bY, bZ + levelSize) * dX) * (1f - dY)
                + (random.Rand(bX, bY + levelSize, bZ + levelSize) * (1f - dX) + random.Rand(bX + levelSize, bY + levelSize, bZ + levelSize) * dX) * dY) * dZ
                        ) * _weightTable[level];
            }
            return val;
        }

GetValue() [2/2]

override float pluginbase.Helpers.Computative.Algorithms.Perlin.GetValue ( int  x, int  y  )

virtual

Get a 2D value between 0-1

Parameters

x	A System.Int32
y	A System.Int32

Returns

A System.Int32

Attribute: level

;

Attribute: level

;

Implements pluginbase.Helpers.Computative.ValuePoint3D.

        {
            int bX, bY;
            float dX, dY;
            float val = 0f;
            for (int level = 0; level < Levels; ++level)
            {
                int levelSize = _sizeTable[level];
                if (levelSize <= 0){
                    break;
                }

                bX = x - MExt.mmod(x, levelSize);
                bY = y - MExt.mmod(y, levelSize);
                
                dX = (x - bX) / (float)levelSize;
                dY = (y - bY) / (float)levelSize;

                val += ((random.Rand(bX, bY) * (1f - dX) + random.Rand(bX + levelSize, bY) * dX) * (1f - dY)
                    + (random.Rand(bX, bY + levelSize) * (1f - dX) + random.Rand(bX + levelSize, bY + levelSize) * dX) * dY) * _weightTable[level];
            }
            return val;
        }

Member Data Documentation

Frequency

readonly int pluginbase.Helpers.Computative.Algorithms.Perlin.Frequency

Frequency of the perlin noise

Levels

readonly int pluginbase.Helpers.Computative.Algorithms.Perlin.Levels

Number of levels incorporated into perlin noise

---

The documentation for this class was generated from the following file:

• pluginbase/Helpers/Computative/Algorithms/Perlin.cs