Enum Event

pub enum Event {
    Quit {
        timestamp: u64,
    },
    AppTerminating {
        timestamp: u64,
    },
    AppLowMemory {
        timestamp: u64,
    },
    AppWillEnterBackground {
        timestamp: u64,
    },
    AppDidEnterBackground {
        timestamp: u64,
    },
    AppWillEnterForeground {
        timestamp: u64,
    },
    AppDidEnterForeground {
        timestamp: u64,
    },
    Window {
        timestamp: u64,
        window_id: u32,
        win_event: WindowEvent,
    },
    KeyDown {
        timestamp: u64,
        window_id: u32,
        keycode: Option<Keycode>,
        scancode: Option<Scancode>,
        keymod: Mod,
        repeat: bool,
        which: u32,
        raw: u16,
    },
    KeyUp {
        timestamp: u64,
        window_id: u32,
        keycode: Option<Keycode>,
        scancode: Option<Scancode>,
        keymod: Mod,
        repeat: bool,
        which: u32,
        raw: u16,
    },
    TextEditing {
        timestamp: u64,
        window_id: u32,
        text: String,
        start: i32,
        length: i32,
    },
    TextInput {
        timestamp: u64,
        window_id: u32,
        text: String,
    },
    MouseMotion {
        timestamp: u64,
        window_id: u32,
        which: u32,
        mousestate: MouseState,
        x: f32,
        y: f32,
        xrel: f32,
        yrel: f32,
    },
    MouseButtonDown {
        timestamp: u64,
        window_id: u32,
        which: u32,
        mouse_btn: MouseButton,
        clicks: u8,
        x: f32,
        y: f32,
    },
    MouseButtonUp {
        timestamp: u64,
        window_id: u32,
        which: u32,
        mouse_btn: MouseButton,
        clicks: u8,
        x: f32,
        y: f32,
    },
    MouseWheel {
        timestamp: u64,
        window_id: u32,
        which: u32,
        x: f32,
        y: f32,
        direction: MouseWheelDirection,
        mouse_x: f32,
        mouse_y: f32,
    },
    JoyAxisMotion {
        timestamp: u64,
        which: u32,
        axis_idx: u8,
        value: i16,
    },
    JoyHatMotion {
        timestamp: u64,
        which: u32,
        hat_idx: u8,
        state: HatState,
    },
    JoyButtonDown {
        timestamp: u64,
        which: u32,
        button_idx: u8,
    },
    JoyButtonUp {
        timestamp: u64,
        which: u32,
        button_idx: u8,
    },
    JoyDeviceAdded {
        timestamp: u64,
        which: u32,
    },
    JoyDeviceRemoved {
        timestamp: u64,
        which: u32,
    },
    ControllerAxisMotion {
        timestamp: u64,
        which: u32,
        axis: Axis,
        value: i16,
    },
    ControllerButtonDown {
        timestamp: u64,
        which: u32,
        button: Button,
    },
    ControllerButtonUp {
        timestamp: u64,
        which: u32,
        button: Button,
    },
    ControllerDeviceAdded {
        timestamp: u64,
        which: u32,
    },
    ControllerDeviceRemoved {
        timestamp: u64,
        which: u32,
    },
    ControllerDeviceRemapped {
        timestamp: u64,
        which: u32,
    },
    ControllerTouchpadDown {
        timestamp: u64,
        which: u32,
        touchpad: i32,
        finger: i32,
        x: f32,
        y: f32,
        pressure: f32,
    },
    ControllerTouchpadMotion {
        timestamp: u64,
        which: u32,
        touchpad: i32,
        finger: i32,
        x: f32,
        y: f32,
        pressure: f32,
    },
    ControllerTouchpadUp {
        timestamp: u64,
        which: u32,
        touchpad: i32,
        finger: i32,
        x: f32,
        y: f32,
        pressure: f32,
    },
    FingerDown {
        timestamp: u64,
        touch_id: u64,
        finger_id: u64,
        x: f32,
        y: f32,
        dx: f32,
        dy: f32,
        pressure: f32,
    },
    FingerUp {
        timestamp: u64,
        touch_id: u64,
        finger_id: u64,
        x: f32,
        y: f32,
        dx: f32,
        dy: f32,
        pressure: f32,
    },
    FingerMotion {
        timestamp: u64,
        touch_id: u64,
        finger_id: u64,
        x: f32,
        y: f32,
        dx: f32,
        dy: f32,
        pressure: f32,
    },
    DollarRecord {
        timestamp: u64,
        touch_id: i64,
        gesture_id: i64,
        num_fingers: u32,
        error: f32,
        x: f32,
        y: f32,
    },
    MultiGesture {
        timestamp: u64,
        touch_id: i64,
        d_theta: f32,
        d_dist: f32,
        x: f32,
        y: f32,
        num_fingers: u16,
    },
    ClipboardUpdate {
        timestamp: u64,
    },
    DropFile {
        timestamp: u64,
        window_id: u32,
        filename: String,
    },
    DropText {
        timestamp: u64,
        window_id: u32,
        filename: String,
    },
    DropBegin {
        timestamp: u64,
        window_id: u32,
    },
    DropComplete {
        timestamp: u64,
        window_id: u32,
    },
    AudioDeviceAdded {
        timestamp: u64,
        which: u32,
        iscapture: bool,
    },
    AudioDeviceRemoved {
        timestamp: u64,
        which: u32,
        iscapture: bool,
    },
    RenderTargetsReset {
        timestamp: u64,
    },
    RenderDeviceReset {
        timestamp: u64,
    },
    User {
        timestamp: u64,
        window_id: u32,
        type_: u32,
        code: i32,
        data1: *mut c_void,
        data2: *mut c_void,
    },
    Unknown {
        timestamp: u64,
        type_: u32,
    },
    Display {
        timestamp: u64,
        display: Display,
        display_event: DisplayEvent,
    },
}

Available on crate feature dep_sdl3 only.

Different event types.

Variants

Quit

Fields

timestamp: u64

AppTerminating

Fields

timestamp: u64

AppLowMemory

Fields

timestamp: u64

AppWillEnterBackground

Fields

timestamp: u64

AppDidEnterBackground

Fields

timestamp: u64

AppWillEnterForeground

Fields

timestamp: u64

AppDidEnterForeground

Fields

timestamp: u64

Window

Fields

timestamp: u64

window_id: u32

win_event: WindowEvent

KeyDown

Fields

timestamp: u64

window_id: u32

keycode: Option<Keycode>

scancode: Option<Scancode>

keymod: Mod

repeat: bool

which: u32

raw: u16

KeyUp

Fields

timestamp: u64

window_id: u32

keycode: Option<Keycode>

scancode: Option<Scancode>

keymod: Mod

repeat: bool

which: u32

raw: u16

TextEditing

Fields

timestamp: u64

window_id: u32

text: String

start: i32

length: i32

TextInput

Fields

timestamp: u64

window_id: u32

text: String

MouseMotion

Fields

timestamp: u64

window_id: u32

which: u32

mousestate: MouseState

x: f32

y: f32

xrel: f32

yrel: f32

MouseButtonDown

Fields

timestamp: u64

window_id: u32

which: u32

mouse_btn: MouseButton

clicks: u8

x: f32

y: f32

MouseButtonUp

Fields

timestamp: u64

window_id: u32

which: u32

mouse_btn: MouseButton

clicks: u8

x: f32

y: f32

MouseWheel

Fields

timestamp: u64

window_id: u32

which: u32

x: f32

y: f32

direction: MouseWheelDirection

mouse_x: f32

mouse_y: f32

JoyAxisMotion

Fields

timestamp: u64

which: u32

The joystick’s id

axis_idx: u8

value: i16

JoyHatMotion

Fields

timestamp: u64

which: u32

The joystick’s id

hat_idx: u8

state: HatState

JoyButtonDown

Fields

timestamp: u64

which: u32

The joystick’s id

button_idx: u8

JoyButtonUp

Fields

timestamp: u64

which: u32

The joystick’s id

button_idx: u8

JoyDeviceAdded

Fields

timestamp: u64

which: u32

The newly added joystick’s joystick_index

JoyDeviceRemoved

Fields

timestamp: u64

which: u32

The joystick’s id

ControllerAxisMotion

Fields

timestamp: u64

which: u32

The controller’s joystick id

axis: Axis

value: i16

ControllerButtonDown

Fields

timestamp: u64

which: u32

The controller’s joystick id

button: Button

ControllerButtonUp

Fields

timestamp: u64

which: u32

The controller’s joystick id

button: Button

ControllerDeviceAdded

Fields

timestamp: u64

which: u32

The newly added controller’s joystick_index

ControllerDeviceRemoved

Fields

timestamp: u64

which: u32

The controller’s joystick id

ControllerDeviceRemapped

Fields

timestamp: u64

which: u32

The controller’s joystick id

ControllerTouchpadDown

Fields

timestamp: u64

which: u32

The joystick instance id

touchpad: i32

The index of the touchpad

finger: i32

The index of the finger on the touchpad

x: f32

Normalized in the range 0…1 with 0 being on the left

y: f32

Normalized in the range 0…1 with 0 being at the top

pressure: f32

Normalized in the range 0…1

ControllerTouchpadMotion

Fields

timestamp: u64

which: u32

The joystick instance id

touchpad: i32

The index of the touchpad

finger: i32

The index of the finger on the touchpad

x: f32

Normalized in the range 0…1 with 0 being on the left

y: f32

Normalized in the range 0…1 with 0 being at the top

pressure: f32

Normalized in the range 0…1

ControllerTouchpadUp

Fields

timestamp: u64

which: u32

The joystick instance id

touchpad: i32

The index of the touchpad

finger: i32

The index of the finger on the touchpad

x: f32

Normalized in the range 0…1 with 0 being on the left

y: f32

Normalized in the range 0…1 with 0 being at the top

pressure: f32

Normalized in the range 0…1

FingerDown

Fields

timestamp: u64

touch_id: u64

finger_id: u64

x: f32

y: f32

dx: f32

dy: f32

pressure: f32

FingerUp

Fields

timestamp: u64

touch_id: u64

finger_id: u64

x: f32

y: f32

dx: f32

dy: f32

pressure: f32

FingerMotion

Fields

timestamp: u64

touch_id: u64

finger_id: u64

x: f32

y: f32

dx: f32

dy: f32

pressure: f32

DollarRecord

Fields

timestamp: u64

touch_id: i64

gesture_id: i64

num_fingers: u32

error: f32

x: f32

y: f32

MultiGesture

Fields

timestamp: u64

touch_id: i64

d_theta: f32

d_dist: f32

x: f32

y: f32

num_fingers: u16

ClipboardUpdate

Fields

timestamp: u64

DropFile

Fields

timestamp: u64

window_id: u32

filename: String

DropText

Fields

timestamp: u64

window_id: u32

filename: String

DropBegin

Fields

timestamp: u64

window_id: u32

DropComplete

Fields

timestamp: u64

window_id: u32

AudioDeviceAdded

Fields

timestamp: u64

which: u32

iscapture: bool

AudioDeviceRemoved

Fields

timestamp: u64

which: u32

iscapture: bool

RenderTargetsReset

Fields

timestamp: u64

RenderDeviceReset

Fields

timestamp: u64

User

Fields

timestamp: u64

window_id: u32

type_: u32

code: i32

data1: *mut c_void

data2: *mut c_void

Unknown

Fields

timestamp: u64

type_: u32

Display

Fields

timestamp: u64

display: Display

display_event: DisplayEvent

Implementations

impl Event

pub fn from_ll(raw: SDL_Event) -> Event

pub fn is_user_event(&self) -> bool

pub fn as_user_event_type<T>(&self) -> Option<T>

where T: Any,

pub fn is_same_kind_as(&self, other: &Event) -> bool

Returns true if they are the same “kind” of events.

Example:

use sdl3::event::Event;

let ev1 = Event::JoyButtonDown {
    timestamp: 0,
    which: 0,
    button_idx: 0,
};
let ev2 = Event::JoyButtonDown {
    timestamp: 1,
    which: 1,
    button_idx: 1,
};

assert!(ev1 != ev2); // The events aren't equal (they contain different values).
assert!(ev1.is_same_kind_as(&ev2)); // But they are of the same kind!

pub fn get_timestamp(&self) -> u64

Returns the timestamp field of the event.

Example

use sdl3::event::Event;

let ev = Event::JoyButtonDown {
    timestamp: 12,
    which: 0,
    button_idx: 0,
};
assert!(ev.get_timestamp() == 12);

pub fn get_window_id(&self) -> Option<u32>

Returns the window_id field of the event if it’s present (not all events have it!).

Example

use sdl3::event::Event;

let ev = Event::JoyButtonDown {
    timestamp: 0,
    which: 0,
    button_idx: 0,
};
assert!(ev.get_window_id() == None);

let another_ev = Event::DropBegin {
    timestamp: 0,
    window_id: 3,
};
assert!(another_ev.get_window_id() == Some(3));

pub fn is_window(&self) -> bool

Returns true if this is a window event.

Example

use sdl3::event::Event;

let ev = Event::Quit {
    timestamp: 0,
};
assert!(ev.is_window());

let ev = Event::AppLowMemory {
    timestamp: 0,
};
assert!(ev.is_window());

let another_ev = Event::TextInput {
    timestamp: 0,
    window_id: 0,
    text: String::new(),
};
assert!(another_ev.is_window() == false); // Not a window event!

pub fn is_keyboard(&self) -> bool

Returns true if this is a keyboard event.

Example

use sdl3::event::Event;
use sdl3::keyboard::Mod;

let ev = Event::KeyDown {
    timestamp: 0,
    window_id: 0,
    keycode: None,
    scancode: None,
    keymod: Mod::empty(),
    repeat: false,
    which: 0,
    raw: 0,
};
assert!(ev.is_keyboard());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_keyboard() == false); // Not a keyboard event!

pub fn is_text(&self) -> bool

Returns true if this is a text event.

Example

use sdl3::event::Event;

let ev = Event::TextInput {
    timestamp: 0,
    window_id: 0,
    text: String::new(),
};
assert!(ev.is_text());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_text() == false); // Not a text event!

pub fn is_mouse(&self) -> bool

Returns true if this is a mouse event.

Example

use sdl3::event::Event;
use sdl3::mouse::MouseWheelDirection;

let ev = Event::MouseWheel {
    timestamp: 0,
    window_id: 0,
    which: 0,
    mouse_x: 0.0,
    mouse_y: 0.0,
    x: 0.0,
    y: 0.0,
    direction: MouseWheelDirection::Normal,
};
assert!(ev.is_mouse());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_mouse() == false); // Not a mouse event!

pub fn is_controller(&self) -> bool

Returns true if this is a controller event.

Example

use sdl3::event::Event;

let ev = Event::ControllerDeviceAdded {
    timestamp: 0,
    which: 0,
};
assert!(ev.is_controller());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_controller() == false); // Not a controller event!

pub fn is_joy(&self) -> bool

Returns true if this is a joy event.

Example

use sdl3::event::Event;

let ev = Event::JoyButtonUp {
    timestamp: 0,
    which: 0,
    button_idx: 0,
};
assert!(ev.is_joy());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_joy() == false); // Not a joy event!

pub fn is_finger(&self) -> bool

Returns true if this is a finger event.

Example

use sdl3::event::Event;

let ev = Event::FingerMotion {
    timestamp: 0,
    touch_id: 0,
    finger_id: 0,
    x: 0.,
    y: 0.,
    dx: 0.,
    dy: 0.,
    pressure: 0.,
};
assert!(ev.is_finger());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_finger() == false); // Not a finger event!

pub fn is_drop(&self) -> bool

Returns true if this is a drop event.

Example

use sdl3::event::Event;

let ev = Event::DropBegin {
    timestamp: 0,
    window_id: 3,
};
assert!(ev.is_drop());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_drop() == false); // Not a drop event!

pub fn is_audio(&self) -> bool

Returns true if this is an audio event.

Example

use sdl3::event::Event;

let ev = Event::AudioDeviceAdded {
    timestamp: 0,
    which: 3,
    iscapture: false,
};
assert!(ev.is_audio());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_audio() == false); // Not an audio event!

pub fn is_render(&self) -> bool

Returns true if this is a render event.

Example

use sdl3::event::Event;

let ev = Event::RenderTargetsReset {
    timestamp: 0,
};
assert!(ev.is_render());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_render() == false); // Not a render event!

pub fn is_user(&self) -> bool

Returns true if this is a user event.

Example

use sdl3::event::Event;

let ev = Event::User {
    timestamp: 0,
    window_id: 0,
    type_: 0,
    code: 0,
    data1: ::std::ptr::null_mut(),
    data2: ::std::ptr::null_mut(),
};
assert!(ev.is_user());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_user() == false); // Not a user event!

pub fn is_unknown(&self) -> bool

Returns true if this is an unknown event.

Example

use sdl3::event::Event;

let ev = Event::Unknown {
    timestamp: 0,
    type_: 0,
};
assert!(ev.is_unknown());

let another_ev = Event::Quit {
    timestamp: 0,
};
assert!(another_ev.is_unknown() == false); // Not an unknown event!

pub fn get_converted_coords<T>(&self, canvas: &Canvas<T>) -> Option<Event>

where T: RenderTarget,

pub fn convert_coords<T>(&mut self, canvas: &Canvas<T>) -> bool

where T: RenderTarget,

Trait Implementations

impl Clone for Event

fn clone(&self) -> Event

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Event

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl PartialEq for Event

fn eq(&self, other: &Event) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Send for Event

This does not auto-derive because User’s data fields can be used to store pointers to types that are !Send. Dereferencing these as pointers requires using unsafe and ensuring your own safety guarantees.

impl StructuralPartialEq for Event

impl Sync for Event

This does not auto-derive because User’s data fields can be used to store pointers to types that are !Sync. Dereferencing these as pointers requires using unsafe and ensuring your own safety guarantees.