use std::any::Any; pub mod bitmaps; pub mod color; pub mod input; pub mod os; pub use bitmaps::BitmapImage; pub use color::Color; pub use input::*; pub use os::*; /// Compositing operator. /// We implement a small subset of possible compositing operators. /// More information on these and their temrinology can be found /// in the Cairo documentation here: /// https://www.cairographics.org/operators/ #[derive(Debug, Clone, Copy)] pub enum Operator { /// Apply the alpha channel of src and combine src with dest, /// according to the classic OVER composite operator Over, /// Ignore dest; take src as the result of the operation Source, /// Multiply src x dest. The result is at least as dark as /// the darker of the two input colors. This is used to /// apply a color tint. Multiply, /// Multiply src with the provided color, then apply the /// Over operator on the result with the dest as the dest. /// This is used to colorize the src and then blend the /// result into the destination. MultiplyThenOver(Color), } #[derive(Debug, Clone, Copy)] pub struct Dimensions { pub pixel_width: usize, pub pixel_height: usize, pub dpi: usize, } pub trait PaintContext { fn get_dimensions(&self) -> Dimensions; /// Clear the entire context to the specified color fn clear(&mut self, color: Color) { let dims = self.get_dimensions(); self.clear_rect(0, 0, dims.pixel_width, dims.pixel_height, color); } /// Clear a rectangle to the specified color fn clear_rect( &mut self, dest_x: isize, dest_y: isize, width: usize, height: usize, color: Color, ); fn draw_image( &mut self, dest_x: isize, dest_y: isize, im: &dyn BitmapImage, operator: Operator, ) { let (dest_width, dest_height) = im.image_dimensions(); self.draw_image_subset(dest_x, dest_y, 0, 0, dest_width, dest_height, im, operator) } fn draw_image_subset( &mut self, dest_x: isize, dest_y: isize, src_x: usize, src_y: usize, width: usize, height: usize, im: &dyn BitmapImage, operator: Operator, ); fn draw_line( &mut self, start_x: isize, start_y: isize, dest_x: isize, dest_y: isize, color: Color, operator: Operator, ); } #[derive(Debug, Clone, Copy, PartialEq, Eq)] pub enum MouseCursor { Arrow, Hand, Text, } #[allow(unused_variables)] pub trait WindowCallbacks: Any { /// Called when the window close button is clicked. /// Return true to allow the close to continue, false to /// prevent it from closing. fn can_close(&mut self) -> bool { true } /// Called when the window is being destroyed by the gui system fn destroy(&mut self) {} /// Called when the window is resized, or when the dpi has changed fn resize(&mut self, dimensions: Dimensions) {} /// Called when the window contents need painting fn paint(&mut self, context: &mut dyn PaintContext) { context.clear(Color::rgb(0x20, 0x40, 0x60)); } /// Called to handle a key event. /// If your window didn't handle the event, you must return false. /// This is particularly important for eg: ALT keys on windows, /// otherwise standard key assignments may not function in your window. fn key_event(&mut self, key: &KeyEvent, context: &dyn WindowOps) -> bool { false } fn mouse_event(&mut self, event: &MouseEvent, context: &dyn WindowOps) { context.set_cursor(Some(MouseCursor::Arrow)); } /// Called when the window is created and allows the embedding /// app to reference the window and operate upon it. fn created(&mut self, window: &Window) {} /// An unfortunate bit of boilerplate; you need to provie an impl /// of this method that returns `self` in order for the downcast_ref /// method of the Any trait to be usable on WindowCallbacks. /// https://stackoverflow.com/q/46045298/149111 and others have /// some rationale on why Rust works this way. fn as_any(&mut self) -> &mut dyn Any; } pub trait WindowOps { /// Show a hidden window fn show(&self); /// Hide a visible window fn hide(&self); /// Change the cursor fn set_cursor(&self, cursor: Option); /// Invalidate the window so that the entire client area will /// be repainted shortly fn invalidate(&self); /// Change the titlebar text for the window fn set_title(&self, title: &str); /// Schedule a callback on the data associated with the window. /// The `Any` that is passed in corresponds to the WindowCallbacks /// impl you passed to `new_window`, pre-converted to Any so that /// you can `downcast_ref` or `downcast_mut` it and operate on it. fn apply(&self, func: F) where Self: Sized; } pub trait WindowOpsMut { /// Show a hidden window fn show(&mut self); /// Hide a visible window fn hide(&mut self); /// Change the cursor fn set_cursor(&mut self, cursor: Option); /// Invalidate the window so that the entire client area will /// be repainted shortly fn invalidate(&mut self); /// Change the titlebar text for the window fn set_title(&mut self, title: &str); }