Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 3.0.2 |
License | MIT |
Build type | AMENT_CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | kilted |
Last Updated | 2025-08-01 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
DepthAI Library
DepthAI library for interfacing with Luxonis DepthAI hardware. It’s written in C++ and offers Python bindings out of the box.
Important — You’re viewing the
v3.x.y
release-candidate branch.
- For production projects that still rely on v2, check out the
v2_stable
branch.- Need to migrate? Follow the step-by-step v2 → v3 Porting Guide.
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.
Examples
Examples for both C++ and Python are available in the examples
folder. To see how to build and run them see README.md for more information.
To build the examples in C++ configure with the following option added:
cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build
Dependencies
- CMake >= 3.20
- C/C++17 compiler
- [Linux] libudev >= 1.0.0
- [optional] OpenCV 4 (required if building examples and for record and replay)
- [optional] PCL (required for point cloud example)
To install libudev on Debian based systems (Ubuntu, etc.): sudo apt install libudev-dev
To install OpenCV:
MacOS: brew install opencv
Linux: sudo apt install libopencv-dev
Windows: choco install opencv
To install PCL:
MacOS: brew install pcl
Linux: sudo apt install libpcl-dev
Using Python bindings
Installing the latest pre-released version of the library can be done with:
python3 -m pip install --extra-index-url https://artifacts.luxonis.com/artifactory/luxonis-python-release-local/ --pre -U depthai
or by running:
python3 examples/python/install_requirements.py on the branch you want to install
For more specific information about Python bindings, see Python README.
Building
Make sure submodules are updated
git submodule update --init --recursive
Then configure and build
cmake -S . -B build
cmake --build build --parallel [num CPU cores]
On Windows it’s often required to specify the location of the OpenCV installation. In case you used chocolatey to install OpenCV, you can use the following command:
cmake -S . -B build -DOpenCV_DIR=C:/tools/opencv/build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release --parallel [num CPU cores]
ℹ️ To speed up build times, use
cmake --build build --parallel [num CPU cores]
.
Dynamic library
To build a dynamic version of the library configure with the following option added
cmake -S . -B build -D'BUILD_SHARED_LIBS=ON'
cmake --build build --parallel [num CPU cores]
Installation and Integration
Installation of the DepthAI library is currently only available as a dynamic library. To install the library, use the following command:
cmake -S . -B build -D'BUILD_SHARED_LIBS=ON' -D'CMAKE_INSTALL_PREFIX=[path/to/install/dir]'
cmake --build build --target install --parallel [num CPU cores]
Verifying installation
To verify the installation works as expected, you can test if the integration project compiles and runs. This is done by running the following command:
File truncated at 100 lines see the full file
Changelog for package depthai
3.0.0 (2025-07-31)
# DepthAI v3.0.0 release candidate is out :tada: We’re proud to announce a new major revision of the DepthAI library is now in release candidate stage and ready to be used.
## Simplified API We've simplified and unified the API to lower the barrier to entry and make development more intuitive. Core tasks like setting up camera streams, running neural networks, and building spatial pipelines are now streamlined with fewer lines of code.
We have removed many deprecated functions and simplified node constructors, creating a cleaner, more consistent, and easier-to-use library for newcomers as well as more experienced users.
## Refreshed nodes We've revisited some of the most fundamental nodes to make them more powerful and flexible.
-
Camera
- The [ColorCamera]{.title-ref} and [MonoCamera]{.title-ref} nodes have been replaced by a single, generic [Camera]{.title-ref} node that works across all platforms.
- It supports a variable number of outputs, where each can have an
independent:
- Type (NV12, RGB interleaved or planar, ...)
- Size
- FPS
- [Python](https://github.com/luxonis/depthai-core/tree/main/examples/python/Camera) and [C++](https://github.com/luxonis/depthai-core/tree/main/examples/cpp/Camera) examples.
-
ImageManip
- The [ImageManip]{.title-ref} node has been revised for more robust and predictable behavior (we now track the order of operations to make the output fully deterministic).
- It now supports relative crops and can be used as a host-side node in addition to running on RVC2 and RVC4 devices.
- [Python](https://github.com/luxonis/depthai-core/tree/main/examples/python/ImageManip/) and [C++](https://github.com/luxonis/depthai-core/tree/main/examples/cpp/ImageManip/) examples.
## New nodes DepthAI v3 introduces new high-level nodes to simplify working with high level concepts (RGBD pointclouds, SLAM)
-
- RGBD: This node makes it easy to work with synchronized and aligned color and depth data. It features an "autocreate" mode that automatically constructs the required input pipeline, delivering a ready-to-use RGBD message or a colored point cloud.
-
- VSLAM: We've added SLAM and VIO as host nodes, enabling advanced spatial AI applications. These are currently available on Linux and macOS and are in early preview.
## Support for host nodes DepthAI v3 now supports custom host nodes, allowing you to run parts of your pipeline on the host with custom logic while keeping the rest on-device. Whether you need to run complex post-processing in Python or integrate with external libraries, it’s all part of the same unified pipeline. See the [Python](https://github.com/luxonis/depthai-core/tree/main/examples/python/HostNodes) and [C++](https://github.com/luxonis/depthai-core/tree/main/examples/cpp/HostNodes) examples.
## Visualizer Debugging and development just got easier with our new integrated visualizer. You can now visualize camera streams, neural network outputs, and detection overlays in real-time. The visualizer is also able to display the pipeline graph, making it a great tool for understanding and debugging your application's data flow. See the [Python](https://github.com/luxonis/depthai-core/tree/main/examples/python/Visualizer) and [C++](https://github.com/luxonis/depthai-core/tree/main/examples/cpp/Visualizer) examples.
## A lot of nice to have features: * Auto reconnect: If a device has a flaky connection and crashes, the library will now automatically try to reconnect instead of exiting, making your applications more resilient. * Unified Coordinate System: We’ve standardized all coordinate systems. Camera, IMU, and spatial data now use the RDF (Right-Down-Forward) convention, eliminating inconsistencies when fusing data from multiple sensors. * Native Model Zoo Support: Take advantage of the new Luxonis Model Zoo, which integrates natively into v3. Loading and deploying models is now seamless, with no boilerplate required. * Remapping points between different frames: We've much improved the developer experience where detections from one image in the pipeline (on the input of the NN for example) need to be remapped to another image in the pipeline, that's still in full resolution by internally tracking all of the image operations that are made to streams. See
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Name | Deps |
---|---|
depthai-ros | |
depthai_bridge | |
depthai_examples |
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file
Dependant Packages
Launch files
Messages
Services
Plugins
Recent questions tagged depthai at Robotics Stack Exchange
Package Summary
Tags | No category tags. |
Version | 2.30.0 |
License | MIT |
Build type | CMAKE |
Use | RECOMMENDED |
Repository Summary
Checkout URI | https://github.com/luxonis/depthai-core.git |
VCS Type | git |
VCS Version | ros-release |
Last Updated | 2025-03-20 |
Dev Status | DEVELOPED |
Released | RELEASED |
Tags | No category tags. |
Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Package Description
Additional Links
Maintainers
- Adam Serafin
Authors
- Martin Peterlin
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
Changelog for package depthai
2.30.0 (2025-03-18)
- Features
- Add RVC4 discovery to point users to v3 version of the library for OAK4 devices
- Add support for a new VCM enabling autofocus on new IMX378 CCMs
- Bug fixes
- Fix an edge case in ImageManip to make https://github.com/geaxgx/depthai_hand_tracker run in edge mode again
- Fix an edge case when sending MessageGroup from host to device and using more than 4 messages
2.29.0 (2024-11-26)
-
Features
-
Add the ability to change the calibration on the device in runtime with the new [dai::Device.setCalibration()]{.title-ref} method and to retrieve it with the [dai::Device.getCalibration()]{.title-ref}.
-
- New [StereoDepth]{.title-ref} presets:
-
- [DEFAULT]{.title-ref}
- [FACE]{.title-ref}
- [HIGH_DETAIL]{.title-ref}
- [ROBOTICS]{.title-ref}
-
- Multiple camera improvements (more details in https://github.com/luxonis/depthai-core/pull/972):
-
- Expose more downsampling modes when picking a lower than native resolutions
- Expose more binning modes when binning is picked on IMX582/586 ([sum]{.title-ref} and [avg]{.title-ref})
- HDR on IMX582/586
- Option to bypass 3A for having manual expose/ISO take effect faster
- Initial support for new Sony 4K Starvis sensors: IMX678 and IMX715
- Option to set the main camera to drive auto-exposure and auto-white-balance in multi-camera configurations
-
- Improved StereoDepth filtering and an option to use a set a custom order of filters
-
- Disparity is first scaled to 13 bit before going through filtering, which results in filters being more effective.
-
Misc
-
Remove false reports on crashes that happened on device destruction
- Add [getWidth()]{.title-ref} and [getHeight()]{.title-ref} API to [EncodedFrame]{.title-ref}
2.28.0 (2024-08-21)
Features * Changed the automatic crashdump collection to always on unless DEPTHAI_DISABLE_CRASHDUMP_COLLECTION is set. * Added DEPTHAI_ENABLE_ANALYTICS_COLLECTION environment varialbe - when set, analytic data (pipeline schema) is sent to Luxonis which will be used to further improve the library. * Undistort both outputs of ToF by default. * Improved 3A syncing on OAK-D-LR * Added support for YoloV10 * Bug fixes * Fix Camera node to correctly allocate resources for undistortion * Fix StereoDepth node when decimation filter and depth alignment are used * Fix host timestamps of thermal frames to be synced * Misc * Updated XLink to support clangd and shared libraries on Windows: * luxonis/XLink#81 * luxonis/XLink#84 * Remove a custom assert to always produce a crash dump to improve the UX with the automatic crashdump collection * Increased watchdog priority on device side to improve stability during high load
2.26.1 (2024-06-12)
- Fix building shared libs (ROS only)
2.26.0 (2024-05-27)
- PointCloud node along with the PointCloudData message
- On device pointcloud generation
- Native conversion to PCL message type - similar to getCvFrame()
- Support for the OAK Thermal
- New setManualFocusRaw() API with more granularity for setting manual focus position
- New getStereoPairs() and getAvailableStereoPairs() API to allow more device agnostic programming
- Add the intensity output to the ToF node
- Add the crop sensor configs in getConnectedCameraFeatures() now contain how each of the resolutions is cropped from the native sensor resolution
- Added DeviceBootloader::getFlashedVersion to retrieve the bootloader version that is flashed on device.
- ImageAlign node
File truncated at 100 lines see the full file