TouchDesigner 擅长实时交互：音频分析、反馈、遮罩、多屏合成和协议输出。Pixel LED Animator 3 擅长从零生成画面本身：145 个效果生成器、调色板、关键帧、文字和图像叠加层。
把两者连起来，您就同时拥有这两种能力。Pixel LED Animator 以 NDI 或 Spout2 信号源的形式发送实时预览，TouchDesigner 把它作为 TOP 接收。接下来您就可以让动画随声音反应、把它铺满整面墙，或接入更大的演出网络。
该用哪种输入
| NDI In TOP | Spout In TOP | |
|---|---|---|
| 平台 | Windows、macOS、Linux 接收端 | 仅 Windows |
| 传输方式 | 网络视频 | 本地 GPU 纹理共享 |
| 同一台电脑 | 可用 | 可用，延迟更低 |
| 第二台电脑 | 可用 | 不适用 |
| 设置 | 防火墙与发现 | 无需设置 |
| 最适合 | 分布式部署、笔记本、媒体服务器 | 单台 Windows 机器、对时序要求严格的现场 |
如果两个应用都运行在同一台 Windows 电脑上，先从 Spout 开始。当 TouchDesigner 运行在另一台机器上，或多个系统需要同一个源时，改用 NDI。
第 1 步：在 Pixel LED Animator 中启动输出
- 开始播放，让预览动起来。
- 把预览输出切换条设为 Spout 或 NDI，或打开流式传输窗口，选择对应协议并点击 Start Streaming。
- 确认发送方名称：
Pixel LED Animator 3。
应用按画布分辨率发送 RGB 帧。如果画布是 64 x 32，TouchDesigner 收到的就是 64 x 32；它不会收到缩放后的 1080p 画面。请在搭建网络之前先确定工作分辨率。
第 2 步：在 TouchDesigner 中接收信号
NDI In TOP
- 添加一个 NDI In TOP。
- 在源参数中选择
Pixel LED Animator 3。 - 测试时把分辨率设为 Native，之后锁定为矩阵尺寸。
Spout In TOP
- 添加一个 Spout In TOP。
- 选择
Pixel LED Animator 3作为发送方。 - 在节点信息弹窗中确认分辨率。
在输入 TOP 上挂一个 Info CHOP，用来观察帧率、分辨率和丢帧情况。如果在加入任何效果之前帧率就不稳定，请先解决源或网络问题。
第 3 步：搭建干净的处理链
一条简单可靠的链路是这样的：
NDI In / Spout In → Null → Level → Composite → Out
把 Null TOP 当作唯一的输入主节点，下游每个分支都引用这个 Null。这样您可以换掉 Spout 改用 NDI，而不必重建整个网络。
然后只添加演出真正需要的节点：
- Level TOP 控制曝光、伽马和透明度。
- Transform TOP 控制位置、缩放和旋转。
- Feedback TOP 配合 Composite TOP，做出拖尾和运动残影。
- Chroma Key TOP 在需要透明度时使用；源本身不带 alpha。
- Cache TOP 用来平滑短暂的网络抖动。
- Audio In CHOP → Math CHOP → Null CHOP → export，用音乐驱动亮度、缩放或颜色。
要做像素级精确的工作，请把输入 TOP 的过滤方式设为 Nearest。平滑过滤适合有机质感，但会毁掉锐利的 LED 边缘。
第 4 步：输出到 LED 或屏幕
TouchDesigner 可以通过自带的 DMX/Art-Net 算子、媒体服务器或直接视频输出送出画面。请选择与接收端匹配的路径：
- Art-Net/sACN 控制器： 像素数量和宇宙映射必须与控制器配置完全一致。
- 媒体服务器或 Resolume： 直接把 NDI 或 Spout 往下传，不要重新编码。
- LED 处理器： 按处理器的原生分辨率输出视频信号。
- 仅做预览： 使用 Window COMP，并让渲染分辨率保持在矩阵尺寸。
如果 TouchDesigner 只负责音频反应，请把处理结果通过 Art-Net 送回控制器，而不是再做一次视频编码。
第 5 步：让性能保持可预测
1920 x 1080、60 FPS 的 NDI 是很重的流，矩阵预览几乎不需要这么大的带宽。
- 让源分辨率匹配矩阵，而不是匹配显示器。
- 矩阵工作用 30 FPS，除非效果依赖高速运动。
- 同机工作时优先使用 Spout。
- 关闭不需要的 TOP，保持网络层级浅。
- 演出前接上真实控制器测试。
故障排除
| 问题 | 解决方法 |
|---|---|
| 找不到 NDI 源 | 检查 NDI 运行时、防火墙、子网和发现设置；重启两个应用 |
| 缺少 Spout 发送方 | Spout 仅支持 Windows；确认 Spout2 运行时已安装，且输出切换条不在 关闭 |
| TouchDesigner 中画面全黑 | 在应用中开始播放并点击 Start Streaming |
| 卡顿或丢帧 | 降低分辨率或 FPS，改用 Spout，简化网络 |
| 像素边缘发虚 | 把输入 TOP 的过滤方式设为 Nearest |
| 颜色偏移 | 检查 Level TOP，避免伽马被应用两次 |
常见问题
TouchDesigner 能把结果发给 WLED 吗？ 可以，通过 Art-Net 输出到配置为 Art-Net 接收端的 WLED。DDP 不是 TouchDesigner 的标准算子，所以走 Art-Net 或 sACN 更稳妥。
需要 NDI 许可证吗？ NDI 运行时可免费安装和使用。在自家产品中集成 NDI 支持的开发者，需要另行遵守 SDK 授权条款。
两个应用可以跑在不同的电脑上吗？ 可以，通过 NDI。两台机器需要在同一网络内，并在防火墙中放行。
信号源带 alpha 吗？ 不带。Pixel LED Animator 发送的是 RGB。需要透明度时，请在 TouchDesigner 中使用 Chroma Key TOP 或亮度键。
能用来做投影映射吗？ 可以。用 TouchDesigner 的映射工具把生成的画面变形贴合到投影表面，再输出到投影机或 LED 处理器。
