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 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292
// Take a look at the license at the top of the repository in the LICENSE file.
use crate::prelude::*;
use crate::{Display, Key, KeymapKey, ModifierType};
use glib::translate::*;
use glib::IsA;
use std::{mem, ptr};
#[derive(Debug, PartialEq, Eq, Ord, PartialOrd)]
pub enum Backend {
Wayland,
X11,
Win32,
MacOS,
Broadway,
}
impl Backend {
// rustdoc-stripper-ignore-next
/// Equivalent to the C macro `GDK_IS_WAYLAND_DISPLAY`
#[doc(alias = "GDK_IS_WAYLAND_DISPLAY")]
pub fn is_wayland(&self) -> bool {
matches!(self, Self::Wayland)
}
// rustdoc-stripper-ignore-next
/// Equivalent to the C macro `GDK_IS_X11_DISPLAY`
#[doc(alias = "GDK_IS_X11_DISPLAY")]
pub fn is_x11(&self) -> bool {
matches!(self, Self::X11)
}
// rustdoc-stripper-ignore-next
/// Equivalent to the C macro `GDK_IS_WIN32_DISPLAY`
#[doc(alias = "GDK_IS_WIN32_DISPLAY")]
pub fn is_win32(&self) -> bool {
matches!(self, Self::Win32)
}
// rustdoc-stripper-ignore-next
/// Equivalent to the C macro `GDK_IS_MACOS_DISPLAY`
#[doc(alias = "GDK_IS_MACOS_DISPLAY")]
pub fn is_macos(&self) -> bool {
matches!(self, Self::MacOS)
}
// rustdoc-stripper-ignore-next
/// Equivalent to the C macro `GDK_IS_BROADWAY_DISPLAY`
#[doc(alias = "GDK_IS_BROADWAY_DISPLAY")]
pub fn is_broadway(&self) -> bool {
matches!(self, Self::Broadway)
}
}
// rustdoc-stripper-ignore-next
/// Trait containing manually implemented methods of [`Display`](crate::Display).
pub trait DisplayExtManual: 'static {
/// Translates the contents of a `GdkEventKey` into a keyval, effective group,
/// and level.
///
/// Modifiers that affected the translation and are thus unavailable for
/// application use are returned in @consumed_modifiers.
///
/// The @effective_group is the group that was actually used for the
/// translation; some keys such as Enter are not affected by the active
/// keyboard group. The @level is derived from @state.
///
/// @consumed_modifiers gives modifiers that should be masked out
/// from @state when comparing this key press to a keyboard shortcut.
/// For instance, on a US keyboard, the `plus` symbol is shifted, so
/// when comparing a key press to a `<Control>plus` accelerator `<Shift>`
/// should be masked out.
///
/// This function should rarely be needed, since `GdkEventKey` already
/// contains the translated keyval. It is exported for the benefit of
/// virtualized test environments.
/// ## `keycode`
/// a keycode
/// ## `state`
/// a modifier state
/// ## `group`
/// active keyboard group
///
/// # Returns
///
/// [`true`] if there was a keyval bound to keycode/state/group.
///
/// ## `keyval`
/// return location for keyval
///
/// ## `effective_group`
/// return location for effective group
///
/// ## `level`
/// return location for level
///
/// ## `consumed`
/// return location for modifiers that were used
/// to determine the group or level
#[doc(alias = "gdk_display_translate_key")]
fn translate_key(
&self,
keycode: u32,
state: ModifierType,
group: i32,
) -> Option<(Key, i32, i32, ModifierType)>;
/// Retrieves a desktop-wide setting such as double-click time
/// for the @self.
/// ## `name`
/// the name of the setting
/// ## `value`
/// location to store the value of the setting
///
/// # Returns
///
/// [`true`] if the setting existed and a value was stored
/// in @value, [`false`] otherwise
#[doc(alias = "gdk_display_get_setting")]
fn get_setting(&self, name: &str) -> Option<glib::Value>;
/// Obtains a list of keycode/group/level combinations that will
/// generate @keyval.
///
/// Groups and levels are two kinds of keyboard mode; in general, the level
/// determines whether the top or bottom symbol on a key is used, and the
/// group determines whether the left or right symbol is used.
///
/// On US keyboards, the shift key changes the keyboard level, and there
/// are no groups. A group switch key might convert a keyboard between
/// Hebrew to English modes, for example.
///
/// `GdkEventKey` contains a `group` field that indicates the active
/// keyboard group. The level is computed from the modifier mask.
///
/// The returned array should be freed with g_free().
/// ## `keyval`
/// a keyval, such as `GDK_KEY_a`, `GDK_KEY_Up`, `GDK_KEY_Return`, etc.
///
/// # Returns
///
/// [`true`] if keys were found and returned
///
/// ## `keys`
/// return location
/// for an array of [`KeymapKey`][crate::KeymapKey]
#[doc(alias = "gdk_display_map_keyval")]
fn map_keyval(&self, keyval: Key) -> Option<Vec<KeymapKey>>;
/// Returns the keyvals bound to @keycode.
///
/// The Nth [`KeymapKey`][crate::KeymapKey] in @keys is bound to the Nth keyval in @keyvals.
///
/// When a keycode is pressed by the user, the keyval from
/// this list of entries is selected by considering the effective
/// keyboard group and level.
///
/// Free the returned arrays with g_free().
/// ## `keycode`
/// a keycode
///
/// # Returns
///
/// [`true`] if there were any entries
///
/// ## `keys`
/// return
/// location for array of [`KeymapKey`][crate::KeymapKey]
///
/// ## `keyvals`
/// return
/// location for array of keyvals
#[doc(alias = "gdk_display_map_keycode")]
fn map_keycode(&self, keycode: u32) -> Option<Vec<(KeymapKey, Key)>>;
// rustdoc-stripper-ignore-next
/// Get the currently used display backend
fn backend(&self) -> Backend;
}
impl<O: IsA<Display>> DisplayExtManual for O {
fn translate_key(
&self,
keycode: u32,
state: ModifierType,
group: i32,
) -> Option<(Key, i32, i32, ModifierType)> {
unsafe {
let mut keyval = mem::MaybeUninit::uninit();
let mut effective_group = mem::MaybeUninit::uninit();
let mut level = mem::MaybeUninit::uninit();
let mut consumed = mem::MaybeUninit::uninit();
let ret = from_glib(ffi::gdk_display_translate_key(
self.as_ref().to_glib_none().0,
keycode,
state.into_glib(),
group,
keyval.as_mut_ptr(),
effective_group.as_mut_ptr(),
level.as_mut_ptr(),
consumed.as_mut_ptr(),
));
if ret {
let keyval = keyval.assume_init();
let effective_group = effective_group.assume_init();
let level = level.assume_init();
let consumed = consumed.assume_init();
Some((
from_glib(keyval),
effective_group,
level,
from_glib(consumed),
))
} else {
None
}
}
}
fn get_setting(&self, name: &str) -> Option<glib::Value> {
unsafe {
let mut value = glib::Value::uninitialized();
let ret = ffi::gdk_display_get_setting(
self.as_ref().to_glib_none().0,
name.to_glib_none().0,
value.to_glib_none_mut().0,
);
if from_glib(ret) {
Some(value)
} else {
None
}
}
}
fn map_keyval(&self, keyval: Key) -> Option<Vec<KeymapKey>> {
unsafe {
let mut keys = ptr::null_mut();
let mut n_keys = mem::MaybeUninit::uninit();
let ret = from_glib(ffi::gdk_display_map_keyval(
self.as_ref().to_glib_none().0,
keyval.into_glib(),
&mut keys,
n_keys.as_mut_ptr(),
));
if ret {
Some(FromGlibContainer::from_glib_full_num(
keys,
n_keys.assume_init() as usize,
))
} else {
None
}
}
}
fn map_keycode(&self, keycode: u32) -> Option<Vec<(KeymapKey, Key)>> {
unsafe {
let mut keys = ptr::null_mut();
let mut keyvals = ptr::null_mut();
let mut n_entries = mem::MaybeUninit::uninit();
let ret = from_glib(ffi::gdk_display_map_keycode(
self.as_ref().to_glib_none().0,
keycode,
&mut keys,
&mut keyvals,
n_entries.as_mut_ptr(),
));
if ret {
let n_keys = n_entries.assume_init() as usize;
let keyvals: Vec<u32> = FromGlibContainer::from_glib_full_num(keyvals, n_keys);
let keyvals = keyvals.into_iter().map(|k| from_glib(k));
let keys: Vec<KeymapKey> = FromGlibContainer::from_glib_full_num(keys, n_keys);
Some(keys.into_iter().zip(keyvals).collect())
} else {
None
}
}
}
fn backend(&self) -> Backend {
match self.as_ref().type_().name() {
"GdkWaylandDisplay" => Backend::Wayland,
"GdkX11Display" => Backend::X11,
"GdkMacosDisplay" => Backend::MacOS,
"GdkWin32Display" => Backend::Win32,
"GdkBroadwayDisplay" => Backend::Broadway,
e => panic!("Unsupported display backend {e}"),
}
}
}