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

Curve

继承： Resource < RefCounted < Object

数学曲线。

描述

该资源通过定义一组点和每个点的切线来描述数学曲线。默认情况下，X 轴和 Y 轴的范围都在 0 到 1 之间，但是范围可以调整。

请注意，许多资源和节点会假设用户设置的是单位曲线。单位曲线即域（X 轴）在 0 到 1 之间的曲线。例如 CPUParticles2D.angle_curve 和 Line2D.width_curve 用的就是单位曲线。

属性

int	bake_resolution	100
float	max_domain	1.0
float	max_value	1.0
float	min_domain	0.0
float	min_value	0.0
int	point_count	0

方法

int	add_point(position: Vector2, left_tangent: float = 0, right_tangent: float = 0, left_mode: TangentMode = 0, right_mode: TangentMode = 0)
void	bake()
void	clean_dupes()
void	clear_points()
float	get_domain_range() const
TangentMode	get_point_left_mode(index: int) const
float	get_point_left_tangent(index: int) const
Vector2	get_point_position(index: int) const
TangentMode	get_point_right_mode(index: int) const
float	get_point_right_tangent(index: int) const
float	get_value_range() const
void	remove_point(index: int)
float	sample(offset: float) const
float	sample_baked(offset: float) const
void	set_point_left_mode(index: int, mode: TangentMode)
void	set_point_left_tangent(index: int, tangent: float)
int	set_point_offset(index: int, offset: float)
void	set_point_right_mode(index: int, mode: TangentMode)
void	set_point_right_tangent(index: int, tangent: float)
void	set_point_value(index: int, y: float)

---

信号

domain_changed() 🔗

更改 max_domain 或 min_domain 时发出。

---

range_changed() 🔗

更改 max_value 或 min_value 时发出。

---

枚举

enum TangentMode: 🔗

TangentMode TANGENT_FREE = 0

点这边的切线是用户自定义的。

TangentMode TANGENT_LINEAR = 1

曲线计算点的这一侧的切线，作为向相邻点的一半的斜率。

TangentMode TANGENT_MODE_COUNT = 2

可用切线模式的总数。

---

属性说明

int bake_resolution = 100 🔗

• void set_bake_resolution(value: int)

• int get_bake_resolution()

烘焙（即缓存）曲线数据中包含的点的数量。

---

float max_domain = 1.0 🔗

• void set_max_domain(value: float)

• float get_max_domain()

点能够达到的最大域（X 坐标）。

---

float max_value = 1.0 🔗

• void set_max_value(value: float)

• float get_max_value()

点能够达到的最大值（Y 坐标）。切线可能导致两点之间存在更大的值。

---

float min_domain = 0.0 🔗

• void set_min_domain(value: float)

• float get_min_domain()

点能够达到的最小域（X 坐标）。

---

float min_value = 0.0 🔗

• void set_min_value(value: float)

• float get_min_value()

点能够达到的最小值（Y 坐标）。切线可能导致两点之间存在更小的值。

---

int point_count = 0 🔗

• void set_point_count(value: int)

• int get_point_count()

描述该曲线的点的数量。

---

方法说明

int add_point(position: Vector2, left_tangent: float = 0, right_tangent: float = 0, left_mode: TangentMode = 0, right_mode: TangentMode = 0) 🔗

在曲线上添加一个点。对于每一侧，如果 *_mode 为 TANGENT_LINEAR，则 *_tangent 角度（以度为单位）将使用曲线到邻近点的一半的斜率。如果 *_mode 设置为 TANGENT_FREE，则允许自定义分配给 *_tangent 的角度。

---

void bake() 🔗

重新计算曲线的烘焙点缓存。

---

void clean_dupes() 🔗

移除重复点，即与曲线上相邻点的距离小于 0.00001 个单位（引擎中的 epsilon 值）的点。

---

void clear_points() 🔗

从曲线中移除所有点。

---

float get_domain_range() const 🔗

返回 min_domain 和 max_domain 的差。

---

TangentMode get_point_left_mode(index: int) const 🔗

返回索引为 index 的点的左侧切线模式 TangentMode。

---

float get_point_left_tangent(index: int) const 🔗

返回索引为 index 的点的左侧切线夹角（单位为度）。

---

Vector2 get_point_position(index: int) const 🔗

返回索引为 index 的点的曲线坐标。

---

TangentMode get_point_right_mode(index: int) const 🔗

返回索引为 index 的点的右侧切线模式 TangentMode。

---

float get_point_right_tangent(index: int) const 🔗

返回索引为 index 的点的右侧切线夹角（单位为度）。

---

float get_value_range() const 🔗

返回 min_value 和 max_value 的差。

---

void remove_point(index: int) 🔗

移除曲线中索引为 index 的点。

---

float sample(offset: float) const 🔗

返回沿曲线的 X 位置 offset 处将存在的点的 Y 值。

---

float sample_baked(offset: float) const 🔗

使用烘焙的缓存返回沿曲线的 X 位置 offset 处将存在的点的 Y 值。烘焙尚未烘焙的曲线的点。

---

void set_point_left_mode(index: int, mode: TangentMode) 🔗

将索引为 index 的点的左侧 TangentMode 设置为 mode。

---

void set_point_left_tangent(index: int, tangent: float) 🔗

将索引为 index 的点的左侧切线角度设置为 tangent。

---

int set_point_offset(index: int, offset: float) 🔗

设置相对于 0.5 的偏移量。

---

void set_point_right_mode(index: int, mode: TangentMode) 🔗

将索引为 index 的点的右侧 TangentMode 设置为 mode。

---

void set_point_right_tangent(index: int, tangent: float) 🔗

将索引为 index 的点的右侧切线角度设置为 tangent。

---

void set_point_value(index: int, y: float) 🔗

将索引为 index 的点的垂直位置设置为 y。