redguard-preservation 0.6.2

A CLI tool to preserve Redguard 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

/// Parsed 256-color palette from a Redguard COL file.
pub struct Palette {
    pub colors: [[u8; 3]; 256],
}

impl Palette {
    /// Parses palette bytes into a 256-entry RGB table.
    pub fn parse(data: &[u8]) -> crate::Result<Self> {
        if data.len() < 776 {
            return Err(crate::error::Error::Parse(format!(
                "COL file too small: {} bytes (expected 776)",
                data.len()
            )));
        }

        let mut colors = [[0u8; 3]; 256];
        for (i, color) in colors.iter_mut().enumerate() {
            let offset = 8 + i * 3;
            color[0] = data[offset];
            color[1] = data[offset + 1];
            color[2] = data[offset + 2];
        }

        Ok(Self { colors })
    }

    /// Returns a palette entry normalized to 0.0..=1.0 RGB values.
    #[must_use]
    pub fn get_rgb_f32(&self, index: u8) -> [f32; 3] {
        let c = self.colors[usize::from(index)];
        [
            f32::from(c[0]) / 255.0,
            f32::from(c[1]) / 255.0,
            f32::from(c[2]) / 255.0,
        ]
    }
}