sghtmltopdf 0.6.1

HTML to PDF renderer that does not depend on Chromium, WebKit or Gecko
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

//! Page size and margin definitions. The inside of the page (its content area) is the containing block.

use super::geometry::EdgeSizes;

/// A page size in CSS px (1px = 1/96in), as `@page { size }` gives it.
#[derive(Debug, Clone, Copy, PartialEq)]
pub struct PageSize {
    /// The width in CSS px.
    pub width: f32,
    /// The height in CSS px.
    pub height: f32,
}

impl PageSize {
    /// 210mm x 297mm (at 96dpi).
    pub const A4: PageSize = PageSize {
        width: 793.7,
        height: 1122.5,
    };
    /// 297mm x 420mm (at 96dpi).
    pub const A3: PageSize = PageSize {
        width: 1122.5,
        height: 1587.4,
    };
    /// 148mm x 210mm (at 96dpi).
    pub const A5: PageSize = PageSize {
        width: 559.4,
        height: 793.7,
    };
    /// 8.5in x 11in (at 96dpi, for `size: letter` in `@page`).
    pub const LETTER: PageSize = PageSize {
        width: 816.0,
        height: 1056.0,
    };
    /// 8.5in x 14in (at 96dpi).
    pub const LEGAL: PageSize = PageSize {
        width: 816.0,
        height: 1344.0,
    };

    /// Swap width and height (for the `landscape` modifier).
    pub fn landscape(self) -> Self {
        Self {
            width: self.height,
            height: self.width,
        }
    }
}

/// The page size and margins. The default is A4 with a 1in (96px) margin on every side.
#[derive(Debug, Clone, Copy, PartialEq)]
#[non_exhaustive]
pub struct PageSettings {
    /// The page size.
    pub size: PageSize,
    /// The page margins in CSS px. Headers, footers and `@page` margin boxes are drawn here.
    pub margin: EdgeSizes,
}

impl Default for PageSettings {
    /// Default margin, equal to one inch (96px).
    fn default() -> Self {
        Self {
            size: PageSize::A4,
            margin: EdgeSizes {
                top: 96.0,
                right: 96.0,
                bottom: 96.0,
                left: 96.0,
            },
        }
    }
}

impl PageSettings {
    /// The width of the page area inside the margins, in CSS px.
    pub fn content_width(&self) -> f32 {
        self.size.width - self.margin.left - self.margin.right
    }

    /// The height of the page area inside the margins, in CSS px.
    pub fn content_height(&self) -> f32 {
        self.size.height - self.margin.top - self.margin.bottom
    }
}