Ubuntu

Method 1: Docker

Pull the latest docker image

$ docker pull hedgehao/lips-openni2-sdk

Run with following command to bridge USB and GUI between docker and host.

$ docker run -it --privileged -v /dev/bus/usb/:/dev/bus/usb --device=/dev/dri --group-add video -v /tmp/.X11-unix/:/tmp/.X11-unix -e "DISPLAY=$DISPLAY" hedgehao/lips-openni2-sdk

Method 2: Install Manually

1. Download LIPSedge OpenNI2 SDK from the release page

2. Extract files from the downloaded SDK file.

3. Install dependencies

$ sudo apt-get install libopenni2-0 libopenni2-dev

4. Build OpenCV3.4 by executing opencv3.4.1_installation_in_linux.sh in the SDK folder.

$ sudo ./LIPS-Linux-x64-OpenNI2.2/opencv3.4.1_installation_in_linux.sh

5. Execute install.sh in SDK folder.

$ sudo ./LIPS-Linux-x64-OpenNI2.2/install.sh

6. Accessing camera video stream through NiViewer. NiViewer provide video streaming and some basic configuration. Right click in NiViewer to open configuration menu.

./LIPS-Linux-x64-OpenNI2.2/Tools/NiViewer

7. LIPSedge provide much more specific configuration. We will discuss about it in laster articles.

8. There are some handy tools to test your camera.

• Ni2CameraMatrix: Access camera's parameters.

• Ni2PointCloud: Camera point cloud view.

• Ni2PowerTest: LIPS SDK supports a Standby Mode (Low Power Mode) for which users can stop live streaming temporarily and resume live streaming at any time by sending a status code through Ni2PowerTest.