fltk2 0.1.7

Rust bindings for the FLTK GUI library
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
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

use fltk_sys::fl;
use std::sync::{
    Arc, LazyLock, Mutex,
    atomic::{AtomicBool, Ordering},
};

/// Basically a check for global locking
pub(crate) static IS_INIT: AtomicBool = AtomicBool::new(false);

/// The fonts associated with the application
pub(crate) static FONTS: LazyLock<Arc<Mutex<Vec<String>>>> = LazyLock::new(|| {
    Arc::from(Mutex::from(vec![
        "Helvetica".to_owned(),
        "HelveticaBold".to_owned(),
        "HelveticaItalic".to_owned(),
        "HelveticaBoldItalic".to_owned(),
        "Courier".to_owned(),
        "CourierBold".to_owned(),
        "CourierItalic".to_owned(),
        "CourierBoldItalic".to_owned(),
        "Times".to_owned(),
        "TimesBold".to_owned(),
        "TimesItalic".to_owned(),
        "TimesBoldItalic".to_owned(),
        "Symbol".to_owned(),
        "Screen".to_owned(),
        "ScreenBold".to_owned(),
        "Zapfdingbats".to_owned(),
    ]))
});
static UI_THREAD: LazyLock<std::thread::ThreadId> = LazyLock::new(|| std::thread::current().id());

/// Inits all styles, fonts and images available to FLTK.
/// Also initializes global locking
/// # Panics
/// If the current environment lacks threading support. Practically this should never happen!
pub fn init_all() {
    unsafe {
        fl::Fl_init_all();
        #[cfg(not(feature = "single-threaded"))]
        assert!((fl::Fl_lock() == 0), "fltk-rs requires threading support!");
        #[cfg(feature = "enable-glwindow")]
        {
            unsafe extern "C" {
                pub fn open_gl() -> i32;
            }
            open_gl();
        }
        if !IS_INIT.load(Ordering::Relaxed) {
            IS_INIT.store(true, Ordering::Relaxed);
        }
    }
}

#[doc(hidden)]
/// Check whether we're in the ui thread
pub fn is_ui_thread() -> bool {
    *UI_THREAD == std::thread::current().id()
}

/// Check if fltk-rs was initialized
pub fn is_initialized() -> bool {
    IS_INIT.load(Ordering::Relaxed)
}

/// Disables wayland when building with use-wayland.
/// Needs to be called before showing the first window
pub fn disable_wayland() {
    unsafe { fl::Fl_disable_wayland() }
}