OpenSimplexNoise¶

Inherits: Resource < Reference < Object

Generador de ruido basado en Open Simplex.

Descripción¶

Este recurso le permite configurar y tomar muestras de un espacio de ruido fractal. He aquí un breve ejemplo de uso que configura un OpenSimplexNoise y obtiene muestras en varias posiciones y dimensiones:

var ruido = OpenSimplexNoise.new()

# Configurar
ruido.seed = randi()
ruido.octaves = 4
ruido.period = 20.0
ruido.persistence = 0.8

# Muestra
print("Valores:")
print(ruido.get_noise_2d(1.0, 1.0))
print(ruido.get_noise_3d(0.5, 3.0, 15.0))
print(ruido.get_noise_4d(0.5, 1.9, 4.7, 0.0))

Propiedades¶

float	lacunarity	`2.0`
int	octaves	`3`
float	period	`64.0`
float	persistence	`0.5`
int	seed	`0`

Métodos¶

Image	get_image ( int width, int height, Vector2 noise_offset=Vector2( 0, 0 ) ) const
float	get_noise_1d ( float x ) const
float	get_noise_2d ( float x, float y ) const
float	get_noise_2dv ( Vector2 pos ) const
float	get_noise_3d ( float x, float y, float z ) const
float	get_noise_3dv ( Vector3 pos ) const
float	get_noise_4d ( float x, float y, float z, float w ) const
Image	get_seamless_image ( int size ) const

Descripciones de Propiedades¶

float lacunarity

Default	`2.0`
Setter	set_lacunarity(value)
Getter	get_lacunarity()

Diferencia de período entre octaves.

int octaves

Default	`3`
Setter	set_octaves(value)
Getter	get_octaves()

Número de capas de ruido de OpenSimplex que se muestrean para obtener el ruido fractal. Los valores más altos dan como resultado un ruido más detallado, pero tardan más tiempo en generarse.

Nota: El máximo valor permitido es 9.

float period

Default	`64.0`
Setter	set_period(value)
Getter	get_period()

Período de la octava base. Un período más bajo da como resultado un ruido de mayor frecuencia (más valor cambia a través de la misma distancia).

float persistence

Default	`0.5`
Setter	set_persistence(value)
Getter	get_persistence()

Factor de contribución de las diferentes octavas. Un valor de persistence de 1 significa que todas las octavas tienen la misma contribución, un valor de 0,5 significa que cada octava contribuye la mitad que la anterior.

int seed

Default	`0`
Setter	set_seed(value)
Getter	get_seed()

La semilla usada para generar valores aleatorios, diferentes semillas generarán diferentes mapas de ruido.

Descripciones de Métodos¶

Image get_image ( int width, int height, Vector2 noise_offset=Vector2( 0, 0 ) ) const

Generate a noise image in Image.FORMAT_L8 format with the requested width and height, based on the current noise parameters. If noise_offset is specified, then the offset value is used as the coordinates of the top-left corner of the generated noise.

float get_noise_1d ( float x ) const

Devuelve el valor de ruido 1D [-1,1] en la coordenada x dada.

Nota: Este método devuelve realmente el valor de ruido 2D [-1,1] con el valor fijo de la coordenada y 0,0.

float get_noise_2d ( float x, float y ) const

Devuelve el valor de ruido 2D [-1,1] en la posición dada.

float get_noise_2dv ( Vector2 pos ) const

Devuelve el valor de ruido 2D [-1,1] en la posición dada.

float get_noise_3d ( float x, float y, float z ) const

Devuelve el valor de ruido 3D [-1,1] en la posición dada.

float get_noise_3dv ( Vector3 pos ) const

Devuelve el valor de ruido 3D [-1,1] en la posición dada.

float get_noise_4d ( float x, float y, float z, float w ) const

Devuelve el valor de ruido 4D [-1,1] en la posición dada.

Image get_seamless_image ( int size ) const

Generate a tileable noise image in Image.FORMAT_L8 format, based on the current noise parameters. Generated seamless images are always square (size × size).

Note: Seamless noise has a lower contrast compared to non-seamless noise. This is due to the way noise uses higher dimensions for generating seamless noise.