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
use crate::color::{self, IntoLinSrgba, Srgb, Srgba}; use crate::draw::properties::ColorScalar; use crate::draw::Draw; use crate::geom; use crate::math::BaseFloat; /// A type used to update the background colour. pub struct Background<'a, S = geom::scalar::Default> where S: 'a + BaseFloat, { draw: &'a Draw<S>, } /// Begin coloring the background. pub fn new<'a, S>(draw: &'a Draw<S>) -> Background<'a, S> where S: BaseFloat, { Background { draw } } impl<'a, S> Background<'a, S> where S: BaseFloat, { /// Clear the background with the given color. /// /// This method supports any color type that can be converted into RGBA. /// /// Colors that have no alpha channel will be given an opaque alpha channel value `1.0`. pub fn color<C>(self, color: C) -> Self where C: IntoLinSrgba<ColorScalar>, { if let Ok(mut state) = self.draw.state.try_borrow_mut() { state.background_color = Some(color.into_lin_srgba()); } self } /// Specify the color via red, green and blue channels. pub fn rgb(self, r: ColorScalar, g: ColorScalar, b: ColorScalar) -> Self { self.color(Srgb::new(r, g, b)) } /// Specify the color via red, green, blue and alpha channels. pub fn rgba(self, r: ColorScalar, g: ColorScalar, b: ColorScalar, a: ColorScalar) -> Self { self.color(Srgba::new(r, g, b, a)) } /// Specify the color via hue, saturation and luminance. /// /// If you're looking for HSV or HSB, use the `hsv` method instead. /// /// The given hue expects a value between `0.0` and `1.0` where `0.0` is 0 degress and `1.0` is /// 360 degrees (or 2 PI radians). /// /// See the [wikipedia entry](https://en.wikipedia.org/wiki/HSL_and_HSV) for more details on /// this color space. pub fn hsl(self, h: ColorScalar, s: ColorScalar, l: ColorScalar) -> Self { let hue = h * 360.0; self.color(color::Hsl::new(hue, s, l)) } /// Specify the color via hue, saturation, luminance and an alpha channel. /// /// If you're looking for HSVA or HSBA, use the `hsva` method instead. /// /// The given hue expects a value between `0.0` and `1.0` where `0.0` is 0 degress and `1.0` is /// 360 degrees (or 2 PI radians). /// /// See the [wikipedia entry](https://en.wikipedia.org/wiki/HSL_and_HSV) for more details on /// this color space. pub fn hsla(self, h: ColorScalar, s: ColorScalar, l: ColorScalar, a: ColorScalar) -> Self { let hue = h * 360.0; self.color(color::Hsla::new(hue, s, l, a)) } /// Specify the color via hue, saturation and *value* (brightness). /// /// This is sometimes also known as "hsb". /// /// The given hue expects a value between `0.0` and `1.0` where `0.0` is 0 degress and `1.0` is /// 360 degrees (or 2 PI radians). /// /// See the [wikipedia entry](https://en.wikipedia.org/wiki/HSL_and_HSV) for more details on /// this color space. pub fn hsv(self, h: ColorScalar, s: ColorScalar, v: ColorScalar) -> Self { let hue = h * 360.0; self.color(color::Hsv::new(hue, s, v)) } /// Specify the color via hue, saturation, *value* (brightness) and an alpha channel. /// /// This is sometimes also known as "hsba". /// /// The given hue expects a value between `0.0` and `1.0` where `0.0` is 0 degress and `1.0` is /// 360 degrees (or 2 PI radians). /// /// See the [wikipedia entry](https://en.wikipedia.org/wiki/HSL_and_HSV) for more details on /// this color space. pub fn hsva(self, h: ColorScalar, s: ColorScalar, v: ColorScalar, a: ColorScalar) -> Self where S: Into<color::RgbHue<S>>, { let hue = h * 360.0; self.color(color::Hsva::new(hue, s, v, a)) } }