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))

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

Default

2.0

Setter

set_lacunarity(value)

Getter

get_lacunarity()

Diferencia de período entre 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.


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).


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.


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

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.


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.


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


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


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


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


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.