Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

NoiseTexture2D

Hérite de : Texture2D < Texture < Resource < RefCounted < Object

Une texture 2D remplie de bruit généré par un objet Noise.

Description

Utilise la bibliothèque FastNoiseLite ou d'autres générateurs de bruit pour remplir les données de texture à votre taille désirée. NoiseTexture2D peut également générer des textures de normal map.

La classe utilise des Threads pour générer les données de texture en interne, donc Texture2D.get_image() peut renvoyer null si le processus de génération n'est pas encore terminé. Dans ce cas, vous devez attendre que la texture soit générée avant d'accéder à l'image et aux données d'octet générées :

var texture = NoiseTexture2D.new()
texture.noise = FastNoiseLite.new()
await texture.changed
var image = texture.get_image()
var donnees = image.get_data()

Propriétés

bool

as_normal_map

false

float

bump_strength

8.0

Gradient

color_ramp

bool

generate_mipmaps

true

int

height

512

bool

in_3d_space

false

bool

invert

false

Noise

noise

bool

normalize

true

bool

resource_local_to_scene

false (overrides Resource)

bool

seamless

false

float

seamless_blend_skirt

0.1

int

width

512

Descriptions des propriétés

bool as_normal_map = false 🔗

  • void set_as_normal_map(value: bool)

  • bool is_normal_map()

Si true, la texture résultante contient une carte normale créée à partir du bruit original interprété comme une carte de bosse.

float bump_strength = 8.0 🔗

  • void set_bump_strength(value: float)

  • float get_bump_strength()

L'intensité des cartes de bosse utilisées dans cette texture. Une valeur plus élevée rendra les cartes de bosse plus grandes alors qu'une valeur plus basse les rendra plus douces.

Gradient color_ramp 🔗

Un Gradient qui est utilisé pour associer la luminance de chaque pixel à une valeur de couleur.

bool generate_mipmaps = true 🔗

  • void set_generate_mipmaps(value: bool)

  • bool is_generating_mipmaps()

Détermine si des mipmaps sont générées pour cette texture. Activer ceci résulte en moins de crénelage de texture au loin, au coût d'augmenter l'utilisation de mémoire d'environ 33% et de rendant la génération de texture de bruit plus lente.

Note : generate_mipmaps nécessite que le filtrage de mipmap soit activé sur le matériau utilisant le NoiseTexture2D pour avoir un effet.

int height = 512 🔗

  • void set_height(value: int)

  • int get_height()

Hauteur de la texture générée (en pixels).

bool in_3d_space = false 🔗

  • void set_in_3d_space(value: bool)

  • bool is_in_3d_space()

Détermine si l'image de bruit est calculée dans l'espace 3D. Peut résulter en un contraste réduit.

bool invert = false 🔗

  • void set_invert(value: bool)

  • bool get_invert()

Si true, inverse la texture de bruit. Le blanc devient noir, le noir devient blanc.

Noise noise 🔗

L'instance de l'objet Noise.

bool normalize = true 🔗

  • void set_normalize(value: bool)

  • bool is_normalized()

Si true, l'image de bruit provenant du générateur de bruit est normalisée à la plage 0.0 à 1.0.

Retirer la normalisation peut affecter le contraste et vous permet de générer des textures de bruit raccordables non répétées.

bool seamless = false 🔗

  • void set_seamless(value: bool)

  • bool get_seamless()

If true, a seamless texture is requested from the Noise resource.

Note: Seamless noise textures may take longer to generate and/or can have a lower contrast compared to non-seamless noise depending on the used Noise resource. This is because some implementations use higher dimensions for generating seamless noise.

Note: The default FastNoiseLite implementation uses the fallback path for seamless generation. If using a width or height lower than the default, you may need to increase seamless_blend_skirt to make seamless blending more effective.

float seamless_blend_skirt = 0.1 🔗

  • void set_seamless_blend_skirt(value: float)

  • float get_seamless_blend_skirt()

Utilisé pour l'implémentation par défaut/de repli de la génération de textures seamless (sans coutures). Il détermine la distance sur laquelle les coutures sont mélangées. Les valeurs élevées peuvent résulter en moins de détails et de contraste. Voir Noise pour plus de détails.

Note : Si vous utilisez une largeur width ou une hauteur height inférieure à la valeur par défaut, vous devrez peut-être augmenter seamless_blend_skirt pour rendre le mélange seamless plus efficace.

int width = 512 🔗

  • void set_width(value: int)

  • int get_width()

Largeur de la texture générée (en pixels).