raylib-bindings 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8ab6c66464a50d2218f198f0d891d726036a78c86c5ab368296bf0b5c677eac3
-  data.tar.gz: af743c8496a19ea555e1c8b0238ab9de92590208582dcd535f70a5fe96440312
+  metadata.gz: e935d742cc8c2d199ae7db8272cd334f6c832f4a46f059752c1a9de01fa54203
+  data.tar.gz: 18eb540a946b82e593a487812c03329a2789bfe0a58982b2de81bd059103bc17
 SHA512:
-  metadata.gz: 374d95b0a608850b17b6d21b25bbd43f2cafb12f2be8fa53b0ffdb21419412e13d2e5f29f676120ee06ac93bb215ca0e8672453da654ae4a2eab903e4df637ce
-  data.tar.gz: d98f6c812fe58502d00bf03247aaca99d598bcce807b85a41cc34756b70b4cd559e18e754d278204689ace1dc35a220c8053df5e5c1cc5a9dc3df098cfccde58
+  metadata.gz: d33bbe65b446c6dd1567a6bb241627852cd38ffc1b442c0010e54c5a27cf90d1529faf7aa33ad69ba31ce2be704cb93c9d180862ed1d7d5d4a873661c8b01af1
+  data.tar.gz: 2673214f8c6a27f89465bfa33397ebb31d7efdc69a879bae16a4202970dc4a6bf1deda178253c67a6bcfff2affff049670184097bd9b49c1974da21d6704e36e

data/ChangeLog

@@ -1,3 +1,16 @@
+2024-02-03  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* Updated with latest raylib ( https://github.com/raysan5/raylib/commit/29ff658d9223068378269e4a705811f085fafdf4 ) and raygui ( https://github.com/raysan5/raygui/commit/58411f4cceb8ae82933f2001461db9940278fdeb )
+
+2024-01-27  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* examples/snake_case_rlgl : Added
+
+2024-01-20  vaiorabbit  <http://twitter.com/vaiorabbit>
+
+	* Raylib.load_lib : Added 'method_naming' option to import APIs in snake case convention
+	* examples/snake_case_api.rb : Added
+
 2024-01-07  vaiorabbit  <http://twitter.com/vaiorabbit>
 
 	* Updated README

data/README.md

@@ -3,7 +3,7 @@
 # Yet another raylib wrapper for Ruby #
 
 *   Created : 2021-10-17
-*   Last modified : 2024-01-07
+*   Last modified : 2024-02-03
 
 Provides Ruby bindings for raylib-related libraries including:
 
@@ -133,6 +133,8 @@ D:\> ruby template.rb
 
 ## Projects ##
 
+### Games ###
+
 See the projects below to learn how to use this library:
 
 *   Whac-a-Mole! : Ruby raylib bindings demo
@@ -147,6 +149,12 @@ See the projects below to learn how to use this library:
     *   <img src="https://raw.githubusercontent.com/vaiorabbit/raylib-bindings-flapper/main/doc/screenshot_01.png" width="150">
     *   <https://github.com/vaiorabbit/raylib-bindings-flapper>
 
+### Libraries ###
+
+*   raylib-bindings-tileson : Provides Ruby bindings for raylib-tileson ( https://github.com/RobLoach/raylib-tileson )
+    *   <img src="https://raw.githubusercontent.com/vaiorabbit/raylib-bindings-tileson/main/doc/screenshot_00.png" width="600">
+    *   <https://github.com/vaiorabbit/raylib-bindings-tileson>
+
 ## Limitation ##
 
 *   `SetTraceLogCallback` and `TraceLogCallback` are unusable since Ruby-FFI does not support `:varargs` parameter in callbacks (`Proc`, etc.)

data/lib/physac.rb

@@ -186,7 +186,7 @@ module Raylib
 
   # Function
 
-  def self.setup_physac_symbols
+  def self.setup_physac_symbols(method_naming: :original)
     entries = [
 
       # @!method InitPhysics()
@@ -314,7 +314,16 @@ module Raylib
       [:GetPhysicsShapeVertex, :GetPhysicsShapeVertex, [:pointer, :int], Vector2.by_value],
     ]
     entries.each do |entry|
-      attach_function entry[0], entry[1], entry[2], entry[3]
+      api_name = if method_naming == :snake_case
+                   snake_case_name = entry[0].to_s.gsub(/([A-Z]+)([A-Z0-9][a-z])/, '\1_\2').gsub(/([a-z\d])([A-Z0-9])/, '\1_\2').downcase
+                   snake_case_name.gsub!('vector_3', 'vector3_') if snake_case_name.include?('vector_3')
+                   snake_case_name.gsub!('vector_2', 'vector2_') if snake_case_name.include?('vector_2')
+                   snake_case_name.chop! if snake_case_name.end_with?('_')
+                   snake_case_name.to_sym
+                 else
+                   entry[0]
+                 end
+      attach_function api_name, entry[1], entry[2], entry[3]
     rescue FFI::NotFoundError => e
       warn "[Warning] Failed to import #{entry[0]} (#{e})."
     end

data/lib/raygui_main.rb

@@ -454,7 +454,7 @@ module Raylib
 
   # Function
 
-  def self.setup_raygui_symbols
+  def self.setup_raygui_symbols(method_naming: :original)
     entries = [
 
       # @!method GuiEnable()
@@ -635,7 +635,7 @@ module Raylib
       [:GuiScrollPanel, :GuiScrollPanel, [Rectangle.by_value, :pointer, Rectangle.by_value, :pointer, :pointer], :int],
 
       # @!method GuiLabel(bounds, text)
-      #   GuiLabel : Label control, shows text
+      #   GuiLabel : Label control
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @return [int]
@@ -649,14 +649,14 @@ module Raylib
       [:GuiButton, :GuiButton, [Rectangle.by_value, :pointer], :int],
 
       # @!method GuiLabelButton(bounds, text)
-      #   GuiLabelButton : Label button control, show true when clicked
+      #   GuiLabelButton : Label button control, returns true when clicked
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @return [int]
       [:GuiLabelButton, :GuiLabelButton, [Rectangle.by_value, :pointer], :int],
 
       # @!method GuiToggle(bounds, text, active)
-      #   GuiToggle : Toggle Button control, returns true when active
+      #   GuiToggle : Toggle Button control
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @param active [bool *]
@@ -664,7 +664,7 @@ module Raylib
       [:GuiToggle, :GuiToggle, [Rectangle.by_value, :pointer, :pointer], :int],
 
       # @!method GuiToggleGroup(bounds, text, active)
-      #   GuiToggleGroup : Toggle Group control, returns active toggle index
+      #   GuiToggleGroup : Toggle Group control
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @param active [int *]
@@ -672,7 +672,7 @@ module Raylib
       [:GuiToggleGroup, :GuiToggleGroup, [Rectangle.by_value, :pointer, :pointer], :int],
 
       # @!method GuiToggleSlider(bounds, text, active)
-      #   GuiToggleSlider : Toggle Slider control, returns true when clicked
+      #   GuiToggleSlider : Toggle Slider control
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @param active [int *]
@@ -688,7 +688,7 @@ module Raylib
       [:GuiCheckBox, :GuiCheckBox, [Rectangle.by_value, :pointer, :pointer], :int],
 
       # @!method GuiComboBox(bounds, text, active)
-      #   GuiComboBox : Combo Box control, returns selected item index
+      #   GuiComboBox : Combo Box control
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @param active [int *]
@@ -696,7 +696,7 @@ module Raylib
       [:GuiComboBox, :GuiComboBox, [Rectangle.by_value, :pointer, :pointer], :int],
 
       # @!method GuiDropdownBox(bounds, text, active, editMode)
-      #   GuiDropdownBox : Dropdown Box control, returns selected item
+      #   GuiDropdownBox : Dropdown Box control
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @param active [int *]
@@ -705,7 +705,7 @@ module Raylib
       [:GuiDropdownBox, :GuiDropdownBox, [Rectangle.by_value, :pointer, :pointer, :bool], :int],
 
       # @!method GuiSpinner(bounds, text, value, minValue, maxValue, editMode)
-      #   GuiSpinner : Spinner control, returns selected value
+      #   GuiSpinner : Spinner control
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @param value [int *]
@@ -736,7 +736,7 @@ module Raylib
       [:GuiTextBox, :GuiTextBox, [Rectangle.by_value, :pointer, :int, :bool], :int],
 
       # @!method GuiSlider(bounds, textLeft, textRight, value, minValue, maxValue)
-      #   GuiSlider : Slider control, returns selected value
+      #   GuiSlider : Slider control
       #   @param bounds [Rectangle]
       #   @param textLeft [const char *]
       #   @param textRight [const char *]
@@ -747,7 +747,7 @@ module Raylib
       [:GuiSlider, :GuiSlider, [Rectangle.by_value, :pointer, :pointer, :pointer, :float, :float], :int],
 
       # @!method GuiSliderBar(bounds, textLeft, textRight, value, minValue, maxValue)
-      #   GuiSliderBar : Slider Bar control, returns selected value
+      #   GuiSliderBar : Slider Bar control
       #   @param bounds [Rectangle]
       #   @param textLeft [const char *]
       #   @param textRight [const char *]
@@ -758,7 +758,7 @@ module Raylib
       [:GuiSliderBar, :GuiSliderBar, [Rectangle.by_value, :pointer, :pointer, :pointer, :float, :float], :int],
 
       # @!method GuiProgressBar(bounds, textLeft, textRight, value, minValue, maxValue)
-      #   GuiProgressBar : Progress Bar control, shows current progress value
+      #   GuiProgressBar : Progress Bar control
       #   @param bounds [Rectangle]
       #   @param textLeft [const char *]
       #   @param textRight [const char *]
@@ -783,7 +783,7 @@ module Raylib
       [:GuiDummyRec, :GuiDummyRec, [Rectangle.by_value, :pointer], :int],
 
       # @!method GuiGrid(bounds, text, spacing, subdivs, mouseCell)
-      #   GuiGrid : Grid control, returns mouse cell position
+      #   GuiGrid : Grid control
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @param spacing [float]
@@ -793,7 +793,7 @@ module Raylib
       [:GuiGrid, :GuiGrid, [Rectangle.by_value, :pointer, :float, :int, :pointer], :int],
 
       # @!method GuiListView(bounds, text, scrollIndex, active)
-      #   GuiListView : List View control, returns selected list item index
+      #   GuiListView : List View control
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @param scrollIndex [int *]
@@ -874,7 +874,7 @@ module Raylib
       [:GuiColorPickerHSV, :GuiColorPickerHSV, [Rectangle.by_value, :pointer, :pointer], :int],
 
       # @!method GuiColorPanelHSV(bounds, text, colorHsv)
-      #   GuiColorPanelHSV : Color Panel control that returns HSV color value, used by GuiColorPickerHSV()
+      #   GuiColorPanelHSV : Color Panel control that updates Hue-Saturation-Value color value, used by GuiColorPickerHSV()
       #   @param bounds [Rectangle]
       #   @param text [const char *]
       #   @param colorHsv [Vector3 *]
@@ -882,7 +882,16 @@ module Raylib
       [:GuiColorPanelHSV, :GuiColorPanelHSV, [Rectangle.by_value, :pointer, :pointer], :int],
     ]
     entries.each do |entry|
-      attach_function entry[0], entry[1], entry[2], entry[3]
+      api_name = if method_naming == :snake_case
+                   snake_case_name = entry[0].to_s.gsub(/([A-Z]+)([A-Z0-9][a-z])/, '\1_\2').gsub(/([a-z\d])([A-Z0-9])/, '\1_\2').downcase
+                   snake_case_name.gsub!('vector_3', 'vector3_') if snake_case_name.include?('vector_3')
+                   snake_case_name.gsub!('vector_2', 'vector2_') if snake_case_name.include?('vector_2')
+                   snake_case_name.chop! if snake_case_name.end_with?('_')
+                   snake_case_name.to_sym
+                 else
+                   entry[0]
+                 end
+      attach_function api_name, entry[1], entry[2], entry[3]
     rescue FFI::NotFoundError => e
       warn "[Warning] Failed to import #{entry[0]} (#{e})."
     end

data/lib/raylib.rb

@@ -17,24 +17,24 @@ require_relative 'raygui_helper'
 module Raylib
   extend FFI::Library
 
-  def self.load_lib(libpath, raygui_libpath: nil, physac_libpath: nil)
+  def self.load_lib(libpath, raygui_libpath: nil, physac_libpath: nil, method_naming: :original)
     lib_paths = [libpath, raygui_libpath, physac_libpath].compact
 
     ffi_lib_flags :now, :global
     ffi_lib(*lib_paths)
-    setup_symbols
+    setup_symbols(method_naming: method_naming)
 
-    setup_raygui_symbols unless raygui_libpath.nil?
-    setup_physac_symbols unless physac_libpath.nil?
+    setup_raygui_symbols(method_naming: method_naming) unless raygui_libpath.nil?
+    setup_physac_symbols(method_naming: method_naming) unless physac_libpath.nil?
   rescue LoadError => e
     warn e
   end
 
-  def self.setup_symbols
-    setup_raylib_symbols
-    setup_raymath_symbols
-    setup_rcamera_symbols
-    setup_rlgl_symbols
+  def self.setup_symbols(method_naming: :original)
+    setup_raylib_symbols(method_naming: method_naming)
+    setup_raymath_symbols(method_naming: method_naming)
+    setup_rcamera_symbols(method_naming: method_naming)
+    setup_rlgl_symbols(method_naming: method_naming)
   end
 
   #

data/lib/raylib_helper.rb

@@ -61,6 +61,9 @@ module Raylib
   # Math helper
   #
 
+  DEG2RAD = Math::PI / 180.0
+  RAD2DEG = 180.0 / Math::PI
+
   class Vector2
     def self.create(x = 0, y = 0)
       Vector2.new.set(x, y)

data/lib/raylib_main.rb

@@ -157,7 +157,7 @@ module Raylib
   KEY_KP_ENTER = 335      # Key: Keypad Enter
   KEY_KP_EQUAL = 336      # Key: Keypad =
   KEY_BACK = 4            # Key: Android back button
-  KEY_MENU = 82           # Key: Android menu button
+  KEY_MENU = 5            # Key: Android menu button
   KEY_VOLUME_UP = 24      # Key: Android volume up button
   KEY_VOLUME_DOWN = 25    # Key: Android volume down button
 
@@ -1123,7 +1123,7 @@ module Raylib
 
   # Function
 
-  def self.setup_raylib_symbols
+  def self.setup_raylib_symbols(method_naming: :original)
     entries = [
 
       # @!method InitWindow(width, height, title)
@@ -5117,7 +5117,16 @@ module Raylib
       [:DetachAudioMixedProcessor, :DetachAudioMixedProcessor, [:AudioCallback], :void],
     ]
     entries.each do |entry|
-      attach_function entry[0], entry[1], entry[2], entry[3]
+      api_name = if method_naming == :snake_case
+                   snake_case_name = entry[0].to_s.gsub(/([A-Z]+)([A-Z0-9][a-z])/, '\1_\2').gsub(/([a-z\d])([A-Z0-9])/, '\1_\2').downcase
+                   snake_case_name.gsub!('vector_3', 'vector3_') if snake_case_name.include?('vector_3')
+                   snake_case_name.gsub!('vector_2', 'vector2_') if snake_case_name.include?('vector_2')
+                   snake_case_name.chop! if snake_case_name.end_with?('_')
+                   snake_case_name.to_sym
+                 else
+                   entry[0]
+                 end
+      attach_function api_name, entry[1], entry[2], entry[3]
     rescue FFI::NotFoundError => e
       warn "[Warning] Failed to import #{entry[0]} (#{e})."
     end

data/lib/raymath.rb

@@ -38,7 +38,7 @@ module Raylib
 
   # Function
 
-  def self.setup_raymath_symbols
+  def self.setup_raymath_symbols(method_naming: :original)
     entries = [
 
       # @!method Clamp(value, min, max)
@@ -837,7 +837,16 @@ module Raylib
       [:QuaternionEquals, :QuaternionEquals, [Quaternion.by_value, Quaternion.by_value], :int],
     ]
     entries.each do |entry|
-      attach_function entry[0], entry[1], entry[2], entry[3]
+      api_name = if method_naming == :snake_case
+                   snake_case_name = entry[0].to_s.gsub(/([A-Z]+)([A-Z0-9][a-z])/, '\1_\2').gsub(/([a-z\d])([A-Z0-9])/, '\1_\2').downcase
+                   snake_case_name.gsub!('vector_3', 'vector3_') if snake_case_name.include?('vector_3')
+                   snake_case_name.gsub!('vector_2', 'vector2_') if snake_case_name.include?('vector_2')
+                   snake_case_name.chop! if snake_case_name.end_with?('_')
+                   snake_case_name.to_sym
+                 else
+                   entry[0]
+                 end
+      attach_function api_name, entry[1], entry[2], entry[3]
     rescue FFI::NotFoundError => e
       warn "[Warning] Failed to import #{entry[0]} (#{e})."
     end

data/lib/rcamera.rb

@@ -19,7 +19,7 @@ module Raylib
 
   # Function
 
-  def self.setup_rcamera_symbols
+  def self.setup_rcamera_symbols(method_naming: :original)
     entries = [
 
       # @!method GetCameraForward(camera)
@@ -109,7 +109,16 @@ module Raylib
       [:GetCameraProjectionMatrix, :GetCameraProjectionMatrix, [:pointer, :float], Matrix.by_value],
     ]
     entries.each do |entry|
-      attach_function entry[0], entry[1], entry[2], entry[3]
+      api_name = if method_naming == :snake_case
+                   snake_case_name = entry[0].to_s.gsub(/([A-Z]+)([A-Z0-9][a-z])/, '\1_\2').gsub(/([a-z\d])([A-Z0-9])/, '\1_\2').downcase
+                   snake_case_name.gsub!('vector_3', 'vector3_') if snake_case_name.include?('vector_3')
+                   snake_case_name.gsub!('vector_2', 'vector2_') if snake_case_name.include?('vector_2')
+                   snake_case_name.chop! if snake_case_name.end_with?('_')
+                   snake_case_name.to_sym
+                 else
+                   entry[0]
+                 end
+      attach_function api_name, entry[1], entry[2], entry[3]
     rescue FFI::NotFoundError => e
       warn "[Warning] Failed to import #{entry[0]} (#{e})."
     end

data/lib/rlgl.rb

@@ -77,6 +77,8 @@ module Raylib
   RL_BLEND_DST_ALPHA = 0x80CA                   # GL_BLEND_DST_ALPHA
   RL_BLEND_SRC_ALPHA = 0x80CB                   # GL_BLEND_SRC_ALPHA
   RL_BLEND_COLOR = 0x8005                       # GL_BLEND_COLOR
+  RL_READ_FRAMEBUFFER = 0x8CA8                  # GL_READ_FRAMEBUFFER
+  RL_DRAW_FRAMEBUFFER = 0x8CA9                  # GL_DRAW_FRAMEBUFFER
 
   # Enum
 
@@ -313,7 +315,7 @@ module Raylib
 
   # Function
 
-  def self.setup_rlgl_symbols
+  def self.setup_rlgl_symbols(method_naming: :original)
     entries = [
 
       # @!method rlMatrixMode(mode)
@@ -584,6 +586,11 @@ module Raylib
       #   @return [void]
       [:rlDisableFramebuffer, :rlDisableFramebuffer, [], :void],
 
+      # @!method rlGetActiveFramebuffer()
+      #   rlGetActiveFramebuffer : Get the currently active render texture (fbo), 0 for default framebuffer
+      #   @return [unsigned int]
+      [:rlGetActiveFramebuffer, :rlGetActiveFramebuffer, [], :uint],
+
       # @!method rlActiveDrawBuffers(count)
       #   rlActiveDrawBuffers : Activate multiple draw color buffers
       #   @param count [int]
@@ -1319,7 +1326,16 @@ module Raylib
       [:rlLoadDrawQuad, :rlLoadDrawQuad, [], :void],
     ]
     entries.each do |entry|
-      attach_function entry[0], entry[1], entry[2], entry[3]
+      api_name = if method_naming == :snake_case
+                   snake_case_name = entry[0].to_s.gsub(/([A-Z]+)([A-Z0-9][a-z])/, '\1_\2').gsub(/([a-z\d])([A-Z0-9])/, '\1_\2').downcase
+                   snake_case_name.gsub!('vector_3', 'vector3_') if snake_case_name.include?('vector_3')
+                   snake_case_name.gsub!('vector_2', 'vector2_') if snake_case_name.include?('vector_2')
+                   snake_case_name.chop! if snake_case_name.end_with?('_')
+                   snake_case_name.to_sym
+                 else
+                   entry[0]
+                 end
+      attach_function api_name, entry[1], entry[2], entry[3]
     rescue FFI::NotFoundError => e
       warn "[Warning] Failed to import #{entry[0]} (#{e})."
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: raylib-bindings
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - vaiorabbit
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-07 00:00:00.000000000 Z
+date: 2024-02-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -83,7 +83,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.5
 signing_key:
 specification_version: 4
 summary: Ruby bindings for raylib, raygui and Physac