cotati 0.1.2

cotati is a general-purpose vector drawing interface that does not restrict binding to a back-end renderer.
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

use crate::{Angle, Length, Point, PreserveAspectRatio, Rgba, Transform};

/// A rendering target must implement this trait.
pub trait Renderer {
    /// Error type returns by [`submit`](Renderer::submit) function.
    type Error;

    /// Clear all graphics instructions in the stack.
    fn clear(&mut self);

    /// Pop n instructions from graphics stack.
    fn pop(&mut self, n: usize);

    /// Push `entity` instruction into stack.
    fn push_entity(&mut self, id: &str);

    /// Push a `canvas` instruction.
    fn push_canvas(&mut self, width: Length, height: Length);
    /// Push a `viewbox` instruction.
    fn push_viewbox(&mut self, width: Length, height: Length);

    /// Push a `PreserveAspectRatio` instruction.
    fn push_preserve_aspect_ratio(&mut self, ratio: PreserveAspectRatio);

    /// Push a `transform` instruction into graphics stack.
    fn push_transform(&mut self, transform: Transform);

    /// Push a `fill` instruction into graphics stack.
    fn push_fill(&mut self, color: Rgba);

    /// Push a `stroke` instruction into graphics stack.
    fn push_stroke(&mut self, color: Rgba, width: Length);

    /// Push a debug `label` instruction into graphics stack.
    fn push_label(&mut self, label: &str);

    /// Attach a entity into the rendering tree.
    fn entity_ref(&mut self, id: &str);

    /// Draw a line on the target.
    fn line(&mut self, from: Point, to: Point);

    /// Draw a quadratic bezier curve on the target.
    fn quadratic_bezier(&mut self, from: Point, ctrl: Point, to: Point);

    /// Draw a cubic bezier curve on the target.
    fn cubic_bezier(&mut self, from: Point, ctrl1: Point, ctrl2: Point, to: Point);

    /// Draw an elliptic arc curve segment.
    fn arc(
        &mut self,
        center: Point,
        raddii: (Length, Length),
        start_angle: Angle,
        sweep_angle: Angle,
        x_rotation: Angle,
    );

    /// Submits a series of graphics instructions for execution.
    fn submit(&mut self) -> Result<(), Self::Error>;
}