/python_openni2_samples

This repository hosts python3 example scripts to use Terabee 3Dcam 80x60 with OpenNI2.

Primary LanguagePython

README

The purpose of this README is to provide example python scripts to get started with using Terabee 3Dcam 80x60 with OpenNI 2 framework. We provide here both Linux and Windows instructions.

For more information about the Terabee 3Dcam 80x60, please click here.

Requirements

In order to use those sample you will need the following requirements:

  • On linux, you will need:

    • To install the OpenNI 2 library

      sudo apt-get install libopenni2-dev

    • To install OpenCV

      Important note: The right OpenCV version is mandatory in order to use the SDK. We recommend following the OpenCV installation for linux available here.

    • To Install the Terabee OpenNI 2 SDK for Linux following these steps:
      • Download the SDK from the Downloads section of Terabee 3Dcam here

      • Extract the content of the archive (relevant to your system architecture and desired OpenNI version) in the directory of your choice

      • Enter the SDK folder and install the SDK with root permission

        sudo ./install.sh

  • On Windows, you will need:

    • To install the Terabee OpenNI2 SDK for Windows following these steps:

      • Download the SDK from the Downloads section of Terabee 3Dcam here

      • Once downloaded, install the SDK by running the file relevant to your system architecture and desired OpenNI version.

    • To copy the following files from "C:/Program Files/TERABEEToF" to "C:/Program Files/OpenNI2/Redist/OpenNI2/Drivers"

      • DeviceModules2.dll
      • RvcLib.dll
  • In both Linux and Windows, you will need Python 3 with the following python modules:

    • openni
    • numpy
    • platform
    • cv2
      • On Linux this module is automatically installed when installing OpenCV
      • On Windows you need the pip package named opencv_python

    Those modules can be installed using pip with the folowing command with elevated privileges:

    pip install <module name>

    Important Note: The Python architecture (64 or 32 bits) must match the architecture of the SDK.