SDL_EventType(3type)

SDL_EventType(3type) 💅✨

SDL3 DATATYPES — yeah bestie, that's the little corner of the manual this one lives in.

Okay so. Sit down, grab a snack 🍓, because this page is the master list of every single event type SDL can hand you. Like, the whole menu. Every vibe your app can get pinged with. And it is LONG, so we're doing it in two parts — this is part one. No skipping, no skimming, we're getting every constant and every number. Periodt. 💖

---

💖 NAME 💖

SDL_EventType — the types of events that can be delivered. 🌈

Like, that's it. That's the whole name section. The entire roster of things that can show up in your event loop and go "hey. hey. bestie. something happened." 👑

---

🌸 SYNOPSIS 🌸

First things first, you gotta pull in the header:

#include <SDL3/SDL_events.h>

typedef enum SDL_EventType
{
    SDL_EVENT_FIRST     = 0,     /**< Unused (do not remove) */

    /* Application events */
    SDL_EVENT_QUIT           = 0x100, /**< User-requested quit */

    /* These application events have special meaning on iOS and Android, see README-ios.md and README-android.md for details */
    SDL_EVENT_TERMINATING,      /**< The application is being terminated by the OS. This event must be handled in a callback set with SDL_AddEventWatch().
                                     Called on iOS in applicationWillTerminate()
                                     Called on Android in onDestroy()
                                */
    SDL_EVENT_LOW_MEMORY,       /**< The application is low on memory, free memory if possible. This event must be handled in a callback set with SDL_AddEventWatch().
                                     Called on iOS in applicationDidReceiveMemoryWarning()
                                     Called on Android in onTrimMemory()
                                */
    SDL_EVENT_WILL_ENTER_BACKGROUND, /**< The application is about to enter the background. This event must be handled in a callback set with SDL_AddEventWatch().
                                     Called on iOS in applicationWillResignActive()
                                     Called on Android in onPause()
                                */
    SDL_EVENT_DID_ENTER_BACKGROUND, /**< The application did enter the background and may not get CPU for some time. This event must be handled in a callback set with SDL_AddEventWatch().
                                     Called on iOS in applicationDidEnterBackground()
                                     Called on Android in onPause()
                                */
    SDL_EVENT_WILL_ENTER_FOREGROUND, /**< The application is about to enter the foreground. This event must be handled in a callback set with SDL_AddEventWatch().
                                     Called on iOS in applicationWillEnterForeground()
                                     Called on Android in onResume()
                                */
    SDL_EVENT_DID_ENTER_FOREGROUND, /**< The application is now interactive. This event must be handled in a callback set with SDL_AddEventWatch().
                                     Called on iOS in applicationDidBecomeActive()
                                     Called on Android in onResume()
                                */

    SDL_EVENT_LOCALE_CHANGED,  /**< The user's locale preferences have changed. */

    SDL_EVENT_SYSTEM_THEME_CHANGED, /**< The system theme changed */

    /* Display events */
    /* 0x150 was SDL_DISPLAYEVENT, reserve the number for sdl2-compat */
    SDL_EVENT_DISPLAY_ORIENTATION = 0x151,   /**< Display orientation has changed to data1 */
    SDL_EVENT_DISPLAY_ADDED,                 /**< Display has been added to the system */
    SDL_EVENT_DISPLAY_REMOVED,               /**< Display has been removed from the system */
    SDL_EVENT_DISPLAY_MOVED,                 /**< Display has changed position */
    SDL_EVENT_DISPLAY_DESKTOP_MODE_CHANGED,  /**< Display has changed desktop mode */
    SDL_EVENT_DISPLAY_CURRENT_MODE_CHANGED,  /**< Display has changed current mode */
    SDL_EVENT_DISPLAY_CONTENT_SCALE_CHANGED, /**< Display has changed content scale */
    SDL_EVENT_DISPLAY_USABLE_BOUNDS_CHANGED, /**< Display has changed usable bounds */
    SDL_EVENT_DISPLAY_FIRST = SDL_EVENT_DISPLAY_ORIENTATION,
    SDL_EVENT_DISPLAY_LAST = SDL_EVENT_DISPLAY_USABLE_BOUNDS_CHANGED,

    /* Window events */
    /* 0x200 was SDL_WINDOWEVENT, reserve the number for sdl2-compat */
    /* 0x201 was SDL_SYSWMEVENT, reserve the number for sdl2-compat */
    SDL_EVENT_WINDOW_SHOWN = 0x202,     /**< Window has been shown */
    SDL_EVENT_WINDOW_HIDDEN,            /**< Window has been hidden */
    SDL_EVENT_WINDOW_EXPOSED,           /**< Window has been exposed and should be redrawn, and can be redrawn directly from event watchers for this event.
                                             data1 is 1 for live-resize expose events, 0 otherwise. */
    SDL_EVENT_WINDOW_MOVED,             /**< Window has been moved to data1, data2 */
    SDL_EVENT_WINDOW_RESIZED,           /**< Window has been resized to data1xdata2 */
    SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED,/**< The pixel size of the window has changed to data1xdata2 */
    SDL_EVENT_WINDOW_METAL_VIEW_RESIZED,/**< The pixel size of a Metal view associated with the window has changed */
    SDL_EVENT_WINDOW_MINIMIZED,         /**< Window has been minimized */
    SDL_EVENT_WINDOW_MAXIMIZED,         /**< Window has been maximized */
    SDL_EVENT_WINDOW_RESTORED,          /**< Window has been restored to normal size and position */
    SDL_EVENT_WINDOW_MOUSE_ENTER,       /**< Window has gained mouse focus */
    SDL_EVENT_WINDOW_MOUSE_LEAVE,       /**< Window has lost mouse focus */
    SDL_EVENT_WINDOW_FOCUS_GAINED,      /**< Window has gained keyboard focus */
    SDL_EVENT_WINDOW_FOCUS_LOST,        /**< Window has lost keyboard focus */
    SDL_EVENT_WINDOW_CLOSE_REQUESTED,   /**< The window manager requests that the window be closed */
    SDL_EVENT_WINDOW_HIT_TEST,          /**< Window had a hit test that wasn't SDL_HITTEST_NORMAL */
    SDL_EVENT_WINDOW_ICCPROF_CHANGED,   /**< The ICC profile of the window's display has changed */
    SDL_EVENT_WINDOW_DISPLAY_CHANGED,   /**< Window has been moved to display data1 */
    SDL_EVENT_WINDOW_DISPLAY_SCALE_CHANGED, /**< Window display scale has been changed */
    SDL_EVENT_WINDOW_SAFE_AREA_CHANGED, /**< The window safe area has been changed */
    SDL_EVENT_WINDOW_OCCLUDED,          /**< The window has been occluded */
    SDL_EVENT_WINDOW_ENTER_FULLSCREEN,  /**< The window has entered fullscreen mode */
    SDL_EVENT_WINDOW_LEAVE_FULLSCREEN,  /**< The window has left fullscreen mode */
    SDL_EVENT_WINDOW_DESTROYED,         /**< The window with the associated ID is being or has been destroyed. If this message is being handled
                                             in an event watcher, the window handle is still valid and can still be used to retrieve any properties
                                             associated with the window. Otherwise, the handle has already been destroyed and all resources
                                             associated with it are invalid */
    SDL_EVENT_WINDOW_HDR_STATE_CHANGED, /**< Window HDR properties have changed */
    SDL_EVENT_WINDOW_FIRST = SDL_EVENT_WINDOW_SHOWN,
    SDL_EVENT_WINDOW_LAST = SDL_EVENT_WINDOW_HDR_STATE_CHANGED,

    /* Keyboard events */
    SDL_EVENT_KEY_DOWN        = 0x300, /**< Key pressed */
    SDL_EVENT_KEY_UP,                  /**< Key released */
    SDL_EVENT_TEXT_EDITING,            /**< Keyboard text editing (composition) */
    SDL_EVENT_TEXT_INPUT,              /**< Keyboard text input */
    SDL_EVENT_KEYMAP_CHANGED,          /**< Keymap changed due to a system event such as an
                                            input language or keyboard layout change. */
    SDL_EVENT_KEYBOARD_ADDED,          /**< A new keyboard has been inserted into the system */
    SDL_EVENT_KEYBOARD_REMOVED,        /**< A keyboard has been removed */
    SDL_EVENT_TEXT_EDITING_CANDIDATES, /**< Keyboard text editing candidates */
    SDL_EVENT_SCREEN_KEYBOARD_SHOWN,   /**< The on-screen keyboard has been shown */
    SDL_EVENT_SCREEN_KEYBOARD_HIDDEN,  /**< The on-screen keyboard has been hidden */

    /* Mouse events */
    SDL_EVENT_MOUSE_MOTION    = 0x400, /**< Mouse moved */
    SDL_EVENT_MOUSE_BUTTON_DOWN,       /**< Mouse button pressed */
    SDL_EVENT_MOUSE_BUTTON_UP,         /**< Mouse button released */
    SDL_EVENT_MOUSE_WHEEL,             /**< Mouse wheel motion */
    SDL_EVENT_MOUSE_ADDED,             /**< A new mouse has been inserted into the system */
    SDL_EVENT_MOUSE_REMOVED,           /**< A mouse has been removed */

    /* Joystick events */
    SDL_EVENT_JOYSTICK_AXIS_MOTION  = 0x600, /**< Joystick axis motion */
    SDL_EVENT_JOYSTICK_BALL_MOTION,          /**< Joystick trackball motion */
    SDL_EVENT_JOYSTICK_HAT_MOTION,           /**< Joystick hat position change */
    SDL_EVENT_JOYSTICK_BUTTON_DOWN,          /**< Joystick button pressed */
    SDL_EVENT_JOYSTICK_BUTTON_UP,            /**< Joystick button released */
    SDL_EVENT_JOYSTICK_ADDED,                /**< A new joystick has been inserted into the system */
    SDL_EVENT_JOYSTICK_REMOVED,              /**< An opened joystick has been removed */
    SDL_EVENT_JOYSTICK_BATTERY_UPDATED,      /**< Joystick battery level change */
    SDL_EVENT_JOYSTICK_UPDATE_COMPLETE,      /**< Joystick update is complete */

    /* Gamepad events */
    SDL_EVENT_GAMEPAD_AXIS_MOTION  = 0x650, /**< Gamepad axis motion */
    SDL_EVENT_GAMEPAD_BUTTON_DOWN,          /**< Gamepad button pressed */
    SDL_EVENT_GAMEPAD_BUTTON_UP,            /**< Gamepad button released */
    SDL_EVENT_GAMEPAD_ADDED,                /**< A new gamepad has been inserted into the system */
    SDL_EVENT_GAMEPAD_REMOVED,              /**< A gamepad has been removed */
    SDL_EVENT_GAMEPAD_REMAPPED,             /**< The gamepad mapping was updated */
    SDL_EVENT_GAMEPAD_TOUCHPAD_DOWN,        /**< Gamepad touchpad was touched */
    SDL_EVENT_GAMEPAD_TOUCHPAD_MOTION,      /**< Gamepad touchpad finger was moved */
    SDL_EVENT_GAMEPAD_TOUCHPAD_UP,          /**< Gamepad touchpad finger was lifted */
    SDL_EVENT_GAMEPAD_SENSOR_UPDATE,        /**< Gamepad sensor was updated */
    SDL_EVENT_GAMEPAD_UPDATE_COMPLETE,      /**< Gamepad update is complete */
    SDL_EVENT_GAMEPAD_STEAM_HANDLE_UPDATED,  /**< Gamepad Steam handle has changed */

    /* Touch events */
    SDL_EVENT_FINGER_DOWN      = 0x700,
    SDL_EVENT_FINGER_UP,
    SDL_EVENT_FINGER_MOTION,
    SDL_EVENT_FINGER_CANCELED,

    /* Pinch events */
    SDL_EVENT_PINCH_BEGIN      = 0x710,     /**< Pinch gesture started */
    SDL_EVENT_PINCH_UPDATE,                 /**< Pinch gesture updated */
    SDL_EVENT_PINCH_END,                    /**< Pinch gesture ended */

    /* 0x800, 0x801, and 0x802 were the Gesture events from SDL2. Do not reuse these values! sdl2-compat needs them! */

    /* Clipboard events */
    SDL_EVENT_CLIPBOARD_UPDATE = 0x900, /**< The clipboard changed */

    /* Drag and drop events */
    SDL_EVENT_DROP_FILE        = 0x1000, /**< The system requests a file open */
    SDL_EVENT_DROP_TEXT,                 /**< text/plain drag-and-drop event */
    SDL_EVENT_DROP_BEGIN,                /**< A new set of drops is beginning (NULL filename) */
    SDL_EVENT_DROP_COMPLETE,             /**< Current set of drops is now complete (NULL filename) */
    SDL_EVENT_DROP_POSITION,             /**< Position while moving over the window */

---

🎀 okay but what do these ALL mean bestie 🎀

Here's the tour, group by group, in the same order as the enum. Nothing skipped, nothing invented. 🫶

🫧 the "application" era

• SDL_EVENT_FIRST = 0 — literally unused, and the comment says do not remove. So don't. It's the load-bearing zero. 💀
• SDL_EVENT_QUIT = 0x100 — user-requested quit. Somebody wants out. 😭
• SDL_EVENT_TERMINATING — the OS is terminating your app. This one must be handled in a callback set with SDL_AddEventWatch(). On iOS it fires in applicationWillTerminate(), on Android in onDestroy().
• SDL_EVENT_LOW_MEMORY — you're low on memory, free some up if you can. Also must be handled in a callback set with SDL_AddEventWatch(). On iOS it's applicationDidReceiveMemoryWarning(), on Android it's onTrimMemory().
• SDL_EVENT_WILL_ENTER_BACKGROUND — you're about to go to the background. Must be handled in a callback set with SDL_AddEventWatch(). iOS: applicationWillResignActive(). Android: onPause().
• SDL_EVENT_DID_ENTER_BACKGROUND — you did enter the background and might not get CPU for a while. Must be handled in a callback set with SDL_AddEventWatch(). iOS: applicationDidEnterBackground(). Android: onPause().
• SDL_EVENT_WILL_ENTER_FOREGROUND — you're about to come back to the foreground. Must be handled in a callback set with SDL_AddEventWatch(). iOS: applicationWillEnterForeground(). Android: onResume().
• SDL_EVENT_DID_ENTER_FOREGROUND — you're now interactive. Must be handled in a callback set with SDL_AddEventWatch(). iOS: applicationDidBecomeActive(). Android: onResume().

Heads up bestie 💜 — that whole background/foreground/terminating/low-memory crew has special meaning on iOS and Android, and the manpage points you at README-ios.md and README-android.md for the details. Go read those. I'm serious.

• SDL_EVENT_LOCALE_CHANGED — the user's locale preferences changed. 🌍
• SDL_EVENT_SYSTEM_THEME_CHANGED — the system theme changed. 🌗

🖥️ display events

Reserved number alert: 0x150 was SDL_DISPLAYEVENT, and the number is reserved for sdl2-compat. Do not touch it, do not reuse it, it is not yours. 🙅‍♀️

• SDL_EVENT_DISPLAY_ORIENTATION = 0x151 — display orientation changed, and the new value is in data1.
• SDL_EVENT_DISPLAY_ADDED — a display got added to the system.
• SDL_EVENT_DISPLAY_REMOVED — a display got removed from the system.
• SDL_EVENT_DISPLAY_MOVED — a display changed position.
• SDL_EVENT_DISPLAY_DESKTOP_MODE_CHANGED — a display changed desktop mode.
• SDL_EVENT_DISPLAY_CURRENT_MODE_CHANGED — a display changed current mode.
• SDL_EVENT_DISPLAY_CONTENT_SCALE_CHANGED — a display changed content scale.
• SDL_EVENT_DISPLAY_USABLE_BOUNDS_CHANGED — a display changed usable bounds.
• SDL_EVENT_DISPLAY_FIRST = SDL_EVENT_DISPLAY_ORIENTATION — the first display event. Bookend #1. 🎀
• SDL_EVENT_DISPLAY_LAST = SDL_EVENT_DISPLAY_USABLE_BOUNDS_CHANGED — the last display event. Bookend #2.

🪟 window events

More reserved numbers, keep your hands to yourself: 0x200 was SDL_WINDOWEVENT and 0x201 was SDL_SYSWMEVENT, both reserved for sdl2-compat. 💀

• SDL_EVENT_WINDOW_SHOWN = 0x202 — the window has been shown.
• SDL_EVENT_WINDOW_HIDDEN — the window has been hidden.
• SDL_EVENT_WINDOW_EXPOSED — the window has been exposed and should be redrawn, and it can be redrawn directly from event watchers for this event. data1 is 1 for live-resize expose events, 0 otherwise.
• SDL_EVENT_WINDOW_MOVED — the window has been moved to data1, data2.
• SDL_EVENT_WINDOW_RESIZED — the window has been resized to data1xdata2.
• SDL_EVENT_WINDOW_PIXEL_SIZE_CHANGED — the pixel size of the window has changed to data1xdata2.
• SDL_EVENT_WINDOW_METAL_VIEW_RESIZED — the pixel size of a Metal view associated with the window has changed.
• SDL_EVENT_WINDOW_MINIMIZED — the window has been minimized.
• SDL_EVENT_WINDOW_MAXIMIZED — the window has been maximized.
• SDL_EVENT_WINDOW_RESTORED — the window has been restored to normal size and position.
• SDL_EVENT_WINDOW_MOUSE_ENTER — the window gained mouse focus.
• SDL_EVENT_WINDOW_MOUSE_LEAVE — the window lost mouse focus.
• SDL_EVENT_WINDOW_FOCUS_GAINED — the window gained keyboard focus.
• SDL_EVENT_WINDOW_FOCUS_LOST — the window lost keyboard focus.
• SDL_EVENT_WINDOW_CLOSE_REQUESTED — the window manager is asking for the window to be closed. It's a request, bestie, read the room. 👀
• SDL_EVENT_WINDOW_HIT_TEST — the window had a hit test that wasn't SDL_HITTEST_NORMAL.
• SDL_EVENT_WINDOW_ICCPROF_CHANGED — the ICC profile of the window's display has changed.
• SDL_EVENT_WINDOW_DISPLAY_CHANGED — the window has been moved to display data1.
• SDL_EVENT_WINDOW_DISPLAY_SCALE_CHANGED — the window display scale has been changed.
• SDL_EVENT_WINDOW_SAFE_AREA_CHANGED — the window safe area has been changed.
• SDL_EVENT_WINDOW_OCCLUDED — the window has been occluded.
• SDL_EVENT_WINDOW_ENTER_FULLSCREEN — the window entered fullscreen mode. main character energy 🌈
• SDL_EVENT_WINDOW_LEAVE_FULLSCREEN — the window left fullscreen mode.
• SDL_EVENT_WINDOW_DESTROYED — the window with the associated ID is being or has already been destroyed. Important: if this is being handled in an event watcher, the window handle is still valid and can still be used to retrieve any properties associated with the window. Otherwise, the handle has already been destroyed and all resources associated with it are invalid. So like… timing is everything here. ⚠️
• SDL_EVENT_WINDOW_HDR_STATE_CHANGED — the window's HDR properties have changed.
• SDL_EVENT_WINDOW_FIRST = SDL_EVENT_WINDOW_SHOWN — first window event.
• SDL_EVENT_WINDOW_LAST = SDL_EVENT_WINDOW_HDR_STATE_CHANGED — last window event.

⌨️ keyboard events

• SDL_EVENT_KEY_DOWN = 0x300 — a key was pressed.
• SDL_EVENT_KEY_UP — a key was released.
• SDL_EVENT_TEXT_EDITING — keyboard text editing (composition). iykyk 🧚
• SDL_EVENT_TEXT_INPUT — keyboard text input.
• SDL_EVENT_KEYMAP_CHANGED — the keymap changed because of a system event, like an input language or keyboard layout change.
• SDL_EVENT_KEYBOARD_ADDED — a new keyboard was inserted into the system.
• SDL_EVENT_KEYBOARD_REMOVED — a keyboard was removed.
• SDL_EVENT_TEXT_EDITING_CANDIDATES — keyboard text editing candidates.
• SDL_EVENT_SCREEN_KEYBOARD_SHOWN — the on-screen keyboard has been shown.
• SDL_EVENT_SCREEN_KEYBOARD_HIDDEN — the on-screen keyboard has been hidden.

🖱️ mouse events

• SDL_EVENT_MOUSE_MOTION = 0x400 — the mouse moved.
• SDL_EVENT_MOUSE_BUTTON_DOWN — a mouse button was pressed.
• SDL_EVENT_MOUSE_BUTTON_UP — a mouse button was released.
• SDL_EVENT_MOUSE_WHEEL — mouse wheel motion. scrolling behavior fr fr 🌀
• SDL_EVENT_MOUSE_ADDED — a new mouse was inserted into the system.
• SDL_EVENT_MOUSE_REMOVED — a mouse was removed.

🕹️ joystick events

• SDL_EVENT_JOYSTICK_AXIS_MOTION = 0x600 — joystick axis motion.
• SDL_EVENT_JOYSTICK_BALL_MOTION — joystick trackball motion.
• SDL_EVENT_JOYSTICK_HAT_MOTION — joystick hat position change.
• SDL_EVENT_JOYSTICK_BUTTON_DOWN — joystick button pressed.
• SDL_EVENT_JOYSTICK_BUTTON_UP — joystick button released.
• SDL_EVENT_JOYSTICK_ADDED — a new joystick was inserted into the system.
• SDL_EVENT_JOYSTICK_REMOVED — an opened joystick has been removed. (Yeah, "opened" — that word is doing work, don't gloss over it.)
• SDL_EVENT_JOYSTICK_BATTERY_UPDATED — joystick battery level change. 🔋
• SDL_EVENT_JOYSTICK_UPDATE_COMPLETE — joystick update is complete.

🎮 gamepad events

• SDL_EVENT_GAMEPAD_AXIS_MOTION = 0x650 — gamepad axis motion.
• SDL_EVENT_GAMEPAD_BUTTON_DOWN — gamepad button pressed.
• SDL_EVENT_GAMEPAD_BUTTON_UP — gamepad button released.
• SDL_EVENT_GAMEPAD_ADDED — a new gamepad was inserted into the system.
• SDL_EVENT_GAMEPAD_REMOVED — a gamepad was removed.
• SDL_EVENT_GAMEPAD_REMAPPED — the gamepad mapping was updated.
• SDL_EVENT_GAMEPAD_TOUCHPAD_DOWN — gamepad touchpad was touched.
• SDL_EVENT_GAMEPAD_TOUCHPAD_MOTION — gamepad touchpad finger was moved.
• SDL_EVENT_GAMEPAD_TOUCHPAD_UP — gamepad touchpad finger was lifted.
• SDL_EVENT_GAMEPAD_SENSOR_UPDATE — gamepad sensor was updated.
• SDL_EVENT_GAMEPAD_UPDATE_COMPLETE — gamepad update is complete.
• SDL_EVENT_GAMEPAD_STEAM_HANDLE_UPDATED — gamepad Steam handle has changed.

👆 touch events

• SDL_EVENT_FINGER_DOWN = 0x700
• SDL_EVENT_FINGER_UP
• SDL_EVENT_FINGER_MOTION
• SDL_EVENT_FINGER_CANCELED

Okay so the source ships these four with no little /**< ... */ comment, so I'm not about to sit here and invent lore for them. They're the touch crew, they live at 0x700, that's what the page says and that's what I'm telling you. 🤐💜

🤏 pinch events

• SDL_EVENT_PINCH_BEGIN = 0x710 — pinch gesture started.
• SDL_EVENT_PINCH_UPDATE — pinch gesture updated.
• SDL_EVENT_PINCH_END — pinch gesture ended.

HUGE one, do not skip this: 0x800, 0x801, and 0x802 were the Gesture events from SDL2. Do not reuse these values! sdl2-compat needs them! Like, genuinely. Leave them alone. 🚨

📋 clipboard events

• SDL_EVENT_CLIPBOARD_UPDATE = 0x900 — the clipboard changed. 📋✨

📁 drag and drop events

• SDL_EVENT_DROP_FILE = 0x1000 — the system requests a file open.
• SDL_EVENT_DROP_TEXT — a text/plain drag-and-drop event.
• SDL_EVENT_DROP_BEGIN — a new set of drops is beginning (NULL filename).
• SDL_EVENT_DROP_COMPLETE — the current set of drops is now complete (NULL filename).
• SDL_EVENT_DROP_POSITION — position while moving over the window.

---

And that's where part one cuts off, right in the middle of the drag-and-drop crew 😭 the enum keeps going, so stay tuned for part two bestie 💖

           /* Audio hotplug events */
           SDL_EVENT_AUDIO_DEVICE_ADDED = 0x1100,  /**< A new audio device is available */
           SDL_EVENT_AUDIO_DEVICE_REMOVED,         /**< An audio device has been removed. */
           SDL_EVENT_AUDIO_DEVICE_FORMAT_CHANGED,  /**< An audio device's format has been changed by the system. */

           /* Sensor events */
           SDL_EVENT_SENSOR_UPDATE = 0x1200,     /**< A sensor was updated */

           /* Pressure-sensitive pen events */
           SDL_EVENT_PEN_PROXIMITY_IN = 0x1300,  /**< Pressure-sensitive pen has become available */
           SDL_EVENT_PEN_PROXIMITY_OUT,          /**< Pressure-sensitive pen has become unavailable */
           SDL_EVENT_PEN_DOWN,                   /**< Pressure-sensitive pen touched drawing surface */
           SDL_EVENT_PEN_UP,                     /**< Pressure-sensitive pen stopped touching drawing surface */
           SDL_EVENT_PEN_BUTTON_DOWN,            /**< Pressure-sensitive pen button pressed */
           SDL_EVENT_PEN_BUTTON_UP,              /**< Pressure-sensitive pen button released */
           SDL_EVENT_PEN_MOTION,                 /**< Pressure-sensitive pen is moving on the tablet */
           SDL_EVENT_PEN_AXIS,                   /**< Pressure-sensitive pen angle/pressure/etc changed */

           /* Camera hotplug events */
           SDL_EVENT_CAMERA_DEVICE_ADDED = 0x1400,  /**< A new camera device is available */
           SDL_EVENT_CAMERA_DEVICE_REMOVED,         /**< A camera device has been removed. */
           SDL_EVENT_CAMERA_DEVICE_APPROVED,        /**< A camera device has been approved for use by the user. */
           SDL_EVENT_CAMERA_DEVICE_DENIED,          /**< A camera device has been denied for use by the user. */

           /* Render events */
           SDL_EVENT_RENDER_TARGETS_RESET = 0x2000, /**< The render targets have been reset and their contents need to be updated */
           SDL_EVENT_RENDER_DEVICE_RESET, /**< The device has been reset and all textures need to be recreated */
           SDL_EVENT_RENDER_DEVICE_LOST, /**< The device has been lost and can't be recovered. */

           /* Reserved events for private platforms */
           SDL_EVENT_PRIVATE0 = 0x4000,
           SDL_EVENT_PRIVATE1,
           SDL_EVENT_PRIVATE2,
           SDL_EVENT_PRIVATE3,

           /* Internal events */
           SDL_EVENT_POLL_SENTINEL = 0x7F00, /**< Signals the end of an event poll cycle */

           /** Events SDL_EVENT_USER through SDL_EVENT_LAST are for your use,
            *  and should be allocated with SDL_RegisterEvents()
            */
           SDL_EVENT_USER    = 0x8000,

           /**
            *  This last event is only for bounding internal arrays
            */
           SDL_EVENT_LAST    = 0xFFFF,

           /* This just makes sure the enum is the size of Uint32 */
           SDL_EVENT_ENUM_PADDING = 0x7FFFFFFF

       } SDL_EventType;

---

okay bestie, and that's the whole rest of the enum, no crumbs left 💅 look at the range on it — audio hotplug, sensors, pressure-sensitive pen drama, camera hotplug, render tea, some reserved private-platform slots, the internal poll sentinel, and then that big open playground at the top end for SDL_EVENT_USER through SDL_EVENT_LAST which are for you, fr fr. 👑

quick reminder of the receipts though, because these numbers are not decorative:

• SDL_EVENT_AUDIO_DEVICE_ADDED kicks off at 0x1100 and the audio trio just increments from there — added, removed, format changed, that's the arc 💖
• SDL_EVENT_SENSOR_UPDATE sits at 0x1200 all on its own, main character energy, no siblings 🌸
• SDL_EVENT_PEN_PROXIMITY_IN starts the pen block at 0x1300 and the pen events run all the way through SDL_EVENT_PEN_AXIS — proximity in/out, down/up, button down/up, motion, axis 🖊️✨
• SDL_EVENT_CAMERA_DEVICE_ADDED opens at 0x1400, then removed, approved, denied — and yes, approved and denied literally mean the user said yes or no, that's in the comment, not me making stuff up 🙈
• SDL_EVENT_RENDER_TARGETS_RESET is 0x2000, with device reset and device lost trailing behind it — and device lost is the dramatic one, "can't be recovered", so don't be out here pretending it's fine 😭
• SDL_EVENT_PRIVATE0 through SDL_EVENT_PRIVATE3 start at 0x4000 and are, as advertised, reserved for private platforms — not your lane, bestie 🫶
• SDL_EVENT_POLL_SENTINEL is 0x7F00 and it signals the end of an event poll cycle, which is lowkey iconic as a job description 💀
• SDL_EVENT_USER is 0x8000 and it's the start of the events that are for your use, and the docs are clear: they should be allocated with SDL_RegisterEvents() — don't freehand it 🎀
• SDL_EVENT_LAST is 0xFFFF and exists only for bounding internal arrays — it's a fence, not a party invite 🧚
• and SDL_EVENT_ENUM_PADDING = 0x7FFFFFFF is there for exactly one reason and it's in the comment: it makes sure the enum is the size of Uint32 💜

real talk warning: the whole 0x thing matters because these are the actual values the enum holds — if you go comparing or storing them, compare the names, don't go inventing your own numbers. no cap. ✋

---

🌈 AVAILABILITY 🌈

This enum is available since SDL 3.2.0. so if you're on something older than that... bestie, we need to talk 😭

---

and that's the page!! 🎀 this came out of the Simple Directmedia Layer docs, tagged SDL 3.4.18 — go forth and handle your events, you absolute legend 💖✨🦋🌸👑