miniquad 0.3.13

Cross-platform window context and rendering 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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

/// Most backends happened to have exactly the same fields in their *Display struct
/// Maybe something like this may in some public API some day?
/// (important data from this struct is available through function like Context::screen_size)
#[allow(dead_code)]
pub(crate) struct NativeDisplayData {
    pub screen_width: i32,
    pub screen_height: i32,
    pub dpi_scale: f32,
    pub high_dpi: bool,
    pub quit_requested: bool,
    pub quit_ordered: bool,
}

impl Default for NativeDisplayData {
    fn default() -> NativeDisplayData {
        NativeDisplayData {
            screen_width: 1,
            screen_height: 1,
            dpi_scale: 1.,
            high_dpi: false,
            quit_requested: false,
            quit_ordered: false,
        }
    }
}

pub trait NativeDisplay: std::any::Any {
    fn screen_size(&self) -> (f32, f32);
    fn dpi_scale(&self) -> f32;
    fn high_dpi(&self) -> bool;
    fn order_quit(&mut self);
    fn request_quit(&mut self);
    fn cancel_quit(&mut self);

    fn set_cursor_grab(&mut self, _grab: bool);
    fn show_mouse(&mut self, _shown: bool);
    fn set_mouse_cursor(&mut self, _cursor_icon: crate::CursorIcon);
    fn set_window_size(&mut self, _new_width: u32, _new_height: u32);
    fn set_fullscreen(&mut self, _fullscreen: bool);
    fn clipboard_get(&mut self) -> Option<String>;
    fn clipboard_set(&mut self, _data: &str);
    fn dropped_file_count(&mut self) -> usize {
        0
    }
    fn dropped_file_bytes(&mut self, _index: usize) -> Option<Vec<u8>> {
        None
    }
    fn dropped_file_path(&mut self, _index: usize) -> Option<std::path::PathBuf> {
        None
    }
    fn show_keyboard(&mut self, _show: bool) {}

    fn as_any(&mut self) -> &mut dyn std::any::Any;
}

pub mod module;

#[cfg(target_os = "linux")]
pub mod linux_x11;

#[cfg(target_os = "linux")]
pub mod linux_wayland;

#[cfg(target_os = "android")]
pub mod android;

#[cfg(target_os = "windows")]
pub mod windows;

#[cfg(target_os = "android")]
pub use android::*;

#[cfg(target_arch = "wasm32")]
pub mod wasm;

#[cfg(target_os = "macos")]
pub mod macos;

#[cfg(any(target_os = "android", target_os = "linux"))]
pub mod egl;

// there is no glGetProcAddr on webgl, so its impossible to make "gl" module work
// on macos.. well, there is, but way easier to just statically link to gl
#[cfg(not(any(target_arch = "wasm32", target_os = "macos")))]
pub mod gl;

#[cfg(target_arch = "wasm32")]
pub use wasm::webgl as gl;

#[cfg(target_os = "macos")]
pub use macos::gl;

pub mod query_stab;