Whats new? - Summary of changes in librealsense2, including RS400 support, API changes and new functionality.
| Platform | Build Status |
|---|---|
| Linux and OS X |  |
| Windows |
This project is a cross-platform library (Linux, Windows, Mac) for capturing data from the Intel® RealSense™ SR300 and RS4XX depth cameras.
Developer kits containing the necessary hardware to use this library are available for purchase at this link. This project is separate from the production software stack available in the Intel® RealSense™ SDK, namely that this library only encompasses camera capture functionality without additional computer vision algorithms.
- Installation Guides:
- Useful Links
- Documentation
- Functionality
- Compatible Devices
- Compatible Platforms
- Integrations
- License
- Intel RealSense Community - Official support, Q&A and other useful content
- Support Site - Contains content and web ticket capability for 1:1 interaction
- SDK Design Guidelines - Guidelines and tips for designing applications using RealSense cameras
- R200 Datasheet - In-depth information about the R200 camera hardware.
- Intel RealSense Stereoscopic Depth Cameras - A technical paper describing the R200, LR200, SR300 and RS400 in detail. Includes theoretical background, performance expectations, post-processing suggestions, etc.
A comprehensive suite of sample and tutorial applications are provided in the /examples subdirectory. For new users, it is best to review the tutorial series of apps which are designed to progressively introduce API features.
- C API - With doxygen-style API comments
- To build documentation locally from sources, on Ubuntu run the following commands:
sudo apt-get install doxygendoxygen doc/doxygen/doxyfile
- C API - With doxygen-style API comments
- Frame Management - Frame Memory Management, Threading Model and Syncronization
- Frame Metadata - support for frame-metadata attributes
- Python Bindings - official python bindings for librealsense
- What's New? - changes in librealsense2
- Getting Started - Getting started with OpenCV
- Troubleshooting - Useful tips when debugging issues related to the camera
- Error Handling - Documents librealsense error handling policy
- Device specific topics:
- RS400 and External Devices - Notes on integrating RS400 with external devices
- RS400 Advanced Mode - Overview of the Advanced Mode APIs
- Native streams: depth, color, infrared and fisheye.
- Synthetic streams: rectified images, depth aligned to color and vice versa, etc.
- Intrinsic/extrinsic calibration information.
- Majority of hardware-specific functionality for individual camera generations (UVC XU controls).
- Multi-camera capture across heterogeneous camera architectures
- Motion-tracking sensors acquisition
- RealSense SR300
- RealSense RS400/410/430/450
The library is written in standards-conforming C++11 and relies only on the C89 ABI for its public interface. It is developed and tested on the following platforms:
- Ubuntu 14/16 LTS (GCC 4.9 toolchain)
- Windows 10 (Visual Studio 2015 Update 3)
- Mac OS X 10.7+ (Clang toolchain) Temporarily unavailable
- Ostro
Developer kits containing the necessary hardware to use this library are available for purchase at this link. In addition, several consumer tablets and laptops with integrated cameras may also function, such as the HP Spectre x2 with R200.
Developer kits require USB 3.0. RealSense™ cameras do not provide backwards compatibility with USB 2.0. Not all USB host chipsets are compatible with this library, although it has been validated with recent generations of the Intel Host Controller chipset. An exhaustive list of incompatible hardware is not presently provided. On x86, a Haswell or newer architecture is recommended.
For small-form factor usages, this library has been demonstrated to work on the following boards:
The library has been integrated with a number of third-party components and operating systems. While most of these projects are not directly supported by the team, they are useful resources for users of this library.
- Robotic Operating System (Intel Supported; R200, F200, SR300 all supported)
- Yocto / WindRiver Linux
- Arch Linux
Additional language bindings (experimental, community maintained):
Copyright 2016 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.