ruby2d 0.12.1 → 1.0.0

data/assets/platform/include/SDL3/SDL_main_impl.h

@@ -0,0 +1,151 @@
+/*
+  Simple DirectMedia Layer
+  Copyright (C) 1997-2026 Sam Lantinga <slouken@libsdl.org>
+
+  This software is provided 'as-is', without any express or implied
+  warranty.  In no event will the authors be held liable for any damages
+  arising from the use of this software.
+
+  Permission is granted to anyone to use this software for any purpose,
+  including commercial applications, and to alter it and redistribute it
+  freely, subject to the following restrictions:
+
+  1. The origin of this software must not be misrepresented; you must not
+     claim that you wrote the original software. If you use this software
+     in a product, an acknowledgment in the product documentation would be
+     appreciated but is not required.
+  2. Altered source versions must be plainly marked as such, and must not be
+     misrepresented as being the original software.
+  3. This notice may not be removed or altered from any source distribution.
+*/
+
+/* WIKI CATEGORY: Main */
+
+#ifndef SDL_main_impl_h_
+#define SDL_main_impl_h_
+
+#ifndef SDL_main_h_
+#error "This header should not be included directly, but only via SDL_main.h!"
+#endif
+
+/* if someone wants to include SDL_main.h but doesn't want the main handing magic,
+   (maybe to call SDL_RegisterApp()) they can #define SDL_MAIN_HANDLED first.
+   SDL_MAIN_NOIMPL is for SDL-internal usage (only affects implementation,
+   not definition of SDL_MAIN_AVAILABLE etc in SDL_main.h) and if the user wants
+   to have the SDL_main implementation (from this header) in another source file
+   than their main() function, for example if SDL_main requires C++
+   and main() is implemented in plain C */
+#if !defined(SDL_MAIN_HANDLED) && !defined(SDL_MAIN_NOIMPL)
+
+    /* the implementations below must be able to use the implement real main(), nothing renamed
+       (the user's main() will be renamed to SDL_main so it can be called from here) */
+    #ifdef main
+        #undef main
+    #endif
+
+    #ifdef SDL_MAIN_USE_CALLBACKS
+
+        #if 0
+            /* currently there are no platforms that _need_ a magic entry point here
+               for callbacks, but if one shows up, implement it here. */
+
+        #else /* use a standard SDL_main, which the app SHOULD NOT ALSO SUPPLY. */
+
+            /* this define makes the normal SDL_main entry point stuff work...we just provide SDL_main() instead of the app. */
+            #define SDL_MAIN_CALLBACK_STANDARD 1
+
+            int SDL_main(int argc, char **argv)
+            {
+                return SDL_EnterAppMainCallbacks(argc, argv, SDL_AppInit, SDL_AppIterate, SDL_AppEvent, SDL_AppQuit);
+            }
+
+        #endif  /* platform-specific tests */
+
+    #endif  /* SDL_MAIN_USE_CALLBACKS */
+
+
+    /* set up the usual SDL_main stuff if we're not using callbacks or if we are but need the normal entry point,
+       unless the real entry point needs to be somewhere else entirely, like Android where it's in Java code */
+    #if (!defined(SDL_MAIN_USE_CALLBACKS) || defined(SDL_MAIN_CALLBACK_STANDARD)) && !defined(SDL_MAIN_EXPORTED)
+
+        #if defined(SDL_PLATFORM_PRIVATE_MAIN)
+            /* Private platforms may have their own ideas about entry points. */
+            #include "SDL_main_impl_private.h"
+
+        #elif defined(SDL_PLATFORM_WINDOWS)
+
+            /* these defines/typedefs are needed for the WinMain() definition */
+            #ifndef WINAPI
+                #define WINAPI __stdcall
+            #endif
+
+            typedef struct HINSTANCE__ * HINSTANCE;
+            typedef char *LPSTR;
+            typedef wchar_t *PWSTR;
+
+            /* The VC++ compiler needs main/wmain defined, but not for GDK */
+            #if defined(_MSC_VER) && !defined(SDL_PLATFORM_GDK)
+
+                /* This is where execution begins [console apps] */
+                #if defined(UNICODE) && UNICODE
+                    int wmain(int argc, wchar_t *wargv[], wchar_t *wenvp)
+                    {
+                        (void)argc;
+                        (void)wargv;
+                        (void)wenvp;
+                        return SDL_RunApp(0, NULL, SDL_main, NULL);
+                    }
+                #else /* ANSI */
+                    int main(int argc, char *argv[])
+                    {
+                        (void)argc;
+                        (void)argv;
+                        return SDL_RunApp(0, NULL, SDL_main, NULL);
+                    }
+                #endif /* UNICODE */
+
+            #endif /* _MSC_VER && ! SDL_PLATFORM_GDK */
+
+            /* This is where execution begins [windowed apps and GDK] */
+
+            #ifdef __cplusplus
+            extern "C" {
+            #endif
+
+            #if defined(UNICODE) && UNICODE
+            int WINAPI wWinMain(HINSTANCE hInst, HINSTANCE hPrev, PWSTR szCmdLine, int sw)
+            #else /* ANSI */
+            int WINAPI WinMain(HINSTANCE hInst, HINSTANCE hPrev, LPSTR szCmdLine, int sw)
+            #endif
+            {
+                (void)hInst;
+                (void)hPrev;
+                (void)szCmdLine;
+                (void)sw;
+                return SDL_RunApp(0, NULL, SDL_main, NULL);
+            }
+
+            #ifdef __cplusplus
+            } /* extern "C" */
+            #endif
+
+            /* end of SDL_PLATFORM_WINDOWS impls */
+
+        #else /* platforms that use a standard main() and just call SDL_RunApp(), like iOS and 3DS */
+            int main(int argc, char *argv[])
+            {
+                return SDL_RunApp(argc, argv, SDL_main, NULL);
+            }
+
+            /* end of impls for standard-conforming platforms */
+
+        #endif /* SDL_PLATFORM_WIN32 etc */
+
+    #endif /* !defined(SDL_MAIN_USE_CALLBACKS) || defined(SDL_MAIN_CALLBACK_STANDARD) */
+
+    /* rename users main() function to SDL_main() so it can be called from the wrappers above */
+    #define main    SDL_main
+
+#endif /* SDL_MAIN_HANDLED */
+
+#endif /* SDL_main_impl_h_ */

data/assets/{include/SDL2 → platform/include/SDL3}/SDL_messagebox.h

@@ -1,6 +1,6 @@
 /*
   Simple DirectMedia Layer
-  Copyright (C) 1997-2022 Sam Lantinga <slouken@libsdl.org>
+  Copyright (C) 1997-2026 Sam Lantinga <slouken@libsdl.org>
 
   This software is provided 'as-is', without any express or implied
   warranty.  In no event will the authors be held liable for any damages
@@ -19,81 +19,115 @@
   3. This notice may not be removed or altered from any source distribution.
 */
 
+/**
+ * # CategoryMessagebox
+ *
+ * SDL offers a simple message box API, which is useful for simple alerts,
+ * such as informing the user when something fatal happens at startup without
+ * the need to build a UI for it (or informing the user _before_ your UI is
+ * ready).
+ *
+ * These message boxes are native system dialogs where possible.
+ *
+ * There is both a customizable function (SDL_ShowMessageBox()) that offers
+ * lots of options for what to display and reports on what choice the user
+ * made, and also a much-simplified version (SDL_ShowSimpleMessageBox()),
+ * merely takes a text message and title, and waits until the user presses a
+ * single "OK" UI button. Often, this is all that is necessary.
+ */
+
 #ifndef SDL_messagebox_h_
 #define SDL_messagebox_h_
 
-#include "SDL_stdinc.h"
-#include "SDL_video.h"      /* For SDL_Window */
+#include <SDL3/SDL_stdinc.h>
+#include <SDL3/SDL_error.h>
+#include <SDL3/SDL_video.h>      /* For SDL_Window */
 
-#include "begin_code.h"
+#include <SDL3/SDL_begin_code.h>
 /* Set up for C function definitions, even when using C++ */
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 /**
- * SDL_MessageBox flags. If supported will display warning icon, etc.
+ * Message box flags.
+ *
+ * If supported will display warning icon, etc.
+ *
+ * \since This datatype is available since SDL 3.2.0.
  */
-typedef enum
-{
-    SDL_MESSAGEBOX_ERROR                 = 0x00000010,   /**< error dialog */
-    SDL_MESSAGEBOX_WARNING               = 0x00000020,   /**< warning dialog */
-    SDL_MESSAGEBOX_INFORMATION           = 0x00000040,   /**< informational dialog */
-    SDL_MESSAGEBOX_BUTTONS_LEFT_TO_RIGHT = 0x00000080,   /**< buttons placed left to right */
-    SDL_MESSAGEBOX_BUTTONS_RIGHT_TO_LEFT = 0x00000100    /**< buttons placed right to left */
-} SDL_MessageBoxFlags;
+typedef Uint32 SDL_MessageBoxFlags;
+
+#define SDL_MESSAGEBOX_ERROR                    0x00000010u /**< error dialog */
+#define SDL_MESSAGEBOX_WARNING                  0x00000020u /**< warning dialog */
+#define SDL_MESSAGEBOX_INFORMATION              0x00000040u /**< informational dialog */
+#define SDL_MESSAGEBOX_BUTTONS_LEFT_TO_RIGHT    0x00000080u /**< buttons placed left to right */
+#define SDL_MESSAGEBOX_BUTTONS_RIGHT_TO_LEFT    0x00000100u /**< buttons placed right to left */
 
 /**
- * Flags for SDL_MessageBoxButtonData.
+ * SDL_MessageBoxButtonData flags.
+ *
+ * \since This datatype is available since SDL 3.2.0.
  */
-typedef enum
-{
-    SDL_MESSAGEBOX_BUTTON_RETURNKEY_DEFAULT = 0x00000001,  /**< Marks the default button when return is hit */
-    SDL_MESSAGEBOX_BUTTON_ESCAPEKEY_DEFAULT = 0x00000002   /**< Marks the default button when escape is hit */
-} SDL_MessageBoxButtonFlags;
+typedef Uint32 SDL_MessageBoxButtonFlags;
+
+#define SDL_MESSAGEBOX_BUTTON_RETURNKEY_DEFAULT 0x00000001u /**< Marks the default button when return is hit */
+#define SDL_MESSAGEBOX_BUTTON_ESCAPEKEY_DEFAULT 0x00000002u /**< Marks the default button when escape is hit */
 
 /**
  * Individual button data.
+ *
+ * \since This struct is available since SDL 3.2.0.
  */
-typedef struct
+typedef struct SDL_MessageBoxButtonData
 {
-    Uint32 flags;       /**< ::SDL_MessageBoxButtonFlags */
-    int buttonid;       /**< User defined button id (value returned via SDL_ShowMessageBox) */
-    const char * text;  /**< The UTF-8 button text */
+    SDL_MessageBoxButtonFlags flags;
+    int buttonID;       /**< User defined button id (value returned via SDL_ShowMessageBox) */
+    const char *text;   /**< The UTF-8 button text */
 } SDL_MessageBoxButtonData;
 
 /**
  * RGB value used in a message box color scheme
+ *
+ * \since This struct is available since SDL 3.2.0.
  */
-typedef struct
+typedef struct SDL_MessageBoxColor
 {
     Uint8 r, g, b;
 } SDL_MessageBoxColor;
 
-typedef enum
+/**
+ * An enumeration of indices inside the colors array of
+ * SDL_MessageBoxColorScheme.
+ */
+typedef enum SDL_MessageBoxColorType
 {
     SDL_MESSAGEBOX_COLOR_BACKGROUND,
     SDL_MESSAGEBOX_COLOR_TEXT,
     SDL_MESSAGEBOX_COLOR_BUTTON_BORDER,
     SDL_MESSAGEBOX_COLOR_BUTTON_BACKGROUND,
     SDL_MESSAGEBOX_COLOR_BUTTON_SELECTED,
-    SDL_MESSAGEBOX_COLOR_MAX
+    SDL_MESSAGEBOX_COLOR_COUNT                    /**< Size of the colors array of SDL_MessageBoxColorScheme. */
 } SDL_MessageBoxColorType;
 
 /**
  * A set of colors to use for message box dialogs
+ *
+ * \since This struct is available since SDL 3.2.0.
  */
-typedef struct
+typedef struct SDL_MessageBoxColorScheme
 {
-    SDL_MessageBoxColor colors[SDL_MESSAGEBOX_COLOR_MAX];
+    SDL_MessageBoxColor colors[SDL_MESSAGEBOX_COLOR_COUNT];
 } SDL_MessageBoxColorScheme;
 
 /**
  * MessageBox structure containing title, text, window, etc.
+ *
+ * \since This struct is available since SDL 3.2.0.
  */
-typedef struct
+typedef struct SDL_MessageBoxData
 {
-    Uint32 flags;                       /**< ::SDL_MessageBoxFlags */
+    SDL_MessageBoxFlags flags;
     SDL_Window *window;                 /**< Parent window, can be NULL */
     const char *title;                  /**< UTF-8 title */
     const char *message;                /**< UTF-8 message text */
@@ -101,7 +135,7 @@ typedef struct
     int numbuttons;
     const SDL_MessageBoxButtonData *buttons;
 
-    const SDL_MessageBoxColorScheme *colorScheme;   /**< ::SDL_MessageBoxColorScheme, can be NULL to use system settings */
+    const SDL_MessageBoxColorScheme *colorScheme;   /**< SDL_MessageBoxColorScheme, can be NULL to use system settings */
 } SDL_MessageBoxData;
 
 /**
@@ -128,16 +162,19 @@ typedef struct
  * to stderr if you can.
  *
  * \param messageboxdata the SDL_MessageBoxData structure with title, text and
- *                       other options
- * \param buttonid the pointer to which user id of hit button should be copied
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
+ *                       other options.
+ * \param buttonid the pointer to which user id of hit button should be
+ *                 copied.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
+ *
+ * \threadsafety This function should only be called on the main thread.
  *
- * \since This function is available since SDL 2.0.0.
+ * \since This function is available since SDL 3.2.0.
  *
  * \sa SDL_ShowSimpleMessageBox
  */
-extern DECLSPEC int SDLCALL SDL_ShowMessageBox(const SDL_MessageBoxData *messageboxdata, int *buttonid);
+extern SDL_DECLSPEC bool SDLCALL SDL_ShowMessageBox(const SDL_MessageBoxData *messageboxdata, int *buttonid);
 
 /**
  * Display a simple modal message box.
@@ -168,26 +205,26 @@ extern DECLSPEC int SDLCALL SDL_ShowMessageBox(const SDL_MessageBoxData *message
  * concern, check the return value from this function and fall back to writing
  * to stderr if you can.
  *
- * \param flags an SDL_MessageBoxFlags value
- * \param title UTF-8 title text
- * \param message UTF-8 message text
- * \param window the parent window, or NULL for no parent
- * \returns 0 on success or a negative error code on failure; call
- *          SDL_GetError() for more information.
+ * \param flags an SDL_MessageBoxFlags value.
+ * \param title UTF-8 title text.
+ * \param message UTF-8 message text.
+ * \param window the parent window, or NULL for no parent.
+ * \returns true on success or false on failure; call SDL_GetError() for more
+ *          information.
  *
- * \since This function is available since SDL 2.0.0.
+ * \threadsafety This function should only be called on the main thread.
+ *
+ * \since This function is available since SDL 3.2.0.
  *
  * \sa SDL_ShowMessageBox
  */
-extern DECLSPEC int SDLCALL SDL_ShowSimpleMessageBox(Uint32 flags, const char *title, const char *message, SDL_Window *window);
+extern SDL_DECLSPEC bool SDLCALL SDL_ShowSimpleMessageBox(SDL_MessageBoxFlags flags, const char *title, const char *message, SDL_Window *window);
 
 
 /* Ends C function definitions when using C++ */
 #ifdef __cplusplus
 }
 #endif
-#include "close_code.h"
+#include <SDL3/SDL_close_code.h>
 
 #endif /* SDL_messagebox_h_ */
-
-/* vi: set ts=4 sw=4 expandtab: */

data/assets/{include/SDL2 → platform/include/SDL3}/SDL_metal.h

@@ -1,6 +1,6 @@
 /*
   Simple DirectMedia Layer
-  Copyright (C) 1997-2022 Sam Lantinga <slouken@libsdl.org>
+  Copyright (C) 1997-2026 Sam Lantinga <slouken@libsdl.org>
 
   This software is provided 'as-is', without any express or implied
   warranty.  In no event will the authors be held liable for any damages
@@ -20,26 +20,30 @@
 */
 
 /**
- *  \file SDL_metal.h
+ * # CategoryMetal
  *
- *  Header file for functions to creating Metal layers and views on SDL windows.
+ * Functions to creating Metal layers and views on SDL windows.
+ *
+ * This provides some platform-specific glue for Apple platforms. Most macOS
+ * and iOS apps can use SDL without these functions, but this API they can be
+ * useful for specific OS-level integration tasks.
  */
 
 #ifndef SDL_metal_h_
 #define SDL_metal_h_
 
-#include "SDL_video.h"
+#include <SDL3/SDL_video.h>
 
-#include "begin_code.h"
+#include <SDL3/SDL_begin_code.h>
 /* Set up for C function definitions, even when using C++ */
 #ifdef __cplusplus
 extern "C" {
 #endif
 
 /**
- *  \brief A handle to a CAMetalLayer-backed NSView (macOS) or UIView (iOS/tvOS).
+ * A handle to a CAMetalLayer-backed NSView (macOS) or UIView (iOS/tvOS).
  *
- *  \note This can be cast directly to an NSView or UIView.
+ * \since This datatype is available since SDL 3.2.0.
  */
 typedef void *SDL_MetalView;
 
@@ -58,12 +62,17 @@ typedef void *SDL_MetalView;
  * The returned handle can be casted directly to a NSView or UIView. To access
  * the backing CAMetalLayer, call SDL_Metal_GetLayer().
  *
- * \since This function is available since SDL 2.0.12.
+ * \param window the window.
+ * \returns handle NSView or UIView.
+ *
+ * \threadsafety This function should only be called on the main thread.
+ *
+ * \since This function is available since SDL 3.2.0.
  *
  * \sa SDL_Metal_DestroyView
  * \sa SDL_Metal_GetLayer
  */
-extern DECLSPEC SDL_MetalView SDLCALL SDL_Metal_CreateView(SDL_Window * window);
+extern SDL_DECLSPEC SDL_MetalView SDLCALL SDL_Metal_CreateView(SDL_Window *window);
 
 /**
  * Destroy an existing SDL_MetalView object.
@@ -71,36 +80,27 @@ extern DECLSPEC SDL_MetalView SDLCALL SDL_Metal_CreateView(SDL_Window * window);
  * This should be called before SDL_DestroyWindow, if SDL_Metal_CreateView was
  * called after SDL_CreateWindow.
  *
- * \since This function is available since SDL 2.0.12.
+ * \param view the SDL_MetalView object.
  *
- * \sa SDL_Metal_CreateView
- */
-extern DECLSPEC void SDLCALL SDL_Metal_DestroyView(SDL_MetalView view);
-
-/**
- * Get a pointer to the backing CAMetalLayer for the given view.
+ * \threadsafety This function should only be called on the main thread.
  *
- * \since This function is available since SDL 2.0.14.
+ * \since This function is available since SDL 3.2.0.
  *
  * \sa SDL_Metal_CreateView
  */
-extern DECLSPEC void *SDLCALL SDL_Metal_GetLayer(SDL_MetalView view);
+extern SDL_DECLSPEC void SDLCALL SDL_Metal_DestroyView(SDL_MetalView view);
 
 /**
- * Get the size of a window's underlying drawable in pixels (for use with
- * setting viewport, scissor & etc).
+ * Get a pointer to the backing CAMetalLayer for the given view.
  *
- * \param window SDL_Window from which the drawable size should be queried
- * \param w Pointer to variable for storing the width in pixels, may be NULL
- * \param h Pointer to variable for storing the height in pixels, may be NULL
+ * \param view the SDL_MetalView object.
+ * \returns a pointer.
  *
- * \since This function is available since SDL 2.0.14.
+ * \threadsafety This function should only be called on the main thread.
  *
- * \sa SDL_GetWindowSize
- * \sa SDL_CreateWindow
+ * \since This function is available since SDL 3.2.0.
  */
-extern DECLSPEC void SDLCALL SDL_Metal_GetDrawableSize(SDL_Window* window, int *w,
-                                                       int *h);
+extern SDL_DECLSPEC void * SDLCALL SDL_Metal_GetLayer(SDL_MetalView view);
 
 /* @} *//* Metal support functions */
 
@@ -108,6 +108,6 @@ extern DECLSPEC void SDLCALL SDL_Metal_GetDrawableSize(SDL_Window* window, int *
 #ifdef __cplusplus
 }
 #endif
-#include "close_code.h"
+#include <SDL3/SDL_close_code.h>
 
 #endif /* SDL_metal_h_ */

data/assets/{include/SDL2 → platform/include/SDL3}/SDL_misc.h

@@ -1,6 +1,6 @@
 /*
   Simple DirectMedia Layer
-  Copyright (C) 1997-2022 Sam Lantinga <slouken@libsdl.org>
+  Copyright (C) 1997-2026 Sam Lantinga <slouken@libsdl.org>
 
   This software is provided 'as-is', without any express or implied
   warranty.  In no event will the authors be held liable for any damages
@@ -20,17 +20,18 @@
 */
 
 /**
- *  \file SDL_misc.h
+ * # CategoryMisc
  *
- *  \brief Include file for SDL API functions that don't fit elsewhere.
+ * SDL API functions that don't fit elsewhere.
  */
 
 #ifndef SDL_misc_h_
 #define SDL_misc_h_
 
-#include "SDL_stdinc.h"
+#include <SDL3/SDL_stdinc.h>
+#include <SDL3/SDL_error.h>
 
-#include "begin_code.h"
+#include <SDL3/SDL_begin_code.h>
 
 /* Set up for C function definitions, even when using C++ */
 #ifdef __cplusplus
@@ -59,21 +60,21 @@ extern "C" {
  * All this to say: this function can be useful, but you should definitely
  * test it on every platform you target.
  *
- * \param url A valid URL/URI to open. Use `file:///full/path/to/file` for
+ * \param url a valid URL/URI to open. Use `file:///full/path/to/file` for
  *            local files, if supported.
- * \returns 0 on success, or -1 on error; call SDL_GetError() for more
+ * \returns true on success or false on failure; call SDL_GetError() for more
  *          information.
  *
- * \since This function is available since SDL 2.0.14.
+ * \threadsafety This function should only be called on the main thread.
+ *
+ * \since This function is available since SDL 3.2.0.
  */
-extern DECLSPEC int SDLCALL SDL_OpenURL(const char *url);
+extern SDL_DECLSPEC bool SDLCALL SDL_OpenURL(const char *url);
 
 /* Ends C function definitions when using C++ */
 #ifdef __cplusplus
 }
 #endif
-#include "close_code.h"
+#include <SDL3/SDL_close_code.h>
 
 #endif /* SDL_misc_h_ */
-
-/* vi: set ts=4 sw=4 expandtab: */