ruby-sfml 3.0.0.4 → 3.0.0.5

data/lib/sfml/window/context.rb

@@ -0,0 +1,56 @@
+module SFML
+  # Headless OpenGL context — for compiling shaders, generating
+  # textures, or doing GL work without a window. SFML attaches the
+  # context to whichever thread constructed it.
+  #
+  #   ctx = SFML::Context.new
+  #   ctx.active = true
+  #   # … raw GL work / shader compile …
+  #   ctx.active = false
+  #
+  # CSFML always returns a non-NULL context on creation (it falls back
+  # to a pbuffer / EGL surface if no display is available), so the
+  # constructor doesn't raise.
+  class Context
+    def initialize
+      ptr = C::Window.sfContext_create
+      raise Error, "sfContext_create returned NULL" if ptr.null?
+      @handle = FFI::AutoPointer.new(ptr, C::Window.method(:sfContext_destroy))
+    end
+
+    # Activate / deactivate this context on the current thread. Only
+    # one context can be current per thread; setting another active
+    # implicitly deactivates this one.
+    def active=(value)
+      C::Window.sfContext_setActive(@handle, !!value)
+    end
+
+    # The settings the GL driver actually granted (might differ from
+    # what you asked for if the driver couldn't meet every
+    # constraint).
+    def settings
+      ContextSettings.from_native(C::Window.sfContext_getSettings(@handle))
+    end
+
+    # ID of the context currently active on this thread, or 0 if
+    # none. Useful for "am I in the GL context I expect?" assertions.
+    def self.active_context_id
+      C::Window.sfContext_getActiveContextId
+    end
+
+    # Is `extension_name` (e.g. "GL_ARB_compute_shader") supported by
+    # the active context?
+    def self.extension_available?(extension_name)
+      C::Window.sfContext_isExtensionAvailable(extension_name.to_s)
+    end
+
+    # Look up a raw GL function pointer by name. Useful when
+    # interoping with a GL extension that SFML doesn't wrap. Returns
+    # an FFI::Pointer (nil pointer if the function isn't loaded).
+    def self.gl_function(name)
+      C::Window.sfContext_getFunction(name.to_s)
+    end
+
+    attr_reader :handle # :nodoc:
+  end
+end

data/lib/sfml/window/keyboard.rb

@@ -1,9 +1,18 @@
 module SFML
   # Keyboard key code <-> symbol translation, plus Keyboard.key_pressed?(:esc).
   #
-  # The KEY_CODES array order is load-bearing: it matches the sfKeyCode enum
-  # in CSFML/Window/Keyboard.h exactly. sfKeyUnknown is -1 and represented
-  # here by :unknown returned via #code_to_symbol.
+  # Two concepts:
+  #   * **Key**   — logical / layout-dependent. `:a` on a QWERTY keyboard
+  #     is the physical Q on AZERTY. Use this for "what does the user
+  #     mean" (text input, layout-aware shortcuts).
+  #   * **Scancode** — physical / layout-independent. The key at the
+  #     position you expect WASD to be will always be `:scan_w` /
+  #     `:scan_a` / `:scan_s` / `:scan_d`. Use this for "the WASD keys"
+  #     that should stay in the same physical place regardless of
+  #     keyboard layout. Standard in modern games.
+  #
+  # The KEY_CODES / SCAN_CODES arrays are load-bearing: order matches
+  # the sfKeyCode / sfScancode enums in CSFML/Window/Keyboard.h.
   module Keyboard
     KEY_CODES = %i[
       a b c d e f g h i j k l m n o p q r s t u v w x y z
@@ -26,6 +35,41 @@ module SFML
 
     SYMBOL_TO_CODE = KEY_CODES.each_with_index.to_h.freeze
 
+    # Matches sfScancode in CSFML/Window/Keyboard.h exactly.
+    # sfScanUnknown is -1, represented here by :scan_unknown via #scancode_to_symbol.
+    SCAN_CODES = %i[
+      scan_a scan_b scan_c scan_d scan_e scan_f scan_g scan_h
+      scan_i scan_j scan_k scan_l scan_m scan_n scan_o scan_p
+      scan_q scan_r scan_s scan_t scan_u scan_v scan_w scan_x scan_y scan_z
+      scan_num1 scan_num2 scan_num3 scan_num4 scan_num5
+      scan_num6 scan_num7 scan_num8 scan_num9 scan_num0
+      scan_enter scan_escape scan_backspace scan_tab scan_space
+      scan_hyphen scan_equal scan_l_bracket scan_r_bracket scan_backslash
+      scan_semicolon scan_apostrophe scan_grave scan_comma scan_period scan_slash
+      scan_f1 scan_f2 scan_f3 scan_f4 scan_f5 scan_f6
+      scan_f7 scan_f8 scan_f9 scan_f10 scan_f11 scan_f12
+      scan_f13 scan_f14 scan_f15 scan_f16 scan_f17 scan_f18
+      scan_f19 scan_f20 scan_f21 scan_f22 scan_f23 scan_f24
+      scan_caps_lock scan_print_screen scan_scroll_lock scan_pause
+      scan_insert scan_home scan_page_up scan_delete scan_end scan_page_down
+      scan_right scan_left scan_down scan_up
+      scan_num_lock scan_numpad_divide scan_numpad_multiply scan_numpad_minus
+      scan_numpad_plus scan_numpad_equal scan_numpad_enter scan_numpad_decimal
+      scan_numpad1 scan_numpad2 scan_numpad3 scan_numpad4 scan_numpad5
+      scan_numpad6 scan_numpad7 scan_numpad8 scan_numpad9 scan_numpad0
+      scan_non_us_backslash scan_application scan_execute scan_mode_change
+      scan_help scan_menu scan_select scan_redo scan_undo
+      scan_cut scan_copy scan_paste
+      scan_volume_mute scan_volume_up scan_volume_down
+      scan_media_play_pause scan_media_stop scan_media_next_track scan_media_previous_track
+      scan_l_control scan_l_shift scan_l_alt scan_l_system
+      scan_r_control scan_r_shift scan_r_alt scan_r_system
+      scan_back scan_forward scan_refresh scan_stop scan_search scan_favorites scan_home_page
+      scan_launch_application1 scan_launch_application2 scan_launch_mail scan_launch_media_select
+    ].freeze
+
+    SCAN_SYMBOL_TO_CODE = SCAN_CODES.each_with_index.to_h.freeze
+
     # Friendly aliases users might reach for naturally.
     ALIASES = {
       esc:    :escape,
@@ -52,9 +96,53 @@ module SFML
       end
     end
 
-    # SFML::Keyboard.key_pressed?(:escape)
+    def scancode_to_symbol(code)
+      return :scan_unknown if code < 0 || code >= SCAN_CODES.length
+      SCAN_CODES[code]
+    end
+
+    def symbol_to_scancode(symbol)
+      SCAN_SYMBOL_TO_CODE.fetch(symbol) do
+        raise ArgumentError, "Unknown scancode symbol: #{symbol.inspect}. " \
+                             "See SFML::Keyboard::SCAN_CODES."
+      end
+    end
+
+    # SFML::Keyboard.key_pressed?(:escape) — logical key.
     def key_pressed?(symbol)
       C::Window.sfKeyboard_isKeyPressed(symbol_to_code(symbol))
     end
+
+    # SFML::Keyboard.scancode_pressed?(:scan_w) — physical key
+    # regardless of keyboard layout.
+    def scancode_pressed?(symbol)
+      C::Window.sfKeyboard_isScancodePressed(symbol_to_scancode(symbol))
+    end
+
+    # Map a physical scancode to whatever logical key it produces under
+    # the current OS keyboard layout. Returns a key symbol (or
+    # :unknown for unmappable scancodes).
+    def localize(scancode)
+      code_to_symbol(C::Window.sfKeyboard_localize(symbol_to_scancode(scancode)))
+    end
+
+    # Inverse of #localize — find the physical scancode that *would*
+    # produce this logical key under the current layout. Returns a
+    # scancode symbol.
+    def delocalize(key)
+      scancode_to_symbol(C::Window.sfKeyboard_delocalize(symbol_to_code(key)))
+    end
+
+    # Human-readable description for a scancode under the current
+    # layout — e.g. `:scan_w` → `"W"` on QWERTY, `"Z"` on AZERTY.
+    def description(scancode)
+      C::Window.sfKeyboard_getDescription(symbol_to_scancode(scancode))
+    end
+
+    # On-screen / virtual keyboard toggle. No-op on desktop platforms;
+    # meaningful on mobile/touchscreen builds.
+    def virtual_keyboard_visible=(value)
+      C::Window.sfKeyboard_setVirtualKeyboardVisible(!!value)
+    end
   end
 end

data/lib/sfml/window/video_mode.rb

@@ -17,6 +17,28 @@ module SFML
       from_native(C::Window.sfVideoMode_getDesktopMode)
     end
 
+    # All video modes the current display supports for true-fullscreen
+    # window creation, sorted from most to least pixels. Filter by
+    # bpp or aspect ratio in Ruby as needed.
+    def self.fullscreen_modes
+      count_buf = FFI::MemoryPointer.new(:size_t)
+      array_ptr = C::Window.sfVideoMode_getFullscreenModes(count_buf)
+      n = count_buf.read(:size_t)
+      return [] if array_ptr.null? || n.zero?
+
+      stride = C::Window::VideoMode.size
+      Array.new(n) do |i|
+        from_native(C::Window::VideoMode.new(array_ptr + i * stride))
+      end
+    end
+
+    # Does the display actually support this mode at fullscreen?
+    # Always `true` for windowed-mode use (only fullscreen is constrained
+    # to the OS's allowed mode list).
+    def valid?
+      C::Window.sfVideoMode_isValid(to_native)
+    end
+
     def size = Vector2.new(@width, @height)
 
     def to_s = "#<SFML::VideoMode #{@width}x#{@height}@#{@bits_per_pixel}>"

data/lib/sfml.rb

@@ -71,6 +71,7 @@ require "sfml/system/clock"
 require "sfml/system/vector2"
 require "sfml/system/vector3"
 require "sfml/system/rect"
+require "sfml/system/input_stream"
 require "sfml/window/keyboard"
 require "sfml/window/mouse"
 require "sfml/window/joystick"
@@ -82,14 +83,18 @@ require "sfml/window/video_mode"
 require "sfml/window/event"
 require "sfml/window/context_settings"
 require "sfml/window/window"
+require "sfml/window/context"
 require "sfml/graphics/color"
 require "sfml/graphics/transformable"
+require "sfml/graphics/shape_inspectable"
+require "sfml/graphics/transformable_object"
 require "sfml/graphics/image"
 require "sfml/graphics/texture"
 require "sfml/graphics/sprite"
 require "sfml/graphics/circle_shape"
 require "sfml/graphics/rectangle_shape"
 require "sfml/graphics/convex_shape"
+require "sfml/graphics/shape"
 require "sfml/graphics/vertex"
 require "sfml/graphics/vertex_array"
 require "sfml/graphics/vertex_buffer"
@@ -114,6 +119,7 @@ require "sfml/audio/sound_recorder"
 require "sfml/audio/sound_buffer_recorder"
 require "sfml/audio/sound_stream"
 require "sfml/network/ip_address"
+require "sfml/network/packet"
 require "sfml/network/tcp_socket"
 require "sfml/network/tcp_listener"
 require "sfml/network/udp_socket"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-sfml
 version: !ruby/object:Gem::Version
-  version: 3.0.0.4
+  version: 3.0.0.5
 platform: ruby
 authors:
 - Mykhailo Melnyk
@@ -110,12 +110,15 @@ files:
 - lib/sfml/graphics/render_texture.rb
 - lib/sfml/graphics/render_window.rb
 - lib/sfml/graphics/shader.rb
+- lib/sfml/graphics/shape.rb
+- lib/sfml/graphics/shape_inspectable.rb
 - lib/sfml/graphics/sprite.rb
 - lib/sfml/graphics/stencil_mode.rb
 - lib/sfml/graphics/text.rb
 - lib/sfml/graphics/texture.rb
 - lib/sfml/graphics/transform.rb
 - lib/sfml/graphics/transformable.rb
+- lib/sfml/graphics/transformable_object.rb
 - lib/sfml/graphics/vertex.rb
 - lib/sfml/graphics/vertex_array.rb
 - lib/sfml/graphics/vertex_buffer.rb
@@ -124,18 +127,21 @@ files:
 - lib/sfml/network/ftp.rb
 - lib/sfml/network/http.rb
 - lib/sfml/network/ip_address.rb
+- lib/sfml/network/packet.rb
 - lib/sfml/network/socket_selector.rb
 - lib/sfml/network/tcp_listener.rb
 - lib/sfml/network/tcp_socket.rb
 - lib/sfml/network/udp_socket.rb
 - lib/sfml/scene.rb
 - lib/sfml/system/clock.rb
+- lib/sfml/system/input_stream.rb
 - lib/sfml/system/rect.rb
 - lib/sfml/system/time.rb
 - lib/sfml/system/vector2.rb
 - lib/sfml/system/vector3.rb
 - lib/sfml/version.rb
 - lib/sfml/window/clipboard.rb
+- lib/sfml/window/context.rb
 - lib/sfml/window/context_settings.rb
 - lib/sfml/window/cursor.rb
 - lib/sfml/window/event.rb