jiao-cairo 0.3.5

Cross platform 2D painting engine (cairo/gtk binding part)
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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147

// Copyright (c) 2022 Xu Shaohua <shaohua@biofan.org>. All rights reserved.
// Use of this source is governed by Apache-2.0 License that can be found
// in the LICENSE file.

#![allow(clippy::module_name_repetitions)]

use jiao::base::Size;

use crate::error::Error;
use crate::painter::Painter;

#[derive(Debug, Clone)]
pub enum PaintDevice {
    Image(ImagePaintDevice),
    Pdf(PdfPaintDevice),
    Svg(SvgPaintDevice),
}

impl PaintDevice {
    pub fn context(&mut self) -> &cairo::Context {
        self.painter().context()
    }

    pub fn painter(&self) -> &Painter {
        match self {
            Self::Image(image_device) => image_device.painter(),
            Self::Pdf(pdf_device) => pdf_device.painter(),
            Self::Svg(svg_device) => svg_device.painter(),
        }
    }

    pub fn painter_mut(&mut self) -> &mut Painter {
        match self {
            Self::Image(image_device) => image_device.painter_mut(),
            Self::Pdf(pdf_device) => pdf_device.painter_mut(),
            Self::Svg(svg_device) => svg_device.painter_mut(),
        }
    }
}

#[derive(Debug, Clone)]
pub struct ImagePaintDevice {
    surface: cairo::ImageSurface,
    painter: Painter,
}

impl ImagePaintDevice {
    /// Create a new image painting device.
    ///
    /// # Errors
    /// Returns error if failed to create image painting device with specific format.
    pub fn new(format: cairo::Format, width: i32, height: i32) -> Result<Self, Error> {
        let surface = cairo::ImageSurface::create(format, width, height)?;
        let context = cairo::Context::new(&surface)?;
        let painter = Painter::new(context);
        Ok(Self { surface, painter })
    }

    #[must_use]
    pub fn size(&self) -> Size {
        Size::from(self.surface.width(), self.surface.height())
    }

    pub fn surface_mut(&mut self) -> &mut cairo::ImageSurface {
        &mut self.surface
    }

    pub fn painter(&self) -> &Painter {
        &self.painter
    }

    pub fn painter_mut(&mut self) -> &mut Painter {
        &mut self.painter
    }
}

#[derive(Debug, Clone)]
pub struct PdfPaintDevice {
    surface: cairo::PdfSurface,
    painter: Painter,
}

impl PdfPaintDevice {
    /// Create a new pdf paint device with specific size.
    ///
    /// # Errors
    /// Returns error if failed to create new pdf paint device.
    pub fn new<P: AsRef<std::path::Path>>(width: f64, height: f64, path: P) -> Result<Self, Error> {
        let surface = cairo::PdfSurface::new(width, height, path)?;
        let context = cairo::Context::new(&surface)?;
        let painter = Painter::new(context);
        Ok(Self { surface, painter })
    }

    #[must_use]
    pub fn size(&self) -> Size {
        unimplemented!()
    }

    pub fn surface_mut(&mut self) -> &mut cairo::PdfSurface {
        &mut self.surface
    }

    pub fn painter(&self) -> &Painter {
        &self.painter
    }

    pub fn painter_mut(&mut self) -> &mut Painter {
        &mut self.painter
    }
}

#[derive(Debug, Clone)]
pub struct SvgPaintDevice {
    surface: cairo::SvgSurface,
    painter: Painter,
}

impl SvgPaintDevice {
    /// Create a new svg painting device with specific size.
    ///
    /// # Errors
    /// Returns error if failed to create svg surface.
    pub fn new<P: AsRef<std::path::Path>>(width: f64, height: f64, path: P) -> Result<Self, Error> {
        let surface = cairo::SvgSurface::new(width, height, Some(path))?;
        let context = cairo::Context::new(&surface)?;
        let painter = Painter::new(context);
        Ok(Self { surface, painter })
    }

    #[must_use]
    pub fn size(&self) -> Size {
        unimplemented!()
    }

    pub fn surface_mut(&mut self) -> &mut cairo::SvgSurface {
        &mut self.surface
    }

    pub fn painter(&self) -> &Painter {
        &self.painter
    }

    pub fn painter_mut(&mut self) -> &mut Painter {
        &mut self.painter
    }
}