#调试 #osc #终端 #交互式 #控制 #开放 #声音

应用 oscd

一个简单的交互式终端OSC (开放声音控制) 调试器

4个版本

0.1.6 2024年4月6日
0.1.5 2024年4月6日
0.1.4 2023年5月7日
0.1.3 2022年8月14日
0.1.2 2022年8月14日

136音频

每月21 次下载

MIT 协议

6MB
1.5K SLoC

oscd

Build Release crates.io

oscd,一个使用 nom 作为词法分析器/解析器的简单交互式 OSC 终端调试器,oscd 提供自动类型转换和支持发送多个osc参数。

它有两个简单功能

  • 监控发送到端口的OSC消息(通过UDP)
  • 将OSC消息(通过UDP)发送到端口
    • 默认端口 = 57110
    • 默认地址 = 127.0.01

安装/运行

  • 最简单的方法是使用 cargo install oscd
  • 另一种方法是从 最新发布的二进制文件 下载,解压缩并将它放在基于您的操作系统的可执行文件位置,例如 usr/local/bin (对于OSX)
  • 键入 oscd 运行程序

用法

  • 使用以下格式发送消息: <address> <argument>
  • <address> 是用于通信的OSC路径。
  • <argument> 是一个数字或一个字符串(可以省略双引号)并且可以有多个参数。
  • 例如:/s_new "default" -1 0 0 "freq" 850,将被解析为("s_new", [String("default"), Int(-1), Int(0), Int(0), String("freq"), Int(850)]))
  • 默认情况下,oscd会自动为您转换类型,并且它还支持数字字面量类型转换
    • 例如:65.4321_f64 等价于 65.4321 as f64显式转换
    • 它将被解析为 Double(65.4321),否则 osc 将根据输入进行解析(例如 65.4321 = f32)。
  • 请参见以下支持的类型。
  • 完整的 osc 例子:/s_new "default with whitespace" 1002 'A' 12_i32 12_i64 -12 -12_i32 -12_i64 12.4533 1.234_f64 #2f14DF12 ~00110011 @12345:23 [12,20,true] %[10,20,30]

类型

oscd 遵循来自 OscTyperosc

状态 类型 示例 备注
Int(i32) 12341234_i32
Long(i64) 1234_i64
Float(f32) 1234.321234.32_f32
Double(f64) 1234.25434_f64
String(String) "此处填写字符串" 需要用双引号括起来
Bool(bool) truefalse
Char(char) 'S' 需要用单引号括起来
Blob(Vec<u8>) %[10,20,30] % 为前缀,用 , 分隔,不是 u8 的数字将被丢弃
Time(OscTime) @123456789:20 @ 为前缀,用 : 分隔小数部分,例如:@<seconds>:<fractional>
Color(OscColor) #2F14DF2A # 为前缀,后跟 base16 的 #<red><green><blue><alpha>
Midi(OscMidiMessage) ~01F14FA4 ~ 为前缀,后跟 base16 的 ~<port><status><data1><data2>
Array(OscArray) [10,20,true]
Nil Nil
Inf Inf

开发

  • cargo运行

构建 / 发布

  • 使用 Github Action 进行二进制构建,支持以下架构
    • aarch64-linux
    • x86_64-linux
    • x86_64-macos
    • x86_64-windows

绕过安全设置。 (OSX) (可选,如果手动安装二进制文件而不是 cargo install oscd)

从 Mountain Lion 开始的每个 OS X 版本迭代中,苹果公司都逐渐让用户更难访问未经认证的应用程序/二进制文件,例如来自开源/免费软件社区的应用程序/二进制文件。

问题通常在尝试直接或通过 Dock 启动新下载的应用程序/二进制文件时出现。在下载新应用程序时,操作系统将其放入“隔离列表”。一个令人警觉的错误信息会显示应用程序“已损坏”,或来自未知开发者,并被阻止运行。

对于单个应用程序/二进制文件的标准解决方案是使用右键单击(或 Ctrl-单击)应用程序/二进制文件的图标弹出的菜单中的“打开”来启动。

资源

致谢

依赖项

~8–18MB
~205K SLoC