sdl3 1.0.0

data/lib/sdl3/raw/guid.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    class SDL_GUID < FFI::Struct
+      layout :data, [:uint8, 16]
+    end
+
+    attach_function :SDL_GUIDToString, [SDL_GUID, :pointer, :int], :void
+    attach_function :SDL_StringToGUID, [:string], SDL_GUID.by_value
+  end
+end

data/lib/sdl3/raw/haptic.rb

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    typedef :uint32, :SDL_HapticID
+
+    SDL_HAPTIC_CONSTANT = 1 << 0
+    SDL_HAPTIC_SINE = 1 << 1
+    SDL_HAPTIC_SQUARE = 1 << 2
+    SDL_HAPTIC_TRIANGLE = 1 << 3
+    SDL_HAPTIC_SAWTOOTHUP = 1 << 4
+    SDL_HAPTIC_SAWTOOTHDOWN = 1 << 5
+    SDL_HAPTIC_RAMP = 1 << 6
+    SDL_HAPTIC_SPRING = 1 << 7
+    SDL_HAPTIC_DAMPER = 1 << 8
+    SDL_HAPTIC_INERTIA = 1 << 9
+    SDL_HAPTIC_FRICTION = 1 << 10
+    SDL_HAPTIC_LEFTRIGHT = 1 << 11
+    SDL_HAPTIC_RESERVED1 = 1 << 12
+    SDL_HAPTIC_RESERVED2 = 1 << 13
+    SDL_HAPTIC_RESERVED3 = 1 << 14
+    SDL_HAPTIC_CUSTOM = 1 << 15
+    SDL_HAPTIC_GAIN = 1 << 16
+    SDL_HAPTIC_AUTOCENTER = 1 << 17
+    SDL_HAPTIC_STATUS = 1 << 18
+    SDL_HAPTIC_PAUSE = 1 << 19
+
+    SDL_HAPTIC_POLAR = 0
+    SDL_HAPTIC_CARTESIAN = 1
+    SDL_HAPTIC_SPHERICAL = 2
+    SDL_HAPTIC_STEERING_AXIS = 3
+
+    SDL_HAPTIC_INFINITY = 4294967295
+
+    class SDL_HapticDirection < FFI::Struct
+      layout :type, :uint8,
+             :dir, [:int32, 3]
+    end
+
+    class SDL_HapticConstant < FFI::Struct
+      layout :type, :uint16,
+             :direction, SDL_HapticDirection,
+             :length, :uint32,
+             :delay, :uint16,
+             :button, :uint16,
+             :interval, :uint16,
+             :level, :int16,
+             :attack_length, :uint16,
+             :attack_level, :uint16,
+             :fade_length, :uint16,
+             :fade_level, :uint16
+    end
+
+    class SDL_HapticPeriodic < FFI::Struct
+      layout :type, :uint16,
+             :direction, SDL_HapticDirection,
+             :length, :uint32,
+             :delay, :uint16,
+             :button, :uint16,
+             :interval, :uint16,
+             :period, :uint16,
+             :magnitude, :int16,
+             :offset, :int16,
+             :phase, :uint16,
+             :attack_length, :uint16,
+             :attack_level, :uint16,
+             :fade_length, :uint16,
+             :fade_level, :uint16
+    end
+
+    class SDL_HapticCondition < FFI::Struct
+      layout :type, :uint16,
+             :direction, SDL_HapticDirection,
+             :length, :uint32,
+             :delay, :uint16,
+             :button, :uint16,
+             :interval, :uint16,
+             :right_sat, [:uint16, 3],
+             :left_sat, [:uint16, 3],
+             :right_coeff, [:int16, 3],
+             :left_coeff, [:int16, 3],
+             :deadband, [:uint16, 3],
+             :center, [:int16, 3]
+    end
+
+    class SDL_HapticRamp < FFI::Struct
+      layout :type, :uint16,
+             :direction, SDL_HapticDirection,
+             :length, :uint32,
+             :delay, :uint16,
+             :button, :uint16,
+             :interval, :uint16,
+             :start, :int16,
+             :end, :int16,
+             :attack_length, :uint16,
+             :attack_level, :uint16,
+             :fade_length, :uint16,
+             :fade_level, :uint16
+    end
+
+    class SDL_HapticLeftRight < FFI::Struct
+      layout :type, :uint16,
+             :length, :uint32,
+             :large_magnitude, :uint16,
+             :small_magnitude, :uint16
+    end
+
+    class SDL_HapticCustom < FFI::Struct
+      layout :type, :uint16,
+             :direction, SDL_HapticDirection,
+             :length, :uint32,
+             :delay, :uint16,
+             :button, :uint16,
+             :interval, :uint16,
+             :channels, :uint8,
+             :period, :uint16,
+             :samples, :uint16,
+             :data, :pointer,
+             :attack_length, :uint16,
+             :attack_level, :uint16,
+             :fade_length, :uint16,
+             :fade_level, :uint16
+    end
+
+    class SDL_HapticEffect < FFI::Union
+      layout :type, :uint16,
+             :constant, SDL_HapticConstant,
+             :periodic, SDL_HapticPeriodic,
+             :condition, SDL_HapticCondition,
+             :ramp, SDL_HapticRamp,
+             :leftright, SDL_HapticLeftRight,
+             :custom, SDL_HapticCustom
+    end
+
+    attach_function :SDL_GetHaptics, [:pointer], :pointer
+    attach_function :SDL_GetHapticNameForID, [:SDL_HapticID], :string
+    attach_function :SDL_OpenHaptic, [:SDL_HapticID], :pointer
+    attach_function :SDL_GetHapticFromID, [:SDL_HapticID], :pointer
+    attach_function :SDL_GetHapticID, [:pointer], :SDL_HapticID
+    attach_function :SDL_GetHapticName, [:pointer], :string
+    attach_function :SDL_IsMouseHaptic, [], :bool
+    attach_function :SDL_OpenHapticFromMouse, [], :pointer
+    attach_function :SDL_IsJoystickHaptic, [:pointer], :bool
+    attach_function :SDL_OpenHapticFromJoystick, [:pointer], :pointer
+    attach_function :SDL_CloseHaptic, [:pointer], :void
+    attach_function :SDL_GetMaxHapticEffects, [:pointer], :int
+    attach_function :SDL_GetMaxHapticEffectsPlaying, [:pointer], :int
+    attach_function :SDL_GetHapticFeatures, [:pointer], :uint32
+    attach_function :SDL_GetNumHapticAxes, [:pointer], :int
+    attach_function :SDL_HapticEffectSupported, [:pointer, SDL_HapticEffect.ptr], :bool
+    attach_function :SDL_CreateHapticEffect, [:pointer, SDL_HapticEffect.ptr], :int
+    attach_function :SDL_UpdateHapticEffect, [:pointer, :int, SDL_HapticEffect.ptr], :bool
+    attach_function :SDL_RunHapticEffect, %i[pointer int uint32], :bool
+    attach_function :SDL_StopHapticEffect, %i[pointer int], :bool
+    attach_function :SDL_DestroyHapticEffect, %i[pointer int], :void
+    attach_function :SDL_GetHapticEffectStatus, %i[pointer int], :bool
+    attach_function :SDL_SetHapticGain, %i[pointer int], :bool
+    attach_function :SDL_SetHapticAutocenter, %i[pointer int], :bool
+    attach_function :SDL_PauseHaptic, [:pointer], :bool
+    attach_function :SDL_ResumeHaptic, [:pointer], :bool
+    attach_function :SDL_StopHapticEffects, [:pointer], :bool
+    attach_function :SDL_HapticRumbleSupported, [:pointer], :bool
+    attach_function :SDL_InitHapticRumble, [:pointer], :bool
+    attach_function :SDL_PlayHapticRumble, %i[pointer float uint32], :bool
+    attach_function :SDL_StopHapticRumble, [:pointer], :bool
+  end
+end

data/lib/sdl3/raw/hidapi.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    SDL_hid_bus_type = enum :SDL_HID_API_BUS_UNKNOWN, 0x00,
+                            :SDL_HID_API_BUS_USB, 0x01,
+                            :SDL_HID_API_BUS_BLUETOOTH, 0x02,
+                            :SDL_HID_API_BUS_I2C, 0x03,
+                            :SDL_HID_API_BUS_SPI, 0x04
+
+    class SDL_hid_device_info < FFI::Struct
+      layout :path, :string,
+             :vendor_id, :ushort,
+             :product_id, :ushort,
+             :serial_number, :pointer,
+             :release_number, :ushort,
+             :manufacturer_string, :pointer,
+             :product_string, :pointer,
+             :usage_page, :ushort,
+             :usage, :ushort,
+             :interface_number, :int,
+             :interface_class, :int,
+             :interface_subclass, :int,
+             :interface_protocol, :int,
+             :bus_type, SDL_hid_bus_type,
+             :next, :pointer
+    end
+
+    begin
+      attach_function :SDL_hid_init, [], :int
+      attach_function :SDL_hid_exit, [], :int
+      attach_function :SDL_hid_device_change_count, [], :uint32
+      attach_function :SDL_hid_enumerate, %i[ushort ushort], SDL_hid_device_info.ptr
+      attach_function :SDL_hid_free_enumeration, [SDL_hid_device_info.ptr], :void
+      attach_function :SDL_hid_open, %i[ushort ushort pointer], :pointer
+      attach_function :SDL_hid_open_path, [:string], :pointer
+      attach_function :SDL_hid_get_properties, [:pointer], :SDL_PropertiesID
+      attach_function :SDL_hid_write, %i[pointer pointer size_t], :int
+      attach_function :SDL_hid_read_timeout, %i[pointer pointer size_t int], :int
+      attach_function :SDL_hid_read, %i[pointer pointer size_t], :int
+      attach_function :SDL_hid_set_nonblocking, %i[pointer int], :int
+      attach_function :SDL_hid_send_feature_report, %i[pointer pointer size_t], :int
+      attach_function :SDL_hid_get_feature_report, %i[pointer pointer size_t], :int
+      attach_function :SDL_hid_get_input_report, %i[pointer pointer size_t], :int
+      attach_function :SDL_hid_close, [:pointer], :int
+      attach_function :SDL_hid_get_manufacturer_string, %i[pointer pointer size_t], :int
+      attach_function :SDL_hid_get_product_string, %i[pointer pointer size_t], :int
+      attach_function :SDL_hid_get_serial_number_string, %i[pointer pointer size_t], :int
+      attach_function :SDL_hid_get_indexed_string, %i[pointer int pointer size_t], :int
+      attach_function :SDL_hid_get_device_info, [:pointer], SDL_hid_device_info.ptr
+      attach_function :SDL_hid_get_report_descriptor, %i[pointer pointer size_t], :int
+      attach_function :SDL_hid_ble_scan, [:bool], :void
+    rescue FFI::NotFoundError
+      # HIDAPI may not be available in all SDL3 builds
+    end
+  end
+end

data/lib/sdl3/raw/hints.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    SDL_HintPriority = enum :SDL_HINT_DEFAULT, 0,
+                            :SDL_HINT_NORMAL, 1,
+                            :SDL_HINT_OVERRIDE, 2
+
+    callback :SDL_HintCallback, %i[pointer string string string], :void
+
+    attach_function :SDL_SetHintWithPriority, [:string, :string, SDL_HintPriority], :bool
+    attach_function :SDL_SetHint, %i[string string], :bool
+    attach_function :SDL_ResetHint, [:string], :bool
+    attach_function :SDL_ResetHints, [], :void
+    attach_function :SDL_GetHint, [:string], :string
+    attach_function :SDL_GetHintBoolean, [:string, :bool], :bool
+    attach_function :SDL_AddHintCallback, [:string, :SDL_HintCallback, :pointer], :bool
+    attach_function :SDL_RemoveHintCallback, [:string, :SDL_HintCallback, :pointer], :void
+  end
+end

data/lib/sdl3/raw/init.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    SDL_INIT_AUDIO = 0x00000010
+    SDL_INIT_VIDEO = 0x00000020
+    SDL_INIT_JOYSTICK = 0x00000200
+    SDL_INIT_HAPTIC = 0x00001000
+    SDL_INIT_GAMEPAD = 0x00002000
+    SDL_INIT_EVENTS = 0x00004000
+    SDL_INIT_SENSOR = 0x00008000
+    SDL_INIT_CAMERA = 0x00010000
+
+    callback :SDL_MainThreadCallback, %i[pointer], :void
+
+    attach_function :SDL_Init, [:uint32], :bool
+    attach_function :SDL_InitSubSystem, [:uint32], :bool
+    attach_function :SDL_QuitSubSystem, [:uint32], :void
+    attach_function :SDL_WasInit, [:uint32], :uint32
+    attach_function :SDL_Quit, [], :void
+    attach_function :SDL_IsMainThread, [], :bool
+    attach_function :SDL_RunOnMainThread, [:SDL_MainThreadCallback, :pointer, :bool], :bool
+    attach_function :SDL_SetAppMetadata, %i[string string string], :bool
+    attach_function :SDL_SetAppMetadataProperty, %i[string string], :bool
+    attach_function :SDL_GetAppMetadataProperty, [:string], :string
+  end
+end

data/lib/sdl3/raw/iostream.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    SDL_IOStatus = enum :SDL_IO_STATUS_READY, 0,
+                        :SDL_IO_STATUS_ERROR, 1,
+                        :SDL_IO_STATUS_EOF, 2,
+                        :SDL_IO_STATUS_NOT_READY, 3,
+                        :SDL_IO_STATUS_READONLY, 4,
+                        :SDL_IO_STATUS_WRITEONLY, 5
+
+    SDL_IOWhence = enum :SDL_IO_SEEK_SET, 0,
+                        :SDL_IO_SEEK_CUR, 1,
+                        :SDL_IO_SEEK_END, 2
+
+    callback :SDL_IOStreamInterfaceSizeCallback, [:pointer], :int64
+    callback :SDL_IOStreamInterfaceSeekCallback, %i[pointer int64 int], :int64
+    callback :SDL_IOStreamInterfaceReadCallback, %i[pointer pointer size_t pointer], :size_t
+    callback :SDL_IOStreamInterfaceWriteCallback, %i[pointer pointer size_t pointer], :size_t
+    callback :SDL_IOStreamInterfaceFlushCallback, %i[pointer pointer], :bool
+    callback :SDL_IOStreamInterfaceCloseCallback, [:pointer], :bool
+
+    class SDL_IOStreamInterface < FFI::Struct
+      layout :version, :uint32,
+             :size, :SDL_IOStreamInterfaceSizeCallback,
+             :seek, :SDL_IOStreamInterfaceSeekCallback,
+             :read, :SDL_IOStreamInterfaceReadCallback,
+             :write, :SDL_IOStreamInterfaceWriteCallback,
+             :flush, :SDL_IOStreamInterfaceFlushCallback,
+             :close, :SDL_IOStreamInterfaceCloseCallback
+    end
+
+    attach_function :SDL_IOFromFile, %i[string string], :pointer
+    attach_function :SDL_IOFromMem, %i[pointer size_t], :pointer
+    attach_function :SDL_IOFromConstMem, %i[pointer size_t], :pointer
+    attach_function :SDL_IOFromDynamicMem, [], :pointer
+    attach_function :SDL_OpenIO, [SDL_IOStreamInterface.ptr, :pointer], :pointer
+    attach_function :SDL_CloseIO, [:pointer], :bool
+    attach_function :SDL_GetIOProperties, [:pointer], :SDL_PropertiesID
+    attach_function :SDL_GetIOStatus, [:pointer], SDL_IOStatus
+    attach_function :SDL_GetIOSize, [:pointer], :int64
+    attach_function :SDL_SeekIO, [:pointer, :int64, SDL_IOWhence], :int64
+    attach_function :SDL_TellIO, [:pointer], :int64
+    attach_function :SDL_ReadIO, %i[pointer pointer size_t], :size_t
+    attach_function :SDL_WriteIO, %i[pointer pointer size_t], :size_t
+    attach_function :SDL_IOprintf, [:pointer, :string, :varargs], :size_t
+    begin
+      attach_function :SDL_IOvprintf, %i[pointer string pointer], :size_t
+    rescue FFI::NotFoundError
+      # Added in newer SDL3 versions.
+    end
+    attach_function :SDL_FlushIO, [:pointer], :bool
+    attach_function :SDL_LoadFile_IO, %i[pointer pointer bool], :pointer
+    attach_function :SDL_LoadFile, %i[string pointer], :pointer
+    attach_function :SDL_SaveFile_IO, %i[pointer pointer size_t bool], :bool
+    attach_function :SDL_SaveFile, %i[string pointer size_t], :bool
+
+    attach_function :SDL_ReadU8, %i[pointer pointer], :bool
+    attach_function :SDL_ReadS8, %i[pointer pointer], :bool
+    attach_function :SDL_ReadU16LE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadS16LE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadU16BE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadS16BE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadU32LE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadS32LE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadU32BE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadS32BE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadU64LE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadS64LE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadU64BE, %i[pointer pointer], :bool
+    attach_function :SDL_ReadS64BE, %i[pointer pointer], :bool
+
+    attach_function :SDL_WriteU8, %i[pointer uint8], :bool
+    attach_function :SDL_WriteS8, %i[pointer int8], :bool
+    attach_function :SDL_WriteU16LE, %i[pointer uint16], :bool
+    attach_function :SDL_WriteS16LE, %i[pointer int16], :bool
+    attach_function :SDL_WriteU16BE, %i[pointer uint16], :bool
+    attach_function :SDL_WriteS16BE, %i[pointer int16], :bool
+    attach_function :SDL_WriteU32LE, %i[pointer uint32], :bool
+    attach_function :SDL_WriteS32LE, %i[pointer int32], :bool
+    attach_function :SDL_WriteU32BE, %i[pointer uint32], :bool
+    attach_function :SDL_WriteS32BE, %i[pointer int32], :bool
+    attach_function :SDL_WriteU64LE, %i[pointer uint64], :bool
+    attach_function :SDL_WriteS64LE, %i[pointer int64], :bool
+    attach_function :SDL_WriteU64BE, %i[pointer uint64], :bool
+    attach_function :SDL_WriteS64BE, %i[pointer int64], :bool
+  end
+end

data/lib/sdl3/raw/joystick.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    SDL_JoystickType = enum :SDL_JOYSTICK_TYPE_UNKNOWN, 0,
+                            :SDL_JOYSTICK_TYPE_GAMEPAD, 1,
+                            :SDL_JOYSTICK_TYPE_WHEEL, 2,
+                            :SDL_JOYSTICK_TYPE_ARCADE_STICK, 3,
+                            :SDL_JOYSTICK_TYPE_FLIGHT_STICK, 4,
+                            :SDL_JOYSTICK_TYPE_DANCE_PAD, 5,
+                            :SDL_JOYSTICK_TYPE_GUITAR, 6,
+                            :SDL_JOYSTICK_TYPE_DRUM_KIT, 7,
+                            :SDL_JOYSTICK_TYPE_ARCADE_PAD, 8,
+                            :SDL_JOYSTICK_TYPE_THROTTLE, 9,
+                            :SDL_JOYSTICK_TYPE_COUNT, 10
+
+    SDL_JoystickConnectionState = enum :SDL_JOYSTICK_CONNECTION_INVALID, -1,
+                                       :SDL_JOYSTICK_CONNECTION_UNKNOWN, 0,
+                                       :SDL_JOYSTICK_CONNECTION_WIRED, 1,
+                                       :SDL_JOYSTICK_CONNECTION_WIRELESS, 2
+
+    SDL_HAT_CENTERED = 0x00
+    SDL_HAT_UP = 0x01
+    SDL_HAT_RIGHT = 0x02
+    SDL_HAT_DOWN = 0x04
+    SDL_HAT_LEFT = 0x08
+    SDL_HAT_RIGHTUP = SDL_HAT_RIGHT | SDL_HAT_UP
+    SDL_HAT_RIGHTDOWN = SDL_HAT_RIGHT | SDL_HAT_DOWN
+    SDL_HAT_LEFTUP = SDL_HAT_LEFT | SDL_HAT_UP
+    SDL_HAT_LEFTDOWN = SDL_HAT_LEFT | SDL_HAT_DOWN
+
+    attach_function :SDL_LockJoysticks, [], :void
+    begin
+      attach_function :SDL_TryLockJoysticks, [], :bool
+    rescue FFI::NotFoundError
+      # Added in newer SDL3 versions.
+    end
+    attach_function :SDL_UnlockJoysticks, [], :void
+    attach_function :SDL_HasJoystick, [], :bool
+    attach_function :SDL_GetJoysticks, [:pointer], :pointer
+    attach_function :SDL_GetJoystickNameForID, [:SDL_JoystickID], :string
+    attach_function :SDL_GetJoystickPathForID, [:SDL_JoystickID], :string
+    attach_function :SDL_GetJoystickPlayerIndexForID, [:SDL_JoystickID], :int
+    attach_function :SDL_GetJoystickGUIDForID, [:SDL_JoystickID], SDL_GUID.by_value
+    attach_function :SDL_GetJoystickVendorForID, [:SDL_JoystickID], :uint16
+    attach_function :SDL_GetJoystickProductForID, [:SDL_JoystickID], :uint16
+    attach_function :SDL_GetJoystickProductVersionForID, [:SDL_JoystickID], :uint16
+    attach_function :SDL_GetJoystickTypeForID, [:SDL_JoystickID], SDL_JoystickType
+    attach_function :SDL_OpenJoystick, [:SDL_JoystickID], :pointer
+    attach_function :SDL_GetJoystickFromID, [:SDL_JoystickID], :pointer
+    attach_function :SDL_GetJoystickFromPlayerIndex, [:int], :pointer
+    attach_function :SDL_GetJoystickProperties, [:pointer], :SDL_PropertiesID
+    attach_function :SDL_GetJoystickName, [:pointer], :string
+    attach_function :SDL_GetJoystickPath, [:pointer], :string
+    attach_function :SDL_GetJoystickPlayerIndex, [:pointer], :int
+    attach_function :SDL_SetJoystickPlayerIndex, %i[pointer int], :bool
+    attach_function :SDL_GetJoystickGUID, [:pointer], SDL_GUID.by_value
+    attach_function :SDL_GetJoystickVendor, [:pointer], :uint16
+    attach_function :SDL_GetJoystickProduct, [:pointer], :uint16
+    attach_function :SDL_GetJoystickProductVersion, [:pointer], :uint16
+    attach_function :SDL_GetJoystickFirmwareVersion, [:pointer], :uint16
+    attach_function :SDL_GetJoystickSerial, [:pointer], :string
+    attach_function :SDL_GetJoystickType, [:pointer], SDL_JoystickType
+    attach_function :SDL_GetJoystickID, [:pointer], :SDL_JoystickID
+    attach_function :SDL_JoystickConnected, [:pointer], :bool
+    attach_function :SDL_GetNumJoystickAxes, [:pointer], :int
+    attach_function :SDL_GetNumJoystickBalls, [:pointer], :int
+    attach_function :SDL_GetNumJoystickHats, [:pointer], :int
+    attach_function :SDL_GetNumJoystickButtons, [:pointer], :int
+    attach_function :SDL_SetJoystickEventsEnabled, [:bool], :void
+    attach_function :SDL_JoystickEventsEnabled, [], :bool
+    attach_function :SDL_UpdateJoysticks, [], :void
+    attach_function :SDL_GetJoystickAxis, %i[pointer int], :int16
+    attach_function :SDL_GetJoystickAxisInitialState, %i[pointer int pointer], :bool
+    attach_function :SDL_GetJoystickBall, %i[pointer int pointer pointer], :bool
+    attach_function :SDL_GetJoystickHat, %i[pointer int], :uint8
+    attach_function :SDL_GetJoystickButton, %i[pointer int], :bool
+    attach_function :SDL_RumbleJoystick, %i[pointer uint16 uint16 uint32], :bool
+    attach_function :SDL_RumbleJoystickTriggers, %i[pointer uint16 uint16 uint32], :bool
+    attach_function :SDL_SetJoystickLED, %i[pointer uint8 uint8 uint8], :bool
+    attach_function :SDL_SendJoystickEffect, %i[pointer pointer int], :bool
+    attach_function :SDL_CloseJoystick, [:pointer], :void
+    attach_function :SDL_GetJoystickConnectionState, [:pointer], SDL_JoystickConnectionState
+    attach_function :SDL_GetJoystickPowerInfo, %i[pointer pointer], :int32
+
+    begin
+      attach_function :SDL_AttachVirtualJoystick, [:pointer], :SDL_JoystickID
+      attach_function :SDL_DetachVirtualJoystick, [:SDL_JoystickID], :bool
+      attach_function :SDL_IsJoystickVirtual, [:SDL_JoystickID], :bool
+      attach_function :SDL_SetJoystickVirtualAxis, %i[pointer int int16], :bool
+      attach_function :SDL_SetJoystickVirtualBall, %i[pointer int int16 int16], :bool
+      attach_function :SDL_SetJoystickVirtualButton, %i[pointer int bool], :bool
+      attach_function :SDL_SetJoystickVirtualHat, %i[pointer int uint8], :bool
+      attach_function :SDL_SetJoystickVirtualTouchpad, %i[pointer int int bool float float float], :bool
+      attach_function :SDL_SendJoystickVirtualSensorData, %i[pointer int uint64 pointer int], :bool
+      attach_function :SDL_GetJoystickGUIDInfo, [SDL_GUID.by_value, :pointer, :pointer, :pointer, :pointer], :void
+    rescue FFI::NotFoundError
+      # Added in newer SDL3 versions.
+    end
+  end
+end

data/lib/sdl3/raw/keyboard.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    attach_function :SDL_HasKeyboard, [], :bool
+    attach_function :SDL_GetKeyboards, [:pointer], :pointer
+    attach_function :SDL_GetKeyboardNameForID, [:SDL_KeyboardID], :string
+    attach_function :SDL_GetKeyboardFocus, [], :pointer
+    attach_function :SDL_GetKeyboardState, [:pointer], :pointer
+    attach_function :SDL_ResetKeyboard, [], :void
+    attach_function :SDL_GetModState, [], :uint16
+    attach_function :SDL_SetModState, [:uint16], :void
+    attach_function :SDL_GetKeyFromScancode, [:SDL_Scancode, :uint16, :bool], :SDL_Keycode
+    attach_function :SDL_GetScancodeFromKey, [:SDL_Keycode, :pointer], :SDL_Scancode
+    attach_function :SDL_SetScancodeName, [:SDL_Scancode, :string], :bool
+    attach_function :SDL_GetScancodeName, [:SDL_Scancode], :string
+    attach_function :SDL_GetScancodeFromName, [:string], :SDL_Scancode
+    attach_function :SDL_GetKeyName, [:SDL_Keycode], :string
+    attach_function :SDL_GetKeyFromName, [:string], :SDL_Keycode
+    attach_function :SDL_StartTextInput, [:pointer], :bool
+    attach_function :SDL_StartTextInputWithProperties, [:pointer, :SDL_PropertiesID], :bool
+    attach_function :SDL_TextInputActive, [:pointer], :bool
+    attach_function :SDL_StopTextInput, [:pointer], :bool
+    attach_function :SDL_ClearComposition, [:pointer], :bool
+    attach_function :SDL_SetTextInputArea, [:pointer, SDL_Rect.ptr, :int], :bool
+    attach_function :SDL_GetTextInputArea, [:pointer, SDL_Rect.ptr, :pointer], :bool
+    attach_function :SDL_HasScreenKeyboardSupport, [], :bool
+    attach_function :SDL_ScreenKeyboardShown, [:pointer], :bool
+  end
+end

data/lib/sdl3/raw/keycode.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    SDLK_SCANCODE_MASK = 0x40000000
+
+    SDLK_UNKNOWN = 0x00000000
+    SDLK_RETURN = 0x0000000D
+    SDLK_ESCAPE = 0x0000001B
+    SDLK_BACKSPACE = 0x00000008
+    SDLK_TAB = 0x00000009
+    SDLK_SPACE = 0x00000020
+    SDLK_EXCLAIM = 0x00000021
+    SDLK_DBLAPOSTROPHE = 0x00000022
+    SDLK_HASH = 0x00000023
+    SDLK_DOLLAR = 0x00000024
+    SDLK_PERCENT = 0x00000025
+    SDLK_AMPERSAND = 0x00000026
+    SDLK_APOSTROPHE = 0x00000027
+    SDLK_LEFTPAREN = 0x00000028
+    SDLK_RIGHTPAREN = 0x00000029
+    SDLK_ASTERISK = 0x0000002A
+    SDLK_PLUS = 0x0000002B
+    SDLK_COMMA = 0x0000002C
+    SDLK_MINUS = 0x0000002D
+    SDLK_PERIOD = 0x0000002E
+    SDLK_SLASH = 0x0000002F
+    SDLK_0 = 0x00000030
+    SDLK_1 = 0x00000031
+    SDLK_2 = 0x00000032
+    SDLK_3 = 0x00000033
+    SDLK_4 = 0x00000034
+    SDLK_5 = 0x00000035
+    SDLK_6 = 0x00000036
+    SDLK_7 = 0x00000037
+    SDLK_8 = 0x00000038
+    SDLK_9 = 0x00000039
+    SDLK_COLON = 0x0000003A
+    SDLK_SEMICOLON = 0x0000003B
+    SDLK_LESS = 0x0000003C
+    SDLK_EQUALS = 0x0000003D
+    SDLK_GREATER = 0x0000003E
+    SDLK_QUESTION = 0x0000003F
+    SDLK_AT = 0x00000040
+    SDLK_LEFTBRACKET = 0x0000005B
+    SDLK_BACKSLASH = 0x0000005C
+    SDLK_RIGHTBRACKET = 0x0000005D
+    SDLK_CARET = 0x0000005E
+    SDLK_UNDERSCORE = 0x0000005F
+    SDLK_GRAVE = 0x00000060
+    SDLK_A = 0x00000061
+    SDLK_B = 0x00000062
+    SDLK_C = 0x00000063
+    SDLK_D = 0x00000064
+    SDLK_E = 0x00000065
+    SDLK_F = 0x00000066
+    SDLK_G = 0x00000067
+    SDLK_H = 0x00000068
+    SDLK_I = 0x00000069
+    SDLK_J = 0x0000006A
+    SDLK_K = 0x0000006B
+    SDLK_L = 0x0000006C
+    SDLK_M = 0x0000006D
+    SDLK_N = 0x0000006E
+    SDLK_O = 0x0000006F
+    SDLK_P = 0x00000070
+    SDLK_Q = 0x00000071
+    SDLK_R = 0x00000072
+    SDLK_S = 0x00000073
+    SDLK_T = 0x00000074
+    SDLK_U = 0x00000075
+    SDLK_V = 0x00000076
+    SDLK_W = 0x00000077
+    SDLK_X = 0x00000078
+    SDLK_Y = 0x00000079
+    SDLK_Z = 0x0000007A
+    SDLK_DELETE = 0x0000007F
+
+    SDLK_CAPSLOCK = 0x40000039
+    SDLK_F1 = 0x4000003A
+    SDLK_F2 = 0x4000003B
+    SDLK_F3 = 0x4000003C
+    SDLK_F4 = 0x4000003D
+    SDLK_F5 = 0x4000003E
+    SDLK_F6 = 0x4000003F
+    SDLK_F7 = 0x40000040
+    SDLK_F8 = 0x40000041
+    SDLK_F9 = 0x40000042
+    SDLK_F10 = 0x40000043
+    SDLK_F11 = 0x40000044
+    SDLK_F12 = 0x40000045
+    SDLK_PRINTSCREEN = 0x40000046
+    SDLK_SCROLLLOCK = 0x40000047
+    SDLK_PAUSE = 0x40000048
+    SDLK_INSERT = 0x40000049
+    SDLK_HOME = 0x4000004A
+    SDLK_PAGEUP = 0x4000004B
+    SDLK_END = 0x4000004D
+    SDLK_PAGEDOWN = 0x4000004E
+    SDLK_RIGHT = 0x4000004F
+    SDLK_LEFT = 0x40000050
+    SDLK_DOWN = 0x40000051
+    SDLK_UP = 0x40000052
+
+    SDLK_LCTRL = 0x400000E0
+    SDLK_LSHIFT = 0x400000E1
+    SDLK_LALT = 0x400000E2
+    SDLK_LGUI = 0x400000E3
+    SDLK_RCTRL = 0x400000E4
+    SDLK_RSHIFT = 0x400000E5
+    SDLK_RALT = 0x400000E6
+    SDLK_RGUI = 0x400000E7
+
+    SDL_KMOD_NONE = 0x0000
+    SDL_KMOD_LSHIFT = 0x0001
+    SDL_KMOD_RSHIFT = 0x0002
+    SDL_KMOD_LCTRL = 0x0040
+    SDL_KMOD_RCTRL = 0x0080
+    SDL_KMOD_LALT = 0x0100
+    SDL_KMOD_RALT = 0x0200
+    SDL_KMOD_LGUI = 0x0400
+    SDL_KMOD_RGUI = 0x0800
+    SDL_KMOD_NUM = 0x1000
+    SDL_KMOD_CAPS = 0x2000
+    SDL_KMOD_MODE = 0x4000
+    SDL_KMOD_SCROLL = 0x8000
+    SDL_KMOD_CTRL = SDL_KMOD_LCTRL | SDL_KMOD_RCTRL
+    SDL_KMOD_SHIFT = SDL_KMOD_LSHIFT | SDL_KMOD_RSHIFT
+    SDL_KMOD_ALT = SDL_KMOD_LALT | SDL_KMOD_RALT
+    SDL_KMOD_GUI = SDL_KMOD_LGUI | SDL_KMOD_RGUI
+  end
+end

data/lib/sdl3/raw/loadso.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    attach_function :SDL_LoadObject, [:string], :pointer
+    attach_function :SDL_LoadFunction, %i[pointer string], :pointer
+    attach_function :SDL_UnloadObject, [:pointer], :void
+  end
+end

data/lib/sdl3/raw/locale.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SDL3
+  module Raw
+    class SDL_Locale < FFI::Struct
+      layout :language, :string,
+             :country, :string
+    end
+
+    attach_function :SDL_GetPreferredLocales, [:pointer], :pointer
+  end
+end