音视频图形学桌面应用【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址https://gitcode.com/GitHub_Trending/t3/t3点击查看免费下载导读ArtnetOutput是 TiXL 的 Lib.io.dmx 库中用于将 DMX 灯光数据通过 Art-Net 网络协议发送到舞台灯光设备的核心操作符。本文从操作符的使用方法出发结合 TiXL 开源仓库中 ArtnetOutput.cs 的真实实现系统讲解每一个输入参数、广播与单播两种发送模式、多 Universe 自动扩展机制、ArtPoll 节点发现、ArtSync 同步以及后台发送线程的底层原理读完即可在 TiXL 中搭建从画面到真实灯具的完整实时灯光链路。ArtnetOutput 是什么ArtnetOutput归属于 Lib.io.dmx 子命名空间官方文档对其定位为通过 Art-Net 协议在网络上发送 DMX 数据的操作符Sends DMX data over the network using the Art-Net protocol。它可以向灯具、Art-Net 节点或媒体服务器等支持 Art-Net 的设备广播broadcast或单播unicastDMX 数据并且能够同时发送多个 DMX Universe其底层使用专用后台线程保证高吞吐、低延迟的发送性能。它属于 TiXL 完整的 DMX 输入输出家族中的一环。同族操作符包括ArtnetInput —— 接收 Art-Net 数据来自调光台、媒体服务器SacnInput / SacnOutput —— 基于 sACNStreaming ACN / E1.31协议的收发DmxOutput —— 通过 FTDI 等 USB-DMX 硬件接口发送PointsToDmxLights —— 将 3D 点阵转换为 DMX 通道值是 ArtnetOutput 最常见的上游数据源。整个库的概览见 Lib.io.dmx README。兼容性说明该操作符依赖第三方原生库ArtNet.dll源码中以[ExportDependencies(ArtNet.dll)]声明该库随仓库依赖目录分发见 Dependencies/ArtNet.dllTiXL 会按依赖解析机制自动加载。核心特性根据文档并结合源码ArtnetOutput 提供以下关键能力特性说明多输入支持InputsValues为多输入MultiInput每个接入的输入列表对应一个独立的 Universe 发送自动 Universe 扩展单个输入列表超过 512 通道时自动切分为多个 512 通道的包依次发送到连续的 UniverseArtPoll 节点发现内置 ArtPoll/ArtPollReply 机制可自动发现网络上的 Art-Net 节点并填入TargetIpAddress下拉框帧率限制MaxFps限制最大发送速率防止网络泛洪ArtSync 同步SendSync开启后在 DMX 数据后追加 ArtSync 包用于跨节点同步更新自动重连网络异常导致发送连续失败时自动断开并在配置有效后自动恢复自动复活逻辑约 2 秒重试一次官方文档给出的三条快速上手建议广播模式将TargetIpAddress留空即可单播模式填写目标节点 IP。用UniverseChannels为每个输入定义起始 Universe不足时自动扩展。SendTrigger置为 true 开始持续发送置为 false 停止发送。搜索标签AKAartnet、dmx、lighting、sacn。输入参数详解以下是官方文档列出的全部输入参数并结合源码补充了取值范围、默认值与底层行为。名称类型说明含源码级细节InputsValuesListint 多输入多输入槽。每个接入的输入提供一个 Universe 的 DMX 通道数据值为 float/int 列表发送时被钳制到 0–255源码中val 0 ? 0 : (val 255 ? 255 : val)。每个输入最多构成一个 512 通道的包超过部分自动溢出到下一个 UniverseUniverseChannelsListint定义每个输入对应的起始 Universe 编号。当某个输入通道数超过 512 时自动跨入下一 Universe输入数量增加时该列表会自动扩展源码在每帧更新中动态补齐并回写LocalIpAddressString发送所用网卡的 IP 地址。下拉框列出本机所有可用网卡含回环地址127.0.0.1。多网卡机器务必选择连接灯光网络的网卡否则广播地址计算错误SendTriggerBoolean手动发送开关从 0 变 1 的上升沿触发启动后台发送线程置 0 则停止发送。关闭状态下面板显示 Sending is disabled. Enable Send Trigger.ReconnectBoolean强制重连网络 Socket内部会关闭并重建 UDP 套接字必要时重启发送线程SendSyncBoolean开启后每轮 DMX 数据发送完毕后追加一个 ArtSync 包OpCode 0x0052用于多节点同步刷新SendUnicastBoolean开启后以单播方式向TargetIpAddress发送关闭则向子网广播地址发送基于本地 IP 与子网掩码计算失败时回退到全局广播255.255.255.255EnableArtNet4Boolean默认true。开启后启用 Art-Net 4 扩展当节点列表中存在针对某 Universe 的路由条目来自 ArtPollReply 的端口地址表时该 Universe 的数据包直接单播到对应节点而非广播TargetIpAddressString单播目标 IP。留空则广播到整个网络通过 ArtPoll 发现的节点会以名称 (IP)形式出现在该输入的下拉框中选择后自动提取括号内 IPPrintArtnetPollBoolean开启后发送 ArtPoll 包OpCode 0x0020并监听 ArtPollReplyOpCode 0x0021每 3 秒轮询一次发现的节点填充TargetIpAddress下拉框。关闭则停止监听MaxFpsInt32限制最大发送帧率默认600 表示不限速。发送线程用高精度 Stopwatch 做时间调度空闲时 Sleep(1ms)/SpinWait 降 CPU 占用PrintToLogBoolean开启后将状态信息与错误打印到 TiXL 日志便于调试发送线程异常时输出 ArtNet Sender survived error: ...默认值与初始状态源码佐证在 ArtnetOutput.cs 的输入槽定义中可以看到几个重要默认值EnableArtNet4默认true即默认启用 Art-Net 4 单播路由MaxFps默认60SendTrigger、Reconnect、SendSync、SendUnicast、PrintToLog默认均为falseLocalIpAddress默认为空但示例工程见下文将其设为127.0.0.1。输出名称类型ResultT3.Core.DataTypes.CommandResult输出一个 Command在 TiXL 的运算符图中用于表示已执行一次发送动作可作为下游逻辑如触发其他运算的连接点。底层实现剖析它如何在内部工作ArtnetOutput 的实现远超发个 UDP 包的简单程度其内部包含一套为实时性能设计的多线程架构全部代码位于 ArtnetOutput.cs类声明见 第 12 行。1. 生产者-消费者模型与零分配队列主线程更新线程在Update()中收集各输入的通道列表、计算 Universe 映射将数据打包进FrameData后放入ConcurrentQueueFrameData _dataQueue。后台发送线程ArtNetSender以AboveNormal线程优先级独立运行SenderLoop()从队列取帧并逐 Universe 拆包发送从而不阻塞 TiXL 主渲染循环。对象池优化FrameData复用一个ConcurrentBag对象池RentFrameData/_frameDataPool发送完毕的帧回池复用避免高频分配导致的 GC 压力当队列积压超过 2 帧时丢弃最旧帧保证以最新状态发送丢帧保实时。2. Art-Net 数据包构建SendDmxPacket()直接手工构造标准 Art-Net 包发送到 UDP 6454 端口前 8 字节为协议 IDArt-Net\0OpCode 0x0050ArtDmx每 Universe 一个递增序列号_universeSequenceNumbers1–255 循环用于接收端丢包检测Universe 编号拆为低位字节与高位 7 位写入第 15、16 字节通道长度sendLength保证至少 2 字节且为偶数DMX 起始码要求通道值逐字节钳制 0–255 后拷贝进 530 字节的复用缓冲区_packetBuffer。超过 512 通道的输入在发送线程内被切分为多个 512 通道的块并依次递增 Universe 编号发送。3. 广播地址的稳健计算广播模式下并非简单地发往255.255.255.255ConnectionSettings.Update()会先尝试用本地 IP 与网卡子网掩码计算子网定向广播地址CalculateBroadcastAddressIP 与掩码按位或失败才回退到全局广播。这样既减少无关网段的流量也保证回环地址localhost下可正常测试。相关逻辑见 第 511-571 行。4. ArtPoll 节点发现与 Art-Net 4 路由开启PrintArtnetPoll后启动两个后台组件每 3 秒发送一次 ArtPoll 的Timer以及持续ReceiveFrom监听回复的 ArtNetPollListener 线程收到 ArtPollReply长度 ≥ 238 字节OpCode 0x0021后解析节点 IP、短名称18 字节 ASCII以名称 (IP)形式存入发现列表并填充下拉框进一步解析 Net/SwIn/SubSwitch 端口地址表构建_universeRoutingTableUniverse → 节点 IP:6454在EnableArtNet4开启时发送线程会查询该路由表将对应 Universe 直接单播到目标节点——这就是Art-Net 4智能路由的含义。5. 连接生命周期与容错网络变化本地 IP 变更会触发needsSocketRebind自动重建 Socket未连接状态下每 2 秒自动重试连接shouldAutoRevive发送线程连续10 次错误MAX_CONSECUTIVE_ERRORS即置_connected false触发重连流程SocketError.WouldBlock / NoBufferSpaceAvailable / ConnectionReset等瞬时错误被宽容处理不视为失败Socket 设置 10MB 发送缓冲区并启用广播、复用地址选项避免快速重启时的端口占用问题。上手实战从 3D 场景到真实灯具场景 A与 PointsToDmxLights 配合推荐仓库自带的官方示例 HowToDmx.t3对应 UI 布局 HowToDmx.t3ui展示了完整的实战链路GridPoints生成 3D 点阵 →TransformPoints/PerlinNoise3驱动运动 →PointsToDmxLights将点位置/旋转/颜色映射为 DMX 通道支持FixtureChannelSize、Pan/Tilt通道与PanRange/TiltRange、FitInUniverse/FillUniverse等参数→ArtnetOutput发出。示例中ArtnetOutput节点的关键初始配置来自 HowToDmx.t3SendTrigger: true, // 直接开启持续发送 Reconnect: false, SendUnicast: false, // 广播模式 SendSync: false, LocalIpAddress: 127.0.0.1 // 本机回环测试即默认走广播模式、监听本机回环地址方便在没有真实灯光网络时先用本机工具验证。场景 B最简手动测试拖入ArtnetOutput操作符用任意数值列表如PointsToDmxLights输出或手写 0–255 的列表接到InputsValuesLocalIpAddress选择连接灯光网络的网卡 IP广播留空TargetIpAddress单播填目标节点 IP将SendTrigger置为 true在接收端如 Art-Net 节点/模拟器检查数据配合PrintToLog观察日志与面板状态Connected and sending.。推荐配置速查目标配置快速本地验证LocalIpAddress127.0.0.1、SendUnicastfalse、MaxFps60单播到指定灯具节点SendUnicasttrueTargetIpAddress节点IP可用 ArtPoll 发现多 Universe 大场景多个输入接到InputsValuesUniverseChannels自动扩展多节点严格同步开启SendSync发送 ArtSync降低 CPU/网络占用调低MaxFps如 30网络排查开启PrintArtnetPoll发现节点PrintToLog故障排查与提示发不出数据检查SendTrigger是否开启面板会提示 Sending is disabled. Enable Send Trigger.检查LocalIpAddress是否选择了正确的网卡——多网卡机器选错会导致广播发往错误网段。设备无响应确认目标设备支持 Art-Net 且端口 6454 未被占用单播时确认TargetIpAddress正确广播时确认子网一致。数据抖动/丢包调低MaxFps确认网络交换机未泛洪Art-Net 序列号机制可帮助接收端识别乱序。节点找不到确保PrintArtnetPoll开启且设备与电脑处于同一网段等待 3 秒轮询周期。重启后无法绑定端口Socket 已启用ReuseAddress若仍冲突检查是否有其他 Art-Net 软件占用 6454 端口。与 ArtnetInput 联调同一台机器上可用 ArtnetInput 反向接收验证闭环它同样使用LocalIpAddress指定监听网卡。延伸阅读操作符官方文档ArtnetOutput.md同族操作符ArtnetInput、SacnOutput、SacnInput、DmxOutput、PointsToDmxLights完整源码ArtnetOutput.cs可运行示例HowToDmx.t3及其 UI 布局赞分享音视频图形学桌面应用【免费下载链接】t3TiXL is an open source software to create realtime motion graphics.项目地址https://gitcode.com/GitHub_Trending/t3/t3点击查看免费下载相关推荐TiXL 实时灯光控制实战指南深入解析 Lib.io.dmx 的 Art-Net、sACN 与 DMX 全套算子TiXL 实时灯光控制实战指南深入解析 Lib.io.dmx 的 Art Net、sACN 与 DMX 全套算子 TiXL 不仅是一款实时动态图形创作工具其音视频图形学桌面应用TiXL FreeDOutput 操作符实战指南使用 FreeD 协议经 UDP 发送相机追踪数据TiXL FreeDOutput 操作符实战指南使用 FreeD 协议经 UDP 发送相机追踪数据 本指南围绕 TiXL实时动态图形创作软件中 Lib.i音视频图形学桌面应用TiXL OscOutput 操作符实战指南用 OSC 协议把实时画面数据发送到任意接收端TiXL OscOutput 操作符实战指南用 OSC 协议把实时画面数据发送到任意接收端 本篇指南围绕 TiXL 中 Lib.io.osc 库的 OscOu音视频图形学桌面应用上一篇Wordless实战多语言文本分析如何从复杂变简单下一篇颠覆阅读体验Koodo Reader的AI助手与智能分析革命创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考