piston2d-graphics 0.41.0

A library for 2D graphics that works with multiple back-ends
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

use crate::{
    math::hsv,
    radians::Radians,
    types::{Color, ColorComponent},
    Ellipse, Line, Rectangle,
};

/// Implemented by contexts that contains color.
pub trait Colored: Sized {
    /// Multiplies with red, green, blue and alpha values.
    fn mul_rgba(
        self,
        r: ColorComponent,
        g: ColorComponent,
        b: ColorComponent,
        a: ColorComponent,
    ) -> Self;

    /// Mixes the current color with white.
    ///
    /// 0 is black and 1 is white.
    #[inline(always)]
    fn tint(self, f: ColorComponent) -> Self {
        self.mul_rgba(f, f, f, 1.0)
    }

    /// Mixes the current color with black.
    ///
    /// 0 is white and 1 is black.
    #[inline(always)]
    fn shade(self, f: ColorComponent) -> Self {
        let f = 1.0 - f;
        self.mul_rgba(f, f, f, 1.0)
    }

    /// Rotates hue by degrees.
    #[inline(always)]
    fn hue_deg(self, angle: ColorComponent) -> Self {
        let pi: ColorComponent = Radians::_180();
        self.hue_rad(angle * pi / 180.0)
    }

    /// Rotates hue by radians.
    fn hue_rad(self, angle: ColorComponent) -> Self;
}

impl Colored for Color {
    #[inline(always)]
    fn mul_rgba(
        self,
        r: ColorComponent,
        g: ColorComponent,
        b: ColorComponent,
        a: ColorComponent,
    ) -> Self {
        [self[0] * r, self[1] * g, self[2] * b, self[3] * a]
    }

    #[inline(always)]
    fn hue_rad(self, angle: ColorComponent) -> Self {
        hsv(self, angle, 1.0, 1.0)
    }
}

impl Colored for Line {
    #[inline(always)]
    fn mul_rgba(
        mut self,
        r: ColorComponent,
        g: ColorComponent,
        b: ColorComponent,
        a: ColorComponent,
    ) -> Self {
        self.color = self.color.mul_rgba(r, g, b, a);
        self
    }

    #[inline(always)]
    fn hue_rad(mut self, angle: ColorComponent) -> Self {
        self.color = self.color.hue_rad(angle);
        self
    }
}

impl Colored for Ellipse {
    #[inline(always)]
    fn mul_rgba(
        mut self,
        r: ColorComponent,
        g: ColorComponent,
        b: ColorComponent,
        a: ColorComponent,
    ) -> Self {
        self.color = self.color.mul_rgba(r, g, b, a);
        self
    }

    #[inline(always)]
    fn hue_rad(mut self, angle: ColorComponent) -> Self {
        self.color = self.color.hue_rad(angle);
        self
    }
}

impl Colored for Rectangle {
    #[inline(always)]
    fn mul_rgba(
        mut self,
        r: ColorComponent,
        g: ColorComponent,
        b: ColorComponent,
        a: ColorComponent,
    ) -> Self {
        self.color = self.color.mul_rgba(r, g, b, a);
        self
    }

    #[inline(always)]
    fn hue_rad(mut self, angle: ColorComponent) -> Self {
        self.color = self.color.hue_rad(angle);
        self
    }
}