telar 0.2.1

A modular Rust UI framework with its own template language, reactive signals and a self-contained renderer.
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

//! The runners: what turns a mounted tree, a platform and a renderer into a running application.

#[cfg(all(feature = "android-bare", target_os = "android"))]
mod android;
#[cfg(all(
    feature = "desktop-bare",
    not(target_os = "android"),
    not(target_arch = "wasm32")
))]
mod desktop;
#[cfg(any(
    all(
        feature = "desktop-bare",
        not(target_os = "android"),
        not(target_arch = "wasm32")
    ),
    target_os = "android"
))]
mod dev_window;
pub mod font_config;
mod frame_thread;
mod state;
#[cfg(feature = "hardware")]
pub(crate) use font_config::offscreen_hardware_font_config;
mod entry;
mod generic;
mod handler;
mod host;
#[cfg(all(
    feature = "desktop-bare",
    feature = "dev",
    not(target_os = "android"),
    not(target_arch = "wasm32")
))]
mod hot_host;
mod multi;
#[cfg(feature = "tui")]
mod tui;
#[cfg(all(feature = "web-dom", target_arch = "wasm32"))]
mod web;

/// The window an app opens with: `App::window_config` outright replaces whatever the caller passed, including the `[telar.dev.window]` overrides. See [`dev_window::with_dev_overrides`] for why that order.
fn resolved_window<A: crate::app::App + ?Sized>(
    from_config: platform_core::WindowConfig,
    app: &A,
) -> platform_core::WindowConfig {
    app.window_config().unwrap_or(from_config)
}

const FRAME_BUDGET: std::time::Duration = std::time::Duration::from_nanos(1_000_000_000 / 60);

// Long, because what it guards against is somebody walking away from a window they left open, and what it must not do is punish somebody who paused to read: a screen being read produces no frames, so timing this from the last frame slept while they were still there.
const IDLE_GRACE: std::time::Duration = std::time::Duration::from_secs(60);

// Enforced in `on_redraw` as well as reported by `about_to_wait`, because a platform may call `on_redraw` on every loop turn rather than only when a frame is due.
const HW_KEEPALIVE_INTERVAL: std::time::Duration = std::time::Duration::from_secs(1);

// Only the in-flight frame and the one the render thread is consuming are ever live, so the free-list stays tiny; a larger cap would only hold memory.
const COMMAND_BUF_POOL_CAP: usize = 3;

#[cfg(all(feature = "android-bare", target_os = "android"))]
pub use android::run_android_app_with_name;
#[cfg(all(
    feature = "desktop-bare",
    not(target_os = "android"),
    not(target_arch = "wasm32")
))]
pub use desktop::{
    open_window, run_app_windowed, run_desktop_app_with_devtools, run_desktop_app_with_name,
};
pub use entry::{run_app_with_devtools, run_app_with_name};
pub use generic::{run_with_platform, run_with_platform_and_renderer};
pub use host::SurfaceWindow;
#[cfg(all(
    feature = "desktop-bare",
    feature = "dev",
    not(target_os = "android"),
    not(target_arch = "wasm32")
))]
pub use hot_host::run_hot_reload_host;
pub use multi::{build_surface_handler, run_multi_with_platform};
#[cfg(feature = "tui")]
pub use tui::{TuiOptions, run_tui_app_with_name};
#[cfg(all(feature = "web-dom", target_arch = "wasm32"))]
pub use web::{WebOptions, WebRenderer, run_web_app_with_name};