Periodical Noise/Turbulence/Fbm

Detailed Description

Functions
Float	SNoiseP (Vector p, Float t, Int32 t_repeat)
Float	TurbulenceP (Vector p, Float t, Float oct, Bool abs, Int32 t_repeat)
Float	FbmP (Float *table, Vector p, Float t, Float oct, Int32 t_repeat)
Float	RidgedMultifractalP (Float *table, Vector p, Float t, Float oct, Float offset, Float gain, Int32 t_repeat)

Variables
static const Int32	NOISE_RESOLUTION

Function Documentation

SNoiseP()

Float SNoiseP	(	Vector	p,
		Float	t,
		Int32	t_repeat
	)

Generates a periodic signed noise value.

Parameters

[in]	p	The noise coordinate.
[in]	t	The time.
[in]	t_repeat	The time repeat. Must be 2^x - 1, where x = [1..10], i.e. one of 1, 3, 7, 15, 31, 63, 127, 255, 511, and 1023. A noise repeats itself in time every 1024 units. Using a smaller t_repeat the noise will repeat at an earlier time.

Returns

The signed noise value, between -1.0 and 1.0.

TurbulenceP()

Float TurbulenceP	(	Vector	p,
		Float	t,
		Float	oct,
		Bool	abs,
		Int32	t_repeat
	)

Generates a periodic turbulence value, this is a sum of multiple noises with different frequency.

Parameters

[in]	p	The noise coordinate.
[in]	t	The time.
[in]	oct	The number of octaves.
[in]	abs	true for the absolute value.
[in]	t_repeat	The time repeat. Must be 2^x - 1, where x = [1..10], i.e. one of 1, 3, 7, 15, 31, 63, 127, 255, 511, and 1023. A noise repeats itself in time every 1024 units. Using a smaller t_repeat the noise will repeat at an earlier time.

Returns

The turbulence value, between -1.0 and 1.0 unless abs is true, in which case it will be between 0.0 to 1.0.

FbmP()

Float FbmP	(	Float *	table,
		Vector	p,
		Float	t,
		Float	oct,
		Int32	t_repeat
	)

Generates a periodic Fractional Brownian Motion value.

Note

InitFbm() must be called before this function.

Parameters

[in]	table	The preallocated and initialized table by InitFbm(). The caller owns the pointed array.
[in]	p	The evaluation point.
[in]	t	The time.
[in]	oct	The number of octaves. Must not exceed the max_octaves value passed to InitFbm(), but can be lower.
[in]	t_repeat	The time repeat. Must be 2^x - 1, where x = [1..10], i.e. one of 1, 3, 7, 15, 31, 63, 127, 255, 511, and 1023. A noise repeats itself in time every 1024 units. Using a smaller t_repeat the noise will repeat at an earlier time.

Returns

The fBm value.

RidgedMultifractalP()

Float RidgedMultifractalP	(	Float *	table,
		Vector	p,
		Float	t,
		Float	oct,
		Float	offset,
		Float	gain,
		Int32	t_repeat
	)

Generates a periodic fractal function used for such things as landscapes or mountain ranges.

Note

InitFbm() must be called before this function.

Parameters

[in]	table	The preallocated and initialized table by InitFbm(). The caller owns the pointed array.
[in]	p	The evaluation point.
[in]	t	The time.
[in]	oct	The number of octaves. Must not exceed the max_octaves value passed to InitFbm(), but can be lower.
[in]	offset	The zero offset, this controls the multi-fractal.
[in]	gain	The amplification of the fractal value.
[in]	t_repeat	The time repeat. Must be 2^x - 1, where x = [1..10], i.e. one of 1, 3, 7, 15, 31, 63, 127, 255, 511, and 1023. A noise repeats itself in time every 1024 units. Using a smaller t_repeat the noise will repeat at an earlier time.

Returns

The fractal value.

Variable Documentation

NOISE_RESOLUTION

const Int32 NOISE_RESOLUTION

static

Noise resolution.