Release Notes for Intel® RealSense™ SDK Samples
Version v0.6.5
Intel® RealSense™ SDK Samples demonstrate how to develop applications using Intel RealSense cameras with functionality for interacting with objects, people, and mapping environments with SLAM.
New Features and Changes
Please refer to the readme file for the features included in the Sample Applications.
The following changes are introduced in this release:
- A few sample applications were added, please refer to the full list at the readme file: https://github.com/IntelRealSense/realsense_samples/blob/master/README.md
- Fixed rs_pt_tutorial_2 to remove printing the body direction, as this feature is not supported in this release.
Compatible Platforms
The samples were developed and tested on the following platform:
- Intel® Joule™ 570x Developer Kit, running Ubuntu 16.04 LTS (Desktop version). See installation instructions at https://software.intel.com/en-us/first-time-setup-for-joule for information how to update your Intel Joule module.
Software Requirements
- Intel RealSense Cross Platform API - v1.12.1
- Intel RealSense SDK 0.7.1
- Intel RealSense Person Tracking 0.5.10
- Intel RealSense Object Recognition 0.5.1
- Intel RealSense SLAM 2.0.4
- Apache log4cxx
- JPEG
- OpenCV 3.1
Hardware Requirements
- Intel RealSense ZR300 (DS4.1) Rev11 G sensor camera [DS4.1 Firmware 4.1 2.0.71.28, Adapter Board Firmware (CX3) 1.29, Motion Module Firmware 1.25.0.0](MM# 951805).
- Intel Joule 570x Developer Kit with expansion board (MM# 951308).
- Note: This middleware module was validated with one ZR300 camera connected to Joule.
Known Limitations
This release includes the following known limitations:
- The samples are neither designed nor intended to survive stress conditions.
- OR web tutorials use VGA resolution, there is a known Object library issue that VGA resolutions causes memory leak. In addition this lower resolution impacts the classifier accuracy.
- rs_slam_or_pt_tutorial_1 sample memory leak ( 2.5MB in 1 minute).
- pt tutorials: memory leak of 5-120MB after a few hours of run.
- slam_gui_tutorial_1: When zooming out the 2DMap, the center of interest is not on the camera’s current pose, but on the starting point.
- rs_pt_tutorial_4_web: "rid=??" After Person Registration, the RID in the GUI is not always updated (Reproduce rate 50%).
- rs_pt_tutorial_4_web - client was disconnected by server after 77 minutes with Error: Buffer is too large (Reproduce rate <20%).
- rs_pt_tutorial_2_gui: does not update the GUI table data when a person’s distance is larger than 0.5-0.8 meters, when using QVGA resolution. VGA works fine.
- The samples are not consistent when executed without a ZR300 camera connected.
- rs_or_tutorial_1,3,4_gui - stream start flickering and colors inverted to blue after 4-5 seconds, the reason is that not all frames are processed, so the re-drawn boxes looks flickering. The web sample doesn’t have this issue.
- rs_or_tutorial_3_gui -When pressing left mouse button stream freezes, can’t drag and set region.
- In multi-modality mode (such as sample slam_or_pt_tutorial) RGB Full High Definition is not supported due to (Joule) hardware limitation. This may impact the quality of features that require FHD such as Object classifier.
License
Copyright 2017 Intel Corporation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this project except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the LICENSE.
*Other names and brands may be claimed as the property of others