sdl3 1.0.0

data/lib/sdl3/raw/system.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    SDL_Sandbox = enum :SDL_Sandbox, [
+      :SDL_SANDBOX_NONE, 0,
+      :SDL_SANDBOX_UNKNOWN_CONTAINER, 1,
+      :SDL_SANDBOX_FLATPAK, 2,
+      :SDL_SANDBOX_SNAP, 3,
+      :SDL_SANDBOX_MACOS, 4
+    ]
+
+    attach_function :SDL_IsTablet, [], :bool
+    attach_function :SDL_IsTV, [], :bool
+    attach_function :SDL_GetSandbox, [], :SDL_Sandbox
+
+    begin
+      callback :SDL_X11EventHook, %i[pointer pointer], :bool
+      attach_function :SDL_SetX11EventHook, [:SDL_X11EventHook, :pointer], :void
+      attach_function :SDL_SetLinuxThreadPriority, %i[int64 int], :bool
+      attach_function :SDL_SetLinuxThreadPriorityAndPolicy, %i[int64 int int], :bool
+    rescue FFI::NotFoundError
+      # Linux/X11 specific APIs are not available on all platforms.
+    end
+
+    callback :SDL_WindowsMessageHook, [:pointer, :pointer, :uint, :uint64, :int64], :bool
+
+    begin
+      attach_function :SDL_SetWindowsMessageHook, [:SDL_WindowsMessageHook, :pointer], :void
+      attach_function :SDL_GetDirect3D9AdapterIndex, [:pointer], :int
+      attach_function :SDL_GetDXGIOutputInfo, [:pointer, :pointer, :pointer], :bool
+    rescue FFI::NotFoundError
+    end
+
+    begin
+      attach_function :SDL_GetAndroidJNIEnv, [], :pointer
+      attach_function :SDL_GetAndroidActivity, [], :pointer
+      attach_function :SDL_GetAndroidSDKVersion, [], :int
+      attach_function :SDL_IsChromebook, [], :bool
+      attach_function :SDL_IsDeXMode, [], :bool
+      attach_function :SDL_SendAndroidBackButton, [], :void
+      attach_function :SDL_GetAndroidInternalStoragePath, [], :string
+      attach_function :SDL_GetAndroidExternalStorageState, [], :uint32
+      attach_function :SDL_GetAndroidExternalStoragePath, [], :string
+      attach_function :SDL_GetAndroidCachePath, [], :string
+      callback :SDL_RequestAndroidPermissionCallback, [:pointer, :string, :bool], :void
+      attach_function :SDL_RequestAndroidPermission, [:string, :SDL_RequestAndroidPermissionCallback, :pointer], :bool
+      attach_function :SDL_ShowAndroidToast, [:string, :int, :int, :int, :int], :bool
+      attach_function :SDL_SendAndroidMessage, [:uint32, :int], :bool
+    rescue FFI::NotFoundError
+    end
+
+    begin
+      callback :SDL_iOSAnimationCallback, [:pointer], :void
+      attach_function :SDL_SetiOSAnimationCallback, [:pointer, :int, :SDL_iOSAnimationCallback, :pointer], :bool
+      attach_function :SDL_SetiOSEventPump, [:bool], :void
+    rescue FFI::NotFoundError
+    end
+
+    begin
+      attach_function :SDL_OnApplicationWillTerminate, [], :void
+      attach_function :SDL_OnApplicationDidReceiveMemoryWarning, [], :void
+      attach_function :SDL_OnApplicationWillEnterBackground, [], :void
+      attach_function :SDL_OnApplicationDidEnterBackground, [], :void
+      attach_function :SDL_OnApplicationWillEnterForeground, [], :void
+      attach_function :SDL_OnApplicationDidEnterForeground, [], :void
+      attach_function :SDL_OnApplicationDidChangeStatusBarOrientation, [], :void
+    rescue FFI::NotFoundError
+    end
+
+    begin
+      attach_function :SDL_GetGDKTaskQueue, [:pointer], :bool
+      attach_function :SDL_GetGDKDefaultUser, [:pointer], :bool
+    rescue FFI::NotFoundError
+    end
+  end
+end

data/lib/sdl3/raw/thread.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    typedef :uint64, :SDL_ThreadID
+
+    SDL_ThreadPriority = enum :SDL_THREAD_PRIORITY_LOW, 0,
+                              :SDL_THREAD_PRIORITY_NORMAL, 1,
+                              :SDL_THREAD_PRIORITY_HIGH, 2,
+                              :SDL_THREAD_PRIORITY_TIME_CRITICAL, 3
+
+    SDL_ThreadState = enum :SDL_THREAD_UNKNOWN, 0,
+                           :SDL_THREAD_ALIVE, 1,
+                           :SDL_THREAD_DETACHED, 2,
+                           :SDL_THREAD_COMPLETE, 3
+
+    callback :SDL_ThreadFunction, [:pointer], :int
+    callback :SDL_TLSDestructorCallback, [:pointer], :void
+
+    begin
+      attach_function :SDL_CreateThread, [:SDL_ThreadFunction, :string, :pointer], :pointer
+      attach_function :SDL_CreateThreadWithProperties, [:SDL_PropertiesID], :pointer
+    rescue FFI::NotFoundError
+      # Some SDL builds only export runtime thread creation entry points.
+    end
+
+    attach_function :SDL_CreateThreadRuntime, [:SDL_ThreadFunction, :string, :pointer, :pointer, :pointer], :pointer
+    attach_function :SDL_CreateThreadWithPropertiesRuntime, [:SDL_PropertiesID, :pointer, :pointer], :pointer
+    attach_function :SDL_GetThreadName, [:pointer], :string
+    attach_function :SDL_GetCurrentThreadID, [], :SDL_ThreadID
+    attach_function :SDL_GetThreadID, [:pointer], :SDL_ThreadID
+    attach_function :SDL_SetCurrentThreadPriority, [SDL_ThreadPriority], :bool
+    attach_function :SDL_WaitThread, %i[pointer pointer], :void
+    attach_function :SDL_GetThreadState, [:pointer], SDL_ThreadState
+    attach_function :SDL_DetachThread, [:pointer], :void
+    attach_function :SDL_GetTLS, [:pointer], :pointer
+    attach_function :SDL_SetTLS, [:pointer, :pointer, :SDL_TLSDestructorCallback], :bool
+    attach_function :SDL_CleanupTLS, [], :void
+  end
+end

data/lib/sdl3/raw/time.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    typedef :int64, :SDL_Time
+
+    SDL_DateFormat = enum :SDL_DATE_FORMAT_YYYYMMDD, 0,
+                          :SDL_DATE_FORMAT_DDMMYYYY, 1,
+                          :SDL_DATE_FORMAT_MMDDYYYY, 2
+
+    SDL_TimeFormat = enum :SDL_TIME_FORMAT_24HR, 0,
+                          :SDL_TIME_FORMAT_12HR, 1
+
+    class SDL_DateTime < FFI::Struct
+      layout :year, :int,
+             :month, :int,
+             :day, :int,
+             :hour, :int,
+             :minute, :int,
+             :second, :int,
+             :nanosecond, :int,
+             :day_of_week, :int,
+             :utc_offset, :int
+    end
+
+    attach_function :SDL_GetDateTimeLocalePreferences, %i[pointer pointer], :bool
+    attach_function :SDL_GetCurrentTime, [:pointer], :bool
+    attach_function :SDL_TimeToDateTime, [:SDL_Time, SDL_DateTime.ptr, :bool], :bool
+    attach_function :SDL_DateTimeToTime, [SDL_DateTime.ptr, :pointer], :bool
+    attach_function :SDL_TimeToWindows, [:SDL_Time, :pointer, :pointer], :void
+    attach_function :SDL_TimeFromWindows, %i[uint32 uint32], :SDL_Time
+    attach_function :SDL_GetDaysInMonth, %i[int int], :int
+    attach_function :SDL_GetDayOfYear, %i[int int int], :int
+    attach_function :SDL_GetDayOfWeek, %i[int int int], :int
+  end
+end

data/lib/sdl3/raw/timer.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    callback :SDL_TimerCallback, %i[pointer SDL_TimerID uint32], :uint32
+    callback :SDL_NSTimerCallback, %i[pointer SDL_TimerID uint64], :uint64
+
+    attach_function :SDL_GetTicks, [], :uint64
+    attach_function :SDL_GetTicksNS, [], :uint64
+    attach_function :SDL_GetPerformanceCounter, [], :uint64
+    attach_function :SDL_GetPerformanceFrequency, [], :uint64
+    attach_function :SDL_Delay, [:uint32], :void
+    attach_function :SDL_DelayNS, [:uint64], :void
+    attach_function :SDL_DelayPrecise, [:uint64], :void
+    attach_function :SDL_AddTimer, [:uint32, :SDL_TimerCallback, :pointer], :SDL_TimerID
+    attach_function :SDL_AddTimerNS, [:uint64, :SDL_NSTimerCallback, :pointer], :SDL_TimerID
+    attach_function :SDL_RemoveTimer, [:SDL_TimerID], :bool
+  end
+end

data/lib/sdl3/raw/touch.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    SDL_TouchDeviceType = enum :SDL_TOUCH_DEVICE_INVALID, -1,
+                               :SDL_TOUCH_DEVICE_DIRECT, 0,
+                               :SDL_TOUCH_DEVICE_INDIRECT_ABSOLUTE, 1,
+                               :SDL_TOUCH_DEVICE_INDIRECT_RELATIVE, 2
+
+    class SDL_Finger < FFI::Struct
+      layout :id, :SDL_FingerID,
+             :x, :float,
+             :y, :float,
+             :pressure, :float
+    end
+
+    attach_function :SDL_GetTouchDevices, [:pointer], :pointer
+    attach_function :SDL_GetTouchDeviceName, [:SDL_TouchID], :string
+    attach_function :SDL_GetTouchDeviceType, [:SDL_TouchID], SDL_TouchDeviceType
+    attach_function :SDL_GetTouchFingers, [:SDL_TouchID, :pointer], :pointer
+  end
+end

data/lib/sdl3/raw/tray.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    SDL_TrayEntryFlags = enum :SDL_TRAYENTRY_BUTTON, 0x00000001,
+                              :SDL_TRAYENTRY_CHECKBOX, 0x00000002,
+                              :SDL_TRAYENTRY_SUBMENU, 0x00000004,
+                              :SDL_TRAYENTRY_DISABLED, 0x80000000,
+                              :SDL_TRAYENTRY_CHECKED, 0x40000000
+
+    callback :SDL_TrayCallback, %i[pointer pointer], :void
+
+    begin
+      attach_function :SDL_CreateTray, %i[pointer string], :pointer
+      attach_function :SDL_CreateTrayWithProperties, [:SDL_PropertiesID], :pointer
+      attach_function :SDL_SetTrayIcon, %i[pointer pointer], :void
+      attach_function :SDL_SetTrayTooltip, %i[pointer string], :void
+      attach_function :SDL_CreateTrayMenu, [:pointer], :pointer
+      attach_function :SDL_CreateTraySubmenu, [:pointer], :pointer
+      attach_function :SDL_GetTrayMenu, [:pointer], :pointer
+      attach_function :SDL_GetTraySubmenu, [:pointer], :pointer
+      attach_function :SDL_GetTrayEntries, %i[pointer pointer], :pointer
+      attach_function :SDL_RemoveTrayEntry, [:pointer], :void
+      attach_function :SDL_InsertTrayEntryAt, %i[pointer int string uint32], :pointer
+      attach_function :SDL_SetTrayEntryLabel, %i[pointer string], :void
+      attach_function :SDL_GetTrayEntryLabel, [:pointer], :string
+      attach_function :SDL_SetTrayEntryChecked, %i[pointer bool], :void
+      attach_function :SDL_GetTrayEntryChecked, [:pointer], :bool
+      attach_function :SDL_SetTrayEntryEnabled, %i[pointer bool], :void
+      attach_function :SDL_GetTrayEntryEnabled, [:pointer], :bool
+      attach_function :SDL_SetTrayEntryCallback, [:pointer, :SDL_TrayCallback, :pointer], :void
+      attach_function :SDL_ClickTrayEntry, [:pointer], :void
+      attach_function :SDL_UpdateTrays, [], :void
+      attach_function :SDL_DestroyTray, [:pointer], :void
+      attach_function :SDL_GetTrayEntryParent, [:pointer], :pointer
+      attach_function :SDL_GetTrayMenuParentEntry, [:pointer], :pointer
+      attach_function :SDL_GetTrayMenuParentTray, [:pointer], :pointer
+    rescue FFI::NotFoundError
+      # Tray API may not be available in all SDL3 versions
+    end
+  end
+end

data/lib/sdl3/raw/types.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    typedef :uint32, :SDL_WindowID
+    typedef :uint32, :SDL_AudioDeviceID
+    typedef :uint32, :SDL_JoystickID
+    typedef :uint32, :SDL_GamepadID
+    typedef :uint32, :SDL_SensorID
+    typedef :uint32, :SDL_CameraID
+    typedef :uint32, :SDL_PropertiesID
+    typedef :uint64, :SDL_TouchID
+    typedef :uint64, :SDL_FingerID
+    typedef :uint32, :SDL_MouseID
+    typedef :uint32, :SDL_KeyboardID
+    typedef :uint32, :SDL_PenID
+    typedef :uint32, :SDL_TimerID
+    typedef :uint32, :SDL_Keycode
+    typedef :uint32, :SDL_Scancode
+  end
+end

data/lib/sdl3/raw/version.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    attach_function :SDL_GetVersion, [], :int
+    attach_function :SDL_GetRevision, [], :string
+  end
+end

data/lib/sdl3/raw/video.rb

@@ -0,0 +1,208 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    typedef :uint32, :SDL_DisplayID
+
+    SDL_SystemTheme = enum :SDL_SYSTEM_THEME_UNKNOWN, 0,
+                           :SDL_SYSTEM_THEME_LIGHT, 1,
+                           :SDL_SYSTEM_THEME_DARK, 2
+
+    SDL_DisplayOrientation = enum :SDL_ORIENTATION_UNKNOWN, 0,
+                                  :SDL_ORIENTATION_LANDSCAPE, 1,
+                                  :SDL_ORIENTATION_LANDSCAPE_FLIPPED, 2,
+                                  :SDL_ORIENTATION_PORTRAIT, 3,
+                                  :SDL_ORIENTATION_PORTRAIT_FLIPPED, 4
+
+    SDL_ProgressState = enum :SDL_PROGRESS_STATE_INVALID, -1,
+                             :SDL_PROGRESS_STATE_NONE, 0,
+                             :SDL_PROGRESS_STATE_INDETERMINATE, 1,
+                             :SDL_PROGRESS_STATE_NORMAL, 2,
+                             :SDL_PROGRESS_STATE_PAUSED, 3,
+                             :SDL_PROGRESS_STATE_ERROR, 4
+
+    SDL_WINDOW_FULLSCREEN = 0x0000000000000001
+    SDL_WINDOW_OPENGL = 0x0000000000000002
+    SDL_WINDOW_OCCLUDED = 0x0000000000000004
+    SDL_WINDOW_HIDDEN = 0x0000000000000008
+    SDL_WINDOW_BORDERLESS = 0x0000000000000010
+    SDL_WINDOW_RESIZABLE = 0x0000000000000020
+    SDL_WINDOW_MINIMIZED = 0x0000000000000040
+    SDL_WINDOW_MAXIMIZED = 0x0000000000000080
+    SDL_WINDOW_MOUSE_GRABBED = 0x0000000000000100
+    SDL_WINDOW_INPUT_FOCUS = 0x0000000000000200
+    SDL_WINDOW_MOUSE_FOCUS = 0x0000000000000400
+    SDL_WINDOW_EXTERNAL = 0x0000000000000800
+    SDL_WINDOW_MODAL = 0x0000000000001000
+    SDL_WINDOW_HIGH_PIXEL_DENSITY = 0x0000000000002000
+    SDL_WINDOW_MOUSE_CAPTURE = 0x0000000000004000
+    SDL_WINDOW_MOUSE_RELATIVE_MODE = 0x0000000000008000
+    SDL_WINDOW_ALWAYS_ON_TOP = 0x0000000000010000
+    SDL_WINDOW_UTILITY = 0x0000000000020000
+    SDL_WINDOW_TOOLTIP = 0x0000000000040000
+    SDL_WINDOW_POPUP_MENU = 0x0000000000080000
+    SDL_WINDOW_KEYBOARD_GRABBED = 0x0000000000100000
+    SDL_WINDOW_VULKAN = 0x0000000010000000
+    SDL_WINDOW_METAL = 0x0000000020000000
+    SDL_WINDOW_TRANSPARENT = 0x0000000040000000
+    SDL_WINDOW_NOT_FOCUSABLE = 0x0000000080000000
+
+    SDL_FlashOperation = enum :SDL_FLASH_CANCEL, 0,
+                              :SDL_FLASH_BRIEFLY, 1,
+                              :SDL_FLASH_UNTIL_FOCUSED, 2
+
+    class SDL_DisplayMode < FFI::Struct
+      layout :displayID, :SDL_DisplayID,
+             :format, :uint32,
+             :w, :int,
+             :h, :int,
+             :pixel_density, :float,
+             :refresh_rate, :float,
+             :refresh_rate_numerator, :int,
+             :refresh_rate_denominator, :int,
+             :internal, :pointer
+    end
+
+    attach_function :SDL_GetNumVideoDrivers, [], :int
+    attach_function :SDL_GetVideoDriver, [:int], :string
+    attach_function :SDL_GetCurrentVideoDriver, [], :string
+    attach_function :SDL_GetSystemTheme, [], SDL_SystemTheme
+    attach_function :SDL_GetDisplays, [:pointer], :pointer
+    attach_function :SDL_GetPrimaryDisplay, [], :SDL_DisplayID
+    attach_function :SDL_GetDisplayProperties, [:SDL_DisplayID], :SDL_PropertiesID
+    attach_function :SDL_GetDisplayName, [:SDL_DisplayID], :string
+    attach_function :SDL_GetDisplayBounds, [:SDL_DisplayID, SDL_Rect.ptr], :bool
+    attach_function :SDL_GetDisplayUsableBounds, [:SDL_DisplayID, SDL_Rect.ptr], :bool
+    begin
+      attach_function :SDL_GetNaturalDisplayOrientation, [:SDL_DisplayID], SDL_DisplayOrientation
+      attach_function :SDL_GetCurrentDisplayOrientation, [:SDL_DisplayID], SDL_DisplayOrientation
+    rescue FFI::NotFoundError
+      # Added in newer SDL3 versions.
+    end
+    attach_function :SDL_GetDisplayContentScale, [:SDL_DisplayID], :float
+    attach_function :SDL_GetFullscreenDisplayModes, [:SDL_DisplayID, :pointer], :pointer
+    attach_function :SDL_GetClosestFullscreenDisplayMode, [:SDL_DisplayID, :int, :int, :float, :bool, SDL_DisplayMode.ptr], :bool
+    attach_function :SDL_GetDesktopDisplayMode, [:SDL_DisplayID], SDL_DisplayMode.ptr
+    attach_function :SDL_GetCurrentDisplayMode, [:SDL_DisplayID], SDL_DisplayMode.ptr
+    begin
+      attach_function :SDL_GetDisplayForPoint, [SDL_Point.ptr], :SDL_DisplayID
+      attach_function :SDL_GetDisplayForRect, [SDL_Rect.ptr], :SDL_DisplayID
+      attach_function :SDL_GetDisplayForWindow, [:pointer], :SDL_DisplayID
+    rescue FFI::NotFoundError
+      # Added in newer SDL3 versions.
+    end
+
+    attach_function :SDL_CreateWindow, [:string, :int, :int, :uint64], :pointer
+    attach_function :SDL_CreatePopupWindow, [:pointer, :int, :int, :int, :int, :uint64], :pointer
+    attach_function :SDL_CreateWindowWithProperties, [:SDL_PropertiesID], :pointer
+    attach_function :SDL_GetWindowID, [:pointer], :SDL_WindowID
+    attach_function :SDL_GetWindowFromID, [:SDL_WindowID], :pointer
+    attach_function :SDL_GetWindowParent, [:pointer], :pointer
+    attach_function :SDL_GetWindowProperties, [:pointer], :SDL_PropertiesID
+    attach_function :SDL_GetWindowFlags, [:pointer], :uint64
+    attach_function :SDL_SetWindowTitle, %i[pointer string], :bool
+    attach_function :SDL_GetWindowTitle, [:pointer], :string
+    attach_function :SDL_SetWindowIcon, %i[pointer pointer], :bool
+    attach_function :SDL_SetWindowPosition, %i[pointer int int], :bool
+    attach_function :SDL_GetWindowPosition, %i[pointer pointer pointer], :bool
+    attach_function :SDL_SetWindowSize, %i[pointer int int], :bool
+    attach_function :SDL_GetWindowSize, %i[pointer pointer pointer], :bool
+    begin
+      attach_function :SDL_GetWindowPixelDensity, [:pointer], :float
+      attach_function :SDL_GetWindowDisplayScale, [:pointer], :float
+    rescue FFI::NotFoundError
+      # Added in newer SDL3 versions.
+    end
+    attach_function :SDL_GetWindowSafeArea, [:pointer, SDL_Rect.ptr], :bool
+    attach_function :SDL_SetWindowAspectRatio, %i[pointer float float], :bool
+    attach_function :SDL_GetWindowAspectRatio, %i[pointer pointer pointer], :bool
+    attach_function :SDL_GetWindowBordersSize, %i[pointer pointer pointer pointer pointer], :bool
+    attach_function :SDL_GetWindowSizeInPixels, %i[pointer pointer pointer], :bool
+    attach_function :SDL_SetWindowMinimumSize, %i[pointer int int], :bool
+    attach_function :SDL_GetWindowMinimumSize, %i[pointer pointer pointer], :bool
+    attach_function :SDL_SetWindowMaximumSize, %i[pointer int int], :bool
+    attach_function :SDL_GetWindowMaximumSize, %i[pointer pointer pointer], :bool
+    attach_function :SDL_SetWindowBordered, %i[pointer bool], :bool
+    attach_function :SDL_SetWindowResizable, %i[pointer bool], :bool
+    attach_function :SDL_SetWindowAlwaysOnTop, %i[pointer bool], :bool
+    attach_function :SDL_ShowWindow, [:pointer], :bool
+    attach_function :SDL_HideWindow, [:pointer], :bool
+    attach_function :SDL_RaiseWindow, [:pointer], :bool
+    attach_function :SDL_MaximizeWindow, [:pointer], :bool
+    attach_function :SDL_MinimizeWindow, [:pointer], :bool
+    attach_function :SDL_RestoreWindow, [:pointer], :bool
+    attach_function :SDL_SetWindowFullscreen, %i[pointer bool], :bool
+    begin
+      attach_function :SDL_SetWindowFullscreenMode, [:pointer, SDL_DisplayMode.ptr], :bool
+      attach_function :SDL_GetWindowFullscreenMode, [:pointer], SDL_DisplayMode.ptr
+    rescue FFI::NotFoundError
+      # Added in newer SDL3 versions.
+    end
+    attach_function :SDL_SyncWindow, [:pointer], :bool
+    attach_function :SDL_WindowHasSurface, [:pointer], :bool
+    attach_function :SDL_GetWindowSurface, [:pointer], :pointer
+    attach_function :SDL_SetWindowSurfaceVSync, %i[pointer int], :bool
+    attach_function :SDL_GetWindowSurfaceVSync, %i[pointer pointer], :bool
+    attach_function :SDL_UpdateWindowSurface, [:pointer], :bool
+    attach_function :SDL_UpdateWindowSurfaceRects, [:pointer, SDL_Rect.ptr, :int], :bool
+    attach_function :SDL_DestroyWindowSurface, [:pointer], :bool
+    attach_function :SDL_SetWindowKeyboardGrab, %i[pointer bool], :bool
+    attach_function :SDL_SetWindowMouseGrab, %i[pointer bool], :bool
+    attach_function :SDL_GetWindowKeyboardGrab, [:pointer], :bool
+    attach_function :SDL_GetWindowMouseGrab, [:pointer], :bool
+    attach_function :SDL_GetGrabbedWindow, [], :pointer
+    attach_function :SDL_SetWindowMouseRect, [:pointer, SDL_Rect.ptr], :bool
+    attach_function :SDL_GetWindowMouseRect, [:pointer], SDL_Rect.ptr
+    attach_function :SDL_SetWindowOpacity, %i[pointer float], :bool
+    attach_function :SDL_GetWindowOpacity, [:pointer], :float
+    attach_function :SDL_SetWindowParent, %i[pointer pointer], :bool
+    attach_function :SDL_SetWindowModal, %i[pointer bool], :bool
+    attach_function :SDL_SetWindowFocusable, %i[pointer bool], :bool
+    begin
+      attach_function :SDL_SetWindowFillDocument, %i[pointer bool], :bool
+      attach_function :SDL_GetWindowICCProfile, %i[pointer pointer], :pointer
+      attach_function :SDL_GetWindowPixelFormat, [:pointer], :uint32
+      attach_function :SDL_GetWindows, [:pointer], :pointer
+      attach_function :SDL_SetWindowHitTest, %i[pointer pointer pointer], :bool
+      attach_function :SDL_SetWindowShape, %i[pointer pointer], :bool
+      attach_function :SDL_SetWindowProgressState, [:pointer, SDL_ProgressState], :bool
+      attach_function :SDL_GetWindowProgressState, [:pointer], SDL_ProgressState
+      attach_function :SDL_SetWindowProgressValue, %i[pointer float], :bool
+      attach_function :SDL_GetWindowProgressValue, [:pointer], :float
+    rescue FFI::NotFoundError
+      # Added in newer SDL3 versions.
+    end
+    attach_function :SDL_ShowWindowSystemMenu, %i[pointer int int], :bool
+    attach_function :SDL_FlashWindow, [:pointer, SDL_FlashOperation], :bool
+    attach_function :SDL_DestroyWindow, [:pointer], :void
+    attach_function :SDL_ScreenSaverEnabled, [], :bool
+    attach_function :SDL_EnableScreenSaver, [], :bool
+    attach_function :SDL_DisableScreenSaver, [], :bool
+
+    attach_function :SDL_GL_LoadLibrary, [:string], :bool
+    attach_function :SDL_GL_GetProcAddress, [:string], :pointer
+    attach_function :SDL_GL_UnloadLibrary, [], :void
+    attach_function :SDL_GL_ExtensionSupported, [:string], :bool
+    attach_function :SDL_GL_ResetAttributes, [], :void
+    attach_function :SDL_GL_SetAttribute, %i[int int], :bool
+    attach_function :SDL_GL_GetAttribute, %i[int pointer], :bool
+    attach_function :SDL_GL_CreateContext, [:pointer], :pointer
+    attach_function :SDL_GL_MakeCurrent, %i[pointer pointer], :bool
+    attach_function :SDL_GL_GetCurrentWindow, [], :pointer
+    attach_function :SDL_GL_GetCurrentContext, [], :pointer
+    attach_function :SDL_GL_SetSwapInterval, [:int], :bool
+    attach_function :SDL_GL_GetSwapInterval, [:pointer], :bool
+    attach_function :SDL_GL_SwapWindow, [:pointer], :bool
+    attach_function :SDL_GL_DestroyContext, [:pointer], :bool
+
+    begin
+      attach_function :SDL_EGL_GetProcAddress, [:string], :pointer
+      attach_function :SDL_EGL_GetCurrentDisplay, [], :pointer
+      attach_function :SDL_EGL_GetCurrentConfig, [], :pointer
+      attach_function :SDL_EGL_GetWindowSurface, [:pointer], :pointer
+      attach_function :SDL_EGL_SetAttributeCallbacks, %i[pointer pointer pointer pointer], :void
+    rescue FFI::NotFoundError
+      # EGL entry points can be unavailable depending on SDL build options.
+    end
+  end
+end

data/lib/sdl3/raw/vulkan.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    attach_function :SDL_Vulkan_LoadLibrary, [:string], :bool
+    attach_function :SDL_Vulkan_GetVkGetInstanceProcAddr, [], :pointer
+    attach_function :SDL_Vulkan_UnloadLibrary, [], :void
+    attach_function :SDL_Vulkan_GetInstanceExtensions, [:pointer], :pointer
+    attach_function :SDL_Vulkan_CreateSurface, %i[pointer pointer pointer pointer], :bool
+    attach_function :SDL_Vulkan_DestroySurface, %i[pointer pointer pointer], :void
+    attach_function :SDL_Vulkan_GetPresentationSupport, %i[pointer pointer uint32], :bool
+  end
+end

data/lib/sdl3/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module SDL3
+  VERSION = "1.0.0"
+end

data/lib/sdl3.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+require_relative "sdl3/version"
+require_relative "sdl3/raw/base"
+require_relative "sdl3/raw/types"
+require_relative "sdl3/raw/stdinc"
+require_relative "sdl3/raw/assert"
+require_relative "sdl3/raw/bits"
+require_relative "sdl3/raw/guid"
+require_relative "sdl3/raw/init"
+require_relative "sdl3/raw/main"
+require_relative "sdl3/raw/error"
+require_relative "sdl3/raw/rect"
+require_relative "sdl3/raw/pixels"
+require_relative "sdl3/raw/blendmode"
+require_relative "sdl3/raw/hints"
+require_relative "sdl3/raw/log"
+require_relative "sdl3/raw/properties"
+require_relative "sdl3/raw/video"
+require_relative "sdl3/raw/surface"
+require_relative "sdl3/raw/render"
+require_relative "sdl3/raw/scancode"
+require_relative "sdl3/raw/keycode"
+require_relative "sdl3/raw/keyboard"
+require_relative "sdl3/raw/mouse"
+require_relative "sdl3/raw/joystick"
+require_relative "sdl3/raw/gamepad"
+require_relative "sdl3/raw/touch"
+require_relative "sdl3/raw/pen"
+require_relative "sdl3/raw/sensor"
+require_relative "sdl3/raw/events"
+require_relative "sdl3/raw/audio"
+require_relative "sdl3/raw/haptic"
+require_relative "sdl3/raw/timer"
+require_relative "sdl3/raw/filesystem"
+require_relative "sdl3/raw/clipboard"
+require_relative "sdl3/raw/cpuinfo"
+require_relative "sdl3/raw/endian"
+require_relative "sdl3/raw/power"
+require_relative "sdl3/raw/messagebox"
+require_relative "sdl3/raw/locale"
+require_relative "sdl3/raw/misc"
+require_relative "sdl3/raw/platform"
+require_relative "sdl3/raw/system"
+require_relative "sdl3/raw/iostream"
+require_relative "sdl3/raw/time"
+require_relative "sdl3/raw/dialog"
+require_relative "sdl3/raw/loadso"
+require_relative "sdl3/raw/version"
+require_relative "sdl3/raw/thread"
+require_relative "sdl3/raw/mutex"
+require_relative "sdl3/raw/atomic"
+require_relative "sdl3/raw/camera"
+require_relative "sdl3/raw/asyncio"
+require_relative "sdl3/raw/vulkan"
+require_relative "sdl3/raw/metal"
+require_relative "sdl3/raw/storage"
+require_relative "sdl3/raw/process"
+require_relative "sdl3/raw/tray"
+require_relative "sdl3/raw/gpu"
+require_relative "sdl3/raw/openxr"
+require_relative "sdl3/raw/hidapi"
+
+require_relative "sdl3/high_level/surface"
+require_relative "sdl3/high_level/window"
+require_relative "sdl3/high_level/renderer"
+require_relative "sdl3/high_level/texture"
+require_relative "sdl3/high_level/event"
+require_relative "sdl3/high_level/audio_device"
+require_relative "sdl3/high_level/joystick"
+require_relative "sdl3/high_level/gamepad"
+require_relative "sdl3/high_level/haptic"
+require_relative "sdl3/high_level/camera"
+require_relative "sdl3/high_level/timer"
+require_relative "sdl3/high_level/clipboard"
+require_relative "sdl3/high_level/gpu"
+require_relative "sdl3/high_level/sensor"
+
+module SDL3
+  class Error < StandardError; end
+  class InitError < Error; end
+  class WindowError < Error; end
+  class RendererError < Error; end
+  class AudioError < Error; end
+
+  INIT_AUDIO = Raw::SDL_INIT_AUDIO
+  INIT_VIDEO = Raw::SDL_INIT_VIDEO
+  INIT_JOYSTICK = Raw::SDL_INIT_JOYSTICK
+  INIT_HAPTIC = Raw::SDL_INIT_HAPTIC
+  INIT_GAMEPAD = Raw::SDL_INIT_GAMEPAD
+  INIT_EVENTS = Raw::SDL_INIT_EVENTS
+  INIT_SENSOR = Raw::SDL_INIT_SENSOR
+  INIT_CAMERA = Raw::SDL_INIT_CAMERA
+
+  class << self
+    def init(flags)
+      raise InitError, Raw.SDL_GetError unless Raw.SDL_Init(flags)
+
+      true
+    end
+
+    def init_sub_system(flags)
+      raise InitError, Raw.SDL_GetError unless Raw.SDL_InitSubSystem(flags)
+
+      true
+    end
+
+    def quit_sub_system(flags)
+      Raw.SDL_QuitSubSystem(flags)
+    end
+
+    def was_init(flags)
+      Raw.SDL_WasInit(flags)
+    end
+
+    def quit
+      Raw.SDL_Quit
+    end
+
+    def error
+      Raw.SDL_GetError
+    end
+
+    def clear_error
+      Raw.SDL_ClearError
+    end
+  end
+end

data/sdl3.gemspec

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require_relative "lib/sdl3/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "sdl3"
+  spec.version = SDL3::VERSION
+  spec.authors = ["Yudai Takada"]
+  spec.email = ["t.yudai92@gmail.com"]
+
+  spec.summary = "Ruby FFI bindings for SDL3"
+  spec.description = "Complete Ruby bindings for SDL3 multimedia library using FFI"
+  spec.homepage = "https://github.com/ydah/sdl3-ruby"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.1.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+    end
+  end
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "ffi", "~> 1.15"
+end