pdfium 0.10.3

Modern Rust interface to PDFium, the PDF library from Google
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

// PDFium-rs -- Modern Rust interface to PDFium, the PDF library from Google
//
// Copyright (c) 2025-2026 Martin van der Werff <github (at) newinnovations.nl>
//
// This file is part of PDFium-rs.
//
// PDFium-rs is free software: you can redistribute it and/or modify it under the terms of
// the GNU General Public License as published by the Free Software Foundation, either version 3
// of the License, or (at your option) any later version.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
// IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
// FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
// DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
// BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

use crate::pdfium_types::FPDF_DWORD;

/// Rust interface to PDFium colors
///
/// PDFium uses BGRA by default (32-bit color value with alpha channel).
#[derive(Debug, Copy, Clone)]
pub struct PdfiumColor {
    red: u8,
    green: u8,
    blue: u8,
    alpha: u8,
}

impl PdfiumColor {
    /// Constant for the color white (#ffffff)
    pub const WHITE: PdfiumColor = PdfiumColor::new(255, 255, 255, 255);
    /// Constant for the color black (#000000)
    pub const BLACK: PdfiumColor = PdfiumColor::new(0, 0, 0, 255);

    /// Constant for the color red (#ff0000)
    pub const RED: PdfiumColor = PdfiumColor::new(255, 0, 0, 255);
    /// Constant for the color green (#00ff00)
    pub const GREEN: PdfiumColor = PdfiumColor::new(0, 128, 0, 255);
    /// Constant for the color blue (#0000ff)
    pub const BLUE: PdfiumColor = PdfiumColor::new(0, 0, 255, 255);

    /// Constant for the color yellow (#ffff00)
    pub const YELLOW: PdfiumColor = PdfiumColor::new(255, 255, 0, 255);
    /// Constant for the color magenta (#ff00ff)
    pub const MAGENTA: PdfiumColor = PdfiumColor::new(255, 0, 255, 255);
    /// Constant for the color cyan (#00ffff)
    pub const CYAN: PdfiumColor = PdfiumColor::new(0, 255, 255, 255);

    /// Constructs a new [`PdfiumColor`] instance from the given components.
    pub const fn new(red: u8, green: u8, blue: u8, alpha: u8) -> Self {
        Self {
            red,
            green,
            blue,
            alpha,
        }
    }
}

impl From<&PdfiumColor> for FPDF_DWORD {
    /// Converts the [`PdfiumColor`] to the BGRA value
    fn from(value: &PdfiumColor) -> Self {
        let red = value.red as FPDF_DWORD;
        let green = value.green as FPDF_DWORD;
        let blue = value.blue as FPDF_DWORD;
        let alpha = value.alpha as FPDF_DWORD;
        (alpha << 24) | (red << 16) | (green << 8) | blue
    }
}