Skip to content

Home

Jump to bottom
LIPS-HCI edited this page Aug 16, 2017 · 17 revisions

LIPSedge DL User Guide

Table of Contents

Introduction

LIPS is a leading company in Taiwan specialized in Time-of-Flight (ToF) and Stereo vision technology including middleware and hardware ranging from consumer to industrial products such as 3D Scanning, 3D Surveillance, Gaming, Smart TVs, Biometric Recognition, Robotics,…etc. We have two different model for different user. See more introduction in

This Wiki is for the user who

  • Already has a LIPS 3D camera, LIPSedge DL, on hand and want to run example program.
  • OR want to develop application with LIPS 3D depth camera.
  • The target platform is Linux
  • Develop application with OpenNI 1.5

If you don't have one and are interesting with it, please contact with us by e-mail [email protected]

Note

If you are the user of LIPSedge AT, please see the LIPSedge AT wiki page.

Hardware Setup

System Requirements and Environment Preparing

Supported Linux Distribution

  • Ubuntu 14.04 or later

Update and upgrade apt

Makesure all needed tool for the following installation can be found. You can run apt update and upgrade first.

sudo apt-get update
sudo apt-get upgrade

Install OpenCV

OpenCV is a famous computer vision library that LIPS SDK need.

  • Install required packages for building OpenCV 2.
sudo apt-get install cmake pkg-config libgtk2.0-dev

  • Download OpenCV 2.4.11 Linux version source code from here.

  • If your Linux distribution is Ubuntu 16.04 or newer, please download OpenCV 3.1.0

  • Extract and enter OpenCV root folder, for example

cd ~/opencv-2.4.11
  • Create a folder for cmake and change directory to it, for example,
mkdir build && cd build
  • Enter following command to generate cmake files
cmake -D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local ..
  • Once generation is done, enter make command to start the build
make
  • Then, install OpenCV to your system, administrator permission may required.
sudo make install

Install USB library

sudo apt-get install libusb-1.0-0

Install LIPS camera SDK

  • Download SDK from [LIPS SDK] (http://www.lips-hci.com/products/sdk/)

  • Extract the tarball of LIPS 3D depth camera SDK

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

sudo ./install.sh

Run Example Program

NiViewer

NiViewer.exe must be executed in terminal. And it is in the directory:

  • x86+OpenNI1.5 -> SDK_root/Samples/Bin/x86-Release/

  • x64+OpenNI1.5 -> SDK_root/Samples/Bin/x64-Release/

  • x86/x64+OpenNI2.2 -> SDK_root/Tools/

Move to LIPS SDK root folder and execute like that:

./Samples/Bin/x64-Release/NiViewer

Note

If it occurs error message as following while running NiViewer.exe: "error while loading shared libraries: libglut.so.3: cannot open shared object file: No such file or directory" please install library freeglut:

sudo apt-get install freeglut3

NiSimpleViewer

Develop for PC Application

Install Git

Install Git if you didn't install before.

sudo apt-get install git-core

Download sample code

Download the project into the SDK folder via Git clone form this repository.

git clone https://github.com/lips-hci/openni_linux.git LIPS_Sample

Build samples

NiSimpleViewer

cd LIPS_Sample/NiSimpleViewer
CXX=g++ make

Build your own application

You can base the samples we provided to develop your own application. What you need to know to edit Makefile are:

  • Append the source files' name to SRC
  • According the path related to SDK, modify the CPPFLAGS and LDFLAGS appropriately. i.e., you man need to add -I and -L to the correct location.
  • You can also use Clang to compile your application by change CXX from g++ to clang.
Clone this wiki locally