Gradient

颜色过渡。

描述

该资源通过定义一组彩色点以及如何在它们之间进行插值来描述颜色过渡。

另见 Curve，它支持更复杂的缓动方法，但不支持颜色。

属性

PackedColorArray	colors	`PackedColorArray(0, 0, 0, 1, 1, 1, 1, 1)`
ColorSpace	interpolation_color_space	`0`
InterpolationMode	interpolation_mode	`0`
PackedFloat32Array	offsets	`PackedFloat32Array(0, 1)`

方法

void	add_point(offset: float, color: Color)
Color	get_color(point: int)
float	get_offset(point: int)
int	get_point_count() const
void	remove_point(point: int)
void	reverse()
Color	sample(offset: float)
void	set_color(point: int, color: Color)
void	set_offset(point: int, offset: float)

枚举

enum InterpolationMode: 🔗

InterpolationMode GRADIENT_INTERPOLATE_LINEAR = 0

线性插值。

InterpolationMode GRADIENT_INTERPOLATE_CONSTANT = 1

常量插值，颜色会在每个点上突变，在点和点之间保持一致。在某些情况下用于渐变纹理时，可能会造成明显的锯齿。

InterpolationMode GRADIENT_INTERPOLATE_CUBIC = 2

三次插值。

enum ColorSpace: 🔗

ColorSpace GRADIENT_COLOR_SPACE_SRGB = 0

sRGB 色彩空间。

ColorSpace GRADIENT_COLOR_SPACE_LINEAR_SRGB = 1

线性 sRGB 色彩空间。

ColorSpace GRADIENT_COLOR_SPACE_OKLAB = 2

Oklab 色彩空间。该色彩空间能够在不同颜色之间进行平滑、外观统一的过渡。

属性说明

PackedColorArray colors = PackedColorArray(0, 0, 0, 1, 1, 1, 1, 1) 🔗

void set_colors(value: PackedColorArray)
PackedColorArray get_colors()

渐变的颜色，类型为 PackedColorArray。

注意：设置该属性会一次性更新所有颜色。单独更改某个颜色请使用 set_color()。

Note: The returned array is copied and any changes to it will not update the original property value. See PackedColorArray for more details.

ColorSpace interpolation_color_space = 0 🔗

void set_interpolation_color_space(value: ColorSpace)
ColorSpace get_interpolation_color_space()

The color space used to interpolate between points of the gradient. It does not affect the returned colors, which will always use nonlinear sRGB encoding.

Note: This setting has no effect when interpolation_mode is set to GRADIENT_INTERPOLATE_CONSTANT.

InterpolationMode interpolation_mode = 0 🔗

void set_interpolation_mode(value: InterpolationMode)
InterpolationMode get_interpolation_mode()

用于在渐变点之间进行插值的算法。

PackedFloat32Array offsets = PackedFloat32Array(0, 1) 🔗

void set_offsets(value: PackedFloat32Array)
PackedFloat32Array get_offsets()

渐变的偏移量，类型为 PackedFloat32Array。

注意：设置该属性会一次性更新所有偏移量。单独更改某个偏移量请使用 set_offset()。

Note: The returned array is copied and any changes to it will not update the original property value. See PackedFloat32Array for more details.

方法说明

void add_point(offset: float, color: Color) 🔗

使用指定的偏移，将指定的颜色添加到该渐变中。

Color get_color(point: int) 🔗

返回渐变色在索引 point 处的颜色。

float get_offset(point: int) 🔗

返回渐变色在索引 point 处的偏移。

int get_point_count() const 🔗

返回渐变中的颜色数。

void remove_point(point: int) 🔗

移除索引 point 处的颜色。

void reverse() 🔗

将渐变进行翻转/镜像。

注意：这个方法会将所有点以渐变的中点进行镜像，interpolation_mode 为 GRADIENT_INTERPOLATE_CONSTANT 时可能产生意外的结果。

Color sample(offset: float) 🔗

返回偏移量 offset 插值后的颜色。offset 应当在 0.0 和 1.0 之间（含两端）。取值小于 0.0 返回的颜色与 0.0 相同，取值大于 1.0 返回的颜色与 1.0 相同。输入值不在该范围内时，请考虑对输入值使用 @GlobalScope.remap()，将输出值设为 0.0 和 1.0。

void set_color(point: int, color: Color) 🔗

设置渐变色在索引 point 处的颜色。

void set_offset(point: int, offset: float) 🔗

设置渐变色在索引 point 处的偏移。