mirror of
https://github.com/rust-windowing/winit.git
synced 2026-06-28 07:33:14 -04:00
c4310af83c
Mainly fix typos in comments, but also some minor code changes: * Rename `apply_on_poiner` to `apply_on_pointer`. * Rename `ImeState::Commited` to `ImeState::Committed` * Correct `cfg_attr` usage: `wayland_platfrom` -> `wayland_platform`.
51 lines
1.8 KiB
Rust
51 lines
1.8 KiB
Rust
use crate::keyboard::{KeyCode, PhysicalKey};
|
|
|
|
// TODO: Describe what this value contains for each platform
|
|
|
|
/// Additional methods for the [`PhysicalKey`] type that allow the user to access the platform-specific
|
|
/// scancode.
|
|
///
|
|
/// [`PhysicalKey`]: crate::keyboard::PhysicalKey
|
|
pub trait PhysicalKeyExtScancode {
|
|
/// The raw value of the platform-specific physical key identifier.
|
|
///
|
|
/// Returns `Some(key_id)` if the conversion was successful; returns `None` otherwise.
|
|
///
|
|
/// ## Platform-specific
|
|
/// - **Windows:** A 16bit extended scancode
|
|
/// - **Wayland/X11**: A 32-bit linux scancode, which is X11/Wayland keycode subtracted by 8.
|
|
fn to_scancode(self) -> Option<u32>;
|
|
|
|
/// Constructs a `PhysicalKey` from a platform-specific physical key identifier.
|
|
///
|
|
/// Note that this conversion may be lossy, i.e. converting the returned `PhysicalKey` back
|
|
/// using `to_scancode` might not yield the original value.
|
|
///
|
|
/// ## Platform-specific
|
|
/// - **Wayland/X11**: A 32-bit linux scancode. When building from X11/Wayland keycode subtract
|
|
/// `8` to get the value you wanted.
|
|
fn from_scancode(scancode: u32) -> PhysicalKey;
|
|
}
|
|
|
|
impl PhysicalKeyExtScancode for PhysicalKey {
|
|
fn to_scancode(self) -> Option<u32> {
|
|
crate::platform_impl::physicalkey_to_scancode(self)
|
|
}
|
|
|
|
fn from_scancode(scancode: u32) -> PhysicalKey {
|
|
crate::platform_impl::scancode_to_physicalkey(scancode)
|
|
}
|
|
}
|
|
|
|
impl PhysicalKeyExtScancode for KeyCode {
|
|
#[inline]
|
|
fn to_scancode(self) -> Option<u32> {
|
|
<PhysicalKey as PhysicalKeyExtScancode>::to_scancode(PhysicalKey::Code(self))
|
|
}
|
|
|
|
#[inline]
|
|
fn from_scancode(scancode: u32) -> PhysicalKey {
|
|
<PhysicalKey as PhysicalKeyExtScancode>::from_scancode(scancode)
|
|
}
|
|
}
|