pizarra 2.0.0

The backend for a simple vector hand-drawing application
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

use serde::{Serialize, Deserialize};
use serde_with::{serde_as, DisplayFromStr};

use crate::color::Color;
use crate::point::{ScreenUnit, WorldUnit};

#[serde_as]
#[derive(Copy, Clone, Debug, Serialize, Deserialize)]
pub struct Config {
    /// Thikness in pixels used by default while drawing.
    #[serde(default = "default_thickness")]
    pub thickness: ScreenUnit,

    /// Padding in pixels added to drawings while exporting.
    #[serde(default = "default_export_padding")]
    pub export_padding: WorldUnit,

    /// If the cursor's distance to a shape is less than this it will be
    /// considered to be touching and thus be erased.
    #[serde(default = "default_erase_radius")]
    pub erase_radius: ScreenUnit,

    /// When drawing polygons and possibly other shapes in the future this
    /// radius in screen units is used to decide if the cursor is touching a
    /// previous point of the current shape.
    #[serde(default = "default_point_snap_radius")]
    pub point_snap_radius: ScreenUnit,

    /// When pressing + and - keys on the keyboard the zoom increases and
    /// decreases by this factor (must be > 1 so that + zooms in).
    #[serde(default = "default_zoom_factor")]
    pub zoom_factor: f64,

    /// When creating a new drawing this will be the background color. Specified
    /// in CSS hexadecimal format, like '#cebada'
    #[serde_as(as = "DisplayFromStr")]
    #[serde(default = "default_background_color")]
    pub background_color: Color,

    /// When creating a new drawing this will be the starting color of the pen.
    /// Specified in CSS hexadecimal format.
    #[serde_as(as = "DisplayFromStr")]
    #[serde(default = "default_stroke_color")]
    pub stroke_color: Color,

    /// multiply the scroll delta given by the scroll event by this factor to
    /// make it smoother or faster
    #[serde(default = "default_scroll_factor")]
    pub scroll_factor: f64,
}

impl Default for Config {
    fn default() -> Config {
        Config {
            thickness: 2.0.into(),
            export_padding: 20.0.into(),
            erase_radius: 10.0.into(),
            point_snap_radius: 10.0.into(),
            zoom_factor: 2.0,
            background_color: Color::black(),
            stroke_color: Color::white(),
            scroll_factor: -5.0,
        }
    }
}

fn default_thickness() -> ScreenUnit {
    Config::default().thickness
}

fn default_export_padding() -> WorldUnit {
    Config::default().export_padding
}

fn default_erase_radius() -> ScreenUnit {
    Config::default().erase_radius
}

fn default_point_snap_radius() -> ScreenUnit {
    Config::default().point_snap_radius
}

fn default_zoom_factor() -> f64 {
    Config::default().zoom_factor
}

fn default_background_color() -> Color {
    Config::default().background_color
}

fn default_stroke_color() -> Color {
    Config::default().stroke_color
}

fn default_scroll_factor() -> f64 {
    Config::default().scroll_factor
}