03-界面说明

界面说明

整体布局

┌──────────────────────────────────────────────────────────────┐
│  ◆ OSC调试助手  v1.0                           ⚫ 未绑定     │ ← 头部栏
├────────────┬─────────────────────────────────────────────────┤
│ 连接设置    │  ┌─ 日志输出区 ─────────────────────────────┐  │
│ 本地端口   │  │ [RX] /1/fader1 = 0.5                     │  │
│ 远程地址   │  │ [TX] /1/button1 = 1                      │  │
│ 目标端口   │  │ [RX] /synth/filter = 0.75                │  │
│ 编码       │  └──────────────────────────────────────────┘  │
│ [绑定/解绑] │  ┌─ 状态栏 ─────────────────────────────────┐  │
│            │  │ TX: 128 │ RX: 256    [重置] [清除] [导出]│  │
│ 显示设置    │  └──────────────────────────────────────────┘  │
│            │───────────────────────────────────────────────│
│ 发送区      │  ┌─ OSC 控件面板 ──────────────────────────┐  │
│ OSC地址    │  │  [编辑模式 ☐] [缩放▼] [吸附▼]           │  │
│ 类型标签   │  │  ┌────────────────────────────────────┐  │  │
│ 值         │  │  │                                    │  │  │
│ [发送]     │  │  │   [推子]  [按钮]  [旋钮]  [标签]   │  │  │
│ ☐ 自动发送 │  │  │                                    │  │  │
│ 间隔(ms)   │  │  │   (自由布局画布)                   │  │  │
│            │  │  │                                    │  │  │
│ 数据可视化  │  │  └────────────────────────────────────┘  │  │
│            │  │  工具栏: [+推子][+按钮][+旋钮][+标签][删] │  │
│            │  └──────────────────────────────────────────┘  │
└────────────┴─────────────────────────────────────────────────┘

连接设置

字段	说明
本地端口	本机监听的 UDP 端口，用于接收 OSC 消息
远程地址	目标 OSC 设备的 IP 地址
目标端口	目标 OSC 设备的端口
编码	字符编码

点击绑定后本地端口开始监听。OSC 是无连接协议，绑定的同时即可收发。

发送区

字段	说明
OSC 地址	消息地址，如 `/1/fader1`、`/synth/cutoff`
类型标签	值的数据类型：`i`(整数)、`f`(浮点数)、`s`(字符串)
值	要发送的具体数值或文本

OSC 控件面板

控件	图标	功能	发送值
推子 (Fader)	▎▎	垂直滑块，拖拽调整	0.0 ~ 1.0 连续浮点数
按钮 (Button)	●	点击触发	按下=1.0，松开=0.0
旋钮 (Knob)	◎	旋转调整	0.0 ~ 1.0 连续浮点数
标签 (Label)	ABC	显示数值（不发送）	仅显示，用于监控接收值

编辑模式

勾选工具栏的 编辑模式 复选框后：
控件显示蓝色调整手柄
可拖拽控件移动位置
拖拽右下角手柄调整大小
双击控件打开属性设置对话框
右键菜单提供更多选项

取消编辑模式后，控件恢复交互状态（推子可滑动、按钮可点击）。

画布功能

功能	说明
缩放	缩放控件显示大小（50%-200%）
网格吸附	拖动时自动对齐网格（10/20/40px）
滚轮缩放	鼠标滚轮快速调整缩放

控件属性

每个控件可配置：
OSC 地址：绑定的 OSC 消息地址（唯一标识）
颜色：控件的外观颜色
标签：控件下方显示的文本

图表

数据可视化面板用于从 OSC 消息中实时提取数值并绘图。

启用步骤

在左侧 数据可视化 面板中勾选 启用图表
添加数据提取规则
图表区实时更新

规则类型

类型	说明	示例表达式
正则表达式	从 OSC 值日志中匹配数值	`= (\d+\.?\d*)`
JSON 路径	如果 OSC 消息包含 JSON 字符串	`temperature`

图表类型

折线图、平滑曲线、散点图、面积图、柱状图、饼图，适合展示 OSC 参数变化趋势。

时间窗口

5 秒 ~ 600 秒（10 分钟）可调。