Skip to content

moverseai/OrbbecSDK

 
 

Repository files navigation

Orbbec SDK

stability version

The Orbbec 3D camera product software development kit,fully supports UVC, realizes driver-free plug-and-play, provides low-level and high-level simple and easy-to-use APIs, and helps developers use it flexibly in different scenarios.

Besides, this SDK is compatible with Orbbec's original OpenNI protocol devices through built-in code, so that developers can completely migrate to Orbbec SDK to support Orbbec's new generation of products and old products with one set of code.

What is included in the repository

  • library : Orbbec SDK core library files and C/C++ header files.
  • examples : C/C++ samples project source code.
  • doc : API reference documentation and sample documentation.
  • driver : Windows device driver for OpenNI protocol devices (Dabai, Dabai DCW, Dabai DW, Astra mini Pro, Astra Pro Plus, A1 Pro, Gemini E, Gemini E Lite, Gemini). While modules that use the standard UVC protocol do not need to install drivers.
  • scripts : Linux udev rules for resolving permission issues and Windows timestamp registration scripts for resolving timestamp and metadata issues.

Platform support

Windows 10, Ubuntu 16.04/18.04/20.04, ARM Linux 32/64 bit (Raspberry Pi 4B, Jetson Nano, A311D, AGX orin, orin NX, orin nano etc.)

Windows 11, Ubuntu 22.04 and other Linux platforms may also be supported, but have not been fully tested.

Product support

products list firmware version
Femto Bolt 1.0.6 (unsupported ARM32)
Femto Mega 1.1.7 (support window10、Linux(ubuntu20.04、ubuntu22.04)、Arm64(AGX orin, orin NX, orin nano))
Gemini 2 XL Obox: V1.2.5 VL:1.4.54
Astra 2 2.8.20
Gemini 2 L 1.4.32
Gemini 2 1.4.60 /1.4.76
Astra+ 1.0.22/1.0.21/1.0.20/1.0.19
Femto 1.6.7
Femto W 1.1.8
DaBai 2436
DaBai DCW 2460
DaBai DW 2606
Astra Mini Pro 1007
Gemini E 3460
Gemini E Lite 3606
Gemini 3.0.18
Astra Mini S Pro 1.0.05

Getting started

Get source code

git clone https://github.com/orbbec/OrbbecSDK.git

Environment setup

Use Orbbec SDK in your CMake project

Find and link Orbbec SDK in your CMakeLists.txt file like this:

cmake_minimum_required(VERSION 3.1.15)
project(OrbbecSDKTest)

add_executable(${PROJECT_NAME} main.cpp)

# find Orbbec SDK
set(OrbbecSDK_DIR "/your/path/to/OrbbecSDK")
find_package(OrbbecSDK REQUIRED)

# link Orbbec SDK
target_link_libraries(${PROJECT_NAME} OrbbecSDK::OrbbecSDK)

Examples

The sample code is located in the ./examples directory and can be built using CMake.

Build

cd OrbbecSDK && mkdir build && cd build &&
cmake .. && cmake --build . --config Release

Run example

Connect Orbbec camera to you machine, and then run this:

cd OrbbecSDK/build/bin # build output dir
./OBMultiStream  # OBMultiStream.exe on Windows

OrbbecViewer

OrbbecViewer is a useful tool based on Orbbec SDK,that can be used to view the data stream from the Orbbec camera and control the camera. OrbbecViewer

Supported platforms: Windows x64, Linux x64&ARM64

Download link: Releases

Documents

Related links

About

Orbbec SDK C/C++ base core lib

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 62.2%
  • C++ 30.4%
  • CMake 4.1%
  • PowerShell 3.1%
  • Shell 0.2%