首页
/ OSCeleton 技术文档

OSCeleton 技术文档

2024-12-20 05:33:41作者:钟日瑜

1. 安装指南

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

Windows / Linux / Mac OSX

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

  1. 下载并安装 avin 的 Primesense PSDK 驱动(适用于 Kinect):

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 项目。祝您使用愉快!

登录后查看全文
热门项目推荐