OpenNI 1.5.4.0 技术文档

1. 安装指南

1.1 Windows 安装

1.1.1 系统要求

• Microsoft Visual Studio 2010
• Python 2.6+/3.x
• PyWin32
• WIX 3.5
• JDK 6.0

1.1.2 可选要求

• Microsoft WDK（用于构建 USB 设备驱动）
• Doxygen 和 GraphViz（用于构建文档）

1.1.3 安装步骤

1. 卸载之前的版本。
2. 进入目录 Platform\Win32\CreateRedist。
3. 运行脚本：
   • 32 位系统：RedistMaker.bat y 32 y
   • 64 位系统：RedistMaker.bat y 64 y
4. 安装生成的 .exe 文件，路径为 Platform\Win32\CreateRedist\FinalXX\OPENNI-WinXX-1.X.X.X.exe。

1.2 Linux 安装

1.2.1 系统要求

• GCC 4.x
• Python 2.6+/3.x
• LibUSB 1.0.x
• FreeGLUT3
• JDK 6.0

1.2.2 可选要求

• Doxygen 和 GraphViz（用于构建文档）
• Mono（用于构建 Mono 包装器）

1.2.3 安装步骤

1. 进入目录 Platform/Linux/CreateRedist。
2. 运行脚本：./RedistMaker。
3. 进入目录 Platform/Linux/Redist。
4. 运行脚本：sudo ./install.sh。

1.3 MacOSX 安装

1.3.1 系统要求

• Xcode 4.3.2（适用于 MacOSX 10.7）
• Xcode 3.2.6（适用于 MacOSX 10.6）
• LibUSB 1.0.x（补丁开发树）

1.3.2 安装步骤

1. 安装 Xcode 并注册为 Mac 开发者。
2. 通过 MacPorts 或源码编译安装 LibUSB。

2. 项目使用说明

2.1 基本使用

• OpenNI 是一个开源的跨平台框架，用于处理深度摄像头数据。它提供了对深度图像、彩色图像和用户跟踪的支持。
• 用户可以通过 API 获取深度数据、彩色图像数据，并进行进一步的处理。

2.2 示例程序

• OpenNI 提供了多个示例程序，位于 Platform/Linux/Build 或 Platform/Win32/Build 目录下。
• 用户可以通过运行这些示例程序来了解如何使用 OpenNI 获取和处理数据。

3. 项目 API 使用文档

3.1 核心 API

• NiSimpleViewer: 一个简单的示例程序，展示了如何获取和显示深度图像。
• NiUserTracker: 一个用户跟踪示例，展示了如何检测和跟踪用户。

3.2 数据获取

• OpenNI::Device: 用于打开和关闭设备。
• OpenNI::DepthGenerator: 用于获取深度数据。
• OpenNI::ImageGenerator: 用于获取彩色图像数据。

3.3 数据处理

• OpenNI::MapOutputMode: 用于设置输出模式（分辨率、帧率等）。
• OpenNI::DepthMetaData: 用于获取深度数据的元信息。

4. 项目安装方式

4.1 源码编译

• 用户可以从 GitHub 获取源码，并根据平台要求进行编译。
• 编译步骤详见 Build Notes 部分。

4.2 二进制安装

• 用户可以直接下载二进制文件进行安装，路径为 http://www.openni.org/Downloads/OpenNIModules.aspx。

4.3 环境变量配置

• 安装完成后，系统会自动配置环境变量，用户也可以手动修改这些变量以指向开发目录。

通过以上文档，用户可以顺利安装、使用和了解 OpenNI 项目。