企业官网建设流程全解析

TiXL IdleMotion（空闲运动）完全指南：让程序化动画在时间线暂停时依然呼吸

【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3

导读

在 TiXL（tooll3）这类以实时程序化动效为核心的创作工具里，时间线暂停往往意味着画面静止——但粒子、噪声、振荡器等程序化动画一旦"冻结"就会丧失生命力，预览体验也会大打折扣。TiXL 的IdleMotion（空闲运动）模式正是为解决这个问题而设计：它让程序化动画在时间线暂停时继续以稳定的速率缓慢运动，而关键帧驱动的动画则严格停住。本文以 TiXL 官方文档.help/references/topics/ui/IdleMotion.md为骨架，结合仓库源码深入讲解该模式的原理、开关方式、适用场景与底层时间流实现，帮助你在预览、背景动画与逐帧精确输出之间自由切换。

一、什么是 IdleMotion：一种"永不冻结"的预览模式

IdleMotion 是 TiXL 时间线系统提供的一种播放模式，官方文档给出的定义是：

A mode that keeps procedural animation gently moving even while the timeline is paused, so a scene never freezes completely when you stop playback.

（一种让程序化动画在时间线暂停期间仍保持缓慢运动的模式，因此当你停止播放时，场景永远不会完全冻结。）

一句话概括它的行为特征：

• 开启时：运算符（Operator）依据一个"持续推进的效果时间（effect time）"运行——即使暂停，这个时间依然前进；而关键帧驱动的时间会随着时间线标记（marker）一起停住。于是噪声、振荡器以及其他连续型动画继续"漂移"，而你的关键帧动画保持静止。
• 关闭时：暂停即完全冻结，输出锁定在当前精确帧。

这对工作流的意义在于：一边工作一边保持预览鲜活，或者用于永远不应看起来静止的背景（例如演出 VJ 背景、粒子氛围层）。当你需要输出完全精确的一帧时，则应关闭 IdleMotion。

二、IdleMotion 在界面中如何操作

2.1 时间线控制条上的开关

IdleMotion 的开关位于时间线（Timeline）控制条上，由一个不可见按钮（##idleMotionToggle）加自绘图标组成。从源码 TimeControls.cs 可以看到它的完整实现逻辑：

// Idle motion { ImGui.PushStyleColor(ImGuiCol.Text, UserSettings.Config.EnableIdleMotion ? UiColors.TextDisabled : new Vector4(0, 0, 0, 0.5f)); if (ImGui.Button("##idleMotionToggle", ControlSize)) { UserSettings.Config.EnableIdleMotion = !UserSettings.Config.EnableIdleMotion; } CustomComponents.TooltipForLastItem("Idle Motion - Keeps beat time running", "This will keep updating the output [Time]\n" + "which is useful for procedural animation and syncing."); // ... 绘制 4x4 节拍网格与状态指示 }

交互细节值得注意：

• 悬停提示：鼠标悬停会显示 "Idle Motion - Keeps beat time running"，进一步说明其作用是"持续更新 [Time] 输出，对程序化动画与同步非常有用"。
• 视觉反馈：开启时，图标显示一个 4×4 的节拍网格（gridColor 使用背景色淡化），并有一个随FxTimeInBars移动的高亮指示块模拟"节拍仍在走动"；关闭时则绘制一条对角斜线表示"已停用"。状态颜色与网格颜色均由UserSettings.Config.EnableIdleMotion驱动。
• 底层持久化：该开关直接读写用户设置字段UserSettings.Config.EnableIdleMotion，其默认值为true（见 UserSettings.cs），属于全局 UI 状态而非项目设置。

2.2 与"节拍同步模式"的自动联动

IdleMotion 不仅在手动开关时生效，还会在**节拍同步（Beat Timing）**模式下被强制启用。在 ProjectSettingsWindow.cs 中，当项目切换到UsesBeatTapping（使用节拍敲击同步）时，代码会执行：

if (playback.UsesBeatTapping) { Playback.Current = T3Ui.DefaultBeatTimingPlayback; UserSettings.Config.ShowTimeline = false; UserSettings.Config.EnableIdleMotion = true; // 强制开启 Playback.Current.PlaybackSpeed = 1; }

这说明在面向现场演出（Live Performance）的节拍同步场景中，IdleMotion 被视为默认且必要的行为——程序化动画必须始终跟随 BPM 运动，不能因"暂停"而停顿。

三、核心原理：两套时间与关键帧时间的解耦

要真正理解 IdleMotion，需要先了解 TiXL 评估上下文（EvaluationContext）中的两套时间。从 EvaluationContext.cs 的注释与实现可以确认：

/// <summary> /// The primary time used for user interactions and keyframe manipulation. /// This is where there time marker in the timeline is displayed... /// </summary> public double LocalTime { get; set; } /// <summary> /// Although similar to KeyframeTime, this one keeps running in pause mode, if Keep Running is active. /// </summary> public double LocalFxTime { get; set; }

• LocalTime（关键帧时间 / 本地时间）：主时间，用于用户交互与关键帧操作，时间线标记（marker）的位置即显示在这里；暂停时它随标记停住。
• LocalFxTime（效果时间 / Fx 时间）：与关键帧时间类似，但在暂停模式下依然继续运行（前提是 IdleMotion 开启）。它专供噪声、振荡器、粒子等效果类运算符读取。

两者的初始值在EvaluationContext.Reset()中分别取自Playback.TimeInBars与Playback.FxTimeInBars（见 EvaluationContext.cs）。

3.1 暂停时的三路分支

LocalFxTime究竟会不会继续走，取决于Playback.Update()中暂停状态下的判断逻辑。核心实现位于 Playback.cs：

var isPlaying = Math.Abs(PlaybackSpeed) > 0.001; if (IsRenderingToFile) { FxTimeInBars = TimeInBars; // 渲染文件时：Fx 时间紧跟关键帧时间 } else if (isPlaying) { TimeInBars += timeSinceLastFrameInSecs * PlaybackSpeed * Bpm / 240.0; FxTimeInBars = TimeInBars; // 播放中：两套时间同步前进 } else // 暂停 { var timeWasManipulated = Math.Abs(TimeInBars - _previousTimeInBars) > 0.00001f; if (timeWasManipulated) { FxTimeInBars = TimeInBars; // 手动拖拽时间线：效果时间跟随 } else if (idleMotionEnabled) { FxTimeInBars += timeSinceLastFrameInSecs * Bpm / 240f; // 暂停 + IdleMotion：效果时间持续前进 } }

可以看到暂停状态下有三条分支：

1. 时间被手动操作过（拖拽标记、点击时间线）：FxTimeInBars跟随TimeInBars跳变，保证预览立即反映新的时间位置；
2. 时间未被操作且 IdleMotion 开启：FxTimeInBars以timeSinceLastFrameInSecs * Bpm / 240f的速率持续累加——这正是"程序化动画继续漂移"的底层来源；
3. 时间未被操作且 IdleMotion 关闭：什么都不做，FxTimeInBars完全静止，输出锁定。

这里出现了一个关键换算系数Bpm / 240f，它与 Playback.cs 中的两个转换方法严格对应：

public double BarsFromSeconds(double secs) => secs * Bpm / 240.0; // 秒 → 小节 public double SecondsFromBars(double bars) => bars * 240.0 / Bpm; // 小节 → 秒

即240 = 60 秒/分钟 × 4 拍/小节。因此 IdleMotion 的"空闲漂移"并非随意乱动，而是严格按项目 BPM 匀速推进——这意味着即使暂停，程序化动画依然与节拍保持同步，非常适合与音频节拍相关的视觉设计。

3.2 驱动链：从 UI 开关到运算符求值

IdleMotion 的完整调用链如下：

1. 时间线 UI 每次刷新时，PlaybackUtils.cs 调用Playback.Current.Update(UserSettings.Config.EnableIdleMotion)，把用户开关传入播放内核；
2. Playback.Update()按上文逻辑维护TimeInBars与FxTimeInBars；
3. 下一帧图求值时，EvaluationContext.Reset()将LocalFxTime = Playback.FxTimeInBars写入上下文（EvaluationContext.cs）；
4. 效果类运算符读取context.LocalFxTime，从而在暂停时也拿到"仍在前进"的时间。

从源码结构看，TiXL 将这一对时间分别命名为TimeInBars（关键帧/播放时间）与FxTimeInBars（效果时间），二者共同构成了 IdleMotion 与普通暂停的核心区别。

四、在运算符层面消费 IdleMotion 时间

4.1 Time 运算符的 LocalIdleMotionFxTime 模式

效果类运算符如何选择"空闲时间"？最典型的例子是Time 运算符（Time.cs）。它通过Mode输入选择时间来源：

var time = timeMode switch { TimeModes.LocalIdleMotionFxTime => contextLocalFxTime, // 空闲效果时间（暂停也走） TimeModes.LocalTime => contextLocalTime, // 本地关键帧时间（暂停即停） TimeModes.PlaybackTime => (float)context.Playback.TimeInBars, TimeModes.Runtime => context.Playback.BarsFromSeconds(Playback.RunTimeInSecs), TimeModes.Frozen => 0, _ => throw new ArgumentOutOfRangeException() };

其中TimeModes.LocalIdleMotionFxTime直接对应 IdleMotion 语义：只要 IdleMotion 开启，即使暂停，Time 运算符输出的时间也会持续增长。随后乘以SpeedFactor，并可由Units选择输出"小节（Bars）"或"秒（Secs）"：

if (Units.GetValue(context) == 1) Timefloat.Value = (float)context.Playback.SecondsFromBars(time * speedFactor); else Timefloat.Value = (float)(time * speedFactor);

值得注意的是该运算符对"冻结"模式的处理：当Mode = Frozen时，会将其输出的DirtyFlagTrigger从Animated切换为None（Time.cs），从脏标记层面停止重算——这与 IdleMotion"保持动画触发"形成对照，体现了 TiXL 对"何时需要刷新"的精细控制。

4.2 子图与 TimeClip 的时间映射

当运算符位于 TimeClip（时间片段）或经过SetCommandTime的子图内时，LocalFxTime会被映射后再使用：Slot.cs 与 TimeClipSlot.cs 中都有

var prevFxTime = context.LocalFxTime; context.LocalFxTime = TimeClip.MapTimelineToSource(prevFxTime); // ... 求值子图 ... context.LocalFxTime = prevFxTime;

因此 IdleMotion 的时间推进同样会经过 TimeClip 的"时间线→源片段"映射，片段内的效果动画在暂停时也会按其拉伸/偏移规则继续漂移。

五、应用场景与实战建议

5.1 适合开启 IdleMotion 的场景

• 长时间编辑时的鲜活预览：在你调参、连线、摆放算子时，粒子、噪声、波形等持续运动，画面"活着"，避免静止画面掩盖程序化问题；
• 演出与装置背景：官方文档明确提到"a background that should never look frozen"——例如 VJ 循环背景、氛围粒子层，暂停键不应让舞台画面凝固；
• 节拍同步（Beat Timing）项目：如前述源码所示，切换到节拍敲击模式时 IdleMotion 会被自动强制开启，程序化动画必须与 BPM 保持呼吸；
• 调试可见性问题：仓库的视频分析记录了一个典型用法——开启 IdleMotion 让点云持续运动，从而使深度排序错误变得可见（见.help/references/video-analysis/fFpMpa7qTB4.md中 23:06→24:25 片段）。

5.2 需要关闭 IdleMotion 的场景

• 逐帧精确输出：当需要让输出停留在完全确定的某一帧（例如导出前的构图确认、截图、对齐检查）时，应关闭 IdleMotion；
• 关键帧动画的精确审查：关闭后关键帧与效果动画同时静止，便于逐帧核查运动曲线与关键帧姿态；
• 渲染文件时无需担心：源码中IsRenderingToFile分支会让FxTimeInBars = TimeInBars，即导出时 IdleMotion 不参与，渲染结果始终由关键帧时间决定，不会引入"漂移"。

5.3 关键参数速查

六、常见问题（FAQ）

Q：IdleMotion 开启时，关键帧动画会继续走吗？不会。IdleMotion 只推进效果时间（FxTimeInBars/LocalFxTime），关键帧时间（TimeInBars/LocalTime）随时间线标记停住。所以效果继续漂移、关键帧保持静止。

Q：IdleMotion 的时间推进有规律吗？会不会乱跳？有规律。它按timeSinceLastFrameInSecs * Bpm / 240f以项目 BPM 匀速推进，与播放时完全同速率、同节拍，因此漂移动画与 BPM 严格对齐。

Q：为什么拖拽时间线标记时效果时间会跳变？因为暂停分支中timeWasManipulated判断（Playback.cs）会让FxTimeInBars跟随TimeInBars，保证你拖到哪、预览立刻显示哪，之后再回到匀速漂移。

Q：导出视频时 IdleMotion 会影响渲染结果吗？不会。IsRenderingToFile分支强制FxTimeInBars = TimeInBars，文件渲染完全由播放/关键帧时间驱动，IdleMotion 只作用于实时预览。

Q：IdleMotion 是项目级设置还是全局设置？从源码看，EnableIdleMotion存储在UserSettings.Config（用户级全局设置，默认开启），但它会在节拍同步模式下被自动强制打开。

七、结语

IdleMotion 是 TiXL 实时工作流中一个"小而关键"的设计：通过将关键帧时间与效果时间解耦，它让程序化动画在暂停时依然按 BPM 匀速呼吸，既保持了预览的生命力，又保证了关键帧运动的精确可控。理解LocalTime与LocalFxTime这对时间的分工，以及 Playback.cs 中暂停状态的三路分支，你就掌握了在"鲜活预览"与"精确冻结"之间自由切换的能力——这正是实时动效创作中常常被忽略、却最能提升体验的细节。

延伸阅读

• Timeline 使用指南
• TiXL 概念入门
• EvaluationContext 时间体系源码
• Playback 播放内核源码

【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址: https://gitcode.com/GitHub_Trending/t3/t3