The project provides high-level bindings to librealsense2 library as well as low-level FFI interface. It supports asynchronous API and integration with image and nalgebra types.
Visit RealSense official repository (link) and install librealsense 2.36.0 on your system.
To add this crate to your project,
[dependencies]
realsense-rust = "0.4"If you have troubles compiling this project, perhaps your system is using older librealsense. Try to update the library. Otherwise you can enable buildtime-bindgen cargo feature to generate Rust bindings during build time.
[dependencies]
realsense-rust = { version = "0.4", features = ["buildtime-bindgen"] }- with-nalgebra (default): Enable nalgebra support.
- with-image (default): Enable image support.
- buildtime-bindgen: Generate Rust bindings during build time.
- device-test: Enable tests that requires connections to RealSense devices.
Please visit the examples directory to see the example usages.
The project uses bindgen to generate bindings from pure C API.
We suggest the official librealsense2 documentation to check out the actual usage of low-level API.
Also, you can choose to browse the generated document for realsense-sys.
cd $repo/realsense-sys
cargo doc --openThe realsense-rust crate is basically a wrapper upon the realsense-sys crate. We suggest to take C++ API as reference and rewrite them in rusty style.
Apache 2.0. See LICENSE file.