rb_sdl2 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 101f794f351d219f8cc70180a9f02cd57c11c507e8542fad5d83c2e4635ea7cd
-  data.tar.gz: fc7e00d5985c46af575e81cdbd2bfd177464f14eeb111e2dfae41cdaffb75e51
+  metadata.gz: f1a9691e0a9183d9ab18c54b3082684680479e993b94b8d4671c36a4a7607554
+  data.tar.gz: d92d27fba832167ee810572136eefb2f5eab51ba6d7c0c2ef5d434dbc2d69fd5
 SHA512:
-  metadata.gz: 0dd39b4cb9da230fd7d63556a3db53be3d28eeee972a5a54aa945cffa246501d3684112d72b8f8b5f3f76cee58d47e21a226998ae791390c4f98d53222aa4cda
-  data.tar.gz: dca9330ed249b66a6b21ad6bc42a42a14cd014f95757529d3f9e14f927f0ca89c9989960e3403511ecb58d315ed28829ca8fa9a61e30a934250ee3cefc22d207
+  metadata.gz: 1935c67fec1c889641e3e47dabd95ca1770239804fcb40d4930f6d1509496a27dfbeed0ddef48460abbcaa03e5afe9bc66db7ae434941085d59b35b83daa7a17
+  data.tar.gz: bd86b878ce15b8663bcc0a0056b8e0ddd700192ba93f39257fb7707fdc5ed032662395df3e13c087297eb25e4e8751626202db34afdc3ad306c91f54ff97fc0c

data/CHANGELOG.md

@@ -1,5 +1,74 @@
 ## [Unreleased]
 
+## [0.2.0] - 2022-05-08
+
+### Added
+- Error.last_error_message= - SDL のエラーメッセージを設定する。
+- Event - SDL_TEXTEDITING_EXT, SDL_POLLSENTINEL イベントを追加。
+- RbSDL2 - クラスメソッドへ CPUInfo, Keyboard, Platform, SDL, Timer, Version のメソッドを追加した。
+- RbSDL2.alert, error_alert, info_alert, warn_alert - シンプルなメッセージボックスを開く。
+- RbSDL2.confirm, confirm? - Ok, Cancel のボタンがあるメッセージボックスを開く。
+- RbSDL2.clipboard_text, RbSDL2.clipboard_text= - テキストクリップボードの読み書き。
+- RbSDL2.hide_cursor, show_cursor - マウスカーソルの表示状態を変更する。
+- RbSDL2.open_rw - ファイル、メモリー、IO オブジェクトを RWOps インスタンスで開く。Surface.load などで使用する。
+- RbSDL2.open_url - アプリケーションからブラウザーを起動できる。
+- RbSDL2.power_info - システムの電源状態を取得する。
+- RbSDL2.screen_saver?, screen_saver= - スクリーンセーバー起動の可否状態を取得、設定する。
+- RWFile, RWMemory, RWObject - SDL の SDL_RWops コンストラクターに応じてクラスを分けた。RWOps を継承している。
+- SDL.ptr_to_str, SDL.str_to_sdl - Ruby 文字列と SDL 文字列の相互変換。
+- SDLPointer - SDL のメモリーアロケーターを使用したメモリー領域を扱うためのクラス。
+- Surface#pixel_color - 指定座標のピクセルのカラーを戻す。
+- Surface#pixel - 指定座標のピクセル値を戻す。
+- Window#mouse_rect, mouse_rect= - ウィンドウ内のマウス移動範囲を指定する。
+
+### Changed
+- Ruby のバージョン要求を 3.1 以上に変更した。
+- sdl2-bindings v0.1.1 に対応した。以前のバージョンは使用できない。
+- Audio, Cursor, Event, Keyboard, Mouse, Window - リファクタリング。再設計した。
+- Error.message -> Error.last_error_message
+- RbSDL2.loop - ループごとに Event.clear を呼び出すのをやめた。これはイベントを握りつぶさないようにするため。
+- RWOps - SDL_RWops コンストラクタ毎に子クラスへ分けた。実際に利用する際には RbSDL2.open_rw を使うこと。
+- SDL.init, SDL.init? - 引数の形式を変更。
+- Window#popup -> Window#current!
+
+### Deprecated
+
+### Fixed
+
+### Removed
+- AudioBuffer.load_rw - load に取り込まれた。
+- PixelFormatEnum - パックされたフォーマットの解析メソッドを削除。実装を変更し不要になった。
+- Surface.load_rw - load に取り込まれた。
+- Surface＃save_rw - save に取り込まれた。
+
+### Security
+
+## [0.1.2] - 2021-10-19
+
+### Added
+- RWOps#inspect - Return Ruby File#inspect like string.
+
+### Changed
+- RWOps - The constructor can accept blocks.
+- RWOperator - Code cleanup.
+
+### Fixed
+- RWOps - some bugs.
+- RWOperator - some bugs.
+
+### Removed
+- RWOps.to_ptr - There is no use case.
+
+## [0.1.1] - 2021-10-11
+
+### Added
+- Added metadata to gemspec.
+- Added document to Error, Platform, SDL, Surface, Timer, and Version.
+- Added description to README.md.
+
+### Changed
+- Changed the contents of Palette#inspect to something meaningful.
+
 ## [0.1.0] - 2021-10-10
 
 - Initial release

data/README.md

@@ -3,9 +3,23 @@
 RbSDL2 は [SDL](https://www.libsdl.org) (Simple DirectMedia Layer) の機能を
 Ruby オブジェクトとして提供します。
 
-SDL 2.0.16 移行を対象としています。この Gem には SDL は含まれていません。
+SDL 2.0.22 以降を対象としています。この Gem には SDL は含まれていません。
 利用する際は環境に合わせて SDL を用意してください。
 
+## Description
+
+RbSDL2 は SDL の機能やポインターを Ruby オブジェクトとして扱います。
+ポインター管理を RbSDL2 が行っているのでメモリー管理を気にせずに SDL の機能を使うことができます。
+最低限のマネージ機能も用意しています。例えばコールバック関数を設定した場合はそのオブジェクトを保持します。
+スコープを外れてもコアダンプすることはありません。
+
+[sdl2-bindings](https://rubygems.org/gems/sdl2-bindings) を基に構築していますので、
+オブジェクトの仕様や性能が気に入らない場合は直接（そして全ての） SDL 関数を呼び出すこともできます。
+各オブジェクトは外部からのポインターから作成することができます。
+C で書いたライブラリとの部分的な連携に利用することもできます。
+
+SDL の仕様や機能について知っている必要はありますが Ruby のコードを読めれば使えるようになっています。
+
 ## Installation
 
     $ gem install rb_sdl2

data/lib/rb_sdl2/audio/audio.rb

@@ -0,0 +1,162 @@
+module RbSDL2
+  class Audio
+    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_AUDIO_STOPPED = 0
+    SDL_AUDIO_PLAYING = 1
+    SDL_AUDIO_PAUSED  = 2
+
+    IS_CAPTURE = -> (capture) { capture ? 1 : 0 }
+
+    class << self
+      require_relative 'audio_device'
+
+      def devices = AudioDevice.devices
+
+      def driver
+        ptr = ::SDL.GetCurrentAudioDriver
+        raise RbSDL2Error, "Audio subsystem has not been initialized" if ptr.null?
+        ptr.read_string
+      end
+
+      def drivers
+        ::SDL.GetNumAudioDrivers.times.map do |num|
+          ptr = ::SDL.GetAudioDriver(num)
+          raise RbSDL2Error if ptr.null?
+          ptr.read_string
+        end
+      end
+
+      def init(driver)
+        raise RbSDL2Error if ::SDL.AudioInit(driver) < 0
+      end
+
+      require_relative 'audio_buffer'
+
+      def load(...) = AudioBuffer.load(...)
+
+      def open(...)
+        obj = new(...)
+        return obj unless block_given?
+        begin
+          yield(obj)
+        ensure
+          obj.close
+        end
+      end
+
+      def play(path)
+        buffer = load(path)
+        obj = Audio.new(spec: buffer.spec)
+        obj.write(buffer)
+        obj.play
+        obj
+      end
+
+      def quit = ::SDL.AudioQuit
+    end
+
+    require_relative 'audio_spec'
+
+    def initialize(device = nil, capture = false, allow_any_change: false,
+                   allow_channels_change: false, allow_frequency_change: false,
+                   allow_format_change: false, allow_samples_change: false,
+                   autoclose: true, spec: nil, **opts)
+      @capture = capture ? true : false
+      @spec = AudioSpec.new
+      allowed_changes = if allow_any_change
+                          SDL_AUDIO_ALLOW_ANY_CHANGE
+                        else
+                          0 |
+                            (allow_channels_change ? SDL_AUDIO_ALLOW_CHANNELS_CHANGE : 0) |
+                            (allow_frequency_change ? SDL_AUDIO_ALLOW_FREQUENCY_CHANGE : 0) |
+                            (allow_format_change ? SDL_AUDIO_ALLOW_FORMAT_CHANGE : 0) |
+                            (allow_samples_change ? SDL_AUDIO_ALLOW_SAMPLES_CHANGE : 0)
+                        end
+      @id = ::SDL.OpenAudioDevice(device ? SDL.str_to_sdl(device) : nil, IS_CAPTURE.(capture),
+                                  spec || AudioSpec.new(**opts), @spec, allowed_changes)
+      raise RbSDL2Error if @id == 0
+      self.autoclose = autoclose
+    end
+
+    class Releaser
+      def initialize(num) = @id = num
+
+      def call(_id) = ::SDL.CloseAudioDevice(@id)
+    end
+
+    def autoclose=(bool)
+      return if closed?
+      if bool
+        ObjectSpace.define_finalizer(self, Releaser.new(@id))
+      else
+        ObjectSpace.undefine_finalizer(self)
+      end
+      @autoclose = bool ? true : false
+    end
+
+    def autoclose? = @autoclose
+
+    def capture? = @capture
+
+    def clear = closed? ? nil : ::SDL.ClearQueuedAudio(self)
+
+    def close
+      unless closed?
+        self.autoclose = false
+        @id = ::SDL.CloseAudioDevice(@id)
+      end
+      nil
+    end
+
+    def closed? = SDL_AUDIO_STOPPED == ::SDL.GetAudioDeviceStatus(@id) || !@id
+
+    def id
+      raise IOError if closed?
+      @id
+    end
+    alias audio_id id
+
+    def inspect
+      "#<#{self.class.name}:#{audio_id}#{closed? ? " (closed)" : nil}>"
+    end
+
+    def pause = closed? ? nil : ::SDL.PauseAudioDevice(id, 1)
+
+    def paused? = closed? ? false : SDL_AUDIO_PAUSED == ::SDL.GetAudioDeviceStatus(id)
+
+    def play = closed? ? nil : ::SDL.PauseAudioDevice(id, 0)
+
+    def playing? = closed? ? false : SDL_AUDIO_PLAYING == ::SDL.GetAudioDeviceStatus(id)
+
+    def read(len)
+      raise IOError if closed?
+      ptr = ::FFI::MemoryPointer.new(len)
+      size = ::SDL.DequeueAudio(id, ptr, len)
+      ptr.read_bytes(size)
+    end
+
+    def size
+      raise IOError if closed?
+      ::SDL.GetQueuedAudioSize(id)
+    end
+    alias length size
+
+    attr_reader :spec
+
+    require_relative 'audio_spec_reader'
+    include AudioSpecReader
+
+    def write(data)
+      raise IOError if closed?
+      err = ::SDL.QueueAudio(id, data, data.size)
+      raise RbSDL2Error if err < 0
+      data.size
+    end
+  end
+end

data/lib/rb_sdl2/audio/audio_buffer.rb

@@ -2,24 +2,21 @@ module RbSDL2
   class Audio
     class AudioBuffer
       class AudioBufferPointer < ::FFI::AutoPointer
-        def self.release(ptr) = ::SDL2::SDL_FreeWAV(ptr)
+        def self.release(ptr) = ::SDL::FreeWAV(ptr)
       end
 
       class << self
-        require_relative '../rw_ops'
-
-        def load(file) = RWOps.new(file, "rb") { |rw| load_rw(rw) }
-
         require_relative 'audio_spec'
 
-        # load_rw は与えられたオブジェクトをオートクローズしません。
-        def load_rw(rw)
-          spec = AudioSpec.new
-          buf = ::FFI::MemoryPointer.new(:pointer)
-          len = ::FFI::MemoryPointer.new(:uint32)
-          err = ::SDL2::SDL_LoadWAV_RW(rw, 0, spec, buf, len)
-          raise RbSDL2Error if err.null?
-          new(AudioBufferPointer.new(buf.read_pointer), len.read_uint32, spec)
+        def load(obj)
+          RbSDL2.open_rw(obj) do |rw|
+            spec = AudioSpec.new
+            buf = ::FFI::MemoryPointer.new(:pointer)
+            len = ::FFI::MemoryPointer.new(:uint32)
+            err = ::SDL::LoadWAV_RW(rw, 0, spec, buf, len)
+            raise RbSDL2Error if err.null?
+            new(AudioBufferPointer.new(buf.read_pointer), len.read_uint32, spec)
+          end
         end
       end
 
@@ -34,12 +31,8 @@ module RbSDL2
 
       attr_reader :spec
 
-      require 'forwardable'
-      extend Forwardable
-      def_delegators :spec, *%i(channels format frequency)
-
-      require_relative 'audio_format'
-      include AudioFormat
+      require_relative 'audio_spec_reader'
+      include AudioSpecReader
 
       def to_ptr = @ptr
 

data/lib/rb_sdl2/audio/audio_device.rb

@@ -3,42 +3,36 @@ module RbSDL2
     class AudioDevice
       class << self
         def devices(capture = false)
-          is_capture = IS_CAPTURE.(capture)
-          ::SDL2.SDL_GetNumAudioDevices(is_capture).times.map do |num|
-            ptr = ::SDL2.SDL_GetAudioDeviceName(num, is_capture)
-            raise RbSDL2Error if ptr.null?
-
-            spec = AudioSpec.new
-            # SDL_GetAudioDeviceSpec は SDL_GetNumAudioDevices の最新の呼び出しを反映する。
-            err = ::SDL2.SDL_GetAudioDeviceSpec(num, is_capture, spec)
-            raise RbSDL2Error if err != 0
-
-            new(ptr.read_string.force_encoding(Encoding::UTF_8), capture, spec)
-          end
+          ::SDL.GetNumAudioDevices(IS_CAPTURE.(capture)).times.map { |num| new(num, capture) }
         end
       end
 
-      def initialize(name, capture, spec)
-        @capture = CAPTURE.(capture)
-        @name = name
+      def initialize(num, capture)
+        is_capture = IS_CAPTURE.(capture)
+        ptr = ::SDL.GetAudioDeviceName(num, is_capture)
+        raise RbSDL2Error if ptr.null?
+
+        spec = AudioSpec.new
+        # GetAudioDeviceSpec は GetNumAudioDevices の最新の呼び出しを反映する。
+        err = ::SDL.GetAudioDeviceSpec(num, is_capture, spec)
+        raise RbSDL2Error if err != 0
+
+        @capture = capture ? true : false
+        @name = SDL.ptr_to_str(ptr)
         @spec = spec
       end
 
-      attr_reader :capture
+      def capture? = @capture
 
       attr_reader :name
       alias to_s name
 
       attr_reader :spec
 
-      require 'forwardable'
-      extend Forwardable
-      def_delegators :spec, *%i(channels format frequency)
-
-      require_relative 'audio_format'
-      include AudioFormat
+      require_relative 'audio_spec_reader'
+      include AudioSpecReader
 
-      def unknown? = channels == 0 && format == 0 && frequency == 0
+      def unknown? = spec.unknown?
     end
   end
 end

data/lib/rb_sdl2/audio/audio_spec.rb

@@ -1,29 +1,61 @@
 module RbSDL2
   class Audio
     class AudioSpec
-      require_relative 'audio_format'
+      module Reader
+        require 'forwardable'
+        extend Forwardable
+        def_delegators :spec,
+                       *%i(big_endian? bitsize float? signed? channels format frequency samples)
+      end
+
+      SDL_AUDIO_MASK_BITSIZE  = 0xFF
+      SDL_AUDIO_MASK_DATATYPE = 1 << 8
+      SDL_AUDIO_MASK_ENDIAN   = 1 << 12
+      SDL_AUDIO_MASK_SIGNED   = 1 << 15
 
-      def initialize(channels: 0, format: 0, freq: 0, frequency: freq, samples: 0)
-        @st = ::SDL2::SDL_AudioSpec.new
+      def initialize(big_endian: false, bitsize: 16, float: false, signed: true,
+                     channels: 0, format: nil, frequency: 0, samples: 0)
+        @st = ::SDL::AudioSpec.new
         @st[:channels] = channels
-        @st[:format] = format
+        @st[:format] = format || 0 |
+          (big_endian ? SDL_AUDIO_MASK_ENDIAN : 0) |
+          (bitsize & SDL_AUDIO_MASK_BITSIZE) |
+          (float ? SDL_AUDIO_MASK_DATATYPE & SDL_AUDIO_MASK_SIGNED : 0) |
+          (signed ? SDL_AUDIO_MASK_SIGNED : 0)
         @st[:freq] = frequency
         @st[:samples] = samples
       end
 
-      def size = @st[:size]
-      alias chunk_size size
+      def big_endian? = SDL_AUDIO_MASK_ENDIAN & format != 0
 
+      def bitsize = SDL_AUDIO_MASK_BITSIZE & format
+
+      # チャンネル数
       def channels = @st[:channels]
 
+      def float? = SDL_AUDIO_MASK_DATATYPE & format != 0
+
+      # 音声フォーマット
       def format = @st[:format]
 
+      # サンプルレート
       def freq = @st[:freq]
       alias frequency freq
 
+      # 音声バッファのサンプル数。２のべき乗。
       def samples = @st[:samples]
 
+      def signed? = SDL_AUDIO_MASK_SIGNED & format != 0
+
+      # 音量レベル０の値。8ビットフォーマットの際に使用する（と思われる。型が Uint8 であるため）。SDL が決定する。
+      def silence = @st[:silence]
+
+      # 音声バッファのサイズ（Byte）。SDL が決定する。
+      def size = @st[:size]
+
       def to_ptr = @st.to_ptr
+
+      def unknown? = channels == 0 && format == 0 && frequency == 0
     end
   end
 end

data/lib/rb_sdl2/audio/audio_spec_reader.rb

@@ -0,0 +1,10 @@
+module RbSDL2
+  class Audio
+    module AudioSpecReader
+      require 'forwardable'
+      extend Forwardable
+      def_delegators :spec,
+                     *%i(big_endian? bitsize float? signed? channels format frequency samples)
+    end
+  end
+end

data/lib/rb_sdl2/clipboard.rb

@@ -1,44 +1,44 @@
 module RbSDL2
   module Clipboard
     class << self
-      def clear = self.text = nil
+      # クリップボードの内容をクリアします。
+      def clear = ::SDL.SetClipboardText(nil)
 
-      # イベントを pump したとき外部からのクリップボード取得が行われる。
-      # その際に SDL_CLIPBOARDUPDATE イベントがキューに入る。これはイベントコールバックで捕獲できる。
-      # 読み出し時にクリップボードの内容はクリアーされない。
+      require_relative 'sdl_pointer'
+
+      # テキストクリップボードの内容を戻します。文字エンコードは UTF-8 です。
+      # このメソッドを使用する前に video sub-system を初期化しておく必要があります。
+      # クリップボードの取得ができない場合（video sub-system が初期化されていない）場合はエラー通知します。
+      # 読み出し時にクリップボードの内容はクリアーされません。
+      # クリップボードの状態が変化したかどうか知りたい場合はイベントを監視してください。
+      # その場合はイベントを受け取るためウィンドウを表示します。
+      # 次にそのウィンドウがフォーカスされた時に SDL_CLIPBOARDUPDATE イベントを受け取ることができます。
       def text
-        # SDL_GetClipboardText は NULL ポインターを戻さない。返すべき内容がない場合は空の文字列を戻す。
-        ::SDL2.SDL_GetClipboardText.read_string.force_encoding(Encoding::UTF_8)
-      ensure
-        # SDL_GetClipboardText は呼び出されるたびに OS から取得したクリップボードの内容を SDL 内部に保存し、
-        # それをさらにコピーしたものを戻す。
+        # SDL_GetClipboardText() は NULL ポインターを戻さない。返すべき内容がない場合は空文字列を戻す。
+        # 取得できないとき（video sub-system が初期化されていない）も空文字列を戻す。
+        # SDL は OS から取得したクリップボードの内容を SDL 内部に保存し、それをさらにコピーしたものを戻す。
         # アプリケーション側は取得した文字列ポインタを必ず開放しなければならない。
-        ::SDL2.SDL_free(ptr)
-      end
-
-      # クリップボードの内容を戻す。text メソッドと違い読み出し後にクリップボードの内容をクリアーする。
-      def text!
-        str = text
-        clear
-        str
+        ptr = SDLPointer.new(::SDL.GetClipboardText)
+        s = ptr.to_s
+        # クリップボードが空の時（OS 起動直後など）およびエラーの際も空文字列を戻す。
+        raise RbSDL2Error if s.empty? && !SDL.init?(:video)
+        s
       end
 
-      # クリップボードへ書き込む。クリップボードはパブリックであり他のアプリケーションから取得できる。
-      # 当然、SDL もこの書き込みを補足する。
-      # クリップボードの読み出しを行わずに、大量のクリップボード書き込みを行うと SDL はエラーを戻す。
-      # このエラーは SDL からではなく OS から戻るエラーである。書き込み上限や既に書き込んだ回数を知る方法はない。
-      # また、アプリケーション側でクリップボードを読み出しても制限を回避できない。
-      # （OS に保存されたクリップボードはパブリックなコピーでありユーザが取り出さなければそのコピーは消えないだろう）
-      def text=(obj)
-        raise RbSDL2Error if ::SDL2.SDL_SetClipboardText(obj&.to_s&.encode(Encoding::UTF_8)) < 0
+      # テキストクリップボードへ書き込みます。書き込んだ内容は外部アプリケーションから取得できます。
+      # 書き込みを行った場合 SDL は SDL_CLIPBOARDUPDATE イベントを発生させます。
+      # 繰り返しクリップボード書き込みを行うとエラーを戻します。この上限は OS 側にあるため事前に知る方法はありません。
+      # その場合は Clipboard.clear を実行すると書き込みができるようになります。
+      def text=(s)
+        raise RbSDL2Error if ::SDL.SetClipboardText(SDL.str_to_sdl(s)) < 0
       end
 
-      # クリップボードに内容があるか確認をする。
-      # これはアプリケーションがクリップボードを読み出しても内容はクリアーされないため、
-      # クリップボードの更新を知るためには実装を工夫する必要がある。
-      # もっとも簡単な方法は、クリップボードの内容を読み込み度に Clipboard.text = nil を実行し、
-      # クリップボードをクリアする。
-      def text? = ::SDL2.SDL_HasClipboardText == ::SDL2::SDL_TRUE
+      # クリップボードに内容があるか確認します。
+      # 取得できないとき（video sub-system が初期化されていない）も false を戻します。
+      # 外部アプリケーションがクリップボードを読み出しても内容はクリアーされません。
+      # クリップボードのクリアを行った場合、または外部アプリケーションからテキスト以外の内容がクリップボードにセット
+      # された場合 false になります。
+      def exist? = ::SDL.HasClipboardText == ::SDL::TRUE
     end
   end
 end

data/lib/rb_sdl2/cpu_info.rb

@@ -1,39 +1,56 @@
 module RbSDL2
   module CPUInfo
     class << self
-      def cpu_count = ::SDL2.SDL_GetCPUCount
+      # Power CPU の AltiVec 拡張命令セット
+      def altivec? = ::SDL.HasAltiVec == ::SDL::TRUE
 
-      def cpu_cache_line_size = ::SDL2.SDL_GetCPUCacheLineSize
+      # AMD x86 CPU の 3DNow! 拡張命令セット
+      def amd3dnow? = ::SDL.Has3DNow == ::SDL::TRUE
 
-      def system_ram = ::SDL2.SDL_GetSystemRAM
+      # Arm CPU の SIMD 命令セット
+      def armsimd? = ::SDL.HasARMSIMD == ::SDL::TRUE
 
-      def rdtsc? = ::SDL2.SDL_HasRDTSC == ::SDL2::SDL_TRUE
+      # x86 CPU の AVX 命令セット
+      def avx = ::SDL.HasAVX == ::SDL::TRUE
 
-      def altivec? = ::SDL2.SDL_HasAltiVec == ::SDL2::SDL_TRUE
+      # x86 CPU の AVX2 命令セット
+      def avx2 = ::SDL.HasAVX2 == ::SDL::TRUE
 
-      def mmx? = ::SDL2.SDL_HasMMX == ::SDL2::SDL_TRUE
+      # x86 CPU の AVX-512F 命令セット
+      def avx512f? = ::SDL.HasAVX512F == ::SDL::TRUE
 
-      def _3dnow? = ::SDL2.SDL_Has3DNow == ::SDL2::SDL_TRUE
+      # CPU の L1 キャッシュラインサイズ（Byte）
+      def cpu_cache_line_size = ::SDL.GetCPUCacheLineSize
 
-      def sse? = ::SDL2.SDL_HasSSE == ::SDL2::SDL_TRUE
+      # 論理 CPU コアの総数
+      def cpu_count = ::SDL.GetCPUCount
 
-      def sse2? = ::SDL2.SDL_HasSSE2 == ::SDL2::SDL_TRUE
+      # x86 CPU の MMX 命令セット
+      def mmx? = ::SDL.HasMMX == ::SDL::TRUE
 
-      def sse3? = ::SDL2.SDL_HasSSE3 == ::SDL2::SDL_TRUE
+      # Arm CPU の NEON 命令セット
+      def neon? = ::SDL.HasNEON == ::SDL::TRUE
 
-      def sse41? = ::SDL2.SDL_HasSSE41 == ::SDL2::SDL_TRUE
+      # x86 CPU の RDTSC 命令
+      def rdtsc? = ::SDL.HasRDTSC == ::SDL::TRUE
 
-      def sse42? = ::SDL2.SDL_HasSSE42 == ::SDL2::SDL_TRUE
+      # x86 CPU の SSE 命令セット
+      def sse? = ::SDL.HasSSE == ::SDL::TRUE
 
-      def avx? = ::SDL2.SDL_HasAVX == ::SDL2::SDL_TRUE
+      # x86 CPU の SSE2 命令セット
+      def sse2 = ::SDL.HasSSE2 == ::SDL::TRUE
 
-      def avx2? = ::SDL2.SDL_HasAVX2 == ::SDL2::SDL_TRUE
+      # x86 CPU の SSE3 命令セット
+      def sse3 = ::SDL.HasSSE3 == ::SDL::TRUE
 
-      def avx512f = ::SDL2.SDL_HasAVX512F == ::SDL2::SDL_TRUE
+      # x86 CPU の SSE4.1 命令セット
+      def sse41? = ::SDL.HasSSE41 == ::SDL::TRUE
 
-      def armsimd? = ::SDL2.SDL_HasARMSIMD == ::SDL2::SDL_TRUE
+      # x86 CPU の SSE4.2 命令セット
+      def sse42? = ::SDL.HasSSE42 == ::SDL::TRUE
 
-      def neon? = ::SDL2.SDL_HasNEON == ::SDL2::SDL_TRUE
+      # システム RAM のサイズ（MB）
+      def system_ram = ::SDL.GetSystemRAM
     end
   end
 end