cmx 0.2.0

Rust Spectral Color Management Library
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

// SPDX-License-Identifier: Apache-2.0 OR MIT
// Copyright (c) 2021-2026, Harbers Bik LLC

use std::{
    fmt::{Debug, Display},
    str::FromStr,
};

use crate::error::ParseError;

mod cmm;
pub use cmm::Cmm;

mod device_class;
pub use device_class::DeviceClass;

//pub(crate) mod tag_signature;

mod colorspace;
pub use colorspace::ColorSpace;

pub mod technology;
//pub mod type_signature;

mod pcs;
pub use pcs::Pcs;

mod platform;
pub use platform::Platform;

#[derive(Clone, Copy, PartialEq, Eq, Hash, Default)]
pub struct Signature(pub u32);

/// Represents an ICC profile signature, which is a 4-byte value that can be interpreted as an ASCII string.
impl Display for Signature {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        format_u32_as_string(f, self.0)
    }
}

/// Represents an ICC profile signature, which is a 4-byte value that can be interpreted as an ASCII string.
impl Debug for Signature {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        format_u32_as_string(f, self.0)
    }
}

fn format_u32_as_string(f: &mut std::fmt::Formatter<'_>, value: u32) -> std::fmt::Result {
    use crate::is_printable_ascii_bytes;
    let bytes = value.to_be_bytes();
    if is_printable_ascii_bytes(&bytes) {
        let s = String::from_utf8_lossy(&bytes);
        write!(f, "{s}")
    } else {
        write!(f, "{value:08X}")
    }
}

/// Parses a 4-character string into a `Signature`.
/// If the string is not exactly 4 characters long, it returns an error.
/// If the string is valid, it converts it to a `u32` by interpreting the bytes in big-endian order.
/// Example:
/// ```rust
/// use cmx::signatures::Signature;
/// // using parse
/// let tag: Signature = "abcd".parse().unwrap();
/// assert_eq!(tag.0, 0x61626364); // 'abcd' in big-endian  
///
/// // Smaller strings are padded with spaces:
/// let tag: Signature = "XYZ".parse().unwrap();
/// assert_eq!(tag.0, 0x58595A20); // 'XYZ ' in big-endian  
///
/// // using from_str directly:
/// use std::str::FromStr;
/// let tag = Signature::from_str("mntr").unwrap();
/// assert_eq!(tag.0, 0x6D6E7472); // 'mntr' in big-endian
/// ```    
impl FromStr for Signature {
    type Err = crate::error::Error;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        if s.len() > 4 || s.is_empty() {
            return Err(ParseError::new(format!(
                "Signature must be between 1 and 4 characters - got: {s}"
            ))
            .into());
        }
        // Pad the string to 4 characters with spaces if necessary
        let padded = format!("{s: <4}"); // Pad with spaces to ensure it's 4 characters
        let bytes = padded.as_bytes();
        let value = u32::from_be_bytes([bytes[0], bytes[1], bytes[2], bytes[3]]);
        Ok(Signature(value))
    }
}

impl From<Signature> for u32 {
    fn from(sig: Signature) -> Self {
        sig.0
    }
}

impl From<u32> for Signature {
    fn from(value: u32) -> Self {
        Signature(value)
    }
}

impl From<Signature> for [u8; 4] {
    fn from(sig: Signature) -> Self {
        sig.0.to_be_bytes()
    }
}