pdfium_render/pdf/
color.rs

1//! Defines the [PdfColor] struct, a 32-bit RGB color value with an optional alpha channel.
2
3use crate::bindgen::FPDF_DWORD;
4use crate::error::PdfiumError;
5
6/// A 32-bit RGB color value with an optional alpha channel.
7///
8/// A variety of non-transparent colors are available as const values on this struct.
9///
10/// Note that when used as a form field highlight color, a solid color with no opacity
11/// will overprint any user data in the field. Use the [PdfColor::with_alpha()] function
12/// to apply an alpha channel value to an existing [PdfColor].
13#[derive(Debug, Copy, Clone)]
14pub struct PdfColor {
15    r: u8,
16    g: u8,
17    b: u8,
18    a: u8,
19}
20
21impl PdfColor {
22    pub const WHITE: PdfColor = PdfColor::new(255, 255, 255, 255);
23    pub const BLACK: PdfColor = PdfColor::new(0, 0, 0, 255);
24    pub const GREY_90: PdfColor = PdfColor::new(230, 230, 230, 255);
25    pub const GREY_80: PdfColor = PdfColor::new(204, 204, 204, 255);
26    pub const GREY_70: PdfColor = PdfColor::new(179, 179, 179, 255);
27    pub const GREY_60: PdfColor = PdfColor::new(153, 153, 153, 255);
28    pub const GREY_50: PdfColor = PdfColor::new(128, 128, 128, 255);
29    pub const GREY_40: PdfColor = PdfColor::new(102, 102, 102, 255);
30    pub const GREY_30: PdfColor = PdfColor::new(77, 77, 77, 255);
31    pub const GREY_20: PdfColor = PdfColor::new(51, 51, 51, 255);
32    pub const GREY_10: PdfColor = PdfColor::new(26, 26, 26, 255);
33
34    // Additional colors taken from https://www.rapidtables.com/web/color/RGB_Color.html
35
36    pub const LIME: PdfColor = PdfColor::new(0, 255, 0, 255);
37    pub const BLUE: PdfColor = PdfColor::new(0, 0, 255, 255);
38    pub const YELLOW: PdfColor = PdfColor::new(255, 255, 0, 255);
39    pub const CYAN: PdfColor = PdfColor::new(0, 255, 255, 255);
40    pub const MAGENTA: PdfColor = PdfColor::new(255, 0, 255, 255);
41    pub const SILVER: PdfColor = PdfColor::new(192, 192, 192, 255);
42    pub const OLIVE: PdfColor = PdfColor::new(128, 128, 0, 255);
43    pub const PURPLE: PdfColor = PdfColor::new(128, 0, 128, 255);
44    pub const TEAL: PdfColor = PdfColor::new(0, 128, 128, 255);
45    pub const NAVY: PdfColor = PdfColor::new(0, 0, 128, 255);
46    pub const MAROON: PdfColor = PdfColor::new(128, 0, 0, 255);
47    pub const DARK_RED: PdfColor = PdfColor::new(139, 0, 0, 255);
48    pub const BROWN: PdfColor = PdfColor::new(165, 42, 42, 255);
49    pub const FIREBRICK: PdfColor = PdfColor::new(178, 34, 34, 255);
50    pub const CRIMSON: PdfColor = PdfColor::new(220, 20, 60, 255);
51    pub const RED: PdfColor = PdfColor::new(255, 0, 0, 255);
52    pub const TOMATO: PdfColor = PdfColor::new(255, 99, 71, 255);
53    pub const CORAL: PdfColor = PdfColor::new(255, 127, 80, 255);
54    pub const INDIAN_RED: PdfColor = PdfColor::new(205, 92, 92, 255);
55    pub const LIGHT_CORAL: PdfColor = PdfColor::new(240, 128, 128, 255);
56    pub const DARK_SALMON: PdfColor = PdfColor::new(233, 150, 122, 255);
57    pub const SALMON: PdfColor = PdfColor::new(250, 128, 114, 255);
58    pub const LIGHT_SALMON: PdfColor = PdfColor::new(255, 160, 122, 255);
59    pub const ORANGE_RED: PdfColor = PdfColor::new(255, 69, 0, 255);
60    pub const DARK_ORANGE: PdfColor = PdfColor::new(255, 140, 0, 255);
61    pub const ORANGE: PdfColor = PdfColor::new(255, 165, 0, 255);
62    pub const GOLD: PdfColor = PdfColor::new(255, 215, 0, 255);
63    pub const DARK_GOLDEN_ROD: PdfColor = PdfColor::new(184, 134, 11, 255);
64    pub const GOLDEN_ROD: PdfColor = PdfColor::new(218, 165, 32, 255);
65    pub const PALE_GOLDEN_ROD: PdfColor = PdfColor::new(238, 232, 170, 255);
66    pub const DARK_KHAKI: PdfColor = PdfColor::new(189, 183, 107, 255);
67    pub const KHAKI: PdfColor = PdfColor::new(240, 230, 140, 255);
68    pub const YELLOW_GREEN: PdfColor = PdfColor::new(154, 205, 50, 255);
69    pub const DARK_OLIVE_GREEN: PdfColor = PdfColor::new(85, 107, 47, 255);
70    pub const OLIVE_DRAB: PdfColor = PdfColor::new(107, 142, 35, 255);
71    pub const LAWN_GREEN: PdfColor = PdfColor::new(124, 252, 0, 255);
72    pub const CHARTREUSE: PdfColor = PdfColor::new(127, 255, 0, 255);
73    pub const GREEN_YELLOW: PdfColor = PdfColor::new(173, 255, 47, 255);
74    pub const DARK_GREEN: PdfColor = PdfColor::new(0, 100, 0, 255);
75    pub const GREEN: PdfColor = PdfColor::new(0, 128, 0, 255);
76    pub const FOREST_GREEN: PdfColor = PdfColor::new(34, 139, 34, 255);
77    pub const LIME_GREEN: PdfColor = PdfColor::new(50, 205, 50, 255);
78    pub const LIGHT_GREEN: PdfColor = PdfColor::new(144, 238, 144, 255);
79    pub const PALE_GREEN: PdfColor = PdfColor::new(152, 251, 152, 255);
80    pub const DARK_SEA_GREEN: PdfColor = PdfColor::new(143, 188, 143, 255);
81    pub const MEDIUM_SPRING_GREEN: PdfColor = PdfColor::new(0, 250, 154, 255);
82    pub const SPRING_GREEN: PdfColor = PdfColor::new(0, 255, 127, 255);
83    pub const SEA_GREEN: PdfColor = PdfColor::new(46, 139, 87, 255);
84    pub const MEDIUM_AQUA_MARINE: PdfColor = PdfColor::new(102, 205, 170, 255);
85    pub const MEDIUM_SEA_GREEN: PdfColor = PdfColor::new(60, 179, 113, 255);
86    pub const LIGHT_SEA_GREEN: PdfColor = PdfColor::new(32, 178, 170, 255);
87    pub const DARK_SLATE_GRAY: PdfColor = PdfColor::new(47, 79, 79, 255);
88    pub const DARK_CYAN: PdfColor = PdfColor::new(0, 139, 139, 255);
89    pub const AQUA: PdfColor = PdfColor::new(0, 255, 255, 255);
90    pub const LIGHT_CYAN: PdfColor = PdfColor::new(224, 255, 255, 255);
91    pub const DARK_TURQUOISE: PdfColor = PdfColor::new(0, 206, 209, 255);
92    pub const TURQUOISE: PdfColor = PdfColor::new(64, 224, 208, 255);
93    pub const MEDIUM_TURQUOISE: PdfColor = PdfColor::new(72, 209, 204, 255);
94    pub const PALE_TURQUOISE: PdfColor = PdfColor::new(175, 238, 238, 255);
95    pub const AQUA_MARINE: PdfColor = PdfColor::new(127, 255, 212, 255);
96    pub const POWDER_BLUE: PdfColor = PdfColor::new(176, 224, 230, 255);
97    pub const CADET_BLUE: PdfColor = PdfColor::new(95, 158, 160, 255);
98    pub const STEEL_BLUE: PdfColor = PdfColor::new(70, 130, 180, 255);
99    pub const CORNFLOWER_BLUE: PdfColor = PdfColor::new(100, 149, 237, 255);
100    pub const DEEP_SKY_BLUE: PdfColor = PdfColor::new(0, 191, 255, 255);
101    pub const DODGER_BLUE: PdfColor = PdfColor::new(30, 144, 255, 255);
102    pub const LIGHT_BLUE: PdfColor = PdfColor::new(173, 216, 230, 255);
103    pub const SKY_BLUE: PdfColor = PdfColor::new(135, 206, 235, 255);
104    pub const LIGHT_SKY_BLUE: PdfColor = PdfColor::new(135, 206, 250, 255);
105    pub const MIDNIGHT_BLUE: PdfColor = PdfColor::new(25, 25, 112, 255);
106    pub const DARK_BLUE: PdfColor = PdfColor::new(0, 0, 139, 255);
107    pub const MEDIUM_BLUE: PdfColor = PdfColor::new(0, 0, 205, 255);
108    pub const ROYAL_BLUE: PdfColor = PdfColor::new(65, 105, 225, 255);
109    pub const BLUE_VIOLET: PdfColor = PdfColor::new(138, 43, 226, 255);
110    pub const INDIGO: PdfColor = PdfColor::new(75, 0, 130, 255);
111    pub const DARK_SLATE_BLUE: PdfColor = PdfColor::new(72, 61, 139, 255);
112    pub const SLATE_BLUE: PdfColor = PdfColor::new(106, 90, 205, 255);
113    pub const MEDIUM_SLATE_BLUE: PdfColor = PdfColor::new(123, 104, 238, 255);
114    pub const MEDIUM_PURPLE: PdfColor = PdfColor::new(147, 112, 219, 255);
115    pub const DARK_MAGENTA: PdfColor = PdfColor::new(139, 0, 139, 255);
116    pub const DARK_VIOLET: PdfColor = PdfColor::new(148, 0, 211, 255);
117    pub const DARK_ORCHID: PdfColor = PdfColor::new(153, 50, 204, 255);
118    pub const MEDIUM_ORCHID: PdfColor = PdfColor::new(186, 85, 211, 255);
119    pub const THISTLE: PdfColor = PdfColor::new(216, 191, 216, 255);
120    pub const PLUM: PdfColor = PdfColor::new(221, 160, 221, 255);
121    pub const VIOLET: PdfColor = PdfColor::new(238, 130, 238, 255);
122    pub const ORCHID: PdfColor = PdfColor::new(218, 112, 214, 255);
123    pub const MEDIUM_VIOLET_RED: PdfColor = PdfColor::new(199, 21, 133, 255);
124    pub const PALE_VIOLET_RED: PdfColor = PdfColor::new(219, 112, 147, 255);
125    pub const DEEP_PINK: PdfColor = PdfColor::new(255, 20, 147, 255);
126    pub const HOT_PINK: PdfColor = PdfColor::new(255, 105, 180, 255);
127    pub const LIGHT_PINK: PdfColor = PdfColor::new(255, 182, 193, 255);
128    pub const PINK: PdfColor = PdfColor::new(255, 192, 203, 255);
129    pub const ANTIQUE_WHITE: PdfColor = PdfColor::new(250, 235, 215, 255);
130    pub const BEIGE: PdfColor = PdfColor::new(245, 245, 220, 255);
131    pub const BISQUE: PdfColor = PdfColor::new(255, 228, 196, 255);
132    pub const BLANCHED_ALMOND: PdfColor = PdfColor::new(255, 235, 205, 255);
133    pub const WHEAT: PdfColor = PdfColor::new(245, 222, 179, 255);
134    pub const CORN_SILK: PdfColor = PdfColor::new(255, 248, 220, 255);
135    pub const LEMON_CHIFFON: PdfColor = PdfColor::new(255, 250, 205, 255);
136    pub const LIGHT_GOLDEN_ROD_YELLOW: PdfColor = PdfColor::new(250, 250, 210, 255);
137    pub const LIGHT_YELLOW: PdfColor = PdfColor::new(255, 255, 224, 255);
138    pub const SADDLE_BROWN: PdfColor = PdfColor::new(139, 69, 19, 255);
139    pub const SIENNA: PdfColor = PdfColor::new(160, 82, 45, 255);
140    pub const CHOCOLATE: PdfColor = PdfColor::new(210, 105, 30, 255);
141    pub const PERU: PdfColor = PdfColor::new(205, 133, 63, 255);
142    pub const SANDY_BROWN: PdfColor = PdfColor::new(244, 164, 96, 255);
143    pub const BURLY_WOOD: PdfColor = PdfColor::new(222, 184, 135, 255);
144    pub const TAN: PdfColor = PdfColor::new(210, 180, 140, 255);
145    pub const ROSY_BROWN: PdfColor = PdfColor::new(188, 143, 143, 255);
146    pub const MOCCASIN: PdfColor = PdfColor::new(255, 228, 181, 255);
147    pub const NAVAJO_WHITE: PdfColor = PdfColor::new(255, 222, 173, 255);
148    pub const PEACH_PUFF: PdfColor = PdfColor::new(255, 218, 185, 255);
149    pub const MISTY_ROSE: PdfColor = PdfColor::new(255, 228, 225, 255);
150    pub const LAVENDER_BLUSH: PdfColor = PdfColor::new(255, 240, 245, 255);
151    pub const LINEN: PdfColor = PdfColor::new(250, 240, 230, 255);
152    pub const OLD_LACE: PdfColor = PdfColor::new(253, 245, 230, 255);
153    pub const PAPAYA_WHIP: PdfColor = PdfColor::new(255, 239, 213, 255);
154    pub const SEA_SHELL: PdfColor = PdfColor::new(255, 245, 238, 255);
155    pub const MINT_CREAM: PdfColor = PdfColor::new(245, 255, 250, 255);
156    pub const SLATE_GRAY: PdfColor = PdfColor::new(112, 128, 144, 255);
157    pub const LIGHT_SLATE_GRAY: PdfColor = PdfColor::new(119, 136, 153, 255);
158    pub const LIGHT_STEEL_BLUE: PdfColor = PdfColor::new(176, 196, 222, 255);
159    pub const LAVENDER: PdfColor = PdfColor::new(230, 230, 250, 255);
160    pub const FLORAL_WHITE: PdfColor = PdfColor::new(255, 250, 240, 255);
161    pub const ALICE_BLUE: PdfColor = PdfColor::new(240, 248, 255, 255);
162    pub const GHOST_WHITE: PdfColor = PdfColor::new(248, 248, 255, 255);
163    pub const HONEYDEW: PdfColor = PdfColor::new(240, 255, 240, 255);
164    pub const IVORY: PdfColor = PdfColor::new(255, 255, 240, 255);
165    pub const AZURE: PdfColor = PdfColor::new(240, 255, 255, 255);
166    pub const SNOW: PdfColor = PdfColor::new(255, 250, 250, 255);
167    pub const DIM_GREY: PdfColor = PdfColor::new(105, 105, 105, 255);
168    pub const GREY: PdfColor = PdfColor::new(128, 128, 128, 255);
169    pub const DARK_GREY: PdfColor = PdfColor::new(169, 169, 169, 255);
170    pub const LIGHT_GREY: PdfColor = PdfColor::new(211, 211, 211, 255);
171    pub const GAINSBORO: PdfColor = PdfColor::new(220, 220, 220, 255);
172    pub const WHITE_SMOKE: PdfColor = PdfColor::new(245, 245, 245, 255);
173
174    #[inline]
175    // The from_pdfium() function is not currently used, but we expect it to be in future
176    #[allow(dead_code)]
177    pub(crate) const fn from_pdfium(argb: FPDF_DWORD) -> Self {
178        Self::new(
179            ((argb & 0xFF0000) >> 16) as u8,
180            ((argb & 0xFF00) >> 8) as u8,
181            (argb & 0xFF) as u8,
182            ((argb & 0xFF000000) >> 24) as u8,
183        )
184    }
185
186    /// Constructs a new [PdfColor] object from the given arguments.
187    #[inline]
188    pub const fn new(red: u8, green: u8, blue: u8, alpha: u8) -> Self {
189        Self {
190            r: red,
191            g: green,
192            b: blue,
193            a: alpha,
194        }
195    }
196
197    /// Returns the result of importing the given hexadecimal color specification,
198    /// as in HTML. For example, `#800080` represents a shade of purple with 100% opacity,
199    /// and `#40800080` is the same shade of purple with 25% opacity. The leading hash
200    /// symbol is required.
201    pub fn from_hex(hex: &str) -> Result<Self, PdfiumError> {
202        if hex.starts_with('#') {
203            match hex.len() {
204                7 => {
205                    // Potential HTML-style RGB triplet in hexadecimal format
206                    // with leading #.
207
208                    FPDF_DWORD::from_str_radix(&hex[1..hex.len()], 16)
209                        .map(PdfColor::from_pdfium)
210                        .map(|color| color.with_alpha(255))
211                        .map_err(PdfiumError::ParseHexadecimalColorError)
212                }
213                9 => {
214                    // Potential ARGB quadruplet in hexadecimal format with leading #.
215
216                    FPDF_DWORD::from_str_radix(&hex[1..hex.len()], 16)
217                        .map(PdfColor::from_pdfium)
218                        .map_err(PdfiumError::ParseHexadecimalColorError)
219                }
220                _ => Err(PdfiumError::ParseHexadecimalColorUnexpectedLength),
221            }
222        } else {
223            Err(PdfiumError::ParseHexadecimalColorMissingLeadingHash)
224        }
225    }
226
227    /// Returns the result of averaging the RGB and alpha values of the two given [PdfColor] objects.
228    #[inline]
229    pub const fn mix(a: &PdfColor, b: &PdfColor) -> Self {
230        a.mix_with(b)
231    }
232
233    /// Returns the result of averaging the RGB and alpha values of this [PdfColor] with the given [PdfColor].
234    #[inline]
235    pub const fn mix_with(&self, other: &PdfColor) -> Self {
236        Self {
237            r: (self.r + other.r) / 2,
238            g: (self.g + other.g) / 2,
239            b: (self.b + other.b) / 2,
240            a: (self.a + other.a) / 2,
241        }
242    }
243
244    /// Constructs a new [PdfColor] by copying the red, green, and blue color components
245    /// of this color and applying the given alpha value.
246    #[inline]
247    pub const fn with_alpha(&self, alpha: u8) -> Self {
248        Self {
249            r: self.r,
250            g: self.g,
251            b: self.b,
252            a: alpha,
253        }
254    }
255
256    /// Returns the alpha (opacity) component of this color, with 0 = completely transparent
257    /// and 255 = completely opaque (solid).
258    #[inline]
259    pub fn alpha(&self) -> u8 {
260        self.a
261    }
262
263    /// Returns the red component of this color.
264    #[inline]
265    pub fn red(&self) -> u8 {
266        self.r
267    }
268
269    /// Returns the green component of this color.
270    #[inline]
271    pub fn green(&self) -> u8 {
272        self.g
273    }
274
275    /// Returns the blue component of this color.
276    #[inline]
277    pub fn blue(&self) -> u8 {
278        self.b
279    }
280
281    /// Returns the hexadecimal representation of this color, as in HTML, without
282    /// a leading hash symbol. Excludes the alpha channel value. For example,
283    /// `PdfColor::PURPLE.to_hex()` will return "800080".
284    #[inline]
285    pub fn to_hex(&self) -> String {
286        format!("{:02X?}{:02X?}{:02X?}", self.r, self.g, self.b)
287    }
288
289    /// Returns the hexadecimal representation of this color, as in HTML, without
290    /// a leading hash symbol. Includes the alpha channel value. For example,
291    /// `PdfColor::PURPLE.to_hex_with_alpha()` will return "FF800080".
292    #[inline]
293    pub fn to_hex_with_alpha(&self) -> String {
294        format!(
295            "{:02X?}{:02X?}{:02X?}{:02X?}",
296            self.a, self.r, self.g, self.b
297        )
298    }
299
300    /// Returns this color encoded as a 32-bit hexadecimal 0xAARRGGBB value,
301    /// suitable for passing to Pdfium.
302    #[inline]
303    pub(crate) fn as_pdfium_color(&self) -> FPDF_DWORD {
304        let (alpha, r, g, b) = self.color_components();
305
306        ((alpha << 24) | (b << 16) | (g << 8) | r) as FPDF_DWORD
307    }
308
309    /// Returns a tuple comprising this color encoded as a 32-bit hexadecimal 0xFFRRGGBB value
310    /// and this alpha encoded as an 8-bit value, suitable for passing to Pdfium.
311    #[inline]
312    pub(crate) fn as_pdfium_color_with_alpha(&self) -> (FPDF_DWORD, u8) {
313        let (alpha, r, g, b) = self.color_components();
314
315        (
316            ((0xFF << 24) | (b << 16) | (g << 8) | r) as FPDF_DWORD,
317            alpha as u8,
318        )
319    }
320
321    /// Returns the raw color components of this [PdfColor] in the order (alpha, R, G, B).
322    #[inline]
323    fn color_components(&self) -> (FPDF_DWORD, FPDF_DWORD, FPDF_DWORD, FPDF_DWORD) {
324        (
325            self.a as FPDF_DWORD,
326            self.r as FPDF_DWORD,
327            self.g as FPDF_DWORD,
328            self.b as FPDF_DWORD,
329        )
330    }
331}
332
333#[cfg(test)]
334mod tests {
335    use crate::prelude::*;
336
337    #[test]
338    fn test_from_hex() {
339        assert_eq!(
340            PdfColor::from_hex("#800080").unwrap().color_components(),
341            PdfColor::PURPLE.color_components()
342        );
343        assert_eq!(
344            PdfColor::from_hex("#FF800080").unwrap().color_components(),
345            PdfColor::PURPLE.color_components()
346        );
347        assert_eq!(
348            PdfColor::from_hex("#40800080").unwrap().color_components(),
349            PdfColor::PURPLE.with_alpha(64).color_components()
350        );
351    }
352
353    #[test]
354    fn test_to_hex() {
355        assert_eq!(PdfColor::PURPLE.to_hex(), "800080");
356        assert_eq!(PdfColor::PURPLE.with_alpha(64).to_hex(), "800080");
357        assert_eq!(PdfColor::PURPLE.to_hex_with_alpha(), "FF800080");
358        assert_eq!(
359            PdfColor::PURPLE.with_alpha(64).to_hex_with_alpha(),
360            "40800080"
361        );
362    }
363}
pdfium_render/pdf/color.rs

pdfium_render/pdf/
color.rs
