03-界面说明

界面说明

整体布局

┌──────────────────────────────────────────────────────────────┐
│  ◆ TUIO调试助手  v1.0                          ⚫ 未连接     │ ← 头部栏
├────────────┬─────────────────────────────────────────────────┤
│ 模式选择    │  ┌─ 对象/触控画布 ─────────────────────────┐  │
│ ○ 发送端   │  │                                          │  │
│ ○ 接收端   │  │     ○ (触控点/物体可视化)               │  │
│            │  │     ╲                                     │  │
│ 发送端配置  │  │      ╲  angle                           │  │
│ 目标地址   │  │       □ (物体)                           │  │
│ 目标端口   │  │                                          │  │
│ 本地端口   │  └──────────────────────────────────────────┘  │
│ 模拟模式   │  ┌─ 对象树 ─────────────────────────────────┐  │
│ 物体CID    │  │ SID:0  CID:5  x:0.5 y:0.3 a:45°         │  │
│ 物体角度   │  │ SID:1  CID:3  x:0.7 y:0.6 a:90°         │  │
│ [清除画布] │  └──────────────────────────────────────────┘  │
│            │                                               │
│ 接收端配置  │  ┌─ 日志输出区 ─────────────────────────────┐  │
│ 监听端口   │  │ [RX] /tuio/2Dcur set 0 0.5 0.3 0 0 0   │  │
│ [监听]     │  │ [RX] /tuio/2Dobj set 0 5 0.5 0.3 0.785 │  │
│            │  └──────────────────────────────────────────┘  │
│ 显示设置    │  ┌─ 状态栏 ─────────────────────────────────┐  │
│ 时间戳     │  │ TX: 256 │ RX: 512    [重置] [清除] [导出]│  │
│ 自动滚动   │  └──────────────────────────────────────────┘  │
│ 行距/字号  │                                               │
└────────────┴─────────────────────────────────────────────────┘

模式选择

模式	说明
TUIO 发送端	在画布上操作，生成 TUIO 消息并发送到目标
TUIO 接收端	监听端口，接收 TUIO 消息并可视化

发送端配置

参数	说明
目标地址	接收端的 IP 地址
目标端口	接收端的端口（TUIO 默认 3333）
本地端口	本机监听端口
模拟模式	光标 / 物体 / 多点触控
CID	物体类型的 Class ID（物体模式）
Angle	物体初始角度（物体模式）
清除画布	清除所有触控点/物体

模拟模式

画布上点击/拖拽/松开发送 TUIO 2Dcur 消息。对应单点触控场景。

操作映射：
按下 → /tuio/2Dcur set
移动 → 同上（位置更新）
抬起 → 从 alive 列表中移除该 sid

物体模式 (Object)

放置 fiducial 标记物，发送 TUIO 2Dobj 消息。包含位置、角度和类别信息。

操作映射：
点击 → 弹窗设置 CID（类别）和初始角度
拖拽 → 更新物体位置
旋转 → 拖拽旋转手柄调整角度
右键删除 → 移除物体

消息格式：
/tuio/2Dobj set ...

多点触控模式 (MultiTouch)

模拟多手指触控，使用锚点（Anchor）机制。

操作映射：
按下 → 添加一个锚点（anchor），分配 SID
移动 → 更新活跃锚点的位置
抬起 → 移除对应锚点

对象树

实时显示当前活跃的 TUIO 对象/光标列表：

列	说明
SID	会话 ID（Session ID）
CID	类型 ID（物体模式）/ —（光标模式）
X	归一化 X 坐标 (0.0-1.0)
Y	归一化 Y 坐标 (0.0-1.0)
Angle	旋转角度（弧度，物体模式）

对象树 50ms 自动刷新。

日志

日志区显示所有 TUIO 通信数据：

特性	说明
TX 颜色	🟡 金色 — 发送的 TUIO/OSC 消息
RX 颜色	🟢 青色 — 接收的 TUIO/OSC 消息
SYS 颜色	⚪ 灰色 — 系统消息
右键菜单	复制选定行 / 复制全部

TUIO 消息以 OSC 格式展示，可直接查看原始协议数据，方便分析。日志区下方状态栏显示字节计数，支持重置、清除和导出为 TXT/CSV。