minigl 2.3.6 → 2.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db8b9de89a3372e81cfdef102808b9bbaec3fbd88a930c95cd5af2f946cb744d
-  data.tar.gz: d4fd66ee8e177e80fcbbe14808e4a8518a526fc6cec47d41adfc032da881750c
+  metadata.gz: 6623569ecf1fbd81357b4fe2e06b22024c2ce05829298750e1574e08a02b2706
+  data.tar.gz: ded142065a95df7c458d873a6c2049f4229f3fd40863872fdf19033f07331635
 SHA512:
-  metadata.gz: c966227f4b6a7d020c5e07c601fc18d8ea6603f07f6d661bc92127ae1335b02118e71ed997c2f25fd1c9089ae0e4730d61d0395a82ef0c2e495025b25fd019c3
-  data.tar.gz: e603e887d2c595c61e16bdeee8fd1b928414cf895caa7f98dd69b2aed0cf7bf2eb2dd0d115a460b07797d19ce3dccfeafc825151935012c62bc94671fdd90f2d
+  metadata.gz: 6cbb8a59c7b77104a1a8bba97d2ab740520cc6987eda4761e438b8b36fcd30b85eaacaa6caab32884118f52dadf3b763718017114db25b09b6f416dd7e1d5588
+  data.tar.gz: 6b3db4da549096602dc258f26101f665713422f510f5623cf7e53bdb1940226dd4a97740e44446a60554e6e1ea29abfb981355ac3caa2006e8111b32dc3aa9d2

data/README.md

@@ -14,6 +14,14 @@ It provides the following features:
 More functionalities are coming. Feel free to contribute! You can send feedback
 to victordavidsantos@gmail.com.
 
+## Made with MiniGL
+
+Below are two full games built with MiniGL, both available for free download and also open source.
+* [Super Bombinhas](https://victords.itch.io/super-bombinhas) ([source](https://github.com/victords/super-bombinhas))
+* [ConnecMan](https://victords.itch.io/connecman) ([source](https://github.com/victords/connecman))
+
+*Super Bombinhas* is also available on [Steam](https://store.steampowered.com/app/1553840).
+
 ## Installing
 
 MiniGL was built on top of the Gosu gem. This gem has its own dependencies for
@@ -29,9 +37,10 @@ After installing the Gosu dependencies, you can just `gem install minigl`.
   * The [wiki](https://github.com/victords/minigl/wiki) is a work in progress with tutorials and examples.
   * Test package and examples aren't complete!
 
-## Version 2.3.6
+## Version 2.3.7
 
-  * Added inverted ramps (for sloped ceilings, still has some issues).
+  * Exposed the `Panel#controls`, `TextField#focused` and `DropDownList#open` properties.
+  * Fixed a bug when clicking overlapping buttons: only the click action of the button with highest z-index (or last updated if z-indexes are the same) will be triggered. **WARNING**: the click callback will only be executed if `Mouse.update` is called after the click happened. If you call `Mouse.update` every frame (which is recommended), there's nothing to worry about.
 
 ## Contributing
 

data/lib/minigl/forms.rb

@@ -98,6 +98,9 @@ module MiniGL
     # Gets or sets whether the panel (and thus all components inside it) are visible.
     attr_accessor :visible
 
+    # The components contained in this panel.
+    attr_reader :controls
+
     # Creates a new Panel.
     # Parameters:
     # [x] The horizontal coordinate of the top-left corner of the panel, or the horizontal offset from the anchor, if provided.
@@ -348,8 +351,10 @@ module MiniGL
           @img_index = 0
           @state = :up
         elsif mouse_press
-          @img_index = 2
-          @state = :down
+          Mouse.add_click(@z_index || 0, lambda do
+            @img_index = 2
+            @state = :down
+          end)
         else
           @img_index = 1
         end
@@ -360,7 +365,7 @@ module MiniGL
         elsif mouse_rel
           @img_index = 1
           @state = :over
-          click
+          Mouse.add_click(@z_index || 0, method(:perform_action))
         else
           @img_index = 2
         end
@@ -379,7 +384,7 @@ module MiniGL
 
     # Executes the button click action.
     def click
-      @action.call @params if @action
+      perform_action
     end
 
     # Sets the position of the button in the screen.
@@ -404,6 +409,7 @@ module MiniGL
     #           will be drawn on top of the ones with smaller z-orders.
     # [color] Color to apply a filter to the image.
     def draw(alpha = 0xff, z_index = 0, color = 0xffffff)
+      @z_index = z_index
       return unless @visible
 
       color = (alpha << 24) | color
@@ -435,6 +441,12 @@ module MiniGL
       @state = :up
       @img_index = 3
     end
+
+    private
+
+    def perform_action
+      @action.call @params if @action
+    end
   end
 
   # This class represents a toggle button, which can be also interpreted as a
@@ -517,20 +529,12 @@ module MiniGL
       @img_index += 1 if @checked
     end
 
-    # Executes the button click action, and toggles its state. The +action+
-    # block always receives as a first parameter +true+, if the button has
-    # been changed to checked, or +false+, otherwise.
-    def click
-      @checked = !@checked
-      @action.call @checked, @params if @action
-    end
-
     # Sets the state of the button to the value given.
     #
     # Parameters:
     # [value] The state to be set (+true+ for checked, +false+ for unchecked).
     def checked=(value)
-      click if value != @checked
+      @action.call(value, @params) if @action && value != @checked
       @checked = value
     end
 
@@ -539,6 +543,13 @@ module MiniGL
       @state = :up
       @img_index = @checked ? 7 : 6
     end
+
+    private
+
+    def perform_action
+      @checked = !@checked
+      @action.call(@checked, @params) if @action
+    end
   end
 
   # This class represents a text field (input).
@@ -547,6 +558,9 @@ module MiniGL
     # INCOMPLETE!
     attr_reader :locale
 
+    # Whether the text field is focused (accepting input)
+    attr_reader :focused
+
     # Creates a new text field.
     #
     # Parameters:
@@ -566,9 +580,9 @@ module MiniGL
     # [margin_x] The x offset, from the field x-coordinate, to draw the text.
     # [margin_y] The y offset, from the field y-coordinate, to draw the text.
     # [max_length] The maximum length of the text inside the field.
-    # [active] Whether the text field must be focused by default. If +false+,
-    #          focus can be granted by clicking inside the text field or by
-    #          calling the +focus+ method.
+    # [focused] Whether the text field must be focused by default. If +false+,
+    #           focus can be granted by clicking inside the text field or by
+    #           calling the +focus+ method.
     # [text] The starting text. Must not be +nil+.
     # [allowed_chars] A string containing all characters that can be typed
     #                 inside the text field. The complete set of supported
@@ -606,7 +620,7 @@ module MiniGL
     # *Obs.:* This method accepts named parameters, but +x+, +y+, +font+ and
     # +img+ are mandatory.
     def initialize(x, y = nil, font = nil, img = nil, cursor_img = nil, disabled_img = nil, margin_x = 0, margin_y = 0,
-                   max_length = 100, active = false, text = '', allowed_chars = nil,
+                   max_length = 100, focused = false, text = '', allowed_chars = nil,
                    text_color = 0, disabled_text_color = 0, selection_color = 0, locale = 'en-us',
                    params = nil, retro = nil, scale_x = 1, scale_y = 1, anchor = nil, &on_text_changed)
       if x.is_a? Hash
@@ -618,7 +632,7 @@ module MiniGL
         margin_x = x.fetch(:margin_x, 0)
         margin_y = x.fetch(:margin_y, 0)
         max_length = x.fetch(:max_length, 100)
-        active = x.fetch(:active, false)
+        focused = x.fetch(:focused, false)
         text = x.fetch(:text, '')
         allowed_chars = x.fetch(:allowed_chars, nil)
         text_color = x.fetch(:text_color, 0)
@@ -647,7 +661,7 @@ module MiniGL
       @cursor_img = Res.img(cursor_img, false, false, '.png', retro) if cursor_img
       @disabled_img = Res.img(disabled_img, false, false, '.png', retro) if disabled_img
       @max_length = max_length
-      @active = active
+      @focused = focused
       @text_x = x + margin_x * @scale_x
       @text_y = y + margin_y * @scale_y
       @selection_color = selection_color
@@ -690,14 +704,14 @@ module MiniGL
 
       ################################ Mouse ################################
       if Mouse.over? @x, @y, @w, @h
-        if not @active and Mouse.button_pressed? :left
-          focus
+        if not @focused and Mouse.button_pressed? :left
+          Mouse.add_click(@z_index || 0, method(:focus))
         end
       elsif Mouse.button_pressed? :left
         unfocus
       end
 
-      return unless @active
+      return unless @focused
 
       if Mouse.double_click? :left
         if @nodes.size > 1
@@ -708,11 +722,7 @@ module MiniGL
         end
         set_cursor_visible
       elsif Mouse.button_pressed? :left
-        set_node_by_mouse
-        @anchor1 = @cur_node
-        @anchor2 = nil
-        @double_clicked = false
-        set_cursor_visible
+        Mouse.add_click(@z_index || 0, method(:focus))
       elsif Mouse.button_down? :left
         if @anchor1 and not @double_clicked
           set_node_by_mouse
@@ -902,7 +912,12 @@ module MiniGL
 
     # Grants focus to the text field, so that it allows keyboard input.
     def focus
-      @active = true
+      @focused = true
+      set_node_by_mouse
+      @anchor1 = @cur_node
+      @anchor2 = nil
+      @double_clicked = false
+      set_cursor_visible
     end
 
     # Removes focus from the text field, so that no keyboard input will be
@@ -911,7 +926,7 @@ module MiniGL
       @anchor1 = @anchor2 = nil
       @cursor_visible = false
       @cursor_timer = 0
-      @active = false
+      @focused = false
     end
 
     # Sets the position of the text field in the screen.
@@ -941,6 +956,7 @@ module MiniGL
     # [disabled_color] Color to apply a filter to the image when the field is
     #                  disabled.
     def draw(alpha = 0xff, z_index = 0, color = 0xffffff, disabled_color = 0x808080)
+      @z_index = z_index
       return unless @visible
 
       color = (alpha << 24) | ((@enabled or @disabled_img) ? color : disabled_color)
@@ -1250,6 +1266,9 @@ module MiniGL
     # The selected value in the drop-down list. This is one of the +options+.
     attr_reader :value
 
+    # Whether the list of options is currently visible.
+    attr_reader :open
+
     # An array containing all the options (each of them +String+s) that can be
     # selected in the drop-down list.
     attr_accessor :options

data/lib/minigl/global.rb

@@ -397,6 +397,11 @@ module MiniGL
         @down.clear
         @dbl_click.clear
 
+        if @click
+          @click[:action].call
+          @click = nil
+        end
+
         @dbl_click_timer.each do |k, v|
           if v < G.double_click_delay; @dbl_click_timer[k] += 1
           else; @dbl_click_timer.delete k; end
@@ -474,6 +479,13 @@ module MiniGL
         return @x >= x.x && @x < x.x + x.w && @y >= x.y && @y < x.y + x.h if x.is_a? Rectangle
         @x >= x && @x < x + w && @y >= y && @y < y + h
       end
+
+      # :nodoc:
+      def add_click(z_index, action)
+        return if @click && @click[:z_index] > z_index
+
+        @click = { z_index: z_index, action: action }
+      end
     end
   end
 

data/test/game.rb

@@ -32,11 +32,12 @@ class MyGame < GameWindow
     @ddl = DropDownList.new(0, 10, @font1, nil, nil, ['olá amigos', 'opção 2', 'terceira'], 0, 3, 150, 25, 0, 0x808080, 0xffffff, 0xffff00, nil, 2, 2.5, :north) { |a, b|
       puts "mudou de #{a} para #{b}"
     }
+    @btn2 = Button.new(x: 0, y: 80, font: @font1, text: 'Below', img: :btn, anchor: :north) { puts 'Below the dropdown' }
 
     @panel = Panel.new(10, 10, 720, 520, [
-      Button.new(x: 5, y: 5, font: @font1, text: 'Teste', img: :btn),
+      TextField.new(x: 5, y: 5, font: @font1, text: 'Opa', img: :text, margin_x: 5, margin_y: 5, anchor: :top_left),
+      Button.new(x: 5, y: 5, font: @font1, text: 'Teste', img: :btn) { puts 'top left' },
       @lbl = Label.new(0, 70, @font1, 'Teste de label', 0, 0x666666, 1, 1, :north),
-      TextField.new(x: 5, y: 40, font: @font1, text: 'Opa', img: :text, margin_x: 5, margin_y: 5, anchor: :top_left),
       Button.new(x: 0, y: 5, font: @font1, text: 'Teste', img: :btn, anchor: :top),
       DropDownList.new(x: 0, y: 40, width: 150, height: 25, font: @font1, options: ['olá amigos', 'opção 2', 'terceira'], anchor: :north),
       Button.new(x: 5, y: 5, font: @font1, text: 'Teste', img: :btn, anchor: :northeast),
@@ -44,7 +45,7 @@ class MyGame < GameWindow
       Button.new(x: 0, y: 0, font: @font1, text: 'Teste', img: :btn, anchor: :center),
       Button.new(x: 5, y: 0, font: @font1, text: 'Teste', img: :btn, anchor: :right),
       ToggleButton.new(x: 5, y: 40, img: :check, center_x: false, margin_x: 36, anchor: :east),
-      Button.new(x: 5, y: 5, font: @font1, text: 'Teste', img: :btn, anchor: :southwest),
+      Button.new(x: 5, y: 5, font: @font1, text: 'Teste', img: :btn, anchor: :southwest) { @lbl.visible = !@lbl.visible },
       Button.new(x: 0, y: 5, font: @font1, text: 'Teste', img: :btn, anchor: :south),
       ProgressBar.new(0, 40, 200, 20, :barbg, :barfg, 3456, 70, 2, 2, @font1, 0xff000080, nil, nil, 1, 1, :bottom)
     ], :text, :tiled, true, 2, 2, :bottom_right)
@@ -80,7 +81,11 @@ class MyGame < GameWindow
     @panel.enabled = !@panel.enabled if KB.key_pressed? Gosu::KbN
     @panel.visible = !@panel.visible if KB.key_pressed? Gosu::KbM
 
-    @panel.add_component(Button.new(x: 5, y: 5, font: @font1, text: 'Teste', img: :btn, anchor: :southeast)) if KB.key_pressed?(Gosu::KbB)
+    if KB.key_pressed?(Gosu::KbB)
+      @panel.add_component(Button.new(x: 5, y: 5, font: @font1, text: 'Teste', img: :btn, anchor: :southeast) {
+        puts 'new button added'
+      })
+    end
     @lbl.text = 'Test of changed text' if KB.key_pressed?(Gosu::KB_C)
     @lbl2.text = 'Shorter text' if KB.key_pressed?(Gosu::KB_X)
 
@@ -112,6 +117,7 @@ class MyGame < GameWindow
     @chk.update
     @txt.update
     @ddl.update
+    @btn2.update
 
     @panel.update
 
@@ -145,6 +151,7 @@ class MyGame < GameWindow
                             780, 450, 300, :right, 0xff0000, 255, 1
 
     @ddl.draw 0x80, 1, 0xff8080
+    @btn2.draw
     @btn.draw 0xcc, 1, 0x33ff33
     @chk.draw
     @txt.draw

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: minigl
 version: !ruby/object:Gem::Version
-  version: 2.3.6
+  version: 2.3.7
 platform: ruby
 authors:
 - Victor David Santos
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-02 00:00:00.000000000 Z
+date: 2021-12-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gosu