ruby2d 0.12.0 → 1.0.0

data/assets/{include/SDL2 → platform/include/SDL3}/SDL_test.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,31 +20,27 @@
 */
 
 /**
- *  \file SDL_test.h
- *
  *  Include file for SDL test framework.
  *
- *  This code is a part of the SDL2_test library, not the main SDL library.
+ *  This code is a part of the SDL test library, not the main SDL library.
  */
 
 #ifndef SDL_test_h_
 #define SDL_test_h_
 
-#include "SDL.h"
-#include "SDL_test_assert.h"
-#include "SDL_test_common.h"
-#include "SDL_test_compare.h"
-#include "SDL_test_crc32.h"
-#include "SDL_test_font.h"
-#include "SDL_test_fuzzer.h"
-#include "SDL_test_harness.h"
-#include "SDL_test_images.h"
-#include "SDL_test_log.h"
-#include "SDL_test_md5.h"
-#include "SDL_test_memory.h"
-#include "SDL_test_random.h"
-
-#include "begin_code.h"
+#include <SDL3/SDL.h>
+#include <SDL3/SDL_test_assert.h>
+#include <SDL3/SDL_test_common.h>
+#include <SDL3/SDL_test_compare.h>
+#include <SDL3/SDL_test_crc32.h>
+#include <SDL3/SDL_test_font.h>
+#include <SDL3/SDL_test_fuzzer.h>
+#include <SDL3/SDL_test_harness.h>
+#include <SDL3/SDL_test_log.h>
+#include <SDL3/SDL_test_md5.h>
+#include <SDL3/SDL_test_memory.h>
+
+#include <SDL3/SDL_begin_code.h>
 /* Set up for C function definitions, even when using C++ */
 #ifdef __cplusplus
 extern "C" {
@@ -62,8 +58,6 @@ extern "C" {
 #ifdef __cplusplus
 }
 #endif
-#include "close_code.h"
+#include <SDL3/SDL_close_code.h>
 
 #endif /* SDL_test_h_ */
-
-/* vi: set ts=4 sw=4 expandtab: */

data/assets/{include/SDL2 → platform/include/SDL3}/SDL_test_assert.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,11 +20,9 @@
 */
 
 /**
- *  \file SDL_test_assert.h
+ *  Assertion functions of SDL test framework.
  *
- *  Include file for SDL test framework.
- *
- *  This code is a part of the SDL2_test library, not the main SDL library.
+ *  This code is a part of the SDL test library, not the main SDL library.
  */
 
 /*
@@ -36,70 +34,65 @@
 #ifndef SDL_test_assert_h_
 #define SDL_test_assert_h_
 
-#include "begin_code.h"
+#include <SDL3/SDL_stdinc.h>
+
+#include <SDL3/SDL_begin_code.h>
 /* Set up for C function definitions, even when using C++ */
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-/**
- * \brief Fails the assert.
- */
+/* Fails the assert. */
 #define ASSERT_FAIL     0
 
-/**
- * \brief Passes the assert.
- */
+/* Passes the assert. */
 #define ASSERT_PASS     1
 
-/**
- * \brief Assert that logs and break execution flow on failures.
+/*
+ * Assert that logs and break execution flow on failures.
  *
  * \param assertCondition Evaluated condition or variable to assert; fail (==0) or pass (!=0).
  * \param assertDescription Message to log with the assert describing it.
  */
-void SDLTest_Assert(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(2);
+void SDLCALL SDLTest_Assert(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(2);
 
-/**
- * \brief Assert for test cases that logs but does not break execution flow on failures. Updates assertion counters.
+/*
+ * Assert for test cases that logs but does not break execution flow on failures. Updates assertion counters.
  *
  * \param assertCondition Evaluated condition or variable to assert; fail (==0) or pass (!=0).
  * \param assertDescription Message to log with the assert describing it.
  *
  * \returns the assertCondition so it can be used to externally to break execution flow if desired.
  */
-int SDLTest_AssertCheck(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(2);
+int SDLCALL SDLTest_AssertCheck(int assertCondition, SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(2);
 
-/**
- * \brief Explicitly pass without checking an assertion condition. Updates assertion counter.
+/*
+ * Explicitly pass without checking an assertion condition. Updates assertion counter.
  *
  * \param assertDescription Message to log with the assert describing it.
  */
-void SDLTest_AssertPass(SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(1);
+void SDLCALL SDLTest_AssertPass(SDL_PRINTF_FORMAT_STRING const char *assertDescription, ...) SDL_PRINTF_VARARG_FUNC(1);
 
-/**
- * \brief Resets the assert summary counters to zero.
+/*
+ * Resets the assert summary counters to zero.
  */
-void SDLTest_ResetAssertSummary(void);
+void SDLCALL SDLTest_ResetAssertSummary(void);
 
-/**
- * \brief Logs summary of all assertions (total, pass, fail) since last reset as INFO or ERROR.
+/*
+ * Logs summary of all assertions (total, pass, fail) since last reset as INFO or ERROR.
  */
-void SDLTest_LogAssertSummary(void);
-
+void SDLCALL SDLTest_LogAssertSummary(void);
 
-/**
- * \brief Converts the current assert summary state to a test result.
+/*
+ * Converts the current assert summary state to a test result.
  *
  * \returns TEST_RESULT_PASSED, TEST_RESULT_FAILED, or TEST_RESULT_NO_ASSERT
  */
-int SDLTest_AssertSummaryToTestResult(void);
+int SDLCALL SDLTest_AssertSummaryToTestResult(void);
 
 #ifdef __cplusplus
 }
 #endif
-#include "close_code.h"
+#include <SDL3/SDL_close_code.h>
 
 #endif /* SDL_test_assert_h_ */
-
-/* vi: set ts=4 sw=4 expandtab: */

data/assets/{include/SDL2 → platform/include/SDL3}/SDL_test_common.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,24 +20,22 @@
 */
 
 /**
- *  \file SDL_test_common.h
+ *  Common functions of SDL test framework.
  *
- *  Include file for SDL test framework.
- *
- *  This code is a part of the SDL2_test library, not the main SDL library.
+ *  This code is a part of the SDL test library, not the main SDL library.
  */
 
-/* Ported from original test\common.h file. */
+/* Ported from original test/common.h file. */
 
 #ifndef SDL_test_common_h_
 #define SDL_test_common_h_
 
-#include "SDL.h"
+#include <SDL3/SDL.h>
 
-#if defined(__PSP__)
+#ifdef SDL_PLATFORM_PSP
 #define DEFAULT_WINDOW_WIDTH  480
 #define DEFAULT_WINDOW_HEIGHT 272
-#elif defined(__VITA__)
+#elif defined(SDL_PLATFORM_VITA)
 #define DEFAULT_WINDOW_WIDTH  960
 #define DEFAULT_WINDOW_HEIGHT 544
 #else
@@ -45,6 +43,7 @@
 #define DEFAULT_WINDOW_HEIGHT 480
 #endif
 
+typedef Uint32 SDLTest_VerboseFlags;
 #define VERBOSE_VIDEO   0x00000001
 #define VERBOSE_MODES   0x00000002
 #define VERBOSE_RENDER  0x00000004
@@ -52,20 +51,42 @@
 #define VERBOSE_AUDIO   0x00000010
 #define VERBOSE_MOTION  0x00000020
 
+/* !< Function pointer parsing one argument at argv[index], returning the number of parsed arguments,
+ *    or a negative value when the argument is invalid */
+typedef int (SDLCALL *SDLTest_ParseArgumentsFp)(void *data, char **argv, int index);
+
+/* !< Finalize the argument parser. */
+typedef void (SDLCALL *SDLTest_FinalizeArgumentParserFp)(void *arg);
+
+typedef struct SDLTest_ArgumentParser
+{
+    /* !< Parse an argument. */
+    SDLTest_ParseArgumentsFp parse_arguments;
+    /* !< Finalize this argument parser. Called once before parsing the first argument. */
+    SDLTest_FinalizeArgumentParserFp finalize;
+    /* !< Null-terminated array of arguments. Printed when running with --help. */
+    const char **usage;
+    /* !< User data, passed to all callbacks. */
+    void *data;
+    /* !< Next argument parser. */
+    struct SDLTest_ArgumentParser *next;
+} SDLTest_ArgumentParser;
+
 typedef struct
 {
     /* SDL init flags */
     char **argv;
-    Uint32 flags;
-    Uint32 verbose;
+    SDL_InitFlags flags;
+    SDLTest_VerboseFlags verbose;
 
     /* Video info */
     const char *videodriver;
-    int display;
+    int display_index;
+    SDL_DisplayID displayID;
     const char *window_title;
     const char *window_icon;
-    Uint32 window_flags;
-    SDL_bool flash_on_focus_loss;
+    SDL_WindowFlags window_flags;
+    bool flash_on_focus_loss;
     int window_x;
     int window_y;
     int window_w;
@@ -74,24 +95,35 @@ typedef struct
     int window_minH;
     int window_maxW;
     int window_maxH;
+    float window_min_aspect;
+    float window_max_aspect;
     int logical_w;
     int logical_h;
+    bool auto_scale_content;
+    SDL_RendererLogicalPresentation logical_presentation;
     float scale;
     int depth;
-    int refresh_rate;
+    float refresh_rate;
+    bool fill_usable_bounds;
+    bool fullscreen_exclusive;
+    SDL_DisplayMode fullscreen_mode;
     int num_windows;
     SDL_Window **windows;
+    const char *gpudriver;
 
     /* Renderer info */
     const char *renderdriver;
-    Uint32 render_flags;
-    SDL_bool skip_renderer;
+    int render_vsync;
+    bool skip_renderer;
     SDL_Renderer **renderers;
     SDL_Texture **targets;
 
     /* Audio info */
     const char *audiodriver;
-    SDL_AudioSpec audiospec;
+    SDL_AudioFormat audio_format;
+    int audio_channels;
+    int audio_freq;
+    SDL_AudioDeviceID audio_id;
 
     /* GL settings */
     int gl_red_size;
@@ -107,6 +139,7 @@ typedef struct
     int gl_accum_blue_size;
     int gl_accum_alpha_size;
     int gl_stereo;
+    int gl_release_behavior;
     int gl_multisamplebuffers;
     int gl_multisamplesamples;
     int gl_retained_backing;
@@ -116,12 +149,23 @@ typedef struct
     int gl_debug;
     int gl_profile_mask;
 
-    /* Additional fields added in 2.0.18 */
+    /* Mouse info */
     SDL_Rect confine;
+    bool hide_cursor;
+
+    /* Misc. */
+    int quit_after_ms_interval;
+    SDL_TimerID quit_after_ms_timer;
+
+    /* Options info */
+    SDLTest_ArgumentParser common_argparser;
+    SDLTest_ArgumentParser video_argparser;
+    SDLTest_ArgumentParser audio_argparser;
 
+    SDLTest_ArgumentParser *argparser;
 } SDLTest_CommonState;
 
-#include "begin_code.h"
+#include <SDL3/SDL_begin_code.h>
 /* Set up for C function definitions, even when using C++ */
 #ifdef __cplusplus
 extern "C" {
@@ -130,28 +174,37 @@ extern "C" {
 /* Function prototypes */
 
 /**
- * \brief Parse command line parameters and create common state.
+ * Parse command line parameters and create common state.
  *
  * \param argv Array of command line parameters
  * \param flags Flags indicating which subsystem to initialize (i.e. SDL_INIT_VIDEO | SDL_INIT_AUDIO)
  *
  * \returns a newly allocated common state object.
  */
-SDLTest_CommonState *SDLTest_CommonCreateState(char **argv, Uint32 flags);
+SDLTest_CommonState * SDLCALL SDLTest_CommonCreateState(char **argv, SDL_InitFlags flags);
 
 /**
- * \brief Process one common argument.
+ * Free the common state object.
+ *
+ * You should call SDL_Quit() before calling this function.
+ *
+ * \param state The common state object to destroy
+ */
+void SDLCALL SDLTest_CommonDestroyState(SDLTest_CommonState *state);
+
+/**
+ * Process one common argument.
  *
  * \param state The common state describing the test window to create.
  * \param index The index of the argument to process in argv[].
  *
  * \returns the number of arguments processed (i.e. 1 for --fullscreen, 2 for --video [videodriver], or -1 on error.
  */
-int SDLTest_CommonArg(SDLTest_CommonState * state, int index);
+int SDLCALL SDLTest_CommonArg(SDLTest_CommonState *state, int index);
 
 
 /**
- * \brief Logs command line usage info.
+ * Logs command line usage info.
  *
  * This logs the appropriate command line options for the subsystems in use
  *  plus other common options, and then any application-specific options.
@@ -162,75 +215,79 @@ int SDLTest_CommonArg(SDLTest_CommonState * state, int index);
  * \param argv0 argv[0], as passed to main/SDL_main.
  * \param options an array of strings for application specific options. The last element of the array should be NULL.
  */
-void SDLTest_CommonLogUsage(SDLTest_CommonState * state, const char *argv0, const char **options);
+void SDLCALL SDLTest_CommonLogUsage(SDLTest_CommonState *state, const char *argv0, const char **options);
 
 /**
- * \brief Returns common usage information
- *
- * You should (probably) be using SDLTest_CommonLogUsage() instead, but this
- *  function remains for binary compatibility. Strings returned from this
- *  function are valid until SDLTest_CommonQuit() is called, in which case
- *  those strings' memory is freed and can no longer be used.
+ * Open test window.
  *
  * \param state The common state describing the test window to create.
- * \returns a string with usage information
+ *
+ * \returns true if initialization succeeded, false otherwise
  */
-const char *SDLTest_CommonUsage(SDLTest_CommonState * state);
+bool SDLCALL SDLTest_CommonInit(SDLTest_CommonState *state);
 
 /**
- * \brief Open test window.
+ * Easy argument handling when test app doesn't need any custom args.
  *
  * \param state The common state describing the test window to create.
+ * \param argc argc, as supplied to SDL_main
+ * \param argv argv, as supplied to SDL_main
  *
- * \returns SDL_TRUE if initialization succeeded, false otherwise
+ * \returns false if app should quit, true otherwise.
  */
-SDL_bool SDLTest_CommonInit(SDLTest_CommonState * state);
+bool SDLCALL SDLTest_CommonDefaultArgs(SDLTest_CommonState *state, int argc, char **argv);
 
 /**
- * \brief Easy argument handling when test app doesn't need any custom args.
+ * Print the details of an event.
  *
- * \param state The common state describing the test window to create.
- * \param argc argc, as supplied to SDL_main
- * \param argv argv, as supplied to SDL_main
+ * This is automatically called by SDLTest_CommonEvent() as needed.
  *
- * \returns SDL_FALSE if app should quit, true otherwise.
+ * \param event The event to print.
  */
-SDL_bool SDLTest_CommonDefaultArgs(SDLTest_CommonState * state, const int argc, char **argv);
+void SDLCALL SDLTest_PrintEvent(const SDL_Event *event);
 
 /**
- * \brief Common event handler for test windows.
+ * Common event handler for test windows if you use a standard SDL_main.
  *
  * \param state The common state used to create test window.
  * \param event The event to handle.
  * \param done Flag indicating we are done.
+ */
+void SDLCALL SDLTest_CommonEvent(SDLTest_CommonState *state, SDL_Event *event, int *done);
+
+/**
+ * Common event handler for test windows if you use SDL_AppEvent.
+ *
+ * This does _not_ free anything in `event`.
  *
+ * \param state The common state used to create test window.
+ * \param event The event to handle.
+ * \returns Value suitable for returning from SDL_AppEvent().
  */
-void SDLTest_CommonEvent(SDLTest_CommonState * state, SDL_Event * event, int *done);
+SDL_AppResult SDLCALL SDLTest_CommonEventMainCallbacks(SDLTest_CommonState *state, const SDL_Event *event);
 
 /**
- * \brief Close test window.
+ * Close test window.
  *
  * \param state The common state used to create test window.
  *
  */
-void SDLTest_CommonQuit(SDLTest_CommonState * state);
+void SDLCALL SDLTest_CommonQuit(SDLTest_CommonState *state);
 
 /**
- * \brief Draws various window information (position, size, etc.) to the renderer.
+ * Draws various window information (position, size, etc.) to the renderer.
  *
  * \param renderer The renderer to draw to.
  * \param window The window whose information should be displayed.
  * \param usedHeight Returns the height used, so the caller can draw more below.
  *
  */
-void SDLTest_CommonDrawWindowInfo(SDL_Renderer * renderer, SDL_Window * window, int * usedHeight);
+void SDLCALL SDLTest_CommonDrawWindowInfo(SDL_Renderer *renderer, SDL_Window *window, float *usedHeight);
 
 /* Ends C function definitions when using C++ */
 #ifdef __cplusplus
 }
 #endif
-#include "close_code.h"
+#include <SDL3/SDL_close_code.h>
 
 #endif /* SDL_test_common_h_ */
-
-/* vi: set ts=4 sw=4 expandtab: */

data/assets/{include/SDL2 → platform/include/SDL3}/SDL_test_compare.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,11 +20,9 @@
 */
 
 /**
- *  \file SDL_test_compare.h
+ *  Comparison function of SDL test framework.
  *
- *  Include file for SDL test framework.
- *
- *  This code is a part of the SDL2_test library, not the main SDL library.
+ *  This code is a part of the SDL test library, not the main SDL library.
  */
 
 /*
@@ -36,18 +34,16 @@
 #ifndef SDL_test_compare_h_
 #define SDL_test_compare_h_
 
-#include "SDL.h"
-
-#include "SDL_test_images.h"
+#include <SDL3/SDL.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 Compares a surface and with reference image data for equality
+ * Compares a surface and with reference image data for equality
  *
  * \param surface Surface used in comparison
  * \param referenceSurface Test Surface used in comparison
@@ -55,15 +51,27 @@ extern "C" {
  *
  * \returns 0 if comparison succeeded, >0 (=number of pixels for which the comparison failed) if comparison failed, -1 if any of the surfaces were NULL, -2 if the surface sizes differ.
  */
-int SDLTest_CompareSurfaces(SDL_Surface *surface, SDL_Surface *referenceSurface, int allowable_error);
+int SDLCALL SDLTest_CompareSurfaces(SDL_Surface *surface, SDL_Surface *referenceSurface, int allowable_error);
+int SDLCALL SDLTest_CompareSurfacesIgnoreTransparentPixels(SDL_Surface *surface, SDL_Surface *referenceSurface, int allowable_error);
 
+/**
+ * Compares 2 memory blocks for equality
+ *
+ * \param actual Memory used in comparison, displayed on the left
+ * \param size_actual Size of actual in bytes
+ * \param reference Reference memory, displayed on the right
+ * \param size_reference Size of reference in bytes
+ *
+ * \returns 0 if the left and right memory block are equal, non-zero if they are non-equal.
+ *
+ * \since This function is available since SDL 3.2.0.
+ */
+int SDLCALL SDLTest_CompareMemory(const void *actual, size_t size_actual, const void *reference, size_t size_reference);
 
 /* Ends C function definitions when using C++ */
 #ifdef __cplusplus
 }
 #endif
-#include "close_code.h"
+#include <SDL3/SDL_close_code.h>
 
 #endif /* SDL_test_compare_h_ */
-
-/* vi: set ts=4 sw=4 expandtab: */