vid2img/README.md

Vid2Img - Video to Image

Vid2img is a Rust crate that allows the use of a video file as a collection of frame images. This crate exposes a FileSource type that accepts a video file path and the desired size of the frames, then you can convert the instance into a iterator (.into_iter()). On every iteration you will receive a video frame data encoded as PNG.

use std::path::Path;
use vid2img::FileSource;

fn main() {
    let file_path = Path::new("video.mp4");

    let frame_source = FileSource::new(file_path, (200, 200)).unwrap();
    for frame in frame_source.into_iter() {
        if let Ok(Some(png_img_data)) = frame {
            // do something with the image data here ...
        }
    }
}

We use GStreamer for processing the video and capturing the frames. We make use of the official Rust wrapper to the GStreamer API.

Installation

As we use GStreamer, the installation steps for the GStreamer-rs crate must be followed.