simple_image_interface

This repository is simple image interface library for rust. By using this library you can change easily between images, videos, and camera input. This may be useful for debug like robotics vision area.

Document
- crates.io
- docs.rs
Supported image interface
- Camera
  - Web Camera (v4l2)
  - Realsense
  - Basler Camera
- Video
  - mp4
- Image
  - png
  - jpeg

Get started

Install

Install for rscam

sudo apt install libv4l-dev

Install for ffmpeg-next

sudo apt install -y clang libavcodec-dev libavformat-dev libavutil-dev pkg-config libavdevice-dev

Cargo.toml

"simple_image_interface" = "0.1.6"

Example code

Make interface
- In detail, see example code

use simple_image_interface::simple_image_interface::SimpleImageInterface;

fn main() {
    if args.len() < 2 || &args[1] == "pic" {
        interface = SimpleImageInterface::new_picture("./data/from_raw.png");
    } else if &args[1] == "video" {
        interface = SimpleImageInterface::new_video("./data/random_ball.mp4");
    } else {
        interface = SimpleImageInterface::new_camera("/dev/video0", 640, 360, 330);
        // width, height, fps
    }

    let mut frame_index = 0;
    loop {
        frame_index += 1;
        let input_image = interface.get_frame();
        if input_image.is_none() {
            break;
        }
        my_image_proc(&input_image.unwrap(), frame_index);
    }
}

Example code execution

# Run for picture
cargo run --release --example example pic

# Run for video
cargo run --release --example example video

Note

Simple_image_interface do not use trait object but lapper struct to improve execution speed

History

For new release
- Updated README
- Updated Rust edition
v0.1.6
- Updated dependencies and fix some warnings
- Refactored
v0.1.5
- Refactored
- [caution!!] Changed module architecture
v0.1.4
- Renamed repository name
v0.1.3
- Refactored
v0.1.2
- Reduced crate size
v0.1.1
- Fixed bug
v0.1.0
- Published simple_image_interface

Reference

rscam: Use for camera input
rust-ffmpeg: Use for video input

scepter914 / simple-image-interface-rs