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
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
//! Web-content overlay. Displays a web-page within an area of the main window.
use std::sync::Arc;
use crate::{view::View, Library};
/// Web-content overlay. Displays a web-page within an area of the main window.
///
/// Each `Overlay` is essentially a View and an on-screen quad. You should
/// create the Overlay then load content into the underlying View.
///
/// Can be created with [`Window::create_overlay`](crate::window::Window::create_overlay)
/// or [`Window::create_overlay_with_view`](crate::window::Window::create_overlay_with_view).
pub struct Overlay {
lib: Arc<Library>,
internal: ul_sys::ULOverlay,
view: View,
}
impl Overlay {
/// Internal function helper to create an overlay.
/// (See [`Window::create_overlay`](crate::window::Window::create_overlay))
pub(crate) unsafe fn create(
lib: Arc<Library>,
window: ul_sys::ULWindow,
width: u32,
height: u32,
x: i32,
y: i32,
) -> Option<Self> {
let internal_overlay = lib.appcore().ulCreateOverlay(window, width, height, x, y);
if internal_overlay.is_null() {
return None;
}
let raw_view = lib.appcore().ulOverlayGetView(internal_overlay);
// the overlay owns the view, we can't need to destroy it on drop
let view = View::from_raw(lib.clone(), raw_view)?;
Some(Self {
lib,
internal: internal_overlay,
view,
})
}
/// Internal function helper to create an overlay with a view
/// (See [`Window::create_overlay_with_view`](crate::window::Window::create_overlay_with_view))
pub(crate) unsafe fn create_with_view(
lib: Arc<Library>,
window_raw: ul_sys::ULWindow,
view: View,
x: i32,
y: i32,
) -> Option<Self> {
let internal = lib
.appcore()
.ulCreateOverlayWithView(window_raw, view.to_ul(), x, y);
if internal.is_null() {
return None;
}
Some(Self {
lib,
internal,
view,
})
}
}
impl Overlay {
/// Get the underlying View.
pub fn view(&self) -> &View {
&self.view
}
/// Get the width (in pixels).
pub fn width(&self) -> u32 {
unsafe { self.lib.appcore().ulOverlayGetWidth(self.internal) }
}
/// Get the height (in pixels).
pub fn height(&self) -> u32 {
unsafe { self.lib.appcore().ulOverlayGetHeight(self.internal) }
}
/// Get the x-position (offset from the left of the Window), in pixels.
pub fn x(&self) -> i32 {
unsafe { self.lib.appcore().ulOverlayGetX(self.internal) }
}
/// Get the y-position (offset from the top of the Window), in pixels.
pub fn y(&self) -> i32 {
unsafe { self.lib.appcore().ulOverlayGetY(self.internal) }
}
/// Whether or not the overlay is hidden (not drawn).
pub fn is_hidden(&self) -> bool {
unsafe { self.lib.appcore().ulOverlayIsHidden(self.internal) }
}
/// Show the overlay.
pub fn show(&self) {
unsafe { self.lib.appcore().ulOverlayShow(self.internal) }
}
/// Hide the overlay (will no longer be drawn)
pub fn hide(&self) {
unsafe { self.lib.appcore().ulOverlayHide(self.internal) }
}
/// Whether or not this overlay has keyboard focus.
pub fn has_focus(&self) -> bool {
unsafe { self.lib.appcore().ulOverlayHasFocus(self.internal) }
}
/// Grant this overlay exclusive keyboard focus.
pub fn focus(&self) {
unsafe { self.lib.appcore().ulOverlayFocus(self.internal) }
}
/// Remove keyboard focus.
pub fn unfocus(&self) {
unsafe { self.lib.appcore().ulOverlayUnfocus(self.internal) }
}
/// Move the overlay to a new position (in pixels).
pub fn move_to(&self, x: i32, y: i32) {
unsafe { self.lib.appcore().ulOverlayMoveTo(self.internal, x, y) }
}
/// Resize the overlay (and underlying View), dimensions should be
/// specified in pixels.
pub fn resize(&self, width: u32, height: u32) {
unsafe {
self.lib
.appcore()
.ulOverlayResize(self.internal, width, height)
}
}
// only found in C++ and not in the C API yet.
// pub fn need_repaint(&self) -> bool {
// }
}
impl Drop for Overlay {
fn drop(&mut self) {
unsafe {
self.lib.appcore().ulDestroyOverlay(self.internal);
}
}
}