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
84
85

//! Keyframe and Group of Pictures analysis integration tests.

use std::path::Path;

use unbundle::MediaFile;

fn sample_video_path() -> &'static str {
    "tests/fixtures/sample_video.mp4"
}

#[test]
fn keyframes_returns_list() {
    let path = sample_video_path();
    if !Path::new(path).exists() {
        return;
    }

    let mut unbundler = MediaFile::open(path).expect("open");
    let keyframes = unbundler.video().keyframes().expect("keyframes");

    assert!(!keyframes.is_empty(), "expected at least one keyframe");

    // First keyframe should be near the start.
    assert_eq!(
        keyframes[0].packet_number, 0,
        "first keyframe should be packet 0"
    );
}

#[test]
fn group_of_pictures_analysis() {
    let path = sample_video_path();
    if !Path::new(path).exists() {
        return;
    }

    let mut unbundler = MediaFile::open(path).expect("open");
    let group_of_pictures_info = unbundler
        .video()
        .analyze_group_of_pictures()
        .expect("group of pictures analysis");

    assert!(
        group_of_pictures_info.total_video_packets > 0,
        "expected at least some video packets"
    );
    assert!(
        !group_of_pictures_info.keyframes.is_empty(),
        "expected at least one keyframe in Group of Pictures info"
    );
    assert!(
        group_of_pictures_info.average_group_of_pictures_size > 0.0,
        "average Group of Pictures size should be positive"
    );
    assert!(
        group_of_pictures_info.min_group_of_pictures_size > 0,
        "minimum Group of Pictures size should be positive"
    );
    assert!(
        group_of_pictures_info.max_group_of_pictures_size
            >= group_of_pictures_info.min_group_of_pictures_size,
        "max >= min"
    );
}

#[test]
fn keyframes_have_timestamps() {
    let path = sample_video_path();
    if !Path::new(path).exists() {
        return;
    }

    let mut unbundler = MediaFile::open(path).expect("open");
    let keyframes = unbundler.video().keyframes().expect("keyframes");

    for kf in &keyframes {
        // Timestamps should be non-negative when present.
        if let Some(ts) = kf.timestamp {
            assert!(
                ts.as_secs_f64() >= 0.0,
                "keyframe timestamps should be non-negative"
            );
        }
    }
}