glimmer-dsl-libui 0.4.5 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcc9fbfe0fec2f6678f0515a8471c71fef28e7e8ae7a253bf1d8906aa7b69c11
-  data.tar.gz: 836911f22535571d796e759d20256e380e6dc3692cfd08ca13a62e053fea14ce
+  metadata.gz: e2f52b21e108a75ec59b380fa0d84cd116bb47423877575486ee5bc2647d7953
+  data.tar.gz: 2d7d9ab30e81bd1eb846dca3bddeb79509dab1e641c38b44d5d31914679ab49c
 SHA512:
-  metadata.gz: 5378fe7b1ee1c147705b5a97ff8414cdefcc22fb7720a388b9a8de6694ec128a4bbd2d4ba535b4c6bba5e7373f98ab32264f96bfd448deb7a00b6c07aefe4c42
-  data.tar.gz: cf83d73acf39d2be2bc16544b12466eefd38e76d37b595e9ff623c487a3296c27b1880560da7b067ea1c85b4fd28d1fd22dc9ea6a9ea1b5bc354536ccd38de0c
+  metadata.gz: d90045f52bd836fc18ff4aff2bc096302101651bc006a144af9f80563e171ecd4d236e85ebbb064b53374a61946185fa9aef0946b493b0ca1df967670629ac5e
+  data.tar.gz: 491694ae1ccdbbb5b4c7e0e3bfa30beee648f9a579dfaaa13b35ee583a6551967c441078fa83857c0e886a2991662d83d952f79b73a39e27769262c0c77b822e

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change Log
 
+## 0.4.6
+
+- Support `slider` `value` bidirectional data-binding (with `<=>` sign)
+- Support `color_button` `color` bidirectional data-binding (with `<=>` sign)
+- Support `font_button` `font` write-only unidirectional data-binding (with `<=>` sign)
+- Improve examples/color_button.rb with bidirectional data-binding for `color_button` `color`
+- Improve examples/histogram.rb with bidirectional data-binding for `color_button` `color`
+- Improve examples/font_button.rb with bidirectional data-binding for `font_button` `font`
+
 ## 0.4.5
 
 - Support `spinbox` `value` bidirectional data-binding (with `<=>` sign)

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.4.5
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.4.6
 ## Prerequisite-Free Ruby Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-libui.svg)](http://badge.fury.io/rb/glimmer-dsl-libui)
 [![Join the chat at https://gitter.im/AndyObtiva/glimmer](https://badges.gitter.im/AndyObtiva/glimmer.svg)](https://gitter.im/AndyObtiva/glimmer?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
@@ -373,7 +373,7 @@ gem install glimmer-dsl-libui
 Or install via Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-dsl-libui', '~> 0.4.5'
+gem 'glimmer-dsl-libui', '~> 0.4.6'
 ```
 
 Add `require 'glimmer-dsl-libui'` at the top, and then `include Glimmer` into the top-level main object for testing or into an actual class for serious usage.
@@ -1382,11 +1382,14 @@ Data-binding supports utilizing the [MVP (Model View Presenter)](https://en.wiki
 ![MVP](https://www.researchgate.net/profile/Gilles-Perrouin/publication/320249584/figure/fig8/AS:668260987068418@1536337243385/Model-view-presenter-architecture.png)
 
 [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) supports bidirectional (two-way) data-binding of the following controls/properties via the `<=>` operator (indicating data is moving in both directions between View and Model):
-- `entry` `text` property
-- `multiline_entry` `text` property
-- `non_wrapping_multiline_entry` `text` property
-- `search_entry` `text` property
-- `spinbox` `value` property
+- `color_button`: `color`
+- `entry`: `text`
+- `font_button`: `font`
+- `multiline_entry`: `text`
+- `non_wrapping_multiline_entry`: `text`
+- `search_entry`: `text`
+- `slider`: `value`
+- `spinbox`: `value`
 
 Example of bidirectional data-binding:
 
@@ -1875,7 +1878,7 @@ Example:
 
 ## Examples
 
-The following examples include reimplementions of the examples in the [LibUI](https://github.com/kojix2/LibUI) project utilizing the [Glimmer GUI DSL](#glimmer-gui-dsl-concepts) as well as brand new examples.
+The following examples include reimplementions of the examples in the [LibUI](https://github.com/kojix2/LibUI) project utilizing the [Glimmer GUI DSL](#glimmer-gui-dsl-concepts) (with and without data-binding) as well as brand new examples.
 
 To browse all examples, simply launch the [Meta-Example](examples/meta_example.rb), which lists all examples and displays each example's code when selected. It also enables code editing to facilitate experimentation and learning.
 
@@ -2490,7 +2493,33 @@ UI.quit
 
 ```
 
-[Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+[Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version (with [data-binding](#data-binding)):
+
+```ruby
+require 'glimmer-dsl-libui'
+
+class FontButton
+  include Glimmer
+  
+  attr_accessor :font_descriptor
+  
+  def launch
+    window('hello world', 300, 200) {
+      font_button {
+        font <=> [self, :font_descriptor, after_write: -> { p font_descriptor }]
+      }
+      
+      on_closing do
+        puts 'Bye Bye'
+      end
+    }.show
+  end
+end
+
+FontButton.new.launch
+```
+
+[Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version 2 (without [data-binding](#data-binding)):
 
 ```ruby
 require 'glimmer-dsl-libui'
@@ -2531,7 +2560,33 @@ Mac | Windows | Linux
 ----|---------|------
 ![glimmer-dsl-libui-mac-color-button.png](images/glimmer-dsl-libui-mac-color-button.png) ![glimmer-dsl-libui-mac-color-button-selection.png](images/glimmer-dsl-libui-mac-color-button-selection.png) | ![glimmer-dsl-libui-windows-color-button.png](images/glimmer-dsl-libui-windows-color-button.png) ![glimmer-dsl-libui-windows-color-button-selection.png](images/glimmer-dsl-libui-windows-color-button-selection.png) | ![glimmer-dsl-libui-linux-color-button.png](images/glimmer-dsl-libui-linux-color-button.png) ![glimmer-dsl-libui-linux-color-button-selection.png](images/glimmer-dsl-libui-linux-color-button-selection.png)
 
-New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version (with [data-binding](#data-binding)):
+
+```ruby
+require 'glimmer-dsl-libui'
+
+class ColorButton
+  include Glimmer
+  
+  attr_accessor :selected_color
+  
+  def initialize
+    @selected_color = :blue
+  end
+  
+  def launch
+    window('color button', 240) {
+      color_button {
+        color <=> [self, :selected_color, after_write: ->(color) {p color}]
+      }
+    }.show
+  end
+end
+
+ColorButton.new.launch
+```
+
+New [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version 2 (without [data-binding](#data-binding)):
 
 ```ruby
 require 'glimmer-dsl-libui'
@@ -6975,12 +7030,7 @@ class Histogram
           
           color_button { |cb|
             stretchy false
-            color COLOR_BLUE
-            
-            on_changed do
-              @histogram_color = cb.color
-              @area.queue_redraw_all
-            end
+            color <=> [self, :histogram_color, after_write: -> { @area.queue_redraw_all }]
           }
         }
         

data/VERSION

@@ -1 +1 @@
-0.4.5
+0.4.6

data/examples/color_button.rb

@@ -1,16 +1,21 @@
-# frozen_string_literal: true
-
 require 'glimmer-dsl-libui'
 
-include Glimmer
+class ColorButton
+  include Glimmer
+  
+  attr_accessor :selected_color
+  
+  def initialize
+    @selected_color = :blue
+  end
+  
+  def launch
+    window('color button', 240) {
+      color_button {
+        color <=> [self, :selected_color, after_write: ->(color) {p color}]
+      }
+    }.show
+  end
+end
 
-window('color button', 240) {
-  color_button { |cb|
-    color :blue
-    
-    on_changed do
-      rgba = cb.color
-      p rgba
-    end
-  }
-}.show
+ColorButton.new.launch

data/examples/color_button2.rb

@@ -0,0 +1,14 @@
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('color button', 240) {
+  color_button { |cb|
+    color :blue
+    
+    on_changed do
+      rgba = cb.color
+      p rgba
+    end
+  }
+}.show

data/examples/font_button.rb

@@ -2,17 +2,22 @@
 
 require 'glimmer-dsl-libui'
 
-include Glimmer
-
-window('hello world', 300, 200) {
-  font_button { |fb|
-    on_changed do
-      font_descriptor = fb.font
-      p font_descriptor
-    end
-  }
+class FontButton
+  include Glimmer
+  
+  attr_accessor :font_descriptor
   
-  on_closing do
-    puts 'Bye Bye'
+  def launch
+    window('hello world', 300, 200) {
+      font_button {
+        font <=> [self, :font_descriptor, after_write: -> { p font_descriptor }]
+      }
+      
+      on_closing do
+        puts 'Bye Bye'
+      end
+    }.show
   end
-}.show
+end
+
+FontButton.new.launch

data/examples/font_button2.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('hello world', 300, 200) {
+  font_button { |fb|
+    on_changed do
+      font_descriptor = fb.font
+      p font_descriptor
+    end
+  }
+  
+  on_closing do
+    puts 'Bye Bye'
+  end
+}.show

data/examples/histogram.rb

@@ -71,12 +71,7 @@ class Histogram
           
           color_button { |cb|
             stretchy false
-            color COLOR_BLUE
-            
-            on_changed do
-              @histogram_color = cb.color
-              @area.queue_redraw_all
-            end
+            color <=> [self, :histogram_color, after_write: -> { @area.queue_redraw_all }]
           }
         }
         

data/lib/glimmer/libui/control_proxy/color_button_proxy.rb

@@ -113,6 +113,11 @@ module Glimmer
           Fiddle.free @alpha unless @alpha.nil?
           super
         end
+        
+        def data_bind(property, model_binding)
+          super
+          handle_listener('on_changed') { model_binding.call(color) } if property == 'color'
+        end
       end
     end
   end

data/lib/glimmer/libui/control_proxy/font_button_proxy.rb

@@ -64,6 +64,10 @@ module Glimmer
           ::LibUI.free_font_button_font(@font_descriptor) unless @font_descriptor.nil?
           super
         end
+        
+        def data_bind(property, model_binding)
+          handle_listener('on_changed') { model_binding.call(font) } if property == 'font'
+        end
       end
     end
   end

data/lib/glimmer/libui/control_proxy/slider_proxy.rb

@@ -0,0 +1,38 @@
+# Copyright (c) 2021 Andy Maleh
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+require 'glimmer/libui/control_proxy'
+
+module Glimmer
+  module LibUI
+    class ControlProxy
+      # Proxy for LibUI slider objects
+      #
+      # Follows the Proxy Design Pattern
+      class SliderProxy < ControlProxy
+        def data_bind(property, model_binding)
+          super
+          handle_listener('on_changed') { model_binding.call(value) } if property == 'value'
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-libui
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.4.6
 platform: ruby
 authors:
 - Andy Maleh
@@ -247,6 +247,7 @@ files:
 - examples/basic_window2.rb
 - examples/button_counter.rb
 - examples/color_button.rb
+- examples/color_button2.rb
 - examples/color_the_circles.rb
 - examples/control_gallery.rb
 - examples/custom_draw_text.rb
@@ -259,6 +260,7 @@ files:
 - examples/editable_column_table.rb
 - examples/editable_table.rb
 - examples/font_button.rb
+- examples/font_button2.rb
 - examples/form.rb
 - examples/form2.rb
 - examples/form_table.rb
@@ -370,6 +372,7 @@ files:
 - lib/glimmer/libui/control_proxy/open_type_tag_proxy.rb
 - lib/glimmer/libui/control_proxy/path_proxy.rb
 - lib/glimmer/libui/control_proxy/radio_buttons_proxy.rb
+- lib/glimmer/libui/control_proxy/slider_proxy.rb
 - lib/glimmer/libui/control_proxy/spinbox_proxy.rb
 - lib/glimmer/libui/control_proxy/tab_item_proxy.rb
 - lib/glimmer/libui/control_proxy/table_proxy.rb