background image

4.2.2 Streaming depth data on Windows

The OpenNI SDK comes with a visualization tool: NiViewer. This tool is a generic data
visualizer of OpenNI compatible devices, including depth, RGB and IR cameras. Hence
some of the functionality/features might not be supported for the Terabee 3Dcam
80x60. In order to stream depth data on your PC, please launch NIViewer in the newly
created TerabeeDemo folder. NIViewer 2.2 (x64) is used for the purposes of this demo.

A window will now open on your PC with the depth data streamed real time in the top
left corner of your screen.

Optional: To activate infrared image provided by the camera, right click on the interface
and select Device > Streams > Color > On/Off.

Press “p” on your keyboard to activate pointer mode. An interactive color/distance
scale will now open on the bottom of your screen to represent the distance value of the
red pointer. This allows to target a specific pixel in the depth image and obtain its
distance measure in cm (displayed under “pointer value”).

To display cameras depth image in full screen press “1” on your keyboard.

Copyright

©

Terabee 2019

Terabee, 90 Rue Henri Fabre

01630, St Genis-Pouilly, France (next to CERN)

11/17

Summary of Contents for TB-3DCAM-8060-USB

Page 1: ...User Manual for Terabee 3Dcam 80x60 Technical support support teraranger com Sales and commercial support teraranger terabee com ...

Page 2: ...dows 9 4 2 1 SDK installation 10 4 2 2 Streaming depth data on Windows 11 4 3 Software setup for Linux Debian based 12 4 3 1 SDK installation 12 4 3 2 Streaming depth data on Linux 13 5 Switching between range modes 15 6 Start developing your application 16 6 1 OpenNI 2 C sample code 16 6 2 OpenNI 2 Python sample code 16 6 3 ROS package 16 7 Compliance 16 Copyright Terabee 2019 Terabee 90 Rue Henr...

Page 3: ... design Developed for indoor use the camera features two operating range modes For close range applications such as hand gesture recognition choose close range mode and capture depth data as close as 20 centimeters Switch to standard mode with its 4 meter range for volume measurement people and movement monitoring and robot navigation applications Figure 1 Terabee 3Dcam 80x60 Our compact ToF camer...

Page 4: ...ution 1 of distance Supply Voltage 5V DC USB powered Power Consumption max 4W Operating Temperature 0 C to 40 C Storage Temperature 20 C to 60 C Interfaces USB 2 0 Micro B Weight 83g Use Environment Indoors Dimensions 54 x 53 x 24mm Supporting OS Windows Linux Software Terabee SDK OpenNI 2 2 based C C Python ROS package Conformity CE RoHS Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St ...

Page 5: ...ee 3Dcam 80x60 camera USB 2 0 Micro B Y cable Software development kit available for download on the Terabee 3Dcam 80x60 product page Downloads section Figure 2 Product package contents Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St Genis Pouilly France next to CERN 5 17 ...

Page 6: ...two methods 1 front panel mount using the long M4 screw slots or 2 for a more discreet and integrated look use the back panel mounting shoulder in the front side of the camera The 3mm ledge offers users the possibility to mount the camera behind a surface e g panel ideally with a 3mm thickness See figures 4 and 5 for visualizations Please note that mounting components e g screws are not included i...

Page 7: ...Figure 4 Front panel mounting example Figure 5 Back panel mounting example Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St Genis Pouilly France next to CERN 7 17 ...

Page 8: ...n front of the camera It is better to avoid having other sources of continuous wave or modulated IR light close to the sensor Please consider that dust dirt and condensation can affect the sensor performance It is not advised to add an additional cover in front of the camera please note that this may reduce its performance Please consult figure 6 for correct camera position when mounting to a surf...

Page 9: ...camera Please note that using only one cable may affect camera performance Connect the Micro USB cable micro B side into the camera s USB port Plug the other two ends of Micro USB cable into your PC USB port You ve successfully completed the hardware setup Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St Genis Pouilly France next to CERN 9 17 ...

Page 10: ...contains OpenNI2 2 versions of the SDK for both x32 and x64 architectures For the purposes of this guide the OpenNI 2 2 x64 driver is used A window will open offering to proceed with SDK installation on your PC To proceed click Install During installation of the GUI you might receive a notification from Windows about an unknown application trying to start In the Windows protected your PC screen se...

Page 11: ...C with the depth data streamed real time in the top left corner of your screen Optional To activate infrared image provided by the camera right click on the interface and select Device Streams Color On Off Press p on your keyboard to activate pointer mode An interactive color distance scale will now open on the bottom of your screen to represent the distance value of the red pointer This allows to...

Page 12: ...on the Terabee website The package contains the OpenNI2 2 version of the SDK for both x64 and x86 architectures The Linux version of the SDK is compatible with most of the debian based distributions including Debian up to Stretch Ubuntu 16 04 18 04 Linux Mint Elementary OS 0 3 After the download is complete please extract the desired version that corresponds to your system architecture and save in...

Page 13: ...wer to function the following dependency is required Freeglut please use this command sudo apt get install freeglut3 After successful installation of mentioned dependencies you are now ready to go and start streaming depth data 4 3 2 Streaming depth data on Linux The OpenNI SDK comes with a visualization tool NiViewer This tool is a generic data visualizer of OpenNI compatible devices including de...

Page 14: ...d to activate pointer mode An interactive color distance scale will now open on the bottom of your screen to represent the distance value of the red pointer This allows to target a specific pixel in the depth image and obtain its distance measure in cm displayed under pointer value field Press 1 on your keyboard to display cameras depth image in full screen Press on your keyboard to display all sh...

Page 15: ...duleConfig json Linux usr etc TERABEE lib To edit the file in Windows please locate and run the text editor with elevated privileges this can be done with right click Run as administrator Next in the top bar menu select File Open or Ctrl O and import the ModuleConfig json file To edit the file in Linux please launch your text editor with elevated privileges with the sudo command As a final step to...

Page 16: ...les Each repository comes with a README file displayed on the front page of the repository explaining the different steps necessary to compile and run sample codes 6 2 OpenNI 2 Python sample code In order to allow fast code prototyping we also provide Python3 samples which are compatible with both Windows and Linux OS Please follow the link below to access the Python3 sample code repository on Git...

Page 17: ...Yes Yes Copyright Terabee 2019 Terabee 90 Rue Henri Fabre 01630 St Genis Pouilly France next to CERN 17 17 ...

Reviews: