1mod event;
2#[cfg(target_os = "macos")]
3pub mod mac;
4pub mod test;
5pub mod current {
6 #[cfg(target_os = "macos")]
7 pub use super::mac::*;
8}
9
10use crate::{
11 executor,
12 fonts::{FontId, GlyphId, Metrics as FontMetrics, Properties as FontProperties},
13 geometry::{
14 rect::{RectF, RectI},
15 vector::Vector2F,
16 },
17 text_layout::Line,
18 Menu, Scene,
19};
20use anyhow::Result;
21use async_task::Runnable;
22pub use event::Event;
23use std::{ops::Range, path::PathBuf, rc::Rc, sync::Arc};
24
25pub trait Runner {
26 fn on_finish_launching<F: 'static + FnOnce()>(self, callback: F) -> Self;
27 fn on_menu_command<F: 'static + FnMut(&str)>(self, callback: F) -> Self;
28 fn on_become_active<F: 'static + FnMut()>(self, callback: F) -> Self;
29 fn on_resign_active<F: 'static + FnMut()>(self, callback: F) -> Self;
30 fn on_event<F: 'static + FnMut(Event) -> bool>(self, callback: F) -> Self;
31 fn on_open_files<F: 'static + FnMut(Vec<PathBuf>)>(self, callback: F) -> Self;
32 fn set_menus(self, menus: &[Menu]) -> Self;
33 fn run(self);
34}
35
36pub trait App {
37 fn dispatcher(&self) -> Arc<dyn Dispatcher>;
38 fn activate(&self, ignoring_other_apps: bool);
39 fn open_window(
40 &self,
41 options: WindowOptions,
42 executor: Rc<executor::Foreground>,
43 ) -> Result<Box<dyn Window>>;
44 fn fonts(&self) -> Arc<dyn FontSystem>;
45 fn quit(&self);
46}
47
48pub trait Dispatcher: Send + Sync {
49 fn is_main_thread(&self) -> bool;
50 fn run_on_main_thread(&self, task: Runnable);
51}
52
53pub trait Window: WindowContext {
54 fn on_event(&mut self, callback: Box<dyn FnMut(Event)>);
55 fn on_resize(&mut self, callback: Box<dyn FnMut(&mut dyn WindowContext)>);
56}
57
58pub trait WindowContext {
59 fn size(&self) -> Vector2F;
60 fn scale_factor(&self) -> f32;
61 fn present_scene(&mut self, scene: Scene);
62}
63
64pub struct WindowOptions<'a> {
65 pub bounds: RectF,
66 pub title: Option<&'a str>,
67}
68
69pub trait FontSystem: Send + Sync {
70 fn load_family(&self, name: &str) -> anyhow::Result<Vec<FontId>>;
71 fn select_font(
72 &self,
73 font_ids: &[FontId],
74 properties: &FontProperties,
75 ) -> anyhow::Result<FontId>;
76 fn font_metrics(&self, font_id: FontId) -> FontMetrics;
77 fn typographic_bounds(&self, font_id: FontId, glyph_id: GlyphId) -> anyhow::Result<RectF>;
78 fn glyph_for_char(&self, font_id: FontId, ch: char) -> Option<GlyphId>;
79 fn rasterize_glyph(
80 &self,
81 font_id: FontId,
82 font_size: f32,
83 glyph_id: GlyphId,
84 subpixel_shift: Vector2F,
85 scale_factor: f32,
86 ) -> Option<(RectI, Vec<u8>)>;
87 fn layout_str(&self, text: &str, font_size: f32, runs: &[(Range<usize>, FontId)]) -> Line;
88}