pluginbase.Helpers.Computative.Algorithms.Simplex Class Reference

Simplex noise Implementation from Stefan Gustavson, optimized by Peter Eastman, ported to C#/optimized by Chris LaPointe More...

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

Public Member Functions
	Simplex (IPseudoRandom provider, int frequency, int octaves, float gain=0.65f, float lacunarity=2f)
	Initializes a new instance of the pluginbase.Helpers.Computative.Algorithms.Simplex class. More...
	Simplex (int seed, int frequency, int octaves, float gain=0.65f, float lacunarity=2f)
	Initializes a new instance of the pluginbase.Helpers.Computative.Algorithms.Simplex class. More...
override float	GetValue (int x, int y, int z)
	NOTICE: Due to patent on 3d versions of simplex, it is not included in this implementation More...
override float	GetValue (int x, int y)
	Get a value at an x,y coordinate 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...

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

Simplex noise Implementation from Stefan Gustavson, optimized by Peter Eastman, ported to C#/optimized by Chris LaPointe

Constructor & Destructor Documentation

Simplex() [1/2]

pluginbase.Helpers.Computative.Algorithms.Simplex.Simplex	(	IPseudoRandom	provider,
		int	frequency,
		int	octaves,
		float	gain = 0.65f,
		float	lacunarity = 2f
	)

Initializes a new instance of the pluginbase.Helpers.Computative.Algorithms.Simplex class.

Parameters

provider	Provider.
frequency	Frequency.
octaves	Octaves.
gain	Gain.
lacunarity	Lacunarity.

Attribute: ] tempPerm = new short[256

;

Attribute: i

= (short)i;

Attribute: idx], ref tempPerm[jdx

);

Attribute: i] = tempPerm[i & 255

;

Attribute: i] = (short)(_perm[i

% 12);

Attribute: octaves

;

Attribute: octaves

;

Attribute: i

= currFreq;

Attribute: i

= currAmpl / amplitudeSum;

        {
            _octaves = octaves;
            _frequency = 1.0f / (float)frequency;
            _gain = gain;
            _lacunarity = lacunarity;

            //Setup the permutation based on the random provider
            _random = new Random3D(provider);
            short[] tempPerm = new short[256];
            for (int i=0; i<256; ++i)
            {
                tempPerm[i] = (short)i;
            }
            for (int i=0; i<256; ++i)
            {
                int idx = _random.Randi(i, 0, 255);
                int jdx = _random.Randi(i + 256, 0, 255);
                swap(ref tempPerm[idx], ref tempPerm[jdx]);
            }

            for (int i=0; i<512; ++i)
            {
                _perm[i] = tempPerm[i & 255];
                _permMod12[i] = (short)(_perm[i] % 12);
            }

            //Pre-compute the multiplier tables
            float amplitudeSum = (1.0f - (float)Math.Pow(gain, octaves)) / (1.0f - gain);
            _frequencyTable = new float[octaves];
            _amplitudeTable = new float[octaves];

            float currFreq = _frequency;
            float currAmpl = 1f;
            for (int i=0; i<octaves; ++i)
            {
                _frequencyTable[i] = currFreq;
                _amplitudeTable[i] = currAmpl / amplitudeSum;
                currAmpl *= _gain;
                currFreq *= _lacunarity;
            }
        }

Simplex() [2/2]

pluginbase.Helpers.Computative.Algorithms.Simplex.Simplex	(	int	seed,
		int	frequency,
		int	octaves,
		float	gain = 0.65f,
		float	lacunarity = 2f
	)

Initializes a new instance of the pluginbase.Helpers.Computative.Algorithms.Simplex class.

Parameters

seed	Seed.
frequency	Frequency.
octaves	Octaves.
gain	Gain.
lacunarity	Lacunarity.

            :this(new PseudoRandom(seed), frequency, octaves, gain, lacunarity)
        {
        }

Member Function Documentation

GetValue() [1/2]

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

virtual

NOTICE: Due to patent on 3d versions of simplex, it is not included in this implementation

Returns

The value.

Parameters

x	The x coordinate.
y	The y coordinate.
z	The z coordinate.

Implements pluginbase.Helpers.Computative.ValuePoint3D.

        {
            /*float sum = 0f;
            float freq;
            for (int k = 0; k < _octaves; ++k)
            {
                freq = _frequencyTable[k];
                sum += GetSimplex(x * freq, y * freq, z * freq) * _amplitudeTable[k];
            }
            return sum;*/
            return 0f;
        }

GetValue() [2/2]

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

virtual

Get a value at an x,y coordinate

Returns

The value.

Parameters

x	The x coordinate.
y	The y coordinate.

Attribute: k

;

Attribute: k

;

Implements pluginbase.Helpers.Computative.ValuePoint3D.

        {
            float sum = 0f;
            float freq;
            for (int k = 0; k < _octaves; ++k)
            {
                freq = _frequencyTable[k];
                sum += GetSimplex(x * freq, y * freq) * _amplitudeTable[k];
            }
            return sum;
        }

---

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

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