tension:曲线张力参数(用于cardinal插值)
ComfyUI-KJNodes
时间:2025/06/28
Spline Editor
节点功能:用于创建和编辑样条曲线。它允许用户通过图形界面定义控制点,选择插值方法,并对生成的曲线进行采样,以生成一系列值或蒙版。
Spline Editor-节点参数说明
| 输入参数 | |
| bg_image | 可选背景图像,在 UI 中显示 spline 参考背景。 | 
| 输出参数 | |
| 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)。 | 

