Module Noise

The Blender.Noise submodule.

Noise and Turbulence

This module can be used to generate noise of various types. This can be used for terrain generation, to create textures, make animations more 'animated', object deformation, etc. As an example, this code segment when scriptlinked to a framechanged event, will make the camera sway randomly about, by changing parameters this can look like anything from an earthquake to a very nervous or maybe even drunk cameraman... (the camera needs an ipo with at least one Loc & Rot key for this to work!):

Example:

 from Blender import Get, Scene, Noise
 ####################################################
 # This controls jitter speed
 sl = 0.025
 # This controls the amount of position jitter
 sp = 0.1
 # This controls the amount of rotation jitter
 sr = 0.25
 ####################################################

 time = Get('curtime')
 ob = Scene.GetCurrent().getCurrentCamera()
 ps = (sl*time, sl*time, sl*time)
 # To add jitter only when the camera moves, use this next line instead
 #ps = (sl*ob.LocX, sl*ob.LocY, sl*ob.LocZ)
 rv = Noise.vTurbulence(ps, 3, 0, Noise.NoiseTypes.NEWPERLIN)
 ob.dloc = (sp*rv[0], sp*rv[1], sp*rv[2])
 ob.drot = (sr*rv[0], sr*rv[1], sr*rv[2])

Functions

[hide private]

float

random()
Returns a random floating point number."

source code

3-float list

randuvec()
Returns a random unit vector.

source code

setRandomSeed(seed)
Initializes the random number generator.

source code

float

noise(xyz, type=1)
Returns general noise of the optional specified type.

source code

3-float list

vNoise(xyz, type=1)
Returns noise vector of the optional specified type.

source code

float

turbulence(xyz, octaves, hard, basis=1, ampscale=0.5, freqscale=2.0)
Returns general turbulence value using the optional specified noise 'basis' function.

source code

3-float list

vTurbulence(xyz, octaves, hard, basis=1, ampscale=0.5, freqscale=2.0)
Returns general turbulence vector using the optional specified noise basis function.

source code

float

fBm(xyz, H, lacunarity, octaves, basis=1)
Returns Fractal Brownian Motion noise value (fBm).

source code

float

multiFractal(xyz, H, lacunarity, octaves, basis=1)
Returns Multifractal noise value.

source code

float

vlNoise(xyz, distortion, type1=1, type2=1)
Returns Variable Lacunarity Noise value, a distorted variety of noise.

source code

float

heteroTerrain(xyz, H, lacunarity, octaves, offset, basis=1)
Returns Heterogeneous Terrain value.

source code

float

hybridMFractal(xyz, H, lacunarity, octaves, offset, gain, basis=1)
Returns Hybrid Multifractal value.

source code

float

ridgedMFractal(xyz, H, lacunarity, octaves, offset, gain, basis=1)
Returns Ridged Multifractal value.

source code

list

voronoi(xyz, distance_metric=0, exponent=2.5)
Returns Voronoi diagrams-related data.

source code

float

cellNoise(xyz)
Returns cellnoise.

source code

3-float list

cellNoiseV(xyz)
Returns cellnoise vector/point/color.

source code

Variables

[hide private]

readonly dictionary NoiseTypes = {'BLENDER': 0, 'STDPERLIN': 1}
The available noise types.

readonly dictionary DistanceMetrics = {'DISTANCE': 0}
The available distance metrics values for Voronoi.

__package__ = None

Function Details