glimmer-dsl-swt 4.20.11.1 → 4.20.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83a247e9e977044f7294fcf2430d1ec527f15e0c46b372d0e8c2e91cfbb36321
-  data.tar.gz: 269d918b90ac0b565a27d71a17dfd7b01194e2df6f18c76a2c5b77d496b45202
+  metadata.gz: db6def93b1e2b7c5b5275126e53dbb42e23021721f41a23f98528d1f69f01f1b
+  data.tar.gz: 4d5b8fc17d10df490b1614e573d8a678c418f10cc2e5d43d0352905cf5245b1f
 SHA512:
-  metadata.gz: 033fb29c9fb0bc37ac6786bb33610ee550628a5def123af28b9c732477329edcb13bca3008581c117fd3751bda9e6c953ac4f69bff319f91848be177dac45d77
-  data.tar.gz: d286000814adaf8794105b357fbeec08cef2d202436930b64848f914d99eb1bfe27fffd03b51a430495174018ebdae54fb26165a18ca42cf8e8ecfd4bf5b3694
+  metadata.gz: fae5f9df309f2e0aada6c7557abb786faffc4cfdac5f82945183389bff644376106f0b41d1bc2b9b0d0cd2aaa14a07f2ad506545290cc7870354c377cad98c06
+  data.tar.gz: 85fabb309339aed175bb2bc662af3b9ba9f8b365114bbdaf3f4a642b94187bf2f07406c32c716b3ab71bcfa739a64ff53e7b846a9228e18ed0fe6d84f9890e3a

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Change Log
 
+### 4.20.12.0
+
+- Canvas Shape Listeners: on_mouse_up, on_mouse_down, on_mouse_move, on_drag_detected
+- Make scaffolding not generate an empty () after shell
+
 ### 4.20.11.1
 
 - Make scaffolded app project use bundler optionally only and still load glimmer-dsl-swt otherwise, like in gem-packaged mode (`glimmer package:gem`) to avoid erroring out about bundler.

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 SWT 4.20.11.1
+# [<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 SWT 4.20.12.0
 ## JRuby Desktop Development GUI Framework
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-swt.svg)](http://badge.fury.io/rb/glimmer-dsl-swt)
 [![Travis CI](https://travis-ci.com/AndyObtiva/glimmer-dsl-swt.svg?branch=master)](https://travis-ci.com/github/AndyObtiva/glimmer-dsl-swt)
@@ -15,7 +15,7 @@
 [<img src="https://covers.oreillystatic.com/images/9780596519650/lrg.jpg" width=105 /><br />
 Featured in JRuby Cookbook](http://shop.oreilly.com/product/9780596519650.do) and [Chalmers/Gothenburg University Software Engineering Master's Lecture Material](http://www.cse.chalmers.se/~bergert/slides/guest_lecture_DSLs.pdf)
 
-[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.20.11.1 includes [SWT 4.20](https://download.eclipse.org/eclipse/downloads/drops4/R-4.20-202106111600/), which was released on June 11, 2021. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT. Note that SWT now supports AARCH64 on Mac and Linux, but it is not fully tested in Glimmer DSL for SWT yet, so deem its support experimental for the time being without guarantees for functionality until declared otherwise (report any issues you may encounter).
+[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.20.12.0 includes [SWT 4.20](https://download.eclipse.org/eclipse/downloads/drops4/R-4.20-202106111600/), which was released on June 11, 2021. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT. Note that SWT now supports AARCH64 on Mac and Linux, but it is not fully tested in Glimmer DSL for SWT yet, so deem its support experimental for the time being without guarantees for functionality until declared otherwise (report any issues you may encounter).
 
 **Starting in version 4.20.0.0, [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) comes with the new [***Shine***](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#shine) syntax** for highly intuitive and visually expressive View/Model Attribute Mapping, relying on `<=>` for bidirectional (two-way) data-binding and `<=` for unidirectional (one-way) data-binding, providing an alternative to the `bind` keyword (keep in mind that it is still a beta, so default back to `bind` whenever needed).
 
@@ -45,12 +45,6 @@ shell {
 }.open
 ```
 
-Run via `glimmer samples` or directly:
-
-```
-glimmer samples/hello/hello_world.rb
-```
-
 Glimmer app:
 
 ![Hello World](images/glimmer-hello-world.png)
@@ -62,25 +56,25 @@ Learn more about [Hello, World!](docs/reference/GLIMMER_SAMPLES#hello-world).
 Glimmer GUI DSL code (from [samples/hello/hello_table.rb](samples/hello/hello_table.rb)):
 
 ```ruby
-# ... model code precedes
 shell {
   grid_layout
   
   text 'Hello, Table!'
   background_image File.expand_path('hello_table/baseball_park.png', __dir__)
+  image File.expand_path('hello_table/baseball_park.png', __dir__)
   
   label {
     layout_data :center, :center, true, false
     
     text 'BASEBALL PLAYOFF SCHEDULE'
-    background :transparent
+    background :transparent if OS.windows?
     foreground rgb(94, 107, 103)
     font name: 'Optima', height: 38, style: :bold
   }
   
   combo(:read_only) {
     layout_data :center, :center, true, false
-    selection bind(BaseballGame, :playoff_type)
+    selection <=> [BaseballGame, :playoff_type]
     font height: 14
   }
   
@@ -121,10 +115,10 @@ shell {
     }
     
     # Data-bind table items (rows) to a model collection property, specifying column properties ordering per nested model
-    items bind(BaseballGame, :schedule), column_properties(:game_date, :game_time, :ballpark, :home_team, :away_team, :promotion)
+    items <=> [BaseballGame, :schedule, column_properties: [:game_date, :game_time, :ballpark, :home_team, :away_team, :promotion]]
     
     # Data-bind table selection
-    selection bind(BaseballGame, :selected_game)
+    selection <=> [BaseballGame, :selected_game]
     
     # Default initial sort property
     sort_property :date
@@ -147,20 +141,13 @@ shell {
     text 'Book Selected Game'
     layout_data :center, :center, true, false
     font height: 14
-    enabled bind(BaseballGame, :selected_game)
+    enabled <= [BaseballGame, :selected_game]
     
     on_widget_selected {
       book_selected_game
     }
   }
-}.open
-# ...
-```
-
-Run via `glimmer samples` or directly:
-
-```
-glimmer samples/hello/hello_table.rb
+}
 ```
 
 Glimmer App:
@@ -174,7 +161,6 @@ Learn more about [Hello, Table!](docs/reference/GLIMMER_SAMPLES#hello-table).
 Glimmer GUI DSL code (from [samples/elaborate/tetris.rb](samples/elaborate/tetris.rb)):
 
 ```ruby
-# ... more code resides in other files (navigate sample files to learn more)
 shell(:no_resize) {
   grid_layout {
     num_columns 2
@@ -196,13 +182,6 @@ shell(:no_resize) {
     layout_data(:fill, :fill, true, true)
   }
 }
-# ...
-```
-
-Run via `glimmer samples` or directly:
-
-```
-glimmer samples/elaborate/tetris.rb
 ```
 
 Glimmer app:
@@ -347,7 +326,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.20.11.1
+jgem install glimmer-dsl-swt -v 4.20.12.0
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -375,7 +354,7 @@ Note: if you're using activerecord or activesupport, keep in mind that Glimmer u
 
 Add the following to `Gemfile`:
 ```
-gem 'glimmer-dsl-swt', '~> 4.20.11.1'
+gem 'glimmer-dsl-swt', '~> 4.20.12.0'
 ```
 
 And, then run:
@@ -396,7 +375,7 @@ glimmer
 ```
 
 ```
-Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.20.11.1
+Glimmer (JRuby Desktop Development GUI Framework) - JRuby Gem: glimmer-dsl-swt v4.20.12.0
       
 Usage: glimmer [--bundler] [--pd] [--quiet] [--debug] [--log-level=VALUE] [[ENV_VAR=VALUE]...] [[-jruby-option]...] (application.rb or task[task_args]) [[application2.rb]...]
 
@@ -443,7 +422,9 @@ Select a Glimmer task to run: (Press ↑/↓ arrow to move, Enter to select and
   glimmer scaffold:gem:customwidget[name,namespace]          # Scaffold Glimmer::UI::CustomWidget subclass (part of a view) under its own Ruby gem project (namespace is required) [alt: scaffold:gem:cw]
 ```
 
-Learn more at: [docs/reference/GLIMMER_COMMAND.md](docs/reference/GLIMMER_COMMAND.md)
+Learn more at:
+
+[docs/reference/GLIMMER_COMMAND.md](docs/reference/GLIMMER_COMMAND.md)
 
 ## Girb (Glimmer irb) Command
 
@@ -455,7 +436,9 @@ girb
 
 ![GIRB](/images/glimmer-girb.png)
 
-Learn more at: [docs/reference/GLIMMER_GIRB.md](docs/reference/GLIMMER_GIRB.md)
+Learn more at:
+
+[docs/reference/GLIMMER_GIRB.md](docs/reference/GLIMMER_GIRB.md)
 
 ## Glimmer GUI DSL Syntax
 
@@ -495,13 +478,17 @@ table(:multi) {
 
 If you need more widgets, you can check out the [Nebula Project](https://github.com/AndyObtiva/glimmer-cw-nebula) (50+ enterprise-grade custom widgets)
 
-Learn more at: [docs/reference/GLIMMER_GUI_DSL_SYNTAX.md](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md)
+Learn more at:
+
+[docs/reference/GLIMMER_GUI_DSL_SYNTAX.md](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md)
 
 ## Glimmer Configuration
 
 Glimmer configuration may be done via the `Glimmer::Config` module.
 
-Learn more at: [docs/reference/GLIMMER_CONFIGURATION.md](docs/reference/GLIMMER_CONFIGURATION.md)
+Learn more at:
+
+[docs/reference/GLIMMER_CONFIGURATION.md](docs/reference/GLIMMER_CONFIGURATION.md)
 
 ## Glimmer Style Guide
 
@@ -509,6 +496,10 @@ Learn more at: [docs/reference/GLIMMER_CONFIGURATION.md](docs/reference/GLIMMER_
 
 ## Samples
 
+See a listing of samples including screenshots and explanations at:
+
+[docs/reference/GLIMMER_SAMPLES.md](/docs/reference/GLIMMER_SAMPLES.md)
+
 Check the [samples](/docs/reference/GLIMMER_SAMPLES.md) directory in [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt) for examples on how to write Glimmer applications. To run a sample, make sure to install the `glimmer-dsl-swt` gem first and then run:
 ```
 glimmer samples
@@ -518,8 +509,6 @@ glimmer samples
 
 ![Glimmer Meta-Sample](/images/glimmer-meta-sample.png)
 
-See a listing of samples including screenshots and explanations at: [docs/reference/GLIMMER_SAMPLES.md](/docs/reference/GLIMMER_SAMPLES.md)
-
 ## In Production
 
 The following production apps have been built with Glimmer.

data/VERSION

@@ -1 +1 @@
-4.20.11.1
+4.20.12.0

data/docs/reference/GLIMMER_SAMPLES.md

@@ -44,6 +44,7 @@
     - [Hello, Canvas Transform!](#hello-canvas-transform)
     - [Hello, Canvas Path!](#hello-canvas-path)
     - [Hello, Canvas Data Binding!](#hello-canvas-data-binding)
+    - [Hello, Canvas Shape Listeners!](#hello-canvas-shape-listeners)
     - [Hello, Cursor!](#hello-cursor)
     - [Hello, Progress Bar!](#hello-progress-bar)
     - [Hello, Tree!](#hello-tree)
@@ -816,6 +817,22 @@ Hello, Canvas Data Binding!
 
 ![Hello Canvas Data Binding Line Changed](/images/glimmer-hello-canvas-data-binding-line-changed.png)
 
+#### Hello, Canvas Shape Listeners!
+
+This sample demonstrates Canvas Shape DSL listeners, which are constrained within the bounds of their owning shape.
+
+Code:
+
+[samples/hello/hello_canvas_shape_listeners.rb](/samples/hello/hello_canvas_shape_listeners.rb)
+
+Hello, Canvas Shape Listeners!
+
+![Hello Canvas Shape Listeners](/images/glimmer-hello-canvas-shape-listeners.png)
+
+Hello, Canvas Shape Listeners! - Dragged Circle
+
+![Hello Canvas Shape Listeners Dragged](/images/glimmer-hello-canvas-shape-listeners-dragged.png)
+
 #### Hello, Cursor!
 
 This sample demonstrates the use of the `cursor` property keyword to change the mouse cursor.

data/lib/glimmer/dsl/swt/widget_listener_expression.rb

@@ -21,6 +21,7 @@
 
 require 'glimmer/dsl/expression'
 require 'glimmer/swt/display_proxy'
+require 'glimmer/swt/custom/shape'
 
 module Glimmer
   module DSL
@@ -31,9 +32,9 @@ module Glimmer
         def can_interpret?(parent, keyword, *args, &block)
           Glimmer::Config.logger.debug {"keyword starts with on_: #{keyword.start_with?('on_')}"}
           return false unless keyword.start_with?('on_')
-          widget_or_display_parentage = parent.respond_to?(:swt_widget) || parent.is_a?(Glimmer::SWT::DisplayProxy)
-          Glimmer::Config.logger.debug {"parent #{parent} is a widget or display: #{widget_or_display_parentage}"}
-          return false unless widget_or_display_parentage
+          proper_parent = parent.respond_to?(:swt_widget) || parent.is_a?(Glimmer::SWT::DisplayProxy) || parent.is_a?(Glimmer::SWT::Custom::Shape)
+          Glimmer::Config.logger.debug {"parent #{parent} is a widget, shape, or display: #{proper_parent}"}
+          return false unless proper_parent
           Glimmer::Config.logger.debug {"block exists?: #{!block.nil?}"}
           raise Glimmer::Error, "Listener is missing block for keyword: #{keyword}" unless block_given?
           Glimmer::Config.logger.debug {"args are empty?: #{args.empty?}"}

data/lib/glimmer/rake_task/scaffold.rb

@@ -640,7 +640,7 @@ module Glimmer
       ## Top-most widget must be a shell or another custom shell
       #
       body {
-        shell(#{':fill_screen' if shell_type == :desktopify}) {
+        shell#{'(:fill_screen)' if shell_type == :desktopify} {
           # Replace example content below with custom shell content
           minimum_size #{shell_type == :desktopify ? '768, 432' : '420, 240'}
           image File.join(APP_ROOT, 'package', 'windows', "#{human_name(shell_type == :gem ? custom_shell_name : current_dir_name)}.ico") if OS.windows?

data/lib/glimmer/swt/custom/shape.rb

@@ -239,6 +239,7 @@ module Glimmer
             end
           end
         end
+        alias translate move_by
         
         # rotates shape for an angle around its center
         # this operation is not cumulative (it resets angle every time)
@@ -563,6 +564,17 @@ module Glimmer
           end
         end
         
+        def can_handle_observation_request?(observation_request)
+          drawable.can_handle_observation_request?(observation_request)
+        end
+        
+        def handle_observation_request(observation_request, &block)
+          shape_block = lambda do |event|
+            block.call(event) if include?(event.x, event.y)
+          end
+          drawable.handle_observation_request(observation_request, &shape_block)
+        end
+        
         # Sets data just like SWT widgets
         def set_data(key=nil, value)
           @data ||= {}

data/samples/hello/hello_canvas_shape_listeners.rb

@@ -0,0 +1,171 @@
+# Copyright (c) 2007-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-dsl-swt'
+
+class HelloCanvasShapeListeners
+  include Glimmer::UI::CustomShell
+  
+  attr_accessor :shape_name, :listener_event, :dragged_shape
+
+  body {
+    shell {
+      row_layout(:vertical) {
+        fill true
+        center true
+        margin_width 0
+        margin_height 0
+      }
+      
+      text 'Hello, Canvas Shape Listeners!'
+      
+      label(:center) {
+        text 'Current Shape:'
+        font style: :bold
+      }
+      label(:center) {
+        text <= [self, :shape_name]
+      }
+      
+      label(:center) {
+        text 'Current Event:'
+        font style: :bold
+      }
+      label(:center) {
+        text <= [self, :listener_event]
+      }
+      
+      canvas { |canvas_proxy|
+        layout_data {
+          width 350
+          height 200
+        }
+        
+        background :white
+      
+        @rectangle = rectangle(25, 25, 50, 50) {
+          background :red
+                    
+          # these listener events are limited to the rectangle bounds
+                    
+          on_mouse_down do |event|
+            self.shape_name = 'Square'
+            self.listener_event = 'Mouse Down'
+          end
+          
+          on_drag_detected do |event|
+            self.shape_name = 'Square'
+            self.listener_event += ' / Drag Detected'
+            self.dragged_shape = @rectangle
+          end
+          
+          on_mouse_move do |event|
+            if listener_event.to_s.empty? || shape_name != 'Square'
+              self.listener_event = "Mouse Move"
+            elsif !listener_event.to_s.include?('Mouse Move')
+              self.listener_event += " / Mouse Move"
+            end
+            self.shape_name = 'Square'
+          end
+          
+          on_mouse_up do |event|
+            self.shape_name = 'Square'
+            self.listener_event += ' / Mouse Up'
+            self.dragged_shape = nil
+          end
+        }
+        
+        @oval = oval(150, 120, 50, 50) {
+          background :green
+          
+          # these listener events are limited to the oval bounds
+          
+          on_mouse_down do |event|
+            self.shape_name = 'Circle'
+            self.listener_event = 'Mouse Down'
+          end
+          
+          on_drag_detected do |event|
+            self.shape_name = 'Circle'
+            self.listener_event += ' / Drag Detected'
+            self.dragged_shape = @oval
+          end
+          
+          on_mouse_move do |event|
+            if listener_event.to_s.empty? || shape_name != 'Circle'
+              self.listener_event = "Mouse Move"
+            elsif !listener_event.to_s.include?('Mouse Move')
+              self.listener_event += " / Mouse Move"
+            end
+            self.shape_name = 'Circle'
+          end
+          
+          on_mouse_up do |event|
+            self.shape_name = 'Circle'
+            self.listener_event += ' / Mouse Up'
+            self.dragged_shape = nil
+          end
+        }
+        
+        @polygon = polygon(260, 25, 300, 25, 260, 65) {
+          background :blue
+          
+          # these listener events are limited to the polygon bounds
+          
+          on_mouse_down do |event|
+            self.shape_name = 'Triangle'
+            self.listener_event = 'Mouse Down'
+          end
+          
+          on_drag_detected do |event|
+            self.shape_name = 'Triangle'
+            self.listener_event += ' / Drag Detected'
+            self.dragged_shape = @polygon
+          end
+          
+          on_mouse_move do |event|
+            if listener_event.to_s.empty? || shape_name != 'Triangle'
+              self.listener_event = "Mouse Move"
+            elsif !listener_event.to_s.include?('Mouse Move')
+              self.listener_event += " / Mouse Move"
+            end
+            self.shape_name = 'Triangle'
+          end
+          
+          on_mouse_up do |event|
+            self.shape_name = 'Triangle'
+            self.listener_event += ' / Mouse Up'
+            self.dragged_shape = nil
+          end
+        }
+
+        # This is a general canvas listener event, which is used to move shape even if mouse goes out of its bounds
+        on_mouse_move do |event|
+          dragged_shape.move_by(event.x - @last_x.to_f, event.y - @last_y.to_f) if dragged_shape
+          @last_x = event.x
+          @last_y = event.y
+        end
+      }
+    }
+  }
+end
+
+HelloCanvasShapeListeners.launch

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-swt
 version: !ruby/object:Gem::Version
-  version: 4.20.11.1
+  version: 4.20.12.0
 platform: ruby
 authors:
 - Andy Maleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-23 00:00:00.000000000 Z
+date: 2021-07-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -577,6 +577,7 @@ files:
 - samples/hello/hello_canvas_animation_multi.rb
 - samples/hello/hello_canvas_data_binding.rb
 - samples/hello/hello_canvas_path.rb
+- samples/hello/hello_canvas_shape_listeners.rb
 - samples/hello/hello_canvas_transform.rb
 - samples/hello/hello_checkbox.rb
 - samples/hello/hello_checkbox_group.rb