//! Write your own renderer. #[cfg(debug_assertions)] mod null; #[cfg(debug_assertions)] pub use null::Null; use crate::{Background, BorderRadius, Color, Rectangle, Shadow, Vector}; /// A component that can be used by widgets to draw themselves on a screen. pub trait Renderer: Sized { /// The supported theme of the [`Renderer`]. type Theme; /// Draws the primitives recorded in the given closure in a new layer. /// /// The layer will clip its contents to the provided `bounds`. fn with_layer(&mut self, bounds: Rectangle, f: impl FnOnce(&mut Self)); /// Applies a `translation` to the primitives recorded in the given closure. fn with_translation( &mut self, translation: Vector, f: impl FnOnce(&mut Self), ); /// Fills a [`Quad`] with the provided [`Background`]. fn fill_quad(&mut self, quad: Quad, background: impl Into); /// Clears all of the recorded primitives in the [`Renderer`]. fn clear(&mut self); } /// A polygon with four sides. #[derive(Debug, Clone, Copy, PartialEq)] pub struct Quad { /// The bounds of the [`Quad`]. pub bounds: Rectangle, /// The border radius of the [`Quad`]. pub border_radius: BorderRadius, /// The border width of the [`Quad`]. pub border_width: f32, /// The border color of the [`Quad`]. pub border_color: Color, /// The shadow of the [`Quad`]. pub shadow: Shadow, } /// The styling attributes of a [`Renderer`]. #[derive(Debug, Clone, Copy, PartialEq)] pub struct Style { /// The text color pub text_color: Color, } impl Default for Style { fn default() -> Self { Style { text_color: Color::BLACK, } } }