spf 0.8.0-alpha.0

.spf (Simple Pixel Font) file parser
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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

/*
 * Copyright 2025 SimplePixelFont
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

pub(crate) use super::*;
use crate::vec;

impl<'a, T: TagWriter> DeserializeEngine<'a, ByteReaderImpl<'a>, T> {
    #[cfg(feature = "tagging")]
    pub fn from_data_and_tags(data: &'a [u8], tags: T) -> Self {
        Self {
            bytes: byte::ByteReaderImpl::from(data),
            layout: Layout::default(),
            #[cfg(feature = "tagging")]
            tags,
            #[cfg(feature = "tagging")]
            tagging_data: TaggingData::default(),
            _phantom: PhantomData,
            _phantom2: &PhantomData,
        }
    }
    #[cfg(feature = "tagging")]
    pub fn tagging_engine(&mut self, tags: T) {
        self.tags = tags;
    }
}

impl<'a> DeserializeEngine<'a, ByteReaderImpl<'a>> {
    pub fn from_data(data: &'a [u8]) -> Self {
        Self {
            bytes: byte::ByteReaderImpl::from(data),
            layout: Layout::default(),
            #[cfg(feature = "tagging")]
            tags: TagWriterNoOp,
            #[cfg(feature = "tagging")]
            tagging_data: TaggingData::default(),
            _phantom: PhantomData,
            _phantom2: &PhantomData,
        }
    }
}

impl<'a, R: ByteReader> DeserializeEngine<'a, R> {
    pub fn from_reader(reader: R) -> Self {
        Self {
            bytes: reader,
            layout: Layout::default(),
            #[cfg(feature = "tagging")]
            tags: TagWriterNoOp,
            #[cfg(feature = "tagging")]
            tagging_data: TaggingData::default(),
            _phantom: PhantomData,
            _phantom2: &PhantomData,
        }
    }
}

pub(crate) fn next_signature<R: ByteReader, T: TagWriter>(
    engine: &mut DeserializeEngine<R, T>,
) -> Result<(), DeserializeError> {
    if engine.bytes.index() + 4 > engine.bytes.len() {
        return Err(DeserializeError::UnexpectedEndOfFile);
    }
    #[cfg(feature = "tagging")]
    let start = engine.bytes.byte_index();

    for byte in [127, 102, 115, 70].iter() {
        if engine.bytes.next() != *byte {
            return Err(DeserializeError::InvalidSignature);
        }
    }

    #[cfg(feature = "tagging")]
    engine.tags.tag_span(
        TagKind::Signature,
        Span::new(start, engine.bytes.byte_index()),
    );

    Ok(())
}

pub(crate) fn next_version<R: ByteReader, T: TagWriter>(
    engine: &mut DeserializeEngine<R, T>,
) -> Result<(), DeserializeError> {
    let version = engine.bytes.next();
    let version = Version::try_from(version)?;
    #[cfg(feature = "tagging")]
    engine.tags.tag_byte(
        TagKind::Version { value: version },
        engine.bytes.byte_index(),
    );

    engine.layout.version = version;
    Ok(())
}

pub(crate) fn next_header<R: ByteReader, T: TagWriter>(
    engine: &mut DeserializeEngine<R, T>,
) -> Result<(), DeserializeError> {
    let file_properties = engine.bytes.next();

    engine.layout.compact = byte::get_bit(file_properties, 0);

    #[cfg(feature = "tagging")]
    engine.tags.tag_bitflag(
        TagKind::Header,
        vec![TagKind::CompactFlag {
            enabled: engine.layout.compact,
        }],
        engine.bytes.byte_index(),
    );

    Ok(())
}