Squashed 'external/ircolib/' changes from ce3cd726c..de6e324bd

de6e324bd separate emu thread
10d3daf86 Roms List improvements
95d202f37 Let's make the rom list process on a separate thread so the emulator doesnt take ages to load.
fc306967f Wow the ROM Header was just completely busted. Game list view works now
bad1691ee fuck this shit
2b59e5f46 game list in progress
d26417b83 remappable inputs in progress
ac4af8106 input
e72abc240 update readme
430139dc9 Qt6 frontend
3080d4d45 Fix this small bug too
08cd13b85 Cop0 unused functions do not actually pose a threat (as per manual). They don't do anything, so shall we.
61bb4fb44 make idle loop detection a little more specific with where the load goes
b037de4c3 SAZDFsdff
12e81e73e need to figure out why n64-systemtest loops indefinitely at some address that appears to be valid (i think it's me not invalidating the cache properly)
204f0e13b idle skipping seems to work!
cb8bb634a sdkfjlasdf
58e5c89c1 Fix compilation issue on my machine (no idea)
24fb2898e attempting more serious idle skipping
214719577 Place rsp.Step inside cached interpreter. Gains about 3 more fps
bb97dcc23 mmmmm
920b77d38 wjkhasdfjhkasdf
430ccdab4 it's a start...
4f42a673a Cached interpreter plays Mario 64. Start looking into RSP as well
c9a030787 idle skipping works!
5fbda03ce new idea
366637aba Idle skipping... maybe?
609fa2fb0 Cache instructions implemented but broken lmao. Commented out for now
e140a6d12 - Stop using inheritance for CPU, instead use composition. - Introduce KAIZEN_JIT_ENABLED optional define instead of relying on __aarch64__ and the like. - More cache work
68e613057 prep cache impl
811b4d809 fix clang format
fda755f7d idk
d5024ebbf small MI refactor in preparation of (eventually) implementing the RDRAM interface properly
694b45341 Merge commit '206dcdedf195fb320913584180edb12c7731e396' as 'external/SDL'
206dcdedf Squashed 'external/SDL/' content from commit 4d17b99d0a
4d16e1cb4 need to update sdl
848b19920 Fix compilation error
db61b5299 Merge commit 'e94a94559f28e49678fbcf72199a5258137b0fe9' as 'external/imgui'
e94a94559 Squashed 'external/imgui/' content from commit 02e9b8cac
52edb3757 need to update imgui
c1a705e86 Emulate weird JALR behaviour
4b4c32f4b Fix exception for "unusable COP1" in 4 instructions i missed accidentally (again)
df5828142 Bug putting 0s in the log everywhere
f8b580048 Make isviewer a sink to file
8241e9735 Fix exception for "unusable COP1" in 4 instructions i missed accidentally
b29715f20 small changes
d9a620bc1 make use of my new small utility library
0d1aa938e Add 'external/ircolib/' from commit 'ce3cd726c8df8388d554abf8bb55d55020eb4450'
e64eb40b3 Fuck git

git-subtree-dir: external/ircolib
git-subtree-split: de6e324bde

external/SDL/examples/input/01-joystick-polling/README.txt

@@ -0,0 +1,2 @@
+This example code looks for the current joystick state once per frame,
+and draws a visual representation of it.

external/SDL/examples/input/01-joystick-polling/joystick-polling.c

@@ -0,0 +1,193 @@
+/*
+ * This example code looks for the current joystick state once per frame,
+ * and draws a visual representation of it.
+ *
+ * This code is public domain. Feel free to use it for any purpose!
+ */
+
+/* Joysticks are low-level interfaces: there's something with a bunch of
+   buttons, axes and hats, in no understood order or position. This is
+   a flexible interface, but you'll need to build some sort of configuration
+   UI to let people tell you what button, etc, does what. On top of this
+   interface, SDL offers the "gamepad" API, which works with lots of devices,
+   and knows how to map arbitrary buttons and such to look like an
+   Xbox/PlayStation/etc gamepad. This is easier, and better, for many games,
+   but isn't necessarily a good fit for complex apps and hardware. A flight
+   simulator, a realistic racing game, etc, might want the joystick interface
+   instead of gamepads. */
+
+/* SDL can handle multiple joysticks, but for simplicity, this program only
+   deals with the first stick it sees. */
+
+#define SDL_MAIN_USE_CALLBACKS 1  /* use the callbacks instead of main() */
+#include <SDL3/SDL.h>
+#include <SDL3/SDL_main.h>
+
+/* We will use this renderer to draw into this window every frame. */
+static SDL_Window *window = NULL;
+static SDL_Renderer *renderer = NULL;
+static SDL_Joystick *joystick = NULL;
+static SDL_Color colors[64];
+
+/* This function runs once at startup. */
+SDL_AppResult SDL_AppInit(void **appstate, int argc, char *argv[])
+{
+    int i;
+
+    SDL_SetAppMetadata("Example Input Joystick Polling", "1.0", "com.example.input-joystick-polling");
+
+    if (!SDL_Init(SDL_INIT_VIDEO | SDL_INIT_JOYSTICK)) {
+        SDL_Log("Couldn't initialize SDL: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    if (!SDL_CreateWindowAndRenderer("examples/input/joystick-polling", 640, 480, SDL_WINDOW_RESIZABLE, &window, &renderer)) {
+        SDL_Log("Couldn't create window/renderer: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    for (i = 0; i < SDL_arraysize(colors); i++) {
+        colors[i].r = SDL_rand(255);
+        colors[i].g = SDL_rand(255);
+        colors[i].b = SDL_rand(255);
+        colors[i].a = 255;
+    }
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs when a new event (mouse input, keypresses, etc) occurs. */
+SDL_AppResult SDL_AppEvent(void *appstate, SDL_Event *event)
+{
+    if (event->type == SDL_EVENT_QUIT) {
+        return SDL_APP_SUCCESS;  /* end the program, reporting success to the OS. */
+    } else if (event->type == SDL_EVENT_JOYSTICK_ADDED) {
+        /* this event is sent for each hotplugged stick, but also each already-connected joystick during SDL_Init(). */
+        if (joystick == NULL) {  /* we don't have a stick yet and one was added, open it! */
+            joystick = SDL_OpenJoystick(event->jdevice.which);
+            if (!joystick) {
+                SDL_Log("Failed to open joystick ID %u: %s", (unsigned int) event->jdevice.which, SDL_GetError());
+            }
+        }
+    } else if (event->type == SDL_EVENT_JOYSTICK_REMOVED) {
+        if (joystick && (SDL_GetJoystickID(joystick) == event->jdevice.which)) {
+            SDL_CloseJoystick(joystick);  /* our joystick was unplugged. */
+            joystick = NULL;
+        }
+    }
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs once per frame, and is the heart of the program. */
+SDL_AppResult SDL_AppIterate(void *appstate)
+{
+    int winw = 640, winh = 480;
+    const char *text = "Plug in a joystick, please.";
+    float x, y;
+    int i;
+
+    if (joystick) {  /* we have a stick opened? */
+        text = SDL_GetJoystickName(joystick);
+    }
+
+    SDL_SetRenderDrawColor(renderer, 0, 0, 0, 255);
+    SDL_RenderClear(renderer);
+    SDL_GetWindowSize(window, &winw, &winh);
+
+    /* note that you can get input as events, instead of polling, which is
+       better since it won't miss button presses if the system is lagging,
+       but often times checking the current state per-frame is good enough,
+       and maybe better if you'd rather _drop_ inputs due to lag. */
+
+    if (joystick) {  /* we have a stick opened? */
+        const float size = 30.0f;
+        int total;
+
+        /* draw axes as bars going across middle of screen. We don't know if it's an X or Y or whatever axis, so we can't do more than this. */
+        total = SDL_GetNumJoystickAxes(joystick);
+        y = (winh - (total * size)) / 2;
+        x = ((float) winw) / 2.0f;
+        for (i = 0; i < total; i++) {
+            const SDL_Color *color = &colors[i % SDL_arraysize(colors)];
+            const float val = (((float) SDL_GetJoystickAxis(joystick, i)) / 32767.0f);  /* make it -1.0f to 1.0f */
+            const float dx = x + (val * x);
+            const SDL_FRect dst = { dx, y, x - SDL_fabsf(dx), size };
+            SDL_SetRenderDrawColor(renderer, color->r, color->g, color->b, color->a);
+            SDL_RenderFillRect(renderer, &dst);
+            y += size;
+        }
+
+        /* draw buttons as blocks across top of window. We only know the button numbers, but not where they are on the device. */
+        total = SDL_GetNumJoystickButtons(joystick);
+        x = (winw - (total * size)) / 2;
+        for (i = 0; i < total; i++) {
+            const SDL_Color *color = &colors[i % SDL_arraysize(colors)];
+            const SDL_FRect dst = { x, 0.0f, size, size };
+            if (SDL_GetJoystickButton(joystick, i)) {
+                SDL_SetRenderDrawColor(renderer, color->r, color->g, color->b, color->a);
+            } else {
+                SDL_SetRenderDrawColor(renderer, 0, 0, 0, 255);
+            }
+            SDL_RenderFillRect(renderer, &dst);
+            SDL_SetRenderDrawColor(renderer, 255, 255, 255, color->a);
+            SDL_RenderRect(renderer, &dst);  /* outline it */
+            x += size;
+        }
+
+        /* draw hats across the bottom of the screen. */
+        total = SDL_GetNumJoystickHats(joystick);
+        x = ((winw - (total * (size * 2.0f))) / 2.0f) + (size / 2.0f);
+        y = ((float) winh) - size;
+        for (i = 0; i < total; i++) {
+            const SDL_Color *color = &colors[i % SDL_arraysize(colors)];
+            const float thirdsize = size / 3.0f;
+            const SDL_FRect cross[] = { { x, y + thirdsize, size, thirdsize }, { x + thirdsize, y, thirdsize, size } };
+            const Uint8 hat = SDL_GetJoystickHat(joystick, i);
+
+            SDL_SetRenderDrawColor(renderer, 90, 90, 90, 255);
+            SDL_RenderFillRects(renderer, cross, SDL_arraysize(cross));
+
+            SDL_SetRenderDrawColor(renderer, color->r, color->g, color->b, color->a);
+
+            if (hat & SDL_HAT_UP) {
+                const SDL_FRect dst = { x + thirdsize, y, thirdsize, thirdsize };
+                SDL_RenderFillRect(renderer, &dst);
+            }
+
+            if (hat & SDL_HAT_RIGHT) {
+                const SDL_FRect dst = { x + (thirdsize * 2), y + thirdsize, thirdsize, thirdsize };
+                SDL_RenderFillRect(renderer, &dst);
+            }
+
+            if (hat & SDL_HAT_DOWN) {
+                const SDL_FRect dst = { x + thirdsize, y + (thirdsize * 2), thirdsize, thirdsize };
+                SDL_RenderFillRect(renderer, &dst);
+            }
+
+            if (hat & SDL_HAT_LEFT) {
+                const SDL_FRect dst = { x, y + thirdsize, thirdsize, thirdsize };
+                SDL_RenderFillRect(renderer, &dst);
+            }
+
+            x += size * 2;
+        }
+    }
+
+    x = (((float) winw) - (SDL_strlen(text) * SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE)) / 2.0f;
+    y = (((float) winh) - SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE) / 2.0f;
+    SDL_SetRenderDrawColor(renderer, 255, 255, 255, 255);
+    SDL_RenderDebugText(renderer, x, y, text);
+    SDL_RenderPresent(renderer);
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs once at shutdown. */
+void SDL_AppQuit(void *appstate, SDL_AppResult result)
+{
+    if (joystick) {
+        SDL_CloseJoystick(joystick);
+    }
+
+    /* SDL will clean up the window/renderer for us. */
+}

external/SDL/examples/input/02-joystick-events/README.txt

@@ -0,0 +1,2 @@
+This example code looks for joystick input in the event handler, and
+reports any changes as a flood of info.

external/SDL/examples/input/02-joystick-events/joystick-events.c

@@ -0,0 +1,232 @@
+/*
+ * This example code looks for joystick input in the event handler, and
+ * reports any changes as a flood of info.
+ *
+ * This code is public domain. Feel free to use it for any purpose!
+ */
+
+/* Joysticks are low-level interfaces: there's something with a bunch of
+   buttons, axes and hats, in no understood order or position. This is
+   a flexible interface, but you'll need to build some sort of configuration
+   UI to let people tell you what button, etc, does what. On top of this
+   interface, SDL offers the "gamepad" API, which works with lots of devices,
+   and knows how to map arbitrary buttons and such to look like an
+   Xbox/PlayStation/etc gamepad. This is easier, and better, for many games,
+   but isn't necessarily a good fit for complex apps and hardware. A flight
+   simulator, a realistic racing game, etc, might want the joystick interface
+   instead of gamepads. */
+
+#define SDL_MAIN_USE_CALLBACKS 1  /* use the callbacks instead of main() */
+#include <SDL3/SDL.h>
+#include <SDL3/SDL_main.h>
+
+/* We will use this renderer to draw into this window every frame. */
+static SDL_Window *window = NULL;
+static SDL_Renderer *renderer = NULL;
+static SDL_Color colors[64];
+
+#define MOTION_EVENT_COOLDOWN 40
+
+typedef struct EventMessage
+{
+    char *str;
+    SDL_Color color;
+    Uint64 start_ticks;
+    struct EventMessage *next;
+} EventMessage;
+
+static EventMessage messages;
+static EventMessage *messages_tail = &messages;
+
+static const char *hat_state_string(Uint8 state)
+{
+    switch (state) {
+        case SDL_HAT_CENTERED: return "CENTERED";
+        case SDL_HAT_UP: return "UP";
+        case SDL_HAT_RIGHT: return "RIGHT";
+        case SDL_HAT_DOWN: return "DOWN";
+        case SDL_HAT_LEFT: return "LEFT";
+        case SDL_HAT_RIGHTUP: return "RIGHT+UP";
+        case SDL_HAT_RIGHTDOWN: return "RIGHT+DOWN";
+        case SDL_HAT_LEFTUP: return "LEFT+UP";
+        case SDL_HAT_LEFTDOWN: return "LEFT+DOWN";
+        default: break;
+    }
+    return "UNKNOWN";
+}
+
+static const char *battery_state_string(SDL_PowerState state)
+{
+    switch (state) {
+        case SDL_POWERSTATE_ERROR: return "ERROR";
+        case SDL_POWERSTATE_UNKNOWN: return "UNKNOWN";
+        case SDL_POWERSTATE_ON_BATTERY: return "ON BATTERY";
+        case SDL_POWERSTATE_NO_BATTERY: return "NO BATTERY";
+        case SDL_POWERSTATE_CHARGING: return "CHARGING";
+        case SDL_POWERSTATE_CHARGED: return "CHARGED";
+        default: break;
+    }
+    return "UNKNOWN";
+}
+
+static void add_message(SDL_JoystickID jid, const char *fmt, ...)
+{
+    const SDL_Color *color = &colors[((size_t) jid) % SDL_arraysize(colors)];
+    EventMessage *msg = NULL;
+    char *str = NULL;
+    va_list ap;
+
+    msg = (EventMessage *) SDL_calloc(1, sizeof (*msg));
+    if (!msg) {
+        return;  // oh well.
+    }
+
+    va_start(ap, fmt);
+    SDL_vasprintf(&str, fmt, ap);
+    va_end(ap);
+    if (!str) {
+        SDL_free(msg);
+        return;  // oh well.
+    }
+
+    msg->str = str;
+    SDL_copyp(&msg->color, color);
+    msg->start_ticks = SDL_GetTicks();
+    msg->next = NULL;
+
+    messages_tail->next = msg;
+    messages_tail = msg;
+}
+
+
+/* This function runs once at startup. */
+SDL_AppResult SDL_AppInit(void **appstate, int argc, char *argv[])
+{
+    int i;
+
+    SDL_SetAppMetadata("Example Input Joystick Events", "1.0", "com.example.input-joystick-events");
+
+    if (!SDL_Init(SDL_INIT_VIDEO | SDL_INIT_JOYSTICK)) {
+        SDL_Log("Couldn't initialize SDL: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    if (!SDL_CreateWindowAndRenderer("examples/input/joystick-events", 640, 480, SDL_WINDOW_RESIZABLE, &window, &renderer)) {
+        SDL_Log("Couldn't create window/renderer: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    colors[0].r = colors[0].g = colors[0].b = colors[0].a = 255;
+    for (i = 1; i < SDL_arraysize(colors); i++) {
+        colors[i].r = SDL_rand(255);
+        colors[i].g = SDL_rand(255);
+        colors[i].b = SDL_rand(255);
+        colors[i].a = 255;
+    }
+
+    add_message(0, "Please plug in a joystick.");
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs when a new event (mouse input, keypresses, etc) occurs. */
+SDL_AppResult SDL_AppEvent(void *appstate, SDL_Event *event)
+{
+    if (event->type == SDL_EVENT_QUIT) {
+        return SDL_APP_SUCCESS;  /* end the program, reporting success to the OS. */
+    } else if (event->type == SDL_EVENT_JOYSTICK_ADDED) {
+        /* this event is sent for each hotplugged stick, but also each already-connected joystick during SDL_Init(). */
+        const SDL_JoystickID which = event->jdevice.which;
+        SDL_Joystick *joystick = SDL_OpenJoystick(which);
+        if (!joystick) {
+            add_message(which, "Joystick #%u add, but not opened: %s", (unsigned int) which, SDL_GetError());
+        } else {
+            add_message(which, "Joystick #%u ('%s') added", (unsigned int) which, SDL_GetJoystickName(joystick));
+        }
+    } else if (event->type == SDL_EVENT_JOYSTICK_REMOVED) {
+        const SDL_JoystickID which = event->jdevice.which;
+        SDL_Joystick *joystick = SDL_GetJoystickFromID(which);
+        if (joystick) {
+            SDL_CloseJoystick(joystick);  /* the joystick was unplugged. */
+        }
+        add_message(which, "Joystick #%u removed", (unsigned int) which);
+    } else if (event->type == SDL_EVENT_JOYSTICK_AXIS_MOTION) {
+        static Uint64 axis_motion_cooldown_time = 0;  /* these are spammy, only show every X milliseconds. */
+        const Uint64 now = SDL_GetTicks();
+        if (now >= axis_motion_cooldown_time) {
+            const SDL_JoystickID which = event->jaxis.which;
+            axis_motion_cooldown_time = now + MOTION_EVENT_COOLDOWN;
+            add_message(which, "Joystick #%u axis %d -> %d", (unsigned int) which, (int) event->jaxis.axis, (int) event->jaxis.value);
+        }
+    } else if (event->type == SDL_EVENT_JOYSTICK_BALL_MOTION) {
+        static Uint64 ball_motion_cooldown_time = 0;  /* these are spammy, only show every X milliseconds. */
+        const Uint64 now = SDL_GetTicks();
+        if (now >= ball_motion_cooldown_time) {
+            const SDL_JoystickID which = event->jball.which;
+            ball_motion_cooldown_time = now + MOTION_EVENT_COOLDOWN;
+            add_message(which, "Joystick #%u ball %d -> %d, %d", (unsigned int) which, (int) event->jball.ball, (int) event->jball.xrel, (int) event->jball.yrel);
+        }
+    } else if (event->type == SDL_EVENT_JOYSTICK_HAT_MOTION) {
+        const SDL_JoystickID which = event->jhat.which;
+        add_message(which, "Joystick #%u hat %d -> %s", (unsigned int) which, (int) event->jhat.hat, hat_state_string(event->jhat.value));
+    } else if ((event->type == SDL_EVENT_JOYSTICK_BUTTON_UP) || (event->type == SDL_EVENT_JOYSTICK_BUTTON_DOWN)) {
+        const SDL_JoystickID which = event->jbutton.which;
+        add_message(which, "Joystick #%u button %d -> %s", (unsigned int) which, (int) event->jbutton.button, event->jbutton.down ? "PRESSED" : "RELEASED");
+    } else if (event->type == SDL_EVENT_JOYSTICK_BATTERY_UPDATED) {
+        const SDL_JoystickID which = event->jbattery.which;
+        add_message(which, "Joystick #%u battery -> %s - %d%%", (unsigned int) which, battery_state_string(event->jbattery.state), event->jbattery.percent);
+    }
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs once per frame, and is the heart of the program. */
+SDL_AppResult SDL_AppIterate(void *appstate)
+{
+    const Uint64 now = SDL_GetTicks();
+    const float msg_lifetime = 3500.0f;  /* milliseconds a message lives for. */
+    EventMessage *msg = messages.next;
+    float prev_y = 0.0f;
+    int winw = 640, winh = 480;
+
+    SDL_SetRenderDrawColor(renderer, 0, 0, 0, 255);
+    SDL_RenderClear(renderer);
+    SDL_GetWindowSize(window, &winw, &winh);
+
+    while (msg) {
+        float x, y;
+        const float life_percent = ((float) (now - msg->start_ticks)) / msg_lifetime;
+        if (life_percent >= 1.0f) {  /* msg is done. */
+            messages.next = msg->next;
+            if (messages_tail == msg) {
+                messages_tail = &messages;
+            }
+            SDL_free(msg->str);
+            SDL_free(msg);
+            msg = messages.next;
+            continue;
+        }
+        x = (((float) winw) - (SDL_strlen(msg->str) * SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE)) / 2.0f;
+        y = ((float) winh) * life_percent;
+        if ((prev_y != 0.0f) && ((prev_y - y) < ((float) SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE))) {
+            msg->start_ticks = now;
+            break;  // wait for the previous message to tick up a little.
+        }
+
+        SDL_SetRenderDrawColor(renderer, msg->color.r, msg->color.g, msg->color.b, (Uint8) (((float) msg->color.a) * (1.0f - life_percent)));
+        SDL_RenderDebugText(renderer, x, y, msg->str);
+
+        prev_y = y;
+        msg = msg->next;
+    }
+    
+    SDL_RenderPresent(renderer);
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs once at shutdown. */
+void SDL_AppQuit(void *appstate, SDL_AppResult result)
+{
+    /* SDL will clean up the window/renderer for us. We let the joysticks leak. */
+}

external/SDL/examples/input/03-gamepad-polling/README.txt

@@ -0,0 +1,11 @@
+This example code looks for the current gamepad state once per frame,
+and draws a visual representation of it. See 01-joystick-polling for the
+equivalent example code for the lower-level joystick API.
+
+Please note that on the web, gamepads don't show up until you interact with
+them, so press a button to "connect" the controller.
+
+Also note that on the web, gamepad triggers are treated as buttons (either
+pressed or not) instead of axes (pressed 0 to 100 percent). This is a web
+issue, not an SDL limitation.
+

external/SDL/examples/input/03-gamepad-polling/gamepad-polling.c

@@ -0,0 +1,221 @@
+/*
+ * This example code looks for the current gamepad state once per frame,
+ * and draws a visual representation of it. See 01-joystick-polling for the
+ * equivalent example code for the lower-level joystick API.
+ *
+ * This code is public domain. Feel free to use it for any purpose!
+ */
+
+/* Joysticks are low-level interfaces: there's something with a bunch of
+   buttons, axes and hats, in no understood order or position. This is
+   a flexible interface, but you'll need to build some sort of configuration
+   UI to let people tell you what button, etc, does what. On top of this
+   interface, SDL offers the "gamepad" API, which works with lots of devices,
+   and knows how to map arbitrary buttons and such to look like an
+   Xbox/PlayStation/etc gamepad. This is easier, and better, for many games,
+   but isn't necessarily a good fit for complex apps and hardware. A flight
+   simulator, a realistic racing game, etc, might want the joystick interface
+   instead of gamepads. */
+
+/* SDL can handle multiple gamepads, but for simplicity, this program only
+   deals with the first gamepad it sees. */
+
+#define SDL_MAIN_USE_CALLBACKS 1  /* use the callbacks instead of main() */
+#include <SDL3/SDL.h>
+#include <SDL3/SDL_main.h>
+
+/* We will use this renderer to draw into this window every frame. */
+static SDL_Window *window = NULL;
+static SDL_Renderer *renderer = NULL;
+static SDL_Texture *texture = NULL;
+static SDL_Gamepad *gamepad = NULL;
+
+#define WINDOW_WIDTH 640
+#define WINDOW_HEIGHT 480
+
+/* This function runs once at startup. */
+SDL_AppResult SDL_AppInit(void **appstate, int argc, char *argv[])
+{
+    char *png_path = NULL;
+    SDL_Surface *surface = NULL;
+
+    SDL_SetAppMetadata("Example Input Gamepad Polling", "1.0", "com.example.input-gamepad-polling");
+
+    if (!SDL_Init(SDL_INIT_VIDEO | SDL_INIT_GAMEPAD)) {
+        SDL_Log("Couldn't initialize SDL: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    if (!SDL_CreateWindowAndRenderer("examples/input/gamepad-polling", WINDOW_WIDTH, WINDOW_HEIGHT, SDL_WINDOW_RESIZABLE, &window, &renderer)) {
+        SDL_Log("Couldn't create window/renderer: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    if (!SDL_SetRenderLogicalPresentation(renderer, WINDOW_WIDTH, WINDOW_HEIGHT, SDL_LOGICAL_PRESENTATION_STRETCH)) {
+        return SDL_APP_FAILURE;
+    }
+
+    /* Textures are pixel data that we upload to the video hardware for fast drawing. Lots of 2D
+       engines refer to these as "sprites." We'll do a static texture (upload once, draw many
+       times) with data from a bitmap file. */
+
+    /* SDL_Surface is pixel data the CPU can access. SDL_Texture is pixel data the GPU can access.
+       Load a .png into a surface, move it to a texture from there. */
+    SDL_asprintf(&png_path, "%sgamepad_front.png", SDL_GetBasePath());  /* allocate a string of the full file path */
+    surface = SDL_LoadPNG(png_path);
+    if (!surface) {
+        SDL_Log("Couldn't load bitmap: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    SDL_free(png_path);  /* done with this, the file is loaded. */
+
+    texture = SDL_CreateTextureFromSurface(renderer, surface);
+    if (!texture) {
+        SDL_Log("Couldn't create static texture: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    SDL_DestroySurface(surface);  /* done with this, the texture has a copy of the pixels now. */
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs when a new event (mouse input, keypresses, etc) occurs. */
+SDL_AppResult SDL_AppEvent(void *appstate, SDL_Event *event)
+{
+    if (event->type == SDL_EVENT_QUIT) {
+        return SDL_APP_SUCCESS;  /* end the program, reporting success to the OS. */
+    } else if (event->type == SDL_EVENT_GAMEPAD_ADDED) {
+        /* this event is sent for each hotplugged gamepad, but also each already-connected gamepad during SDL_Init(). */
+        if (gamepad == NULL) {  /* we don't have a stick yet and one was added, open it! */
+            gamepad = SDL_OpenGamepad(event->gdevice.which);
+            if (!gamepad) {
+                SDL_Log("Failed to open gamepad ID %u: %s", (unsigned int) event->gdevice.which, SDL_GetError());
+            }
+        }
+    } else if (event->type == SDL_EVENT_GAMEPAD_REMOVED) {
+        if (gamepad && (SDL_GetGamepadID(gamepad) == event->gdevice.which)) {
+            SDL_CloseGamepad(gamepad);  /* our controller was unplugged. */
+            gamepad = NULL;
+        }
+    }
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs once per frame, and is the heart of the program. */
+SDL_AppResult SDL_AppIterate(void *appstate)
+{
+    const char *text = "Plug in a gamepad, please.";
+    static Uint64 leftthumblast = 0xFFFFFFFF;
+    static Uint64 rightthumblast = 0xFFFFFFFF;
+    const Uint64 now = SDL_GetTicks();
+    Sint16 axis_x, axis_y;
+    float x, y;
+    int i;
+
+    if (gamepad) {  /* we have a stick opened? */
+        text = SDL_GetGamepadName(gamepad);
+    }
+
+    SDL_SetRenderDrawColor(renderer, 0xFF, 0xFF, 0xFF, 0xFF);  /* white */
+    SDL_RenderClear(renderer);
+
+    /* note that you can get input as events, instead of polling, which is
+       better since it won't miss button presses if the system is lagging,
+       but often times checking the current state per-frame is good enough,
+       and maybe better if you'd rather _drop_ inputs due to lag. */
+
+    if (gamepad) {  /* we have a stick opened? */
+        /* where to draw the buttons */
+        const SDL_FRect buttons[] = {
+            { 497, 266, 38,  38 },   /* SDL_GAMEPAD_BUTTON_SOUTH */
+            { 550, 217, 38,  38 },   /* SDL_GAMEPAD_BUTTON_EAST */
+            { 445, 221, 38,  38 },   /* SDL_GAMEPAD_BUTTON_WEST */
+            { 499, 173, 38,  38 },   /* SDL_GAMEPAD_BUTTON_NORTH */
+            { 235, 228, 32,  29 },   /* SDL_GAMEPAD_BUTTON_BACK */
+            { 287, 195, 69,  69 },   /* SDL_GAMEPAD_BUTTON_GUIDE */
+            { 377, 228, 32,  29 },   /* SDL_GAMEPAD_BUTTON_START */
+            { 91,  234, 63,  63 },   /* SDL_GAMEPAD_BUTTON_LEFT_STICK */
+            { 381, 354, 63,  63 },   /* SDL_GAMEPAD_BUTTON_RIGHT_STICK */
+            { 74,  73,  102, 29 },   /* SDL_GAMEPAD_BUTTON_LEFT_SHOULDER */
+            { 468, 73,  102, 29 },   /* SDL_GAMEPAD_BUTTON_RIGHT_SHOULDER */
+            { 207, 316, 32,  32 },   /* SDL_GAMEPAD_BUTTON_DPAD_UP */
+            { 207, 384, 32,  32 },   /* SDL_GAMEPAD_BUTTON_DPAD_DOWN */
+            { 173, 351, 32,  32 },   /* SDL_GAMEPAD_BUTTON_DPAD_LEFT */
+            { 242, 351, 32,  32 },   /* SDL_GAMEPAD_BUTTON_DPAD_RIGHT */
+            { 310, 286, 23,  27 },   /* SDL_GAMEPAD_BUTTON_MISC1 */
+            /* there are other buttons: paddles on the back of the gamepad, touchpads, etc, but this is good enough for now. */
+        };
+
+        SDL_RenderTexture(renderer, texture, NULL, NULL);  /* draw the gamepad picture to the whole window. */
+
+        /* draw green boxes over buttons that are currently pressed. */
+        SDL_SetRenderDrawColor(renderer, 0x00, 0xFF, 0x00, 0xFF);  /* green */
+        for (i = 0; i < SDL_arraysize(buttons); i++) {
+            if (SDL_GetGamepadButton(gamepad, (SDL_GamepadButton) i)) {
+                SDL_RenderFillRect(renderer, &buttons[i]);
+            }
+        }
+
+        SDL_SetRenderDrawColor(renderer, 0xFF, 0xFF, 0x00, 0xFF);  /* yellow */
+
+        /* left thumb axis. */
+        axis_x = SDL_GetGamepadAxis(gamepad, SDL_GAMEPAD_AXIS_LEFTX);
+        axis_y = SDL_GetGamepadAxis(gamepad, SDL_GAMEPAD_AXIS_LEFTY);
+        if ((SDL_abs(axis_x) > 1000) || (SDL_abs(axis_y) > 1000)) {   /* zero means centered, but it might be a little off zero... */
+            leftthumblast = now;  /* keep drawing, we're still moving. */
+        }
+        if ((now - leftthumblast) < 500) {  /* draw if there was movement in the last half-second. */
+            const SDL_FRect box = { 107 + ((axis_x / 32767.0f) * 30.0f), 252 + ((axis_y / 32767.0f) * 30.0f), 30, 30 };
+            SDL_RenderFillRect(renderer, &box);
+        }
+
+        /* right thumb axis. */
+        axis_x = SDL_GetGamepadAxis(gamepad, SDL_GAMEPAD_AXIS_RIGHTX);
+        axis_y = SDL_GetGamepadAxis(gamepad, SDL_GAMEPAD_AXIS_RIGHTY);
+        if ((SDL_abs(axis_x) > 1000) || (SDL_abs(axis_y) > 1000)) {   /* zero means centered, but it might be a little off zero... */
+            rightthumblast = now;  /* keep drawing, we're still moving. */
+        }
+        if ((now - rightthumblast) < 500) {  /* draw if there was movement in the last half-second. */
+            const SDL_FRect box = { 397 + ((axis_x / 32767.0f) * 30.0f), 370 + ((axis_y / 32767.0f) * 30.0f), 30, 30 };
+            SDL_RenderFillRect(renderer, &box);
+        }
+
+        /* left trigger. */
+        axis_y = SDL_GetGamepadAxis(gamepad, SDL_GAMEPAD_AXIS_LEFT_TRIGGER);
+        if (axis_y > 1000) {   /* zero means unpressed, but it might be a little off zero... */
+            const float height = ((axis_y / 32767.0f) * 65.0f);
+            const SDL_FRect box = { 127, 1 + (65.0f - height), 37, height };
+            SDL_RenderFillRect(renderer, &box);
+        }
+
+        /* right trigger. */
+        axis_y = SDL_GetGamepadAxis(gamepad, SDL_GAMEPAD_AXIS_RIGHT_TRIGGER);
+        if (axis_y > 1000) {   /* zero means unpressed, but it might be a little off zero... */
+            const float height = ((axis_y / 32767.0f) * 65.0f);
+            const SDL_FRect box = { 481, 1 + (65.0f - height), 37, height };
+            SDL_RenderFillRect(renderer, &box);
+        }
+    }
+
+    x = (((float) WINDOW_WIDTH) - (SDL_strlen(text) * SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE)) / 2.0f;
+    if (gamepad) {
+        y = (float) (WINDOW_HEIGHT - (SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE + 2));
+    } else {
+        y = (((float) WINDOW_HEIGHT) - SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE) / 2.0f;
+    }
+    SDL_SetRenderDrawColor(renderer, 0x00, 0x00, 0xFF, 0xFF);  /* blue */
+    SDL_RenderDebugText(renderer, x, y, text);
+    SDL_RenderPresent(renderer);
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs once at shutdown. */
+void SDL_AppQuit(void *appstate, SDL_AppResult result)
+{
+    SDL_DestroyTexture(texture);
+    SDL_CloseGamepad(gamepad);
+    /* SDL will clean up the window/renderer for us. */
+}

external/SDL/examples/input/04-gamepad-events/README.txt

@@ -0,0 +1,2 @@
+This example code looks for gamepad input in the event handler, and
+reports any changes as a flood of info.

external/SDL/examples/input/04-gamepad-events/gamepad-events.c

@@ -0,0 +1,212 @@
+/*
+ * This example code looks for gamepad input in the event handler, and
+ * reports any changes as a flood of info.
+ *
+ * This code is public domain. Feel free to use it for any purpose!
+ */
+
+/* Joysticks are low-level interfaces: there's something with a bunch of
+   buttons, axes and hats, in no understood order or position. This is
+   a flexible interface, but you'll need to build some sort of configuration
+   UI to let people tell you what button, etc, does what. On top of this
+   interface, SDL offers the "gamepad" API, which works with lots of devices,
+   and knows how to map arbitrary buttons and such to look like an
+   Xbox/PlayStation/etc gamepad. This is easier, and better, for many games,
+   but isn't necessarily a good fit for complex apps and hardware. A flight
+   simulator, a realistic racing game, etc, might want the joystick interface
+   instead of gamepads. */
+
+#define SDL_MAIN_USE_CALLBACKS 1  /* use the callbacks instead of main() */
+#include <SDL3/SDL.h>
+#include <SDL3/SDL_main.h>
+
+/* We will use this renderer to draw into this window every frame. */
+static SDL_Window *window = NULL;
+static SDL_Renderer *renderer = NULL;
+static SDL_Color colors[64];
+
+#define MOTION_EVENT_COOLDOWN 40
+
+typedef struct EventMessage
+{
+    char *str;
+    SDL_Color color;
+    Uint64 start_ticks;
+    struct EventMessage *next;
+} EventMessage;
+
+static EventMessage messages;
+static EventMessage *messages_tail = &messages;
+
+static const char *battery_state_string(SDL_PowerState state)
+{
+    switch (state) {
+        case SDL_POWERSTATE_ERROR: return "ERROR";
+        case SDL_POWERSTATE_UNKNOWN: return "UNKNOWN";
+        case SDL_POWERSTATE_ON_BATTERY: return "ON BATTERY";
+        case SDL_POWERSTATE_NO_BATTERY: return "NO BATTERY";
+        case SDL_POWERSTATE_CHARGING: return "CHARGING";
+        case SDL_POWERSTATE_CHARGED: return "CHARGED";
+        default: break;
+    }
+    return "UNKNOWN";
+}
+
+static void add_message(SDL_JoystickID jid, const char *fmt, ...)
+{
+    const SDL_Color *color = &colors[((size_t) jid) % SDL_arraysize(colors)];
+    EventMessage *msg = NULL;
+    char *str = NULL;
+    va_list ap;
+
+    msg = (EventMessage *) SDL_calloc(1, sizeof (*msg));
+    if (!msg) {
+        return;  // oh well.
+    }
+
+    va_start(ap, fmt);
+    SDL_vasprintf(&str, fmt, ap);
+    va_end(ap);
+    if (!str) {
+        SDL_free(msg);
+        return;  // oh well.
+    }
+
+    msg->str = str;
+    SDL_copyp(&msg->color, color);
+    msg->start_ticks = SDL_GetTicks();
+    msg->next = NULL;
+
+    messages_tail->next = msg;
+    messages_tail = msg;
+}
+
+
+/* This function runs once at startup. */
+SDL_AppResult SDL_AppInit(void **appstate, int argc, char *argv[])
+{
+    int i;
+
+    SDL_SetAppMetadata("Example Input Gamepad Events", "1.0", "com.example.input-gamepad-events");
+
+    if (!SDL_Init(SDL_INIT_VIDEO | SDL_INIT_GAMEPAD)) {
+        SDL_Log("Couldn't initialize SDL: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    if (!SDL_CreateWindowAndRenderer("examples/input/gamepad-events", 640, 480, SDL_WINDOW_RESIZABLE, &window, &renderer)) {
+        SDL_Log("Couldn't create window/renderer: %s", SDL_GetError());
+        return SDL_APP_FAILURE;
+    }
+
+    colors[0].r = colors[0].g = colors[0].b = colors[0].a = 255;
+    for (i = 1; i < SDL_arraysize(colors); i++) {
+        colors[i].r = SDL_rand(255);
+        colors[i].g = SDL_rand(255);
+        colors[i].b = SDL_rand(255);
+        colors[i].a = 255;
+    }
+
+    add_message(0, "Please plug in a gamepad.");
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs when a new event (mouse input, keypresses, etc) occurs. */
+SDL_AppResult SDL_AppEvent(void *appstate, SDL_Event *event)
+{
+    if (event->type == SDL_EVENT_QUIT) {
+        return SDL_APP_SUCCESS;  /* end the program, reporting success to the OS. */
+    } else if (event->type == SDL_EVENT_GAMEPAD_ADDED) {
+        /* this event is sent for each hotplugged stick, but also each already-connected gamepad during SDL_Init(). */
+        const SDL_JoystickID which = event->gdevice.which;
+        SDL_Gamepad *gamepad = SDL_OpenGamepad(which);
+        if (!gamepad) {
+            add_message(which, "Gamepad #%u add, but not opened: %s", (unsigned int) which, SDL_GetError());
+        } else {
+            char *mapping = SDL_GetGamepadMapping(gamepad);
+            add_message(which, "Gamepad #%u ('%s') added", (unsigned int) which, SDL_GetGamepadName(gamepad));
+            if (mapping) {
+                add_message(which, "Gamepad #%u mapping: %s", (unsigned int) which, mapping);
+                SDL_free(mapping);
+            }
+        }
+    } else if (event->type == SDL_EVENT_GAMEPAD_REMOVED) {
+        const SDL_JoystickID which = event->gdevice.which;
+        SDL_Gamepad *gamepad = SDL_GetGamepadFromID(which);
+        if (gamepad) {
+            SDL_CloseGamepad(gamepad);  /* the gamepad was unplugged. */
+        }
+        add_message(which, "Gamepad #%u removed", (unsigned int) which);
+    } else if (event->type == SDL_EVENT_GAMEPAD_AXIS_MOTION) {
+        static Uint64 axis_motion_cooldown_time = 0;  /* these are spammy, only show every X milliseconds. */
+        const Uint64 now = SDL_GetTicks();
+        if (now >= axis_motion_cooldown_time) {
+            const SDL_JoystickID which = event->gaxis.which;
+            axis_motion_cooldown_time = now + MOTION_EVENT_COOLDOWN;
+            add_message(which, "Gamepad #%u axis %s -> %d", (unsigned int) which, SDL_GetGamepadStringForAxis((SDL_GamepadAxis) event->gaxis.axis), (int) event->gaxis.value);
+        }
+    } else if ((event->type == SDL_EVENT_GAMEPAD_BUTTON_UP) || (event->type == SDL_EVENT_GAMEPAD_BUTTON_DOWN)) {
+        const SDL_JoystickID which = event->gbutton.which;
+        add_message(which, "Gamepad #%u button %s -> %s", (unsigned int) which, SDL_GetGamepadStringForButton((SDL_GamepadButton) event->gbutton.button), event->gbutton.down ? "PRESSED" : "RELEASED");
+    } else if (event->type == SDL_EVENT_JOYSTICK_BATTERY_UPDATED) {
+        const SDL_JoystickID which = event->jbattery.which;
+        if (SDL_IsGamepad(which)) {  /* this is only reported for joysticks, so make sure this joystick is _actually_ a gamepad. */
+            add_message(which, "Gamepad #%u battery -> %s - %d%%", (unsigned int) which, battery_state_string(event->jbattery.state), event->jbattery.percent);
+        }
+    }
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs once per frame, and is the heart of the program. */
+SDL_AppResult SDL_AppIterate(void *appstate)
+{
+    const Uint64 now = SDL_GetTicks();
+    const float msg_lifetime = 3500.0f;  /* milliseconds a message lives for. */
+    EventMessage *msg = messages.next;
+    float prev_y = 0.0f;
+    int winw = 640, winh = 480;
+
+    SDL_SetRenderDrawColor(renderer, 0, 0, 0, 255);
+    SDL_RenderClear(renderer);
+    SDL_GetWindowSize(window, &winw, &winh);
+
+    while (msg) {
+        float x, y;
+        const float life_percent = ((float) (now - msg->start_ticks)) / msg_lifetime;
+        if (life_percent >= 1.0f) {  /* msg is done. */
+            messages.next = msg->next;
+            if (messages_tail == msg) {
+                messages_tail = &messages;
+            }
+            SDL_free(msg->str);
+            SDL_free(msg);
+            msg = messages.next;
+            continue;
+        }
+        x = (((float) winw) - (SDL_strlen(msg->str) * SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE)) / 2.0f;
+        y = ((float) winh) * life_percent;
+        if ((prev_y != 0.0f) && ((prev_y - y) < ((float) SDL_DEBUG_TEXT_FONT_CHARACTER_SIZE))) {
+            msg->start_ticks = now;
+            break;  // wait for the previous message to tick up a little.
+        }
+
+        SDL_SetRenderDrawColor(renderer, msg->color.r, msg->color.g, msg->color.b, (Uint8) (((float) msg->color.a) * (1.0f - life_percent)));
+        SDL_RenderDebugText(renderer, x, y, msg->str);
+
+        prev_y = y;
+        msg = msg->next;
+    }
+    
+    SDL_RenderPresent(renderer);
+
+    return SDL_APP_CONTINUE;  /* carry on with the program! */
+}
+
+/* This function runs once at shutdown. */
+void SDL_AppQuit(void *appstate, SDL_AppResult result)
+{
+    SDL_Quit();
+    /* SDL will clean up the window/renderer for us. We let the gamepads leak. */
+}