| 参数名称 | 说明 |
|---|---|
| bg_image | 可选背景图像，在 UI 中显示 spline 参考背景。 |
Spline Editor
节点功能：用于创建和编辑样条曲线。它允许用户通过图形界面定义控制点，选择插值方法，并对生成的曲线进行采样，以生成一系列值或蒙版。
输入参数
输出参数
| 参数名称 | 说明 |
|---|---|
| mask | 由 y 值生成的灰度图掩码，可用于控制图像区域影响。 |
| coord_str | 原始控制点坐标字符串（JSON）。 |
| float | 插值后的 y 值数组，可用于调度、权重等用途。 |
| count | 输出 float 的数量，受 repeat_output 控制。 |
| normalized_str | 归一化后的坐标字符串（JSON 格式）。 |
控件参数
| 参数名称 | 说明 |
|---|---|
| points_store | 控制点存储用字符串，内部用于状态管理，不建议手动填写。 |
| coordinates | 控制点坐标字符串，来源于 UI 编辑，格式为 JSON。 |
| mask_width | 输出掩码的宽度，单位像素。 |
| mask_height | 输出掩码的高度，单位像素。 |
| points_to_sample | 需要从 spline 曲线上采样的点数。 |
| sampling_method | 曲线采样方式。path 表示沿路径等距，time 表示时间轴均匀，controlpoints 为插值控制点。建议用于 schedule 用途时选择 time，路径动画时选 path。 |
| interpolation | 插值类型。 cardinal：自然样条，平滑曲线，张力可调。 monotone：保形曲线，避免过冲。 basis：B 样条平滑插值。 linear：线性插值。 step-before/step-after：阶梯式跳变插值。 polar/polar-reverse：极坐标样式曲线，实验性。 |
| tension | 曲线张力参数，仅部分插值方法（如 cardinal）有效，范围 0~1。 |
| repeat_output | 输出的浮点数重复次数，适用于循环帧数据。 |
| float_output_type | 输出格式，支持 list、pandas series、tensor。 |
| min_value | 映射后的最小值（默认 0） |
| max_value | 映射后的最大值（默认 1）。 |
tension：曲线张力参数（用于cardinal插值）