From 5a079a2d114f96d4847d1ee305d5b7c16eeec50e Mon Sep 17 00:00:00 2001
From: 3gg <3gg@shellblade.net>
Date: Sat, 27 Dec 2025 12:03:39 -0800
Subject: Initial commit

---
 contrib/SDL-3.2.8/test/relative_mode.markdown | 58 +++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 contrib/SDL-3.2.8/test/relative_mode.markdown

(limited to 'contrib/SDL-3.2.8/test/relative_mode.markdown')

diff --git a/contrib/SDL-3.2.8/test/relative_mode.markdown b/contrib/SDL-3.2.8/test/relative_mode.markdown
new file mode 100644
index 0000000..0a43b6b
--- /dev/null
+++ b/contrib/SDL-3.2.8/test/relative_mode.markdown
@@ -0,0 +1,58 @@
+Relative mode testing
+=====================
+
+See test program at the bottom of this file.
+
+Initial tests:
+
+ - When in relative mode, the mouse shouldn't be moveable outside of the window.
+ - When the cursor is outside the window when relative mode is enabled, mouse
+   clicks should not go to whatever app was under the cursor previously.
+ - When alt/cmd-tabbing between a relative mode app and another app, clicks when
+   in the relative mode app should also not go to whatever app was under the
+   cursor previously.
+
+
+Code
+====
+
+    #include <SDL.h>
+
+    int PollEvents()
+    {
+        SDL_Event event;
+        while (SDL_PollEvent(&event))
+        {
+            switch (event.type)
+            {
+                case SDL_EVENT_QUIT:
+                    return 1;
+                default:
+                    break;
+            }
+        }
+
+        return 0;
+    }
+
+    int main(int argc, char *argv[])
+    {
+        SDL_Window *win;
+
+        SDL_Init(SDL_INIT_VIDEO);
+
+        win = SDL_CreateWindow("Test", 800, 600, 0);
+        SDL_SetWindowRelativeMouseMode(win, true);
+
+        while (1)
+        {
+            if (PollEvents())
+                break;
+        }
+
+        SDL_DestroyWindow(win);
+
+        SDL_Quit();
+
+        return 0;
+    }
-- 
cgit v1.2.3