企业官网建设流程全解析

TiXL 节点详解：FluidFeedback —— 位移驱动型流体反馈效果实战指南

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

导读

FluidFeedback 是 TiXL 图像反馈（feedback）节点族中的代表性示例，其核心思路是"将上一帧输出与当前画面反复合成，并叠加位移（displacement）扰动"，从而产生流动、融化、扩散等流体质感。本文以官方文档为主体，结合仓库中的节点定义（.cs）、图结构（.t3/.t3ui）与示例工程，完整解读该节点的 12 个输入参数、内部渲染链路与调参思路，并给出与 AdvancedFeedback、AfterGlow2 等兄弟节点的选型建议，帮助读者在实时视觉项目中快速落地。

1. 节点定位：它是什么，解决什么问题

FluidFeedback 属于 Lib.image.fx.feedback 反馈节点族。官方文档对其定位只有一句话：

An example of how feedback combined with displacement can lead to a variety of effects.

即"反馈 + 位移可以组合出多种效果"。它的核心机理是帧间自反馈（recursive feedback）：

1. 将上一步渲染结果写回一个循环缓冲区（RenderTarget）；
2. 下一帧开始时，把当前画面与该缓冲区内容再次合成；
3. 在合成路径上插入位移（Displace）、模糊（Blur）与几何变换（缩放/旋转/偏移）；
4. 每一帧的结果都会成为下一帧的输入，由此积累出持续的流体运动感。

这种结构非常适合实时视觉（VJ、livecoding、生成艺术）场景——同一段素材在不同参数下会演化出完全不同的质感，这正是文档中"a variety of effects"的含义。

2. 输入参数全解析（含默认值与推荐调节范围）

文档给出的输入参数表共 12 项。下面结合 FluidFeedback.t3 中保存的默认值，逐一说明其作用与调参方向：

默认值均来自 FluidFeedback.t3 的Inputs段；输入槽的类型定义见 FluidFeedback.cs，其中Command使用MultiInputSlot，支持接入多个命令来源。

3. 输出

在 FluidFeedback.cs 中，输出槽为Slot<Texture2D>，其数据源是内部 RenderTarget 子节点的输出（见下文第 4 节连接关系）。

4. 内部实现：从 .t3 图结构还原反馈链路

FluidFeedback 不是一行 shader，而是一个由 13 个子节点组成的宏节点（macro symbol）。从 FluidFeedback.t3 的Children与Connections可以完整还原它的内部数据流，这也是理解参数语义的关键。

4.1 参与节点清单

4.2 关键数据流（依据 Connections 段还原）

• 位移参数链路：Displacement → Multiply(×0.01) → Displace.Displacement；Shade → Multiply(×0.01) → Displace.Shade；DisplaceOffset → Multiply(×0.01) → Displace.DisplacementOffset；Twist → Displace.Twist；循环纹理经UseTextureReference → Displace.Image。
• 反馈循环：Displace 输出 → Layer2d(缩放/旋转/偏移) → Execute → Switch 分支2；同时DrawScreenQuad → Switch 分支1；RenderTarget接收 Switch 输出作为渲染内容，其输出再作为ColorBuffer输出，并经由 UseTextureReference 回到 Displace 形成自反馈闭环。
• 开关/重置逻辑：IsEnabled ∧ HasTimeChanged → BoolToInt → Switch.Index（false→0 走绘制分支，true→1 走反馈分支）；Reset → BoolToInt(true→2) → Switch.Index，强制切换到清屏绘制分支，从而"重置"反馈积累。

由此可以看出：文档参数表中的每个参数都对应图内一个明确的子节点输入，调节参数的本质是调节内部反馈链路的某个环节。

4.3 界面分组线索

从 FluidFeedback.t3ui 的InputUis可见，官方在参数面板上对常用参数做了分组提示：Displacement属于Feedback组，Twist属于Movement组，Offset增加了间距（AddPadding），Command标记为 Required（必需）。这提示了推荐的第一层调参顺序：先调 Feedback 组定强度，再调 Movement 组定运动。

5. 实战调参：从默认值出发的四种典型质感

以默认值为基准（FluidFeedback.t3），可快速演化出不同风格：

1. 温和熔蜡：保持Displacement≈15、BlurRadius≈4，将Zoom降到 1.0 附近并Rotate设为 0.01～0.1，得到缓慢扩散、边缘软化的熔融感。
2. 漩涡扭曲：大幅提高Twist（如 300～800），配合正负SampleDistance调整流动方向，画面出现卷曲与螺旋。
3. 漂移粒子感：将Offset用时间曲线（如正弦）驱动，让反馈层来回漂移，配合中等Shade突出明暗层次。
4. 场景切换：在新段落开始时把Reset触发为 true 一帧，清空缓冲再关闭，避免旧画面的残影污染新内容。

6. 仓库中的真实使用案例

FluidFeedback 在示例库中已有落地作品，可直接作为参考模板：

• FluidFireLogo.t3ui：官方描述为"SVG 线条动画与 FluidFeedback 结合，模拟火焰燃烧"——这是"反馈制造流动能量感"的典型示范。
• VJSpermZoomer.t3ui：描述为"Weird experiment with FluidFeedback effect"，展示了其在 VJ 场景下的实验性使用。
• FadingFaces.t3ui：将 FluidFeedback 用于人脸/图像的渐变消散效果。

这些示例均位于 Operators/examples/Symbols/user/pixtur 下，可直接在编辑器中打开观察其参数接线方式。

7. 与同族节点如何选型

同目录下还有多个反馈节点，选型建议如下：

三者的官方对照关系记录在反馈族目录 README.md：AdvancedFeedback 被描述为"FluidFeedback 的更通用但更难控制的进阶版"，AdvancedFeedback2 则强调 OKLab 色彩空间。

8. 小结

FluidFeedback 以最少的参数封装了"反馈 + 位移"这一实时视觉中的经典范式：循环缓冲（RenderTarget）+ 位移扰动（Displace）+ 软化（Blur）+ 几何变换（Zoom/Rotate/Offset），并通过 Reset/IsEnabled 完成生命周期控制。掌握它的内部图结构后，读者可以：

• 在编辑器中打开 FluidFeedback.t3 直接观察/复制其反馈链路，改造出属于自己的反馈效果；
• 结合文档参数表与默认值快速调出四种以上的视觉质感；
• 在需要更复杂控制时平滑迁移到 AdvancedFeedback 与 AdvancedFeedback2。

本文中所有参数默认值、子节点构成与连接关系均取自仓库内的 FluidFeedback.t3、FluidFeedback.cs 与 FluidFeedback.t3ui 文件，可自行打开核对。

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