OSCeleton 技术文档

1. 安装指南

1.1 安装 OpenNI 驱动、框架和中间件

Windows / Linux / Mac OSX

首先，您需要安装 OpenNI 框架、驱动和 NITE 中间件。请按照以下步骤操作：

1. 下载并安装 avin 的 Primesense PSDK 驱动（适用于 Kinect）：
   • 项目地址：https://github.com/avin2/SensorKinect
   • 按照项目中的说明安装 OpenNI 框架、驱动和 NITE 中间件。

1.2 安装 OSCeleton

Linux 或 Mac OSX

1. 克隆或下载 OSCeleton 项目。
2. 在终端中进入项目目录。
3. 运行以下命令进行编译：

   make
   

Windows

1. 使用预编译的二进制文件，位于 bin\win32 目录下。
2. 或者使用 VC++ Express 的 .sln 文件进行编译。

2. 项目使用说明

2.1 运行 OSCeleton

默认运行

• 在 Linux 或 Mac OSX 上，直接运行编译后的可执行文件。
• 在 Windows 上，运行 bin\win32 目录下的可执行文件。

自定义运行

• 如果不带任何参数运行可执行文件，OSCeleton 将默认将 OSC 消息发送到本地主机的 7110 端口。
• 您可以通过运行 OSCeleton -h 获取所有可用选项的完整列表。

2.2 测试 OSCeleton

• 使用 Animata 骨骼动画软件进行测试，需要使用 -k 选项以适应 Animata 的特定格式。
• 例如：

  OSCeleton.exe -k -mx 640 -my 480 -ox -160
  

3. 项目 API 使用文档

3.1 OSC 消息格式

新用户检测

• 地址模式：/new_user
• 类型标签：i
• 描述：新用户被检测到，尚未有骨骼数据。

新骨骼检测

• 地址模式：/new_skel
• 类型标签：i
• 描述：新骨骼被检测到，校准成功。

用户丢失

• 地址模式：/lost_user
• 类型标签：i
• 描述：用户丢失，ID 将被释放。

关节消息

• 地址模式：/joint
• 类型标签：sifff
• 描述：包含每个骨骼关节的坐标。

3.2 其他模式

Kitchen 模式

• 使用 -k 选项，消息格式为：
  • 地址模式：/joint
  • 类型标签：sff

Quartz Composer 模式

• 使用 -q 选项，消息格式为：
  • 地址模式：/joint/name/id
  • 类型标签：fff

4. 项目安装方式

4.1 源码编译

• 在 Linux 或 Mac OSX 上，使用 make 命令进行编译。
• 在 Windows 上，使用 VC++ Express 的 .sln 文件进行编译。

4.2 预编译二进制文件

• 在 Windows 上，可以直接使用 bin\win32 目录下的预编译二进制文件。

5. 其他

5.1 社区与支持

• 如有关于功能请求、错误报告或一般讨论，请加入我们的 Google 群组。

5.2 OSCeleton-Puppet

• OSCeleton-Puppet 是 OSCeleton 的一个分支，添加了一些特定项目的功能。
• 新增选项以 -x 开头，如 -xr、-xt 和 -xd。

---

希望这篇文档能帮助您更好地理解和使用 OSCeleton 项目。祝您使用愉快！