cv-bridge 0.3.3

Rust implemenation of cv_bridge that converts between ROS image messages and OpenCV images
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

# cv-bridge-rs
[![Crates.io](https://img.shields.io/crates/v/cv-bridge.svg)](https://crates.io/crates/cv-bridge)
[![Docs.rs](https://docs.rs/cv-bridge/badge.svg)](https://docs.rs/cv-bridge)
<img src="https://img.shields.io/badge/built_with-Rust-dca282.svg">

Rust implemenation of cv_bridge that converts between ROS image messages and OpenCV images

> **Warning**: This package is still under active development. Use at your own risk.  

## Getting Started
### Adding cv_bridge to your project
Add the following to your Cargo.toml file under dependencies:
```toml
[dependencies]
cv-bridge = "0.3.3"
```
or you can use cargo to add the dependency:
```bash
cargo add cv_bridge
```

### Converting between ROS image messages and OpenCV images
``` rust
use opencv::highgui;
use cv_bridge::{
    CvImage,
    msgs::sensor_msgs::Image,
};

fn main() {
    // Initialize ros node
    rosrust::init("image_viewer");

    // Create image subscriber
    let _subscriber_raii = rosrust::subscribe(
        "/camera/image_raw",
        5,
        move |image: Image| {
            // Convert ros Image to opencv Mat
            let mut cv_image = CvImage::from_imgmsg(image).expect("failed to construct CvImage from ros Image"); 
            let mat = cv_image.as_cvmat().expect("failed to convert CvImage to Mat");

            // Display image
            let window = "view";
            highgui::named_window(window, highgui::WINDOW_AUTOSIZE).unwrap();
            highgui::imshow(window, &mat).unwrap();
            highgui::wait_key(1).unwrap();
        }
    );

    rosrust::spin();
}
```

## Features
- [x] Covert to and from sensor_msgs/Image and opencv::core::Mat
- [x] Support for various encodings defined by [sensor_msgs: image_encodings.h](http://docs.ros.org/en/jade/api/sensor_msgs/html/image__encodings_8h_source.html) crate
- [x] Support for 8-bit and 16-bit depth channels
- [ ] Support for 32-bit and 64-bit depth channels
- [x] Documentation and examples
- [ ] Covert to and from sensor_msgs/CompressedImage and opencv::core::Mat