DepthAI C++ Library

Core C++ library

Documentation

Documentation is available over at Luxonis DepthAI API

Disclaimer

DepthAI library doesn’t yet provide API stability guarantees. While we take care to properly deprecate old functions, some changes might still be breaking. We expect to provide API stability from version 3.0.0 onwards.

Dependencies

• CMake >= 3.10
• C/C++14 compiler
• [optional] OpenCV 4 (required if building examples)
• [optional] PCL (required for point cloud example)

To install OpenCV: MacOS: brew install opencv Linux: sudo apt install libopencv-dev

To install PCL: MacOS: brew install pcl Linux: sudo apt install libpcl-dev

ℹ️ On Linux distributions based on RPMs, you need to install perl-core required by OpenSSL dependency.

sudo yum install perl-core

Another option is to disable CURL support by setting DEPTHAI_ENABLE_CURL=OFF when configuring CMake.

cmake -S. -Bbuild -D'DEPTHAI_ENABLE_CURL=OFF'

Building

Make sure submodules are updated

git submodule update --init --recursive

Then configure and build

cmake -S. -Bbuild
cmake --build build

ℹ️ To speed up build times, use cmake --build build --parallel [num CPU cores] (CMake >= 3.12). For older versions use: Linux/macOS: cmake --build build -- -j[num CPU cores], MSVC: cmake --build build -- /MP[num CPU cores]

⚠️ If any CMake commands error with CMake Error: The source directory "" does not exist. replace argument -S with -H

Dynamic library

To build dynamic version of library configure with following option added

cmake -S. -Bbuild -D'BUILD_SHARED_LIBS=ON'
cmake --build build

Android

Android is supported to some extent but not actively pursued nor tested. PRs with any improvements are welcome.

Steps:

• Install Android NDK (for example via Android Studio).
• Set the NDK path:

export ANDROID_HOME=$HOME/.local/lib/Android
export PATH=$PATH:$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools
export NDK=$ANDROID_HOME/ndk/23.1.7779620/ # Check version

• Ensure a recent version of cmake (apt version is outdated, install snap install cmake –classic)
• Run cmake, set your ABI and Platform as needed:

cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmake -DANDROID_ABI=armeabi-v7a -DANDROID_PLATFORM=android-25
cmake --build build

Running examples

To build the examples configure with following option added

cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build

Then navigate to build/examples folder and run a preferred example

``` cd build/examples ./MobileNet/rgb_mobilenet

File truncated at 100 lines see the full file