pdfox 0.1.0

A pure-Rust PDF library — create, parse, and render PDF documents with zero C dependencies
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

/// PDF color spaces and values

#[derive(Debug, Clone, Copy, PartialEq)]
pub enum Color {
    /// RGB color (each channel 0.0–1.0)
    Rgb(f64, f64, f64),
    /// Grayscale (0.0 = black, 1.0 = white)
    Gray(f64),
    /// CMYK (each channel 0.0–1.0)
    Cmyk(f64, f64, f64, f64),
}

impl Color {
    // --- Common color constants ---
    pub const BLACK: Color = Color::Gray(0.0);
    pub const WHITE: Color = Color::Gray(1.0);
    pub const RED: Color = Color::Rgb(1.0, 0.0, 0.0);
    pub const GREEN: Color = Color::Rgb(0.0, 0.8, 0.0);
    pub const BLUE: Color = Color::Rgb(0.0, 0.0, 1.0);
    pub const DARK_BLUE: Color = Color::Rgb(0.0, 0.2, 0.6);
    pub const LIGHT_GRAY: Color = Color::Gray(0.85);
    pub const DARK_GRAY: Color = Color::Gray(0.3);

    /// Create from 8-bit RGB values (0–255)
    pub fn rgb_u8(r: u8, g: u8, b: u8) -> Self {
        Color::Rgb(r as f64 / 255.0, g as f64 / 255.0, b as f64 / 255.0)
    }

    /// Create from hex string like "#FF5733"
    pub fn from_hex(hex: &str) -> Option<Self> {
        let hex = hex.trim_start_matches('#');
        if hex.len() != 6 { return None; }
        let r = u8::from_str_radix(&hex[0..2], 16).ok()?;
        let g = u8::from_str_radix(&hex[2..4], 16).ok()?;
        let b = u8::from_str_radix(&hex[4..6], 16).ok()?;
        Some(Color::rgb_u8(r, g, b))
    }

    /// Emit the PDF fill color operator (`rg` or `g` or `k`)
    pub fn fill_op(&self) -> String {
        match self {
            Color::Rgb(r, g, b) => format!("{:.4} {:.4} {:.4} rg", r, g, b),
            Color::Gray(g) => format!("{:.4} g", g),
            Color::Cmyk(c, m, y, k) => format!("{:.4} {:.4} {:.4} {:.4} k", c, m, y, k),
        }
    }

    /// Emit the PDF stroke color operator (`RG` or `G` or `K`)
    pub fn stroke_op(&self) -> String {
        match self {
            Color::Rgb(r, g, b) => format!("{:.4} {:.4} {:.4} RG", r, g, b),
            Color::Gray(g) => format!("{:.4} G", g),
            Color::Cmyk(c, m, y, k) => format!("{:.4} {:.4} {:.4} {:.4} K", c, m, y, k),
        }
    }
}