跳转至

当前帧

用途

读取图像时间线的当前帧位置、起止帧以及正向和反向进度。

添加路径

Shift+A > 变量 > 当前帧

执行行为

此节点没有执行输入和执行输出,是依赖当前时间线上下文的纯数据节点。下游读取端口时取得当前帧状态;它不会推进时间线。

进度按 (当前帧 - 起始帧) / (结束帧 - 起始帧) 计算并限制在 01。起止帧相同时,进度为 0,反向进度为 1

输入端口

无。

输出端口

端口 类型 说明
当前帧 数值 当前时间线帧号。
起始帧 数值 时间线范围的起始帧。
结束帧 数值 时间线范围的结束帧;不会小于起始帧。
进度 数值 从起始帧到结束帧的 0–1 进度。
反向进度 数值 1 - 进度

属性

无可配置属性。帧范围和当前位置由图像时间线提供。

最小示例

把“进度”输出连接到浮点运算,用于把时间线的 0–1 进度缩放为其他数值范围。

常见错误

  • 期望节点自行播放时间线:它只读取上下文,不控制播放。
  • 在没有运行时帧位置时期待任意当前值:没有显式当前帧时按起始帧读取。
  • 把反向进度理解为负数:反向进度始终是 1 - 进度,同样位于 0–1

相关节点