Curve¶
继承¶
Resource
简要描述¶
数学曲线。
描述¶
可以保存并重新用于其他对象的曲线。默认情况下，它在Y轴上的0和1之间，并且相对于0.5Y位置定位点。
成员¶
| 类型 | 属性名 | 默认值 |
|---|---|---|
| int | bake_resolution | 100 |
| float | max_value | 1.0 |
| float | min_value | 0.0 |
方法¶
| 返回值类型 | 方法名称 |
|---|---|
| int | add_point(position: Vector2, left_tangent: float = 0, right_tangent: float = 0, left_mode: int = 0, right_mode: int = 0) |
| void | bake() |
| void | clean_dupes() |
| void | clear_points() |
| int | get_point_count() const |
| int | get_point_left_mode(index: int) const |
| float | get_point_left_tangent(index: int) const |
| Vector2 | get_point_position(index: int) const |
| int | get_point_right_mode(index: int) const |
| float | get_point_right_tangent(index: int) const |
| float | interpolate(offset: float) const |
| float | interpolate_baked(offset: float) |
| void | remove_point(index: int) |
| void | set_point_left_mode(index: int, mode: int) |
| 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: int) |
| void | set_point_right_tangent(index: int, tangent: float) |
| void | set_point_value(index: int, y: float) |
信号¶
- range_changed
枚举¶
enum TangentMode: - TANGENT_FREE = 0
该点这一侧的切线是用户定义的。
- TANGENT_LINEAR = 1
曲线将计算出该点这一侧的切线，即切向邻近点的中点处的坡度。
- TANGENT_MODE_COUNT = 2
可用切线模式的总数。
常量¶
成员说明¶
- int bake_resolution
| Default | 100 |
|---|---|
| setter | set_bake_resolution(value) |
| getter | get_bake_resolution |
- float max_value
| Default | 1.0 |
|---|---|
| setter | set_max_value(value) |
| getter | get_max_value |
- float min_value
| Default | 0.0 |
|---|---|
| setter | set_min_value(value) |
| getter | get_min_value |
方法说明¶
- add_point add_point(position: Vector2, left_tangent: float = 0, right_tangent: float = 0, left_mode: int = 0, right_mode: int = 0)
在曲线上添加一个点。对于每一边，如果*_mode为TANGENT_LINEAR，则*_tangent角度（以度为单位）将使用曲线到相邻点的中点的斜率。如果*_mode设置为TANGENT_FREE，则允许自定义分配给*_tangent角度。
- bake bake()
重新计算曲线的烘焙点缓存。
- clean_dupes clean_dupes()
删除比其曲线上的相邻点近CMP_EPSILON（0.00001）个单位的点。
- clear_points clear_points()
从曲线中删除所有点。
- get_point_count get_point_count() const
返回描述曲线的点数。
- get_point_left_mode get_point_left_mode(index: int) const
返回index处的点的左侧TangentMode。
- get_point_left_tangent get_point_left_tangent(index: int) const
返回index处的点的左正切角（以度为单位）。
- get_point_position get_point_position(index: int) const
返回index处的点的曲线坐标。
- get_point_right_mode get_point_right_mode(index: int) const
返回index处的点的右侧TangentMode。
- get_point_right_tangent get_point_right_tangent(index: int) const
返回index处的点的右正切角（以度为单位）。
- interpolate interpolate(offset: float) const
返回将在曲线的X位置offset处存在的点的Y值。
- interpolate_baked interpolate_baked(offset: float)
使用烘焙的缓存返回沿曲线的X位置offset处将存在的点的Y值。如果尚未烘焙曲线的点，则将其烘焙。
- remove_point remove_point(index: int)
从曲线中删除index处的点。
- set_point_left_mode set_point_left_mode(index: int, mode: int)
将index处的点的左侧TangentMode设置为mode。
- set_point_left_tangent set_point_left_tangent(index: int, tangent: float)
将index处的点的左正切角设置为tangent。
- set_point_offset set_point_offset(index: int, offset: float)
设置0.5的偏移量。
- set_point_right_mode set_point_right_mode(index: int, mode: int)
将index处的点的右侧TangentMode设置为mode。
- set_point_right_tangent set_point_right_tangent(index: int, tangent: float)
将index处的点的右切角设置为tangent。
- set_point_value set_point_value(index: int, y: float)
将垂直位置y分配给index处的点。