2015-06-24 08:05:37 +10:00
|
|
|
use std::path::PathBuf;
|
2017-07-01 19:20:13 +10:00
|
|
|
use {WindowId, DeviceId};
|
2015-06-24 08:05:37 +10:00
|
|
|
|
2017-09-25 23:58:59 +10:00
|
|
|
/// Describes a generic event.
|
2015-06-24 08:05:37 +10:00
|
|
|
#[derive(Clone, Debug)]
|
2014-07-27 20:59:45 +10:00
|
|
|
pub enum Event {
|
2017-01-29 01:00:17 +11:00
|
|
|
WindowEvent {
|
2017-02-03 19:13:11 +11:00
|
|
|
window_id: WindowId,
|
2017-01-29 01:00:17 +11:00
|
|
|
event: WindowEvent,
|
2017-04-23 06:52:35 +10:00
|
|
|
},
|
|
|
|
DeviceEvent {
|
|
|
|
device_id: DeviceId,
|
|
|
|
event: DeviceEvent,
|
|
|
|
},
|
2017-05-25 23:19:13 +10:00
|
|
|
Awakened,
|
2017-09-16 00:24:09 +10:00
|
|
|
|
|
|
|
/// The application has been suspended or resumed.
|
|
|
|
///
|
|
|
|
/// The parameter is true if app was suspended, and false if it has been resumed.
|
|
|
|
Suspended(bool),
|
2017-01-29 01:00:17 +11:00
|
|
|
}
|
|
|
|
|
2017-09-25 23:58:59 +10:00
|
|
|
/// Describes an event from a `Window`.
|
2017-01-29 01:00:17 +11:00
|
|
|
#[derive(Clone, Debug)]
|
|
|
|
pub enum WindowEvent {
|
|
|
|
|
2014-07-27 20:59:45 +10:00
|
|
|
/// The size of the window has changed.
|
2015-01-13 23:21:36 +11:00
|
|
|
Resized(u32, u32),
|
2014-07-27 20:59:45 +10:00
|
|
|
|
2014-07-28 04:08:31 +10:00
|
|
|
/// The position of the window has changed.
|
2015-01-13 23:21:36 +11:00
|
|
|
Moved(i32, i32),
|
2014-07-28 04:08:31 +10:00
|
|
|
|
2014-07-27 20:59:45 +10:00
|
|
|
/// The window has been closed.
|
|
|
|
Closed,
|
|
|
|
|
2017-07-27 12:56:34 +10:00
|
|
|
/// A file has been dropped into the window.
|
|
|
|
DroppedFile(PathBuf),
|
|
|
|
|
2017-07-27 12:51:00 +10:00
|
|
|
/// A file is being hovered over the window.
|
|
|
|
HoveredFile(PathBuf),
|
|
|
|
|
2017-07-27 12:56:34 +10:00
|
|
|
/// A file was hovered, but has exited the window.
|
|
|
|
HoveredFileCancelled,
|
2015-06-24 08:05:37 +10:00
|
|
|
|
2014-07-28 01:06:03 +10:00
|
|
|
/// The window received a unicode character.
|
|
|
|
ReceivedCharacter(char),
|
|
|
|
|
2014-07-27 20:59:45 +10:00
|
|
|
/// The window gained or lost focus.
|
2014-10-11 21:04:48 +11:00
|
|
|
///
|
2014-07-27 20:59:45 +10:00
|
|
|
/// The parameter is true if the window has gained focus, and false if it has lost focus.
|
|
|
|
Focused(bool),
|
|
|
|
|
2014-08-14 01:04:57 +10:00
|
|
|
/// An event from the keyboard has been received.
|
2017-04-23 06:52:35 +10:00
|
|
|
KeyboardInput { device_id: DeviceId, input: KeyboardInput },
|
2014-08-14 01:04:57 +10:00
|
|
|
|
|
|
|
/// The cursor has moved on the window.
|
2014-10-11 21:04:48 +11:00
|
|
|
///
|
2017-04-23 06:52:35 +10:00
|
|
|
/// `position` is (x,y) coords in pixels relative to the top-left corner of the window. Because the range of this
|
|
|
|
/// data is limited by the display area and it may have been transformed by the OS to implement effects such as
|
|
|
|
/// mouse acceleration, it should not be used to implement non-cursor-like interactions such as 3D camera control.
|
|
|
|
MouseMoved { device_id: DeviceId, position: (f64, f64) },
|
2014-08-14 01:04:57 +10:00
|
|
|
|
2016-11-03 19:31:16 +11:00
|
|
|
/// The cursor has entered the window.
|
2017-04-23 06:52:35 +10:00
|
|
|
MouseEntered { device_id: DeviceId },
|
2016-11-03 19:31:16 +11:00
|
|
|
|
|
|
|
/// The cursor has left the window.
|
2017-04-23 06:52:35 +10:00
|
|
|
MouseLeft { device_id: DeviceId },
|
2016-11-03 19:31:16 +11:00
|
|
|
|
2015-06-16 08:54:43 +10:00
|
|
|
/// A mouse wheel movement or touchpad scroll occurred.
|
2017-04-23 06:52:35 +10:00
|
|
|
MouseWheel { device_id: DeviceId, delta: MouseScrollDelta, phase: TouchPhase },
|
2014-08-14 01:04:57 +10:00
|
|
|
|
2017-04-23 06:52:35 +10:00
|
|
|
/// An mouse button press has been received.
|
|
|
|
MouseInput { device_id: DeviceId, state: ElementState, button: MouseButton },
|
2014-12-17 15:49:11 +11:00
|
|
|
|
2016-02-19 14:51:02 +11:00
|
|
|
/// Touchpad pressure event.
|
|
|
|
///
|
|
|
|
/// At the moment, only supported on Apple forcetouch-capable macbooks.
|
|
|
|
/// The parameters are: pressure level (value between 0 and 1 representing how hard the touchpad
|
|
|
|
/// is being pressed) and stage (integer representing the click level).
|
2017-04-23 06:52:35 +10:00
|
|
|
TouchpadPressure { device_id: DeviceId, pressure: f32, stage: i64 },
|
|
|
|
|
|
|
|
/// Motion on some analog axis not otherwise handled. May overlap with mouse motion.
|
|
|
|
AxisMotion { device_id: DeviceId, axis: AxisId, value: f64 },
|
2016-02-19 14:51:02 +11:00
|
|
|
|
2015-03-25 13:48:32 +11:00
|
|
|
/// The window needs to be redrawn.
|
|
|
|
Refresh,
|
2015-06-05 23:38:21 +10:00
|
|
|
|
|
|
|
/// Touch event has been received
|
2017-09-16 00:24:09 +10:00
|
|
|
Touch(Touch),
|
2015-06-05 23:38:21 +10:00
|
|
|
}
|
|
|
|
|
2017-04-23 06:52:35 +10:00
|
|
|
/// Represents raw hardware events that are not associated with any particular window.
|
|
|
|
///
|
|
|
|
/// Useful for interactions that diverge significantly from a conventional 2D GUI, such as 3D camera or first-person
|
|
|
|
/// game controls. Many physical actions, such as mouse movement, can produce both device and window events. Because
|
|
|
|
/// window events typically arise from virtual devices (corresponding to GUI cursors and keyboard focus) the device IDs
|
|
|
|
/// may not match.
|
|
|
|
///
|
|
|
|
/// Note that these events are delivered regardless of input focus.
|
|
|
|
#[derive(Clone, Debug)]
|
|
|
|
pub enum DeviceEvent {
|
|
|
|
Added,
|
|
|
|
Removed,
|
|
|
|
Motion { axis: AxisId, value: f64 },
|
|
|
|
Button { button: ButtonId, state: ElementState },
|
|
|
|
Key(KeyboardInput),
|
|
|
|
Text { codepoint: char },
|
|
|
|
}
|
|
|
|
|
2017-09-25 23:58:59 +10:00
|
|
|
/// Describes a keyboard input event.
|
2017-04-23 06:52:35 +10:00
|
|
|
#[derive(Debug, Clone, Copy)]
|
|
|
|
pub struct KeyboardInput {
|
|
|
|
/// Identifies the physical key pressed
|
|
|
|
///
|
|
|
|
/// This should not change if the user adjusts the host's keyboard map. Use when the physical location of the
|
|
|
|
/// key is more important than the key's host GUI semantics, such as for movement controls in a first-person
|
|
|
|
/// game.
|
|
|
|
pub scancode: ScanCode,
|
|
|
|
|
|
|
|
pub state: ElementState,
|
|
|
|
|
|
|
|
/// Identifies the semantic meaning of the key
|
|
|
|
///
|
|
|
|
/// Use when the semantics of the key are more important than the physical location of the key, such as when
|
|
|
|
/// implementing appropriate behavior for "page up."
|
|
|
|
pub virtual_keycode: Option<VirtualKeyCode>,
|
|
|
|
|
|
|
|
/// Modifier keys active at the time of this input.
|
|
|
|
///
|
|
|
|
/// This is tracked internally to avoid tracking errors arising from modifier key state changes when events from
|
|
|
|
/// this device are not being delivered to the application, e.g. due to keyboard focus being elsewhere.
|
|
|
|
pub modifiers: ModifiersState
|
|
|
|
}
|
|
|
|
|
2017-09-25 23:58:59 +10:00
|
|
|
/// Describes touch-screen input state.
|
2015-06-05 23:38:21 +10:00
|
|
|
#[derive(Debug, Hash, PartialEq, Eq, Clone, Copy)]
|
|
|
|
pub enum TouchPhase {
|
|
|
|
Started,
|
|
|
|
Moved,
|
|
|
|
Ended,
|
|
|
|
Cancelled
|
|
|
|
}
|
|
|
|
|
|
|
|
/// Represents touch event
|
|
|
|
///
|
|
|
|
/// Every time user touches screen new Start event with some finger id is generated.
|
|
|
|
/// When the finger is removed from the screen End event with same id is generated.
|
|
|
|
///
|
|
|
|
/// For every id there will be at least 2 events with phases Start and End (or Cancelled).
|
|
|
|
/// There may be 0 or more Move events.
|
|
|
|
///
|
|
|
|
///
|
|
|
|
/// Depending on platform implementation id may or may not be reused by system after End event.
|
|
|
|
///
|
|
|
|
/// Gesture regonizer using this event should assume that Start event received with same id
|
|
|
|
/// as previously received End event is a new finger and has nothing to do with an old one.
|
|
|
|
///
|
|
|
|
/// Touch may be cancelled if for example window lost focus.
|
2017-09-25 23:58:59 +10:00
|
|
|
#[derive(Debug, Clone, Copy)]
|
2015-06-05 23:38:21 +10:00
|
|
|
pub struct Touch {
|
2017-04-23 06:52:35 +10:00
|
|
|
pub device_id: DeviceId,
|
2015-06-05 23:38:21 +10:00
|
|
|
pub phase: TouchPhase,
|
|
|
|
pub location: (f64,f64),
|
|
|
|
/// unique identifier of a finger.
|
|
|
|
pub id: u64
|
2014-08-14 01:04:57 +10:00
|
|
|
}
|
|
|
|
|
2017-09-25 23:58:59 +10:00
|
|
|
/// Hardware-dependent keyboard scan code.
|
2017-04-23 06:52:35 +10:00
|
|
|
pub type ScanCode = u32;
|
2014-08-14 01:04:57 +10:00
|
|
|
|
2017-07-01 19:20:13 +10:00
|
|
|
/// Identifier for a specific analog axis on some device.
|
|
|
|
pub type AxisId = u32;
|
|
|
|
|
|
|
|
/// Identifier for a specific button on some device.
|
|
|
|
pub type ButtonId = u32;
|
|
|
|
|
2017-09-25 23:58:59 +10:00
|
|
|
/// Describes the input state of a key.
|
2015-01-24 12:50:06 +11:00
|
|
|
#[derive(Debug, Hash, PartialEq, Eq, Clone, Copy)]
|
2014-08-14 01:04:57 +10:00
|
|
|
pub enum ElementState {
|
|
|
|
Pressed,
|
|
|
|
Released,
|
|
|
|
}
|
2014-07-28 01:06:03 +10:00
|
|
|
|
2017-09-25 23:58:59 +10:00
|
|
|
/// Describes a button of a mouse controller.
|
2015-01-24 12:50:06 +11:00
|
|
|
#[derive(Debug, Hash, PartialEq, Eq, Clone, Copy)]
|
2014-08-14 01:04:57 +10:00
|
|
|
pub enum MouseButton {
|
2015-02-06 02:52:53 +11:00
|
|
|
Left,
|
|
|
|
Right,
|
|
|
|
Middle,
|
|
|
|
Other(u8),
|
2014-07-28 01:06:03 +10:00
|
|
|
}
|
|
|
|
|
2017-09-25 23:58:59 +10:00
|
|
|
/// Describes a difference in the mouse scroll wheel state.
|
2015-07-16 02:37:15 +10:00
|
|
|
#[derive(Debug, Clone, Copy, PartialEq)]
|
2015-06-13 00:32:11 +10:00
|
|
|
pub enum MouseScrollDelta {
|
|
|
|
/// Amount in lines or rows to scroll in the horizontal
|
|
|
|
/// and vertical directions.
|
|
|
|
///
|
|
|
|
/// Positive values indicate movement forward
|
2015-06-14 08:22:51 +10:00
|
|
|
/// (away from the user) or rightwards.
|
2015-06-13 00:32:11 +10:00
|
|
|
LineDelta(f32, f32),
|
|
|
|
/// Amount in pixels to scroll in the horizontal and
|
|
|
|
/// vertical direction.
|
|
|
|
///
|
|
|
|
/// Scroll events are expressed as a PixelDelta if
|
|
|
|
/// supported by the device (eg. a touchpad) and
|
|
|
|
/// platform.
|
|
|
|
PixelDelta(f32, f32)
|
|
|
|
}
|
|
|
|
|
2017-09-25 23:58:59 +10:00
|
|
|
/// Symbolic name for a keyboard key.
|
2015-01-24 12:50:06 +11:00
|
|
|
#[derive(Debug, Hash, PartialEq, Eq, Clone, Copy)]
|
2017-04-12 23:49:14 +10:00
|
|
|
#[repr(u32)]
|
2014-08-14 01:04:57 +10:00
|
|
|
pub enum VirtualKeyCode {
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '1' key over the letters.
|
2014-07-28 01:06:03 +10:00
|
|
|
Key1,
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '2' key over the letters.
|
2014-07-28 01:06:03 +10:00
|
|
|
Key2,
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '3' key over the letters.
|
2014-07-28 01:06:03 +10:00
|
|
|
Key3,
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '4' key over the letters.
|
2014-07-28 01:06:03 +10:00
|
|
|
Key4,
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '5' key over the letters.
|
2014-07-28 01:06:03 +10:00
|
|
|
Key5,
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '6' key over the letters.
|
2014-07-28 01:06:03 +10:00
|
|
|
Key6,
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '7' key over the letters.
|
2014-07-28 01:06:03 +10:00
|
|
|
Key7,
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '8' key over the letters.
|
2014-07-28 01:06:03 +10:00
|
|
|
Key8,
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '9' key over the letters.
|
2014-07-28 01:06:03 +10:00
|
|
|
Key9,
|
2014-11-06 23:26:42 +11:00
|
|
|
/// The '0' key over the 'O' and 'P' keys.
|
|
|
|
Key0,
|
|
|
|
|
2014-07-28 01:06:03 +10:00
|
|
|
A,
|
|
|
|
B,
|
|
|
|
C,
|
|
|
|
D,
|
|
|
|
E,
|
|
|
|
F,
|
2014-11-06 23:26:42 +11:00
|
|
|
G,
|
|
|
|
H,
|
|
|
|
I,
|
|
|
|
J,
|
|
|
|
K,
|
|
|
|
L,
|
|
|
|
M,
|
|
|
|
N,
|
|
|
|
O,
|
|
|
|
P,
|
|
|
|
Q,
|
|
|
|
R,
|
|
|
|
S,
|
|
|
|
T,
|
|
|
|
U,
|
|
|
|
V,
|
|
|
|
W,
|
|
|
|
X,
|
|
|
|
Y,
|
|
|
|
Z,
|
|
|
|
|
|
|
|
/// The Escape key, next to F1.
|
|
|
|
Escape,
|
|
|
|
|
2014-07-28 01:06:03 +10:00
|
|
|
F1,
|
|
|
|
F2,
|
|
|
|
F3,
|
|
|
|
F4,
|
|
|
|
F5,
|
|
|
|
F6,
|
|
|
|
F7,
|
|
|
|
F8,
|
|
|
|
F9,
|
|
|
|
F10,
|
|
|
|
F11,
|
|
|
|
F12,
|
|
|
|
F13,
|
|
|
|
F14,
|
|
|
|
F15,
|
2014-11-06 23:26:42 +11:00
|
|
|
|
|
|
|
/// Print Screen/SysRq.
|
|
|
|
Snapshot,
|
|
|
|
/// Scroll Lock.
|
|
|
|
Scroll,
|
|
|
|
/// Pause/Break key, next to Scroll lock.
|
|
|
|
Pause,
|
|
|
|
|
|
|
|
/// `Insert`, next to Backspace.
|
2014-07-28 01:06:03 +10:00
|
|
|
Insert,
|
2014-11-06 23:26:42 +11:00
|
|
|
Home,
|
|
|
|
Delete,
|
|
|
|
End,
|
|
|
|
PageDown,
|
|
|
|
PageUp,
|
|
|
|
|
|
|
|
Left,
|
|
|
|
Up,
|
|
|
|
Right,
|
|
|
|
Down,
|
|
|
|
|
|
|
|
/// The Backspace key, right over Enter.
|
|
|
|
// TODO: rename
|
|
|
|
Back,
|
|
|
|
/// The Enter key.
|
|
|
|
Return,
|
|
|
|
/// The space bar.
|
|
|
|
Space,
|
|
|
|
|
2016-07-05 09:20:18 +10:00
|
|
|
/// The "Compose" key on Linux.
|
|
|
|
Compose,
|
|
|
|
|
2014-11-06 23:26:42 +11:00
|
|
|
Numlock,
|
|
|
|
Numpad0,
|
|
|
|
Numpad1,
|
|
|
|
Numpad2,
|
|
|
|
Numpad3,
|
|
|
|
Numpad4,
|
|
|
|
Numpad5,
|
|
|
|
Numpad6,
|
|
|
|
Numpad7,
|
|
|
|
Numpad8,
|
|
|
|
Numpad9,
|
|
|
|
|
|
|
|
AbntC1,
|
|
|
|
AbntC2,
|
|
|
|
Add,
|
|
|
|
Apostrophe,
|
|
|
|
Apps,
|
|
|
|
At,
|
|
|
|
Ax,
|
|
|
|
Backslash,
|
|
|
|
Calculator,
|
|
|
|
Capital,
|
|
|
|
Colon,
|
|
|
|
Comma,
|
|
|
|
Convert,
|
|
|
|
Decimal,
|
|
|
|
Divide,
|
|
|
|
Equals,
|
|
|
|
Grave,
|
2014-07-28 01:06:03 +10:00
|
|
|
Kana,
|
|
|
|
Kanji,
|
2014-10-24 03:01:09 +11:00
|
|
|
LAlt,
|
2014-10-15 20:49:10 +11:00
|
|
|
LBracket,
|
2014-07-28 01:06:03 +10:00
|
|
|
LControl,
|
|
|
|
LMenu,
|
|
|
|
LShift,
|
|
|
|
LWin,
|
|
|
|
Mail,
|
|
|
|
MediaSelect,
|
|
|
|
MediaStop,
|
|
|
|
Minus,
|
|
|
|
Multiply,
|
|
|
|
Mute,
|
|
|
|
MyComputer,
|
2016-02-27 20:59:06 +11:00
|
|
|
NavigateForward, // also called "Prior"
|
|
|
|
NavigateBackward, // also called "Next"
|
2014-07-28 01:06:03 +10:00
|
|
|
NextTrack,
|
|
|
|
NoConvert,
|
|
|
|
NumpadComma,
|
|
|
|
NumpadEnter,
|
|
|
|
NumpadEquals,
|
|
|
|
OEM102,
|
|
|
|
Period,
|
2015-07-02 17:52:44 +10:00
|
|
|
PlayPause,
|
2014-07-28 01:06:03 +10:00
|
|
|
Power,
|
2015-07-02 17:52:44 +10:00
|
|
|
PrevTrack,
|
2014-10-24 03:01:09 +11:00
|
|
|
RAlt,
|
2014-07-28 01:06:03 +10:00
|
|
|
RBracket,
|
|
|
|
RControl,
|
|
|
|
RMenu,
|
|
|
|
RShift,
|
|
|
|
RWin,
|
|
|
|
Semicolon,
|
|
|
|
Slash,
|
|
|
|
Sleep,
|
|
|
|
Stop,
|
|
|
|
Subtract,
|
|
|
|
Sysrq,
|
|
|
|
Tab,
|
|
|
|
Underline,
|
|
|
|
Unlabeled,
|
|
|
|
VolumeDown,
|
|
|
|
VolumeUp,
|
|
|
|
Wake,
|
2015-07-02 17:52:44 +10:00
|
|
|
WebBack,
|
2014-07-28 01:06:03 +10:00
|
|
|
WebFavorites,
|
|
|
|
WebForward,
|
|
|
|
WebHome,
|
|
|
|
WebRefresh,
|
|
|
|
WebSearch,
|
|
|
|
WebStop,
|
|
|
|
Yen,
|
2014-07-27 20:59:45 +10:00
|
|
|
}
|
2017-01-18 05:01:10 +11:00
|
|
|
|
|
|
|
/// Represents the current state of the keyboard modifiers
|
|
|
|
///
|
|
|
|
/// Each field of this struct represents a modifier and is `true` if this modifier is active.
|
|
|
|
#[derive(Default, Debug, Clone, Copy)]
|
|
|
|
pub struct ModifiersState {
|
|
|
|
/// The "shift" key
|
|
|
|
pub shift: bool,
|
|
|
|
/// The "control" key
|
|
|
|
pub ctrl: bool,
|
|
|
|
/// The "alt" key
|
|
|
|
pub alt: bool,
|
|
|
|
/// The "logo" key
|
|
|
|
///
|
|
|
|
/// This is the "windows" key on PC and "command" key on Mac.
|
|
|
|
pub logo: bool
|
|
|
|
}
|