sdl2-bindings 0.0.0.pre

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: dff21b21106958f4db5399f9a5db1e6d77368c076630554d9c2f6eaf3fe3379a
+  data.tar.gz: d613101c0808dbe74ceb554da6c906bf9fbd9dcae26045f38d4c8699a617b49e
+SHA512:
+  metadata.gz: 5fcd3d8eb266fd79019c646235f61f53cf305aa4ddeadba1b9abb6456ca12d58e6726ca91886c90c9d10f9258aa5b7a4718be9070a7fc07c592ef67bd71e711a
+  data.tar.gz: bd6a51dd22d647c0988ec0b22a3dd0da2ae62a01804f6d2245368a405bec01e9c252d031293c68e992c2a4d0522e3aea9bd5b42e81bc37b7b590fff9dac4fbd5

data/ChangeLog

@@ -0,0 +1,55 @@
+2019-08-31  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* Refactoring + Cleanup
+	* Some tests are usable again
+
+2019-08-28  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* Exception-safety
+
+2019-08-27  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* lib/sdl2_mixer.rb: Added (experimental)
+
+2019-08-24  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* Added SDL 2.0.10 features.
+	* Added generator. Binding codes are generated semi-automatically.
+	* Now depends on Ruby/FFI. Note that some codes in 'test' directory are still not usable.
+
+2016-04-03  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* lib/sdl2_gfx.rb, test/test_gfx.rb: Added.
+
+2016-04-02  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* Added SDL 2.0.4 features.
+	* lib/version.rb: Added SDL_MAJOR_VERSION, etc.
+
+2015-09-29  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* lib/sdl2_ttf.rb: Added.
+
+2015-09-28  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* lib/sdl2_image.rb: Added.
+	* lib/sdl2_mixer.rb: Added.
+
+2015-09-22  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* lib/pixels.rb, lib/gamecontroller.rb, lib/joystick.rb: Added.
+	* lib/rwops.rb, lib/syswm.rb, lib/surface.rb, lib/render.rb: Added.
+	* lib/cpuinfo.rb, lib/gesture.rb, lib/touch.rb, lib/audio.rb: Added.
+
+2015-09-21  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* lib/events.rb, lib/timer.rb, lib/video.rb: Added.
+	* lib/keyboard.rb, lib/keycode.rb, lib/scancode.rb: Added.
+	* lib/error.rb: Added.
+	* lib/blendmode.rb, lib/clipboard.rb, lib/filesystem.rb, lib/version.rb: Added.
+	* lib/platform.rb, lib/rect.rb, lib/mouse.rb: Added.
+	* lib/messagebox.rb, lib/pixels.rb: Added.
+
+2015-09-19  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* Project started.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+sdl2-bindings : Yet another SDL2 wrapper for Ruby
+Copyright (c) 2015-2019 vaiorabbit <http://twitter.com/vaiorabbit>
+
+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.

data/README.md

@@ -0,0 +1,46 @@
+<!-- -*- mode:markdown; coding:utf-8; -*- -->
+
+# sdl2-bindings : Yet another SDL2 wrapper for Ruby #
+
+[Notice] Experimental project.
+
+*   Created : 2015-09-19
+*   Last modified : 2019-08-31
+
+## Features ##
+
+*   Generated semi-automatically
+*   Based on Ruby/FFI
+    *   No need to build C extension library
+
+
+## Limitations ##
+
+*   Some APIs provided by pre-processor cannot be imported.
+
+## Tested Environment ##
+
+*   [2015-09-19] SDL 2.0.3 (Installed via Homebrew)
+    *   Mac OS X 10.10.5, ruby 2.2.3p173 (2015-08-18 revision 51636) [x86_64-darwin14]
+*   [2016-04-03] SDL 2.0.4 (Installed via Homebrew)
+    *   Mac OS X 10.11.4, ruby 2.3.0p0 (2015-12-25 revision 53290) [x86_64-darwin15]
+    *   sdl2_gfx : 1.0.1
+    *   sdl2_image : 2.0.1
+    *   sdl2_mixer : 2.0.1
+    *   sdl2_ttf : 2.0.13
+*   [2019-08-31] SDL 2.0.10 (Installed via Homebrew)
+
+## License ##
+
+The zlib/libpng License ( http://opensource.org/licenses/Zlib ).
+
+    sdl2-bindings : Yet another SDL2 wrapper for Ruby
+    Copyright (c) 2015-2019 vaiorabbit <http://twitter.com/vaiorabbit>
+
+    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:

data/lib/sdl2.rb

@@ -0,0 +1,166 @@
+# Ruby-SDL2 : Yet another SDL2 wrapper for Ruby
+#
+# * https://github.com/vaiorabbit/sdl2-bindings
+
+require 'ffi'
+require_relative 'sdl2_main.rb'
+require_relative 'sdl2_audio.rb'
+require_relative 'sdl2_blendmode.rb'
+require_relative 'sdl2_clipboard.rb'
+require_relative 'sdl2_cpuinfo.rb'
+require_relative 'sdl2_error.rb'
+require_relative 'sdl2_events.rb'
+require_relative 'sdl2_filesystem.rb'
+require_relative 'sdl2_gamecontroller.rb'
+require_relative 'sdl2_gesture.rb'
+require_relative 'sdl2_haptic.rb'
+require_relative 'sdl2_hints.rb'
+require_relative 'sdl2_joystick.rb'
+require_relative 'sdl2_keyboard.rb'
+require_relative 'sdl2_keycode.rb'
+require_relative 'sdl2_log.rb'
+require_relative 'sdl2_messagebox.rb'
+require_relative 'sdl2_mouse.rb'
+require_relative 'sdl2_pixels.rb'
+require_relative 'sdl2_platform.rb'
+require_relative 'sdl2_power.rb'
+require_relative 'sdl2_rect.rb'
+require_relative 'sdl2_render.rb'
+require_relative 'sdl2_rwops.rb'
+require_relative 'sdl2_scancode.rb'
+require_relative 'sdl2_shape.rb'
+require_relative 'sdl2_surface.rb'
+require_relative 'sdl2_timer.rb'
+require_relative 'sdl2_touch.rb'
+require_relative 'sdl2_version.rb'
+require_relative 'sdl2_video.rb'
+require_relative 'sdl2_vulkan.rb'
+
+require_relative 'sdl2_framerate.rb'
+require_relative 'sdl2_gfxPrimitives.rb'
+require_relative 'sdl2_image.rb'
+require_relative 'sdl2_rotozoom.rb'
+require_relative 'sdl2_imageFilter.rb'
+require_relative 'sdl2_ttf.rb'
+require_relative 'sdl2_mixer.rb'
+
+module SDL2
+  extend FFI::Library
+
+  @@sdl2_import_done = false
+  def self.load_lib(libpath, image_libpath: nil, ttf_libpath: nil, mixer_libpath: nil, gfx_libpath: nil)
+
+    unless @@sdl2_import_done
+      # Ref.: Using Multiple and Alternate Libraries
+      # https://github.com/ffi/ffi/wiki/Using-Multiple-and-Alternate-Libraries
+      begin
+        lib_paths = [libpath, image_libpath, ttf_libpath, mixer_libpath, gfx_libpath].compact
+
+        ffi_lib_flags :now, :global
+        ffi_lib *lib_paths
+        setup_symbols()
+
+        if image_libpath != nil
+          setup_image_symbols()
+        end
+
+        if ttf_libpath != nil
+          setup_ttf_symbols()
+        end
+
+        if mixer_libpath != nil
+          setup_mixer_symbols()
+        end
+
+        if gfx_libpath != nil
+          setup_gfx_framerate_symbols()
+          setup_gfx_primitives_symbols()
+          setup_gfx_imagefilter_symbols()
+          setup_gfx_rotozoom_symbols()
+        end
+      rescue => error
+        puts error
+      end
+    end
+
+  end
+
+  def self.setup_symbols()
+    setup_main_symbols()
+    setup_audio_symbols()
+    setup_blendmode_symbols()
+    setup_clipboard_symbols()
+    setup_cpuinfo_symbols()
+    setup_error_symbols()
+    setup_events_symbols()
+    setup_filesystem_symbols()
+    setup_gamecontroller_symbols()
+    setup_gesture_symbols()
+    setup_haptic_symbols()
+    setup_hints_symbols()
+    setup_joystick_symbols()
+    setup_keyboard_symbols()
+    setup_keycode_symbols()
+    setup_log_symbols()
+    setup_messagebox_symbols()
+    setup_mouse_symbols()
+    setup_pixels_symbols()
+    setup_platform_symbols()
+    setup_power_symbols()
+    setup_rect_symbols()
+    setup_render_symbols()
+    setup_rwops_symbols()
+    setup_scancode_symbols()
+    setup_shape_symbols()
+    setup_surface_symbols()
+    setup_timer_symbols()
+    setup_touch_symbols()
+    setup_version_symbols()
+    setup_video_symbols()
+    setup_vulkan_symbols()
+  end
+
+end
+
+
+if __FILE__ == $0
+#  SDL2.load_lib('libSDL2.dylib')
+#  p SDL2.SDL_Init(SDL2::SDL_INIT_EVERYTHING)
+  SDL2.load_lib('libSDL2.dylib',
+                gfx_libpath: '/usr/local/lib/libSDL2_gfx.dylib'
+               )
+  #SDL2.SDL_SetMainReady()
+  success = SDL2.SDL_Init(SDL2::SDL_INIT_EVERYTHING)
+  exit if success < 0
+
+  WINDOW_W = 320
+  WINDOW_H = 240
+  window = SDL2.SDL_CreateWindow("1st SDL Window via sdl2-bindings", 0, 0, WINDOW_W, WINDOW_H, 0)
+
+  fpsdelay = 100;
+
+  count = 0
+  event = SDL2::SDL_Event.new
+  done = false
+  while not done
+    while SDL2.SDL_PollEvent(event) != 0
+      # 'type' and 'timestamp' are common members for all SDL Event structs.
+      event_type = event[:common][:type]
+      event_timestamp = event[:common][:timestamp]
+      puts "Event : type=0x#{event_type.to_s(16)}, timestamp=#{event_timestamp}"
+
+      case event_type
+      when SDL2::SDL_KEYDOWN
+        if event[:key][:keysym][:sym] == SDL2::SDLK_SPACE
+          puts "\tSPACE key pressed."
+        end
+      end
+    end
+
+    count += 1
+    done = true if count >= 100
+    SDL2.SDL_Delay(fpsdelay)
+  end
+
+  SDL2.SDL_Quit()
+end

data/lib/sdl2_audio.rb

@@ -0,0 +1,201 @@
+# Ruby-SDL2 : Yet another SDL2 wrapper for Ruby
+#
+# * https://github.com/vaiorabbit/sdl2-bindings
+#
+# [NOTICE] This is an automatically generated file.
+
+require 'ffi'
+
+module SDL2
+  extend FFI::Library
+  # Define/Macro
+
+  SDL_AUDIO_MASK_BITSIZE = ( 0xFF )
+  SDL_AUDIO_MASK_DATATYPE = ( 1 << 8 )
+  SDL_AUDIO_MASK_ENDIAN = ( 1 << 12 )
+  SDL_AUDIO_MASK_SIGNED = ( 1 << 15 )
+  SDL_AUDIO_ALLOW_FREQUENCY_CHANGE = 0x00000001
+  SDL_AUDIO_ALLOW_FORMAT_CHANGE = 0x00000002
+  SDL_AUDIO_ALLOW_CHANNELS_CHANGE = 0x00000004
+  SDL_AUDIO_ALLOW_SAMPLES_CHANGE = 0x00000008
+  SDL_AUDIO_ALLOW_ANY_CHANGE = ( SDL_AUDIO_ALLOW_FREQUENCY_CHANGE | SDL_AUDIO_ALLOW_FORMAT_CHANGE | SDL_AUDIO_ALLOW_CHANNELS_CHANGE | SDL_AUDIO_ALLOW_SAMPLES_CHANGE )
+  SDL_AUDIOCVT_MAX_FILTERS = 9
+  SDL_MIX_MAXVOLUME = 128
+
+  # Enum
+
+  SDL_AUDIO_STOPPED = 0
+  SDL_AUDIO_PLAYING = 1
+  SDL_AUDIO_PAUSED = 2
+
+  # Typedef
+
+  typedef :ushort, :SDL_AudioFormat
+  callback :SDL_AudioCallback, [:pointer, :pointer, :int], :void
+  callback :SDL_AudioFilter, [:pointer, :ushort], :void
+  typedef :uint, :SDL_AudioDeviceID
+  typedef :int, :SDL_AudioStatus
+
+  # Struct
+
+  class SDL_AudioSpec < FFI::Struct
+    layout(
+      :freq, :int,
+      :format, :ushort,
+      :channels, :uchar,
+      :silence, :uchar,
+      :samples, :ushort,
+      :padding, :ushort,
+      :size, :uint,
+      :callback, :pointer,
+      :userdata, :pointer,
+    )
+  end
+
+  class SDL_AudioCVT < FFI::Struct
+    layout(
+      :needed, :int,
+      :src_format, :ushort,
+      :dst_format, :ushort,
+      :rate_incr, :double,
+      :buf, :pointer,
+      :len, :int,
+      :len_cvt, :int,
+      :len_mult, :int,
+      :len_ratio, :double,
+      :filters, [:pointer, 10],
+      :filter_index, :int,
+    )
+  end
+
+
+  # Function
+
+  def self.setup_audio_symbols()
+    symbols = [
+      :SDL_GetNumAudioDrivers,
+      :SDL_GetAudioDriver,
+      :SDL_AudioInit,
+      :SDL_AudioQuit,
+      :SDL_GetCurrentAudioDriver,
+      :SDL_OpenAudio,
+      :SDL_GetNumAudioDevices,
+      :SDL_GetAudioDeviceName,
+      :SDL_OpenAudioDevice,
+      :SDL_GetAudioStatus,
+      :SDL_GetAudioDeviceStatus,
+      :SDL_PauseAudio,
+      :SDL_PauseAudioDevice,
+      :SDL_LoadWAV_RW,
+      :SDL_FreeWAV,
+      :SDL_BuildAudioCVT,
+      :SDL_ConvertAudio,
+      :SDL_NewAudioStream,
+      :SDL_AudioStreamPut,
+      :SDL_AudioStreamGet,
+      :SDL_AudioStreamAvailable,
+      :SDL_AudioStreamFlush,
+      :SDL_AudioStreamClear,
+      :SDL_FreeAudioStream,
+      :SDL_MixAudio,
+      :SDL_MixAudioFormat,
+      :SDL_QueueAudio,
+      :SDL_DequeueAudio,
+      :SDL_GetQueuedAudioSize,
+      :SDL_ClearQueuedAudio,
+      :SDL_LockAudio,
+      :SDL_LockAudioDevice,
+      :SDL_UnlockAudio,
+      :SDL_UnlockAudioDevice,
+      :SDL_CloseAudio,
+      :SDL_CloseAudioDevice,
+    ]
+    args = {
+      :SDL_GetNumAudioDrivers => [],
+      :SDL_GetAudioDriver => [:int],
+      :SDL_AudioInit => [:pointer],
+      :SDL_AudioQuit => [],
+      :SDL_GetCurrentAudioDriver => [],
+      :SDL_OpenAudio => [:pointer, :pointer],
+      :SDL_GetNumAudioDevices => [:int],
+      :SDL_GetAudioDeviceName => [:int, :int],
+      :SDL_OpenAudioDevice => [:pointer, :int, :pointer, :pointer, :int],
+      :SDL_GetAudioStatus => [],
+      :SDL_GetAudioDeviceStatus => [:uint],
+      :SDL_PauseAudio => [:int],
+      :SDL_PauseAudioDevice => [:uint, :int],
+      :SDL_LoadWAV_RW => [:pointer, :int, :pointer, :pointer, :pointer],
+      :SDL_FreeWAV => [:pointer],
+      :SDL_BuildAudioCVT => [:pointer, :ushort, :uchar, :int, :ushort, :uchar, :int],
+      :SDL_ConvertAudio => [:pointer],
+      :SDL_NewAudioStream => [:ushort, :uchar, :int, :ushort, :uchar, :int],
+      :SDL_AudioStreamPut => [:pointer, :pointer, :int],
+      :SDL_AudioStreamGet => [:pointer, :pointer, :int],
+      :SDL_AudioStreamAvailable => [:pointer],
+      :SDL_AudioStreamFlush => [:pointer],
+      :SDL_AudioStreamClear => [:pointer],
+      :SDL_FreeAudioStream => [:pointer],
+      :SDL_MixAudio => [:pointer, :pointer, :uint, :int],
+      :SDL_MixAudioFormat => [:pointer, :pointer, :ushort, :uint, :int],
+      :SDL_QueueAudio => [:uint, :pointer, :uint],
+      :SDL_DequeueAudio => [:uint, :pointer, :uint],
+      :SDL_GetQueuedAudioSize => [:uint],
+      :SDL_ClearQueuedAudio => [:uint],
+      :SDL_LockAudio => [],
+      :SDL_LockAudioDevice => [:uint],
+      :SDL_UnlockAudio => [],
+      :SDL_UnlockAudioDevice => [:uint],
+      :SDL_CloseAudio => [],
+      :SDL_CloseAudioDevice => [:uint],
+    }
+    retvals = {
+      :SDL_GetNumAudioDrivers => :int,
+      :SDL_GetAudioDriver => :pointer,
+      :SDL_AudioInit => :int,
+      :SDL_AudioQuit => :void,
+      :SDL_GetCurrentAudioDriver => :pointer,
+      :SDL_OpenAudio => :int,
+      :SDL_GetNumAudioDevices => :int,
+      :SDL_GetAudioDeviceName => :pointer,
+      :SDL_OpenAudioDevice => :uint,
+      :SDL_GetAudioStatus => :int,
+      :SDL_GetAudioDeviceStatus => :int,
+      :SDL_PauseAudio => :void,
+      :SDL_PauseAudioDevice => :void,
+      :SDL_LoadWAV_RW => :pointer,
+      :SDL_FreeWAV => :void,
+      :SDL_BuildAudioCVT => :int,
+      :SDL_ConvertAudio => :int,
+      :SDL_NewAudioStream => :pointer,
+      :SDL_AudioStreamPut => :int,
+      :SDL_AudioStreamGet => :int,
+      :SDL_AudioStreamAvailable => :int,
+      :SDL_AudioStreamFlush => :int,
+      :SDL_AudioStreamClear => :void,
+      :SDL_FreeAudioStream => :void,
+      :SDL_MixAudio => :void,
+      :SDL_MixAudioFormat => :void,
+      :SDL_QueueAudio => :int,
+      :SDL_DequeueAudio => :uint,
+      :SDL_GetQueuedAudioSize => :uint,
+      :SDL_ClearQueuedAudio => :void,
+      :SDL_LockAudio => :void,
+      :SDL_LockAudioDevice => :void,
+      :SDL_UnlockAudio => :void,
+      :SDL_UnlockAudioDevice => :void,
+      :SDL_CloseAudio => :void,
+      :SDL_CloseAudioDevice => :void,
+    }
+    symbols.each do |sym|
+      begin
+        attach_function sym, args[sym], retvals[sym]
+      rescue FFI::NotFoundError => error
+        $stderr.puts("[Warning] Failed to import #{sym} (#{error}).")
+      end
+    end
+  end
+
+end
+
+# TODO : def SDL_LoadWAV
+