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

NoiseTexture3D¶

继承： Texture3D < Texture < Resource < RefCounted < Object

由 Noise 对象生成的噪声所填充的 3D 纹理。

描述¶

使用 FastNoiseLite 库或其他噪声生成器来填充所需大小的纹理数据。

该类在内部使用 Thread 生成纹理数据，因此如果生成过程尚未完成，Texture3D.get_data 可能会返回 null。在这种情况下，需要等待纹理生成后再访问图像：

var texture = NoiseTexture3D.new()
texture.noise = FastNoiseLite.new()
await texture.changed
var data = texture.get_data()

属性¶

Gradient	color_ramp
int	depth	`64`
int	height	`64`
bool	invert	`false`
Noise	noise
bool	normalize	`true`
bool	seamless	`false`
float	seamless_blend_skirt	`0.1`
int	width	`64`

属性说明¶

Gradient color_ramp 🔗

void set_color_ramp(value: Gradient)
Gradient get_color_ramp()

Gradient，用于将每个像素的亮度映射到一个颜色值。

int depth = 64 🔗

void set_depth(value: int)
int get_depth()

生成的纹理的深度（单位为像素）。

int height = 64 🔗

void set_height(value: int)
int get_height()

生成的纹理的高度（单位为像素）。

bool invert = false 🔗

void set_invert(value: bool)
bool get_invert()

如果为 true，则反转该噪声纹理。白变黑，黑变白。

Noise noise 🔗

void set_noise(value: Noise)
Noise get_noise()

Noise 对象的实例。

bool normalize = true 🔗

void set_normalize(value: bool)
bool is_normalized()

如果为 true，来自噪声发生器的噪声图像，将被归一化到范围 0.0 到 1.0。

关闭归一化会影响对比度，并允许生成非重复的可平铺噪声纹理。

bool seamless = false 🔗

void set_seamless(value: bool)
bool get_seamless()

如果为 true，则从 Noise 资源请求无缝纹理。

注意：与非无缝噪声相比，无缝噪声纹理可能需要更长的时间来生成，并且/或者可能具有较低的对比度，具体取决于所使用的 Noise 资源。这是因为一些实现使用更高的维度来生成无缝噪声。

注意：默认的 FastNoiseLite 实现在生成无缝纹理时使用回退路径。如果使用的 width、height 或 depth 小于默认值，你可能需要通过增大 seamless_blend_skirt 来让无缝混合更高效。

float seamless_blend_skirt = 0.1 🔗

void set_seamless_blend_skirt(value: float)
float get_seamless_blend_skirt()

用于无缝纹理生成的默认/回退实现。它决定接缝混合的距离。较高的值可能会导致较少的细节和对比度。详情见 Noise。

注意：如果使用的 width、height 或 depth 小于默认值，你可能需要通过增大 seamless_blend_skirt 来让无缝混合更高效。

int width = 64 🔗

void set_width(value: int)
int get_width()

生成的纹理的宽度（单位为像素）。