unbundle 5.2.0

Unbundle media files - extract still frames, audio tracks, and subtitles from video files
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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

//! Configurable pixel format and resolution for frame extraction.
//!
//! Usage:
//!   cargo run --example pixel_formats -- <input_file>

use std::error::Error;

use unbundle::{ExtractOptions, FrameRange, MediaFile, PixelFormat};

fn main() -> Result<(), Box<dyn Error>> {
    let input_path = std::env::args()
        .nth(1)
        .unwrap_or_else(|| "input.mp4".to_string());

    let mut unbundler = MediaFile::open(&input_path)?;

    // ── RGB8 (default) ─────────────────────────────────────────────
    let config_rgb = ExtractOptions::new().with_pixel_format(PixelFormat::Rgb8);
    let frames = unbundler
        .video()
        .frames_with_options(FrameRange::Range(0, 0), &config_rgb)?;
    let frame = &frames[0];
    println!(
        "RGB8:  {}x{}, color={:?}",
        frame.width(),
        frame.height(),
        frame.color()
    );

    // ── RGBA8 ──────────────────────────────────────────────────────
    let config_rgba = ExtractOptions::new().with_pixel_format(PixelFormat::Rgba8);
    let frames = unbundler
        .video()
        .frames_with_options(FrameRange::Range(0, 0), &config_rgba)?;
    let frame = &frames[0];
    println!(
        "RGBA8: {}x{}, color={:?}",
        frame.width(),
        frame.height(),
        frame.color()
    );

    // ── Grayscale ──────────────────────────────────────────────────
    let config_gray = ExtractOptions::new().with_pixel_format(PixelFormat::Gray8);
    let frames = unbundler
        .video()
        .frames_with_options(FrameRange::Range(0, 0), &config_gray)?;
    let frame = &frames[0];
    println!(
        "Gray8: {}x{}, color={:?}",
        frame.width(),
        frame.height(),
        frame.color()
    );

    // ── Custom resolution ──────────────────────────────────────────
    let config_scaled = ExtractOptions::new().with_resolution(Some(320), None); // width=320, height auto
    let frames = unbundler
        .video()
        .frames_with_options(FrameRange::Range(0, 0), &config_scaled)?;
    let frame = &frames[0];
    println!(
        "Scaled (w=320, auto h): {}x{}",
        frame.width(),
        frame.height(),
    );

    let config_fixed = ExtractOptions::new()
        .with_resolution(Some(200), Some(100))
        .with_maintain_aspect_ratio(false);
    let frames = unbundler
        .video()
        .frames_with_options(FrameRange::Range(0, 0), &config_fixed)?;
    let frame = &frames[0];
    println!(
        "Fixed (200x100, no AR): {}x{}",
        frame.width(),
        frame.height(),
    );

    println!("\nDone!");
    Ok(())
}