#camera-image #camera #webcam #video #image

simple_image_interface

Simple image interface with pictures, video, and camera

8 releases

0.1.7 Mar 18, 2025
0.1.6 Jan 14, 2024
0.1.5 May 6, 2022
0.1.4 Apr 24, 2022
0.1.2 Sep 6, 2021

#244 in Images

Download history 58/week @ 2024-12-04 48/week @ 2024-12-11 4/week @ 2024-12-25 15/week @ 2025-01-01 4/week @ 2025-02-12 58/week @ 2025-03-12 57/week @ 2025-03-19

115 downloads per month

MIT license

17KB
186 lines

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
  • 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

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
  • v0.1.5
    • Refactored
    • [caution!!] Changed module architecture
  • v0.1.4
    • Renamed repository name
  • v0.1.3
    • Refactored
  • v0.1.2
  • v0.1.1
    • Fixed bug
  • v0.1.0
    • Published simple_image_interface

Reference

Dependencies

~4–13MB
~167K SLoC