dbin 0.1.7

Regex-like utility for parsing and rendering binary data
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99

//! BMP file parser
use crate::Pattern;

#[derive(Debug)]
pub enum Key {
    FileSize,
    PixelOffset,
    DibHeaderSize,
    WidthInPixels,
    HeightInPixels,
}

impl From<Key> for i64 {
    fn from(k: Key) -> i64 {
        k as i64
    }
}

// TODO
// pub fn pattern() -> Pattern {
//     use crate::prelude::*;
//     file_header()
// }

pub fn file_header() -> Pattern {
    use crate::prelude::*;

    all_of((
        magic(&[0x42, 0x4D]),
        U32.store(Key::FileSize),
        U16, // reserved
        U16, // reserved
        U32.store(Key::PixelOffset),
    ))
}

pub fn dib_header() -> Pattern {
    use crate::prelude::*;

    all_of(vec![
        U32.store(Key::DibHeaderSize).label("dib-header-size"),
        U32.store(Key::WidthInPixels).label("width-in-pixels"),
        U32.store(Key::HeightInPixels).label("height-in-pixels"),
        U16.label("color-planes"),
        U16.label("bits-per-pixel"),
        U32.label("compression-method"),
        U32.label("raw-image-size"),
        U32.label("horizontal-resolution"),
        U32.label("vertical-resolution"),
        U32.label("colors-in-palette"),
        U32.label("ignored-important-color-count"),
    ])
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::Data;

    pub const BMP_BYTES: &'static [u8] = include_bytes!("TRU256.BMP");

    #[test]
    pub fn file_header_with_sample() {
        let pat = file_header();
        let data = pat.parse(BMP_BYTES).unwrap();
        assert_eq!(
            data,
            Data::fseq(vec![
                Data::fbytes(vec![0x42, 0x4D]),
                Data::Int(49206), // size of the file
                Data::Int(0),
                Data::Int(0),
                Data::Int(54),
            ])
        );
    }

    #[test]
    pub fn dib_header_with_sample() {
        let pat: Pattern = crate::prelude::all_of((file_header(), dib_header())).to_map(vec![
            Key::FileSize,
            Key::PixelOffset,
            Key::DibHeaderSize,
            Key::WidthInPixels,
            Key::HeightInPixels,
        ]);
        let data = pat.parse(BMP_BYTES).unwrap();
        assert_eq!(
            data,
            Data::fseq(vec![
                vec!["FileSize".into(), Data::Int(49206)].into(),
                vec!["PixelOffset".into(), Data::Int(54)].into(),
                vec!["DibHeaderSize".into(), Data::Int(40)].into(),
                vec!["WidthInPixels".into(), Data::Int(256)].into(),
                vec!["HeightInPixels".into(), Data::Int(64)].into(),
            ])
        );
    }
}