OpenNI 项目下载及安装教程

1. 项目介绍

OpenNI（Open Natural Interaction）是一个开源框架，旨在为自然交互设备（如深度摄像头）提供统一的接口。它支持多种传感器设备，并提供了一系列的API，帮助开发者轻松地集成和使用这些设备。OpenNI 主要用于开发与深度摄像头相关的应用程序，如手势识别、3D扫描等。

2. 项目下载位置

OpenNI 项目的源代码托管在 GitHub 上。你可以通过以下步骤下载项目：

1. 打开终端或命令提示符。

2. 使用 git clone 命令下载项目：

   git clone https://github.com/OpenNI/OpenNI.git
   

   这将会在你的当前目录下创建一个名为 OpenNI 的文件夹，并将项目的所有文件下载到该文件夹中。

3. 项目安装环境配置

3.1 Windows 环境配置

3.1.1 安装依赖

在 Windows 上安装 OpenNI 需要以下依赖：

1. Microsoft Visual Studio 2010：用于编译项目。
2. Python 2.6+/3.x：用于脚本执行。
3. PyWin32：用于与 Windows API 交互。
4. WIX 3.5：用于生成安装包。
5. JDK 6.0：用于 Java 开发。

3.1.2 配置环境变量

1. 打开“控制面板” -> “系统” -> “高级系统设置” -> “环境变量”。

2. 添加 JAVA_HOME 环境变量，指向 JDK 的安装目录。例如：

   JAVA_HOME=C:\Program Files (x86)\Java\jdk1.6.0_32
   

3. 确保 PATH 环境变量中包含 Python 和 JDK 的安装路径。

3.2 Linux 环境配置

3.2.1 安装依赖

在 Linux 上安装 OpenNI 需要以下依赖：

1. GCC 4.x：用于编译项目。
2. Python 2.6+/3.x：用于脚本执行。
3. LibUSB 1.0.x：用于 USB 设备支持。
4. FreeGLUT3：用于图形显示。
5. JDK 6.0：用于 Java 开发。

3.2.2 配置环境变量

1. 打开终端，编辑 ~/.bashrc 文件，添加以下内容：

   export JAVA_HOME=/usr/lib/jvm/java-6-openjdk
   export PATH=$PATH:$JAVA_HOME/bin
   

2. 保存并关闭文件，运行以下命令使配置生效：

   source ~/.bashrc
   

3.3 MacOSX 环境配置

3.3.1 安装依赖

在 MacOSX 上安装 OpenNI 需要以下依赖：

1. Xcode：用于编译项目。
2. Python 2.6+/3.x：用于脚本执行。
3. LibUSB 1.0.x：用于 USB 设备支持。
4. FreeGLUT3：用于图形显示。
5. JDK 6.0：用于 Java 开发。

3.3.2 配置环境变量

1. 打开终端，编辑 ~/.bash_profile 文件，添加以下内容：

   export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.6.0_32.jdk/Contents/Home
   export PATH=$PATH:$JAVA_HOME/bin
   

2. 保存并关闭文件，运行以下命令使配置生效：

   source ~/.bash_profile
   

4. 项目安装方式

4.1 Windows 安装

1. 进入项目目录：

   cd OpenNI/Platform/Win32/CreateRedist
   

2. 运行以下命令生成安装包：

   RedistMaker.bat y 32 y
   

   如果是 64 位系统，请运行：

   RedistMaker.bat y 64 y
   

3. 生成的安装包位于 Platform/Win32/CreateRedist/FinalXX 目录下，运行安装包进行安装。

4.2 Linux 安装

1. 进入项目目录：

   cd OpenNI/Platform/Linux/CreateRedist
   

2. 运行以下命令生成安装包：

   ./RedistMaker
   

3. 进入生成的安装包目录：

   cd Platform/Linux/Redist
   

4. 运行以下命令进行安装：

   sudo ./install.sh
   

4.3 MacOSX 安装

1. 进入项目目录：

   cd OpenNI/Platform/MacOSX/CreateRedist
   

2. 运行以下命令生成安装包：

   ./RedistMaker
   

3. 进入生成的安装包目录：

   cd Platform/MacOSX/Redist
   

4. 运行以下命令进行安装：

   sudo ./install.sh
   

5. 项目处理脚本

OpenNI 项目提供了一些处理脚本，用于自动化编译和安装过程。以下是一些常用的脚本：

5.1 Windows

• RedistMaker.bat：用于生成安装包。
• BuildAll.bat：用于编译 USB 驱动。

5.2 Linux

• RedistMaker：用于生成安装包。
• install.sh：用于安装生成的安装包。

5.3 MacOSX

• RedistMaker：用于生成安装包。
• install.sh：用于安装生成的安装包。

通过这些脚本，你可以轻松地完成 OpenNI 项目的下载、编译和安装。