kozan-platform 0.1.0

Abstract platform layer for the Kozan UI platform — zero windowing-backend dependency
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

//! Platform host — abstract interface from view threads to the main thread.
//!
//! Like Chrome's `WidgetHost` / `FrameWidgetHost` Mojo interfaces.
//! The view thread communicates back to the main thread through this trait,
//! never through windowing-backend types (winit, SDL2, etc.).
//!
//! The windowing backend (e.g., `kozan-winit`) provides the concrete
//! implementation.

use crate::id::WindowId;
use crate::request::WindowConfig;

/// The interface from a view thread back to the main thread.
///
/// Implemented by the windowing backend (e.g., `kozan-winit`).
/// The view thread holds an `Arc<dyn PlatformHost>` and calls methods
/// without knowing anything about the underlying windowing system.
///
/// All methods are non-blocking — they send messages to the main thread.
/// If the main thread has exited, calls are silently dropped.
pub trait PlatformHost: Send + Sync {
    /// Request a redraw for this window.
    fn request_redraw(&self, window_id: WindowId);

    /// Set the window title.
    fn set_title(&self, window_id: WindowId, title: &str);

    /// Close the window.
    fn close_window(&self, window_id: WindowId);

    /// Resize the window.
    fn resize_window(&self, window_id: WindowId, width: u32, height: u32);

    /// Request a new window to be created.
    fn create_window(&self, config: WindowConfig);
}