raves_metadata 0.0.4

A library to parse metadata from media 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

use crate::providers::shared::bmff::{BoxHeader, BoxType};

/// Finds all boxes with any of the given types.
pub fn _find_boxes<'borrow, 'types, 'input: 'borrow>(
    input: &'borrow mut &'input [u8],
    types: &'types [BoxType],
) -> Vec<(BoxHeader, &'input [u8])> {
    // here's where we'll store the boxes we find
    let mut boxes: Vec<(BoxHeader, &[u8])> = Vec::new();

    // loop until the input is empty, or we experience an error w/ grabbing
    // some kind of data
    while !input.is_empty() {
        // grab its header
        let Ok(box_header) = BoxHeader::new(input)
            .inspect_err(|e| log::warn!("Failed to construct box header from input. err: {e}"))
        else {
            break;
        };

        // if the list of types has that box's ty, stick it in the list
        if types.contains(&box_header.box_type) {
            // grab its data
            let Some(box_payload) = box_header.payload(input) else {
                break;
            };

            // add to list
            boxes.push((box_header, box_payload));
        } else {
            // if the type isn't there, skip it for the next payload
            let Some(()) = box_header.eat_payload(input) else {
                break;
            };
        }
    }

    boxes
}