glimmer-dsl-swt 4.18.4.10 → 4.18.4.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f06f3cbda7f10f81702dcdff893c91f4b7e381d5e7309c34786993e7000d8fc0
-  data.tar.gz: d08c04bababf1eb91a6a137ca725a082d66ec2479c71e0ef3f093dd472c68616
+  metadata.gz: cb72ad5f93c5c27a2f2ead87225e0ee045e2663e50b04346f5be6065fbf269c2
+  data.tar.gz: 394f955a01f7d5b568ae433dcab240f86b48749e5db428296299388ceaff5773
 SHA512:
-  metadata.gz: 95fbd9e1be14bf90eb36fd92b6e0d86c3a4a3848c1451f1b17234a8fb3521e544c0893d423c04f32bf750c538b6972969407a8ab6fa84e6a3d9ff0181c3fb144
-  data.tar.gz: 32ddd1acf980524c63fef1722ad1f006cf84d08bd1496b387cd0e6a180dd517b920fc458df34c58b2ac489f2c9b48b6a430a1891a21d9789219e965dc86c8f2b
+  metadata.gz: 18dd1f7062fdb14e063820d29168815df77b70f04275559fc812b605d2daf6053815b94579030a749cfc942188115150db093b0f0fc9863247177d112d165d90
+  data.tar.gz: c1809fda609b22045fd5872624cbc234b1353173522f2430767b8f36e4afd096063d5b4fe5fc41b0a24b0f96ec00d9fc0aada8df9537201d1d87fe8eebe26d59

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Change Log
 
+### 4.18.4.11
+
+- Support creating images pixel by pixel with `image(width, height) {|x,y| [r, g, b]}` keyword, which takes a block with x, y coordinates based on the image width and height and returns a pixel foreground color per point
+- Add proper indentation in code_text upon hitting ENTER
+- Reset Canvas Shape DSL alpha value to 255 when not explicitly set on a shape (Apply in Hello, Canvas! Sample)
+- Provide terse syntax for building canvas objects (autodetecting its width and height)
+- Provide terse syntax for building `:image_double_buffered` canvas objects (autodetecting its width and height):
+- Center mandelbrot where mouse is clicked upon zoom
+- Fix issue with Mandelbrot sample off by one error on Cores selected via Menu
+- Fix use of on_events in code_text widget with lines mode true
+
 ### 4.18.4.10
 
 - Hello, Progress Bar!

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.18.4.10
+# [<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.18.4.11
 ## 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)
@@ -342,7 +342,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.18.4.10
+jgem install glimmer-dsl-swt -v 4.18.4.11
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -360,7 +360,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.18.4.10'
+gem 'glimmer-dsl-swt', '~> 4.18.4.11'
 ```
 
 And, then run:
@@ -432,7 +432,7 @@ If you have a Glimmer app you would like referenced here, please mention in a Pu
 
 ### Connector
 
-[<img alt="Connector Logo" src="https://raw.githubusercontent.com/AndyObtiva/connector/master/package/linux/Connector.png" height=40 /> Connector](https://github.com/AndyObtiva/connector): A minimalist open-source web browser
+[<img alt="Connector Logo" src="https://raw.githubusercontent.com/AndyObtiva/connector/master/package/linux/Connector.png" height=40 /> Connector](https://github.com/AndyObtiva/connector): A minimalist open-source multi-engine web browser
 
 ## Packaging & Distribution
 

data/VERSION

@@ -1 +1 @@
-4.18.4.10
+4.18.4.11

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -411,6 +411,10 @@ Although SWT Display is not technically a widget, it has similar APIs and DSL su
 
 [JRuby](https://www.jruby.org/) supports [truly parallel multi-threading](https://github.com/jruby/jruby/wiki/Concurrency-in-jruby) since it relies on the JVM (Java Virtual Machine). As such, it enables development of highly-interactive desktop applications that can do background work while the user is interacting with the GUI. However, any code that interacts with the GUI from a thread other than the main (first) GUI thread must do so only through sync_exec (if it is standard synchronous code) or async_exec.
 
+Most of the time, you simply get away with Ruby [Threads](https://ruby-doc.org/core-2.5.7/Thread.html) and [Mutexes](https://ruby-doc.org/core-2.5.7/Mutex.html).
+
+Otherwise, if you need more advanced concurrency, Glimmer includes the [concurrent-ruby gem](https://rubygems.org/gems/concurrent-ruby), which supports many helpful concurrency techniques such as [Thread Pools](http://ruby-concurrency.github.io/concurrent-ruby/master/file.thread_pools.html) (used in the [Mandelbrot Fractal](GLIMMER_SAMPLES.md#mandelbrot-fractal) sample).
+
 ##### async_exec
 
 `async_exec {}` is a Glimmer DSL keyword in addition to being a method on `display`. It accepts a block and when invoked, adds the block to the end of a queue of GUI events scheduled to run on the SWT event loop, executing asynchronously.
@@ -1411,6 +1415,106 @@ shell {
 }.open
 ```
 
+#### Shapes inside a Widget
+
+Keep in mind that the Shape DSL can be used inside any widget, not just `canvas`. Unlike shapes on a `canvas`, which are standalone graphics, when included in a widget, which already has its own look and feel, shapes are used as a decorative add-on that complements its look by getting painted on top of it. For example, shapes were used to decorate `composite` blocks in the [Tetris](#tetris) sample to have a more bevel look. In summary, Shapes can be used in a hybrid approach (shapes inside a widget), not just standalone in a `canvas`.
+
+#### Shapes inside an Image
+
+You can build an image using the Canvas Shape DSL (including setting the icon of the application).
+
+Example (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
+
+```
+include Glimmer
+
+shell {
+  text 'Image Shape DSL Example'
+  label {
+    bevel_constant = 20
+    icon_block_size = 64
+    icon_bevel_size = icon_block_size.to_f / 25.to_f
+    icon_bevel_pixel_size = 0.16*icon_block_size.to_f
+    icon_size = 8
+    icon_pixel_size = icon_block_size * icon_size
+    image(icon_pixel_size, icon_pixel_size) {
+      icon_size.times { |row|
+        icon_size.times { |column|
+          colored = row >= 1 && column.between?(1, 6)
+          color = colored ? color([:white, :red, :blue, :green, :yellow, :magenta, :cyan, :dark_blue].sample) : color(:white)
+          x = column * icon_block_size
+          y = row * icon_block_size
+          rectangle(x, y, icon_block_size, icon_block_size) {
+            background color
+          }
+          polygon(x, y, x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
+            background rgb(color.red + 4*bevel_constant, color.green + 4*bevel_constant, color.blue + 4*bevel_constant)
+          }
+          polygon(x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size, y + icon_block_size) {
+            background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
+          }
+          polygon(x + icon_block_size, y + icon_block_size, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size) {
+            background rgb(color.red - 2*bevel_constant, color.green - 2*bevel_constant, color.blue - 2*bevel_constant)
+          }
+          polygon(x, y, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
+            background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
+          }
+        }
+      }
+    }
+  }
+}.open
+```
+
+![Image Shape DSL](/images/glimmer-example-image-shape-dsl.png)
+
+Example setting the icon of the application (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
+
+```
+include Glimmer
+
+shell {
+  text 'Image Shape DSL Example'
+  label {
+    text 'Image Shape DSL Example'
+    font height: 30
+  }
+  bevel_constant = 20
+  icon_block_size = 64
+  icon_bevel_size = icon_block_size.to_f / 25.to_f
+  icon_bevel_pixel_size = 0.16*icon_block_size.to_f
+  icon_size = 8
+  icon_pixel_size = icon_block_size * icon_size
+  image(icon_pixel_size, icon_pixel_size) {
+    icon_size.times { |row|
+      icon_size.times { |column|
+        colored = row >= 1 && column.between?(1, 6)
+        color = colored ? color([:white, :red, :blue, :green, :yellow, :magenta, :cyan, :dark_blue].sample) : color(:white)
+        x = column * icon_block_size
+        y = row * icon_block_size
+        rectangle(x, y, icon_block_size, icon_block_size) {
+          background color
+        }
+        polygon(x, y, x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
+          background rgb(color.red + 4*bevel_constant, color.green + 4*bevel_constant, color.blue + 4*bevel_constant)
+        }
+        polygon(x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size, y + icon_block_size) {
+          background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
+        }
+        polygon(x + icon_block_size, y + icon_block_size, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size) {
+          background rgb(color.red - 2*bevel_constant, color.green - 2*bevel_constant, color.blue - 2*bevel_constant)
+        }
+        polygon(x, y, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
+          background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
+        }
+      }
+    }
+  }
+}.open
+```
+
+![Image Shape DSL](/images/glimmer-example-image-shape-dsl-app-switcher-icon.png)
+
 #### Pixel Graphics
 
 **(Early Alpha Feature)**
@@ -1440,6 +1544,21 @@ Result:
 
 ![glimmer example pixel graphics](/images/glimmer-example-pixel-graphics.png)
 
+If you are strictly dealing with pixels (no other shapes), you could even avoid the `pixel` keyword altogether and just provide direct foreground colors by passing a block that receives x, y coordinates:
+
+```ruby
+include Glimmer
+ 
+shell {
+  minimum_size 250, 265
+  text 'Pixel Graphics Example'
+   
+  canvas { |x, y|
+    [y%255, x%255, (x+y)%255]
+  }
+}.open
+```
+
 Remember that you could always default to direct SWT painting via [org.eclipse.swt.graphics.GC](https://help.eclipse.org/2020-12/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/graphics/GC.html) too for even faster performance when needed in rare circumstances. Learn more at the [SWT Graphics Guide](https://www.eclipse.org/articles/Article-SWT-graphics/SWT_graphics.html) and [SWT Image Guide](https://www.eclipse.org/articles/Article-SWT-images/graphics-resources.html#Saving%20Images).
 
 Example of manually doing the same things as in the previous example without relying on the declarative Glimmer Shape DSL (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
@@ -1465,6 +1584,8 @@ shell {
 }.open
 ```
 
+(the code could be optimized further if you are repeating colors by simply reusing `Color` objects instead of re-constructing them)
+
 The only downside with the approach above is that it repaints all pixels on repaints to the window (e.g. during window resize). To get around that, we can rely on a technique called **Image Double-Buffering**. That is to buffer the graphics on an Image first and then set it on the Canvas so that resizes of the shell dont cause a repaint of all the pixels. Additionally, this gives us the added benefit of being able to use the image as a Shell icon via its `image` property.
 
 Example (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
@@ -1501,127 +1622,80 @@ If you need a transparent background for the image, replace the image constructi
 
 That way, wherever you don't draw a point, you get transparency (seeing what is behind the image).
 
-If you don't need a `shell` image icon and `pixel` performance is enough, you can automatically apply **Image Double-Buffering** with the `:image_double_buffered` SWT style (custom Glimmer style not available in SWT itself)
-
-Example (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
+Alternatively, with a very minor performance penalty, Glimmer enables you to build the image pixel by pixel with a friendly Ruby syntax by passing a block that takes the x and y coordinates and returns a foreground color rgb array or Color/ColorProxy object.
 
 ```ruby
 include Glimmer
 
+@the_image = image(250, 250) {|x, y|
+  [y%255, x%255, (x+y)%255]
+}
+
 shell {
   minimum_size 250, 265
   text 'Pixel Graphics Example'
+  image @the_image
   
-  canvas(:image_double_buffered) {
-    250.times {|y|
-      250.times {|x|
-        pixel(x, y, foreground: [y%255, x%255, (x+y)%255])
-      }
-    }
+  canvas {
+    image @the_image
   }
 }.open
 ```
 
-#### Shapes inside a Widget
+If you don't need a `shell` image (icon), you can nest the image directly under the canvas by passing in the `top_level` keyword to treat `image` as a top-level keyword (pretending it is built outside the shell).
 
-Keep in mind that the Shape DSL can be used inside any widget, not just `canvas`. Unlike shapes on a `canvas`, which are standalone graphics, when included in a widget, which already has its own look and feel, shapes are used as a decorative add-on that complements its look by getting painted on top of it. For example, shapes were used to decorate `composite` blocks in the [Tetris](#tetris) sample to have a more bevel look. In summary, Shapes can be used in a hybrid approach (shapes inside a widget), not just standalone in a `canvas`.
+```ruby
+include Glimmer
 
-#### Shapes inside an Image
+shell {
+  minimum_size 250, 265
+  text 'Pixel Graphics Example'
+  
+  canvas {
+    image image(250, 250, top_level: true) {|x, y|
+      [y%255, x%255, (x+y)%255]
+    }
+  }
+}.open
+```
 
-You can build an image using the Canvas Shape DSL (including setting the icon of the application).
+If you don't need a `shell` image (icon) and `pixel` performance is enough, you can automatically apply **Image Double-Buffering** with the `:image_double_buffered` SWT style (custom Glimmer style not available in SWT itself)
 
 Example (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
 
-```
+```ruby
 include Glimmer
 
 shell {
-  text 'Image Shape DSL Example'
-  label {
-    bevel_constant = 20
-    icon_block_size = 64
-    icon_bevel_size = icon_block_size.to_f / 25.to_f
-    icon_bevel_pixel_size = 0.16*icon_block_size.to_f
-    icon_size = 8
-    icon_pixel_size = icon_block_size * icon_size
-    image(icon_pixel_size, icon_pixel_size) {
-      icon_size.times { |row|
-        icon_size.times { |column|
-          colored = row >= 1 && column.between?(1, 6)
-          color = colored ? color([:white, :red, :blue, :green, :yellow, :magenta, :cyan, :dark_blue].sample) : color(:white)
-          x = column * icon_block_size
-          y = row * icon_block_size
-          rectangle(x, y, icon_block_size, icon_block_size) {
-            background color
-          }
-          polygon(x, y, x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
-            background rgb(color.red + 4*bevel_constant, color.green + 4*bevel_constant, color.blue + 4*bevel_constant)
-          }
-          polygon(x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size, y + icon_block_size) {
-            background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
-          }
-          polygon(x + icon_block_size, y + icon_block_size, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size) {
-            background rgb(color.red - 2*bevel_constant, color.green - 2*bevel_constant, color.blue - 2*bevel_constant)
-          }
-          polygon(x, y, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
-            background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
-          }
-        }
+  minimum_size 250, 265
+  text 'Pixel Graphics Example'
+  
+  canvas(:image_double_buffered) {
+    250.times {|y|
+      250.times {|x|
+        pixel(x, y, foreground: [y%255, x%255, (x+y)%255])
       }
     }
   }
 }.open
 ```
 
-![Image Shape DSL](/images/glimmer-example-image-shape-dsl.png)
-
-Example setting the icon of the application (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
+Of course, you could also take advantage of the pixel-less terser syntax:
 
-```
+```ruby
 include Glimmer
 
 shell {
-  text 'Image Shape DSL Example'
-  label {
-    text 'Image Shape DSL Example'
-    font height: 30
-  }
-  bevel_constant = 20
-  icon_block_size = 64
-  icon_bevel_size = icon_block_size.to_f / 25.to_f
-  icon_bevel_pixel_size = 0.16*icon_block_size.to_f
-  icon_size = 8
-  icon_pixel_size = icon_block_size * icon_size
-  image(icon_pixel_size, icon_pixel_size) {
-    icon_size.times { |row|
-      icon_size.times { |column|
-        colored = row >= 1 && column.between?(1, 6)
-        color = colored ? color([:white, :red, :blue, :green, :yellow, :magenta, :cyan, :dark_blue].sample) : color(:white)
-        x = column * icon_block_size
-        y = row * icon_block_size
-        rectangle(x, y, icon_block_size, icon_block_size) {
-          background color
-        }
-        polygon(x, y, x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
-          background rgb(color.red + 4*bevel_constant, color.green + 4*bevel_constant, color.blue + 4*bevel_constant)
-        }
-        polygon(x + icon_block_size, y, x + icon_block_size - icon_bevel_pixel_size, y + icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size, y + icon_block_size) {
-          background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
-        }
-        polygon(x + icon_block_size, y + icon_block_size, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_block_size - icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size) {
-          background rgb(color.red - 2*bevel_constant, color.green - 2*bevel_constant, color.blue - 2*bevel_constant)
-        }
-        polygon(x, y, x, y + icon_block_size, x + icon_bevel_pixel_size, y + icon_block_size - icon_bevel_pixel_size, x + icon_bevel_pixel_size, y + icon_bevel_pixel_size) {
-          background rgb(color.red - bevel_constant, color.green - bevel_constant, color.blue - bevel_constant)
-        }
-      }
-    }
+  minimum_size 250, 265
+  text 'Pixel Graphics Example'
+  
+  canvas(:image_double_buffered) { |x, y|
+    [y%255, x%255, (x+y)%255]
   }
 }.open
 ```
 
-![Image Shape DSL](/images/glimmer-example-image-shape-dsl-app-switcher-icon.png)
-
+As they say, there are many ways to skin a cat! This is in line with the Ruby way of providing more ways than one. Pick and choose the right tool for the job just like true software engineers.
 
 ### Canvas Transform DSL
 
@@ -2715,6 +2789,8 @@ To use, simply use `code_text` in place of the `text` or `styled_text` widget. I
 **lines**
 (default: `false`)
 
+**(BETA FEATURE)**
+
 Shows line numbers when set to true.
 
 If set to a hash like `{width: 4}`, it sets the initial width of the line numbers lane in character count (default: 4)
@@ -2724,6 +2800,8 @@ Keep in mind that if the text grows and required a wider line numbers area, it g
 **theme**
 (default: `'glimmer'`)
 
+**(BETA FEATURE)**
+
 Changes syntax color highlighting theme. Can be one of the following:
 - glimmer
 - github
@@ -2732,6 +2810,8 @@ Changes syntax color highlighting theme. Can be one of the following:
 **language**
 (default: `'ruby'`)
 
+**(BETA FEATURE)**
+
 Sets the code language, which can be one of the following [rouge gem](#https://rubygems.org/gems/rouge) supported languages:
 - abap
 - actionscript
@@ -2941,10 +3021,13 @@ Sets the code language, which can be one of the following [rouge gem](#https://r
 **default_behavior**
 (default: true)
 
+**(BETA FEATURE)**
+
 This adds some default keyboard shortcuts:
 - CMD+A (CTRL+A on Windows/Linux) to select all
 - CTRL+A on Mac to jump to beginning of line
 - CTRL+E on Mac to jump to end of line
+- Attempts to add proper indentation upon adding a new line when hitting ENTER (currently supporting Ruby only)
 
 If you prefer it to be vanilla with no default key event listeners, then pass the `default_behavior: false` option.
 

data/docs/reference/GLIMMER_SAMPLES.md

@@ -605,6 +605,10 @@ Hello, Cursor!
 
 This sample demonstrates the use of the `progress_bar` widget keyword.
 
+It includes an `:indeterminate` progress bar on top, for cases when you could not calculate progress, but still want to inform the user there is an operation happening in the background.
+
+Below it, there are a determinate `:horizontal` (default) progress bar and a `:vertical` progress bar. 
+
 Code:
 
 [samples/hello/hello_progress_bar.rb](/samples/hello/hello_progress_bar.rb)
@@ -731,6 +735,12 @@ Code:
 
 ![Mandelbrot Fractal Zoom 5](/images/glimmer-mandelbrot-zoom5.png)
 
+![Mandelbrot Fractal View Menu](/images/glimmer-mandelbrot-menu-view.png)
+
+![Mandelbrot Fractal Cores Menu](/images/glimmer-mandelbrot-menu-cores.png)
+
+![Mandelbrot Fractal Help Menu](/images/glimmer-mandelbrot-menu-help.png)
+
 ### External Samples
 
 #### Glimmer Calculator

data/glimmer-dsl-swt.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: glimmer-dsl-swt 4.18.4.10 ruby lib
+# stub: glimmer-dsl-swt 4.18.4.11 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "glimmer-dsl-swt".freeze
-  s.version = "4.18.4.10"
+  s.version = "4.18.4.11"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["AndyMaleh".freeze]
-  s.date = "2021-02-16"
+  s.date = "2021-02-19"
   s.description = "Glimmer DSL for SWT (JRuby Desktop Development GUI Framework) is a native-GUI cross-platform desktop development library written in JRuby, an OS-threaded faster JVM version of Ruby. Glimmer's main innovation is a declarative Ruby DSL that enables productive and efficient authoring of desktop application user-interfaces by relying on the robust Eclipse SWT library. Glimmer additionally innovates by having built-in data-binding support, which greatly facilitates synchronizing the GUI with domain models, thus achieving true decoupling of object oriented components and enabling developers to solve business problems (test-first) without worrying about GUI concerns, or alternatively drive development GUI-first, and then write clean business models (test-first) afterwards. Not only does Glimmer provide a large set of GUI widgets, but it also supports drawing Canvas Graphics like Shapes and Animations. To get started quickly, Glimmer offers scaffolding options for Apps, Gems, and Custom Widgets. Glimmer also includes native-executable packaging support, sorely lacking in other libraries, thus enabling the delivery of desktop apps written in Ruby as truly native DMG/PKG/APP files on the Mac + App Store, MSI/EXE files on Windows, and Gem Packaged Shell Scripts on Linux.".freeze
   s.email = "andy.am@gmail.com".freeze
   s.executables = ["glimmer".freeze, "girb".freeze]

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

@@ -32,7 +32,7 @@ module Glimmer
         include_package 'org.eclipse.swt.widgets'
   
         def interpret(parent, keyword, *args, &block)
-          Glimmer::SWT::ColorProxy.flyweight(*args)
+          Glimmer::SWT::ColorProxy.create(*args)
         end
       end
     end

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

@@ -46,11 +46,14 @@ module Glimmer
   
         def interpret(parent, keyword, *args, &block)
           options = args.last.is_a?(Hash) ? args.pop : {}
-          UI::CustomWidget.for(keyword).new(parent, *args, options, &block)
+          UI::CustomWidget.for(keyword).new(parent, *args, options, &block).tap do |new_custom_widget|
+            new_custom_widget.body_root.paint_pixel_by_pixel(&block) if block&.parameters&.count == 2
+          end
         end
   
         def add_content(parent, &block)
           # TODO consider avoiding source_location
+          return if block&.parameters&.count == 2
           if block.source_location == parent.content&.__getobj__.source_location
             parent.content.call(parent) unless parent.content.called?
           else

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

@@ -40,11 +40,18 @@ module Glimmer
   
         def interpret(parent, keyword, *args, &block)
           options = args.last.is_a?(Hash) ? args.last : {}
+          coordinate_args = args.size == (options.empty? ? 2 : 3)
           args.unshift(parent) unless parent.nil? || options[:top_level]
-          Glimmer::SWT::ImageProxy.new(*args, &block)
+          @create_pixel_by_pixel = coordinate_args && block&.parameters&.count == 2
+          if @create_pixel_by_pixel
+            Glimmer::SWT::ImageProxy.create_pixel_by_pixel(*args, &block)
+          else
+            Glimmer::SWT::ImageProxy.create(*args, &block)
+          end
         end
 
         def add_content(parent, &block)
+          return if @create_pixel_by_pixel || block&.parameters&.count == 2
           super
           parent.post_add_content
         end

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

@@ -40,10 +40,13 @@ module Glimmer
         end
 
         def interpret(parent, keyword, *args, &block)
-          Glimmer::SWT::WidgetProxy.create(keyword, parent, args)
+          Glimmer::SWT::WidgetProxy.create(keyword, parent, args).tap do |new_widget_proxy|
+            new_widget_proxy.paint_pixel_by_pixel(&block) if block&.parameters&.count == 2
+          end
         end
 
         def add_content(parent, &block)
+          return if block&.parameters&.count == 2
           super
           parent.post_add_content
           parent.finish_add_content!

data/lib/glimmer/swt/color_proxy.rb

@@ -33,7 +33,7 @@ module Glimmer
       include_package 'org.eclipse.swt.graphics'
       
       class << self
-        def flyweight(*args)
+        def create(*args)
           flyweight_color_proxies[args] ||= new(*args)
         end
         

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

@@ -64,6 +64,18 @@ module Glimmer
           respond_to?(method_name)
         end
         
+        def can_handle_observation_request?(observation_request)
+          @styled_text_proxy.can_handle_observation_request?(observation_request)
+        rescue
+          super
+        end
+        
+        def handle_observation_request(observation_request, &block)
+          @styled_text_proxy.handle_observation_request(observation_request, &block)
+        rescue
+          super
+        end
+        
         def root_block=(block)
           body_root.content(&block)
         end
@@ -153,6 +165,7 @@ module Glimmer
             top_margin 5
             right_margin 5
             bottom_margin 5
+            tabs 2
             
             if default_behavior
               on_key_pressed { |event|
@@ -166,6 +179,15 @@ module Glimmer
                   jump_to_end_of_line
                 end
               }
+              on_verify_text { |verify_event|
+                if verify_event.text == "\n"
+                  line_index = verify_event.widget.get_line_at_offset(verify_event.widget.get_caret_offset)
+                  line = verify_event.widget.get_line(line_index)
+                  line_indent = line.match(/^([ ]*)/)[1].to_s.size
+                  verify_event.text += ' '*line_indent
+                  verify_event.text += ' '*2 if line.strip.end_with?('{') || line.strip.match(/do([ ]*[|][^|]*[|])?$/) || line.start_with?('class') || line.start_with?('module') || line.strip.start_with?('def')
+                end
+              }
             end
             
             on_modify_text { |event|

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

@@ -51,6 +51,50 @@ module Glimmer
           shapes.dup.each {|s| s.dispose(dispose_images: dispose_images, dispose_patterns: dispose_patterns) } if requires_shape_disposal?
         end
         
+        def paint_pixel_by_pixel(width = nil, height = nil, &each_pixel_color)
+          if @image_double_buffered
+            work = lambda do |paint_event|
+              width ||= swt_drawable.bounds.width
+              height ||= swt_drawable.bounds.height
+              @image_proxy_buffer ||= ImageProxy.create_pixel_by_pixel(width, height, &each_pixel_color)
+              @image_proxy_buffer.shape(self).paint(paint_event)
+            end
+          else
+            work = lambda do |paint_event_or_image|
+              the_gc = paint_event_or_image.gc
+              current_foreground = nil
+              width ||= swt_drawable.bounds.width
+              height ||= swt_drawable.bounds.height
+              height.times do |y|
+                width.times do |x|
+                  new_foreground = each_pixel_color.call(x, y)
+                  new_foreground = Glimmer::SWT::ColorProxy.create(new_foreground, ensure_bounds: false) unless new_foreground.is_a?(ColorProxy) || new_foreground.is_a?(Color)
+                  new_foreground = new_foreground.swt_color if new_foreground.is_a?(Glimmer::SWT::ColorProxy)
+                  the_gc.foreground = current_foreground = new_foreground unless new_foreground == current_foreground
+                  the_gc.draw_point x, y
+                end
+              end
+            end
+          end
+          if respond_to?(:gc)
+            work.call(self)
+          else
+            on_swt_paint(&work)
+          end
+        end
+        
+        def swt_drawable
+          swt_drawable = nil
+          if respond_to?(:swt_image)
+            swt_drawable = swt_image
+          elsif respond_to?(:swt_display)
+            swt_drawable = swt_display
+          elsif respond_to?(:swt_widget)
+            swt_drawable = swt_widget
+          end
+          swt_drawable
+        end
+        
         def deregister_shape_painting
           @paint_listener_proxy&.deregister
         end

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

@@ -308,7 +308,11 @@ module Glimmer
             else
               @properties['background'] = [@parent.background] if fill? && !has_some_background?
               @properties['foreground'] = [@parent.foreground] if @parent.respond_to?(:foreground) && draw? && !has_some_foreground?
+              # TODO regarding alpha, make sure to reset it to parent stored alpha once we allow setting shape properties on parents directly without shapes
+              @properties['alpha'] ||= [255]
               @properties['font'] = [@parent.font] if @parent.respond_to?(:font) && draw? && !@properties.keys.map(&:to_s).include?('font')
+              # TODO regarding transform, make sure to reset it to parent stored alpha once we allow setting shape properties on parents directly without shapes
+              # Also do that with all future-added properties
               @properties['transform'] = [nil] if @parent.respond_to?(:transform) && !@properties.keys.map(&:to_s).include?('transform')
               @properties.each do |property, args|
                 method_name = attribute_setter(property)

data/lib/glimmer/swt/image_proxy.rb

@@ -34,13 +34,24 @@ module Glimmer
       include Properties
             
       class << self
-        def create(*args)
+        include_package 'org.eclipse.swt.graphics'
+        
+        def create(*args, &content)
           if args.size == 1 && args.first.is_a?(ImageProxy)
             args.first
           else
-            new(*args)
+            new(*args, &content)
           end
         end
+        
+        def create_pixel_by_pixel(*args, &each_pixel_color)
+          image_proxy = create(*args)
+          options = args.last.is_a?(Hash) ? args.pop : {}
+          height = args[-1]
+          width = args[-2]
+          image_proxy.paint_pixel_by_pixel(width, height, &each_pixel_color)
+          image_proxy
+        end
       end
       
       include_package 'org.eclipse.swt.widgets'
@@ -88,7 +99,7 @@ module Glimmer
         # TODO consider adding a get_data/set_data method to conform with other SWT widgets
         @swt_image.singleton_class.define_method(:dispose) do
           proxy.clear_shapes
-          super
+          super()
         end
         post_add_content if content.nil?
       end

data/samples/elaborate/mandelbrot_fractal.rb

@@ -55,7 +55,7 @@ class Mandelbrot
     end
     
     def processor_count
-      @processor_count ||= Concurrent.processor_count
+      @processor_count ||= Concurrent.physical_processor_count
     end
   end
   
@@ -222,8 +222,8 @@ class MandelbrotFractal
           on_mouse_up { |mouse_event|
             if !@drag_detected
               origin = @scrolled_composite.origin
-              @location_x = [[origin.x + mouse_event.x - @scrolled_composite.bounds.width / 2.0, 0].max, @scrolled_composite.bounds.width].min
-              @location_y = [[origin.y + mouse_event.y - @scrolled_composite.bounds.height / 2.0, 0].max, @scrolled_composite.bounds.height].min
+              @location_x = mouse_event.x
+              @location_y = mouse_event.y
               if mouse_event.button == 1
                 zoom_in
               elsif mouse_event.button > 2
@@ -265,7 +265,7 @@ class MandelbrotFractal
         menu {
           text '&Cores'
           
-          Concurrent.processor_count.times {|n|
+          Concurrent.physical_processor_count.times {|n|
             processor_number = n + 1
             menu_item(:radio) {
               text "&#{processor_number}"
@@ -279,10 +279,10 @@ class MandelbrotFractal
                 accelerator COMMAND, :alt, (processor_number - 20).to_s
               end
               
-              selection true if processor_number == Concurrent.processor_count
+              selection true if processor_number == Concurrent.physical_processor_count
               
               on_widget_selected {
-                Mandelbrot.processor_count = n
+                Mandelbrot.processor_count = processor_number
               }
             }
           }
@@ -316,21 +316,16 @@ class MandelbrotFractal
       width = the_mandelbrot.width
       height = the_mandelbrot.height
       pixels = the_mandelbrot.points
-      new_mandelbrot_image = image(width, height, top_level: true) # invoke as a top-level parentless keyword to avoid nesting under any widget
-      new_mandelbrot_image_gc = new_mandelbrot_image.gc
-      current_foreground = nil
       Mandelbrot.work_in_progress = "Consuming Points To Build Image for Zoom #{mandelbrot_zoom}x"
-      Mandelbrot.progress = Mandelbrot::PROGRESS_MAX
+      Mandelbrot.progress = Mandelbrot::PROGRESS_MAX + 1
       point_index = 0
       point_count = width*height
-      height.times { |y|
-        width.times { |x|
-          new_foreground = color_palette[pixels[y][x]]
-          new_mandelbrot_image_gc.foreground = current_foreground = new_foreground unless new_foreground == current_foreground
-          new_mandelbrot_image_gc.draw_point x, y
-          point_index += 1
-          Mandelbrot.progress -= 1 if (Mandelbrot::PROGRESS_MAX - (point_index.to_f / point_count.to_f)*Mandelbrot::PROGRESS_MAX) < Mandelbrot.progress
-        }
+      # invoke as a top-level parentless keyword to avoid nesting under any widget
+      new_mandelbrot_image = image(width, height, top_level: true) { |x, y|
+        point_index += 1
+        Mandelbrot.progress -= 1 if (Mandelbrot::PROGRESS_MAX - (point_index.to_f / point_count.to_f)*Mandelbrot::PROGRESS_MAX) < Mandelbrot.progress
+        pixel_color_index = pixels[y][x]
+        color_palette[pixel_color_index]
       }
       Mandelbrot.progress = 0
       flyweight_mandelbrot_images[mandelbrot_zoom] = new_mandelbrot_image
@@ -387,8 +382,9 @@ class MandelbrotFractal
     @canvas.set_size @mandelbrot_image.bounds.width, @mandelbrot_image.bounds.height
     @scrolled_composite.swt_widget.set_min_size(Point.new(@mandelbrot_image.bounds.width, @mandelbrot_image.bounds.height))
     if @location_x && @location_y
+      # center on mouse click location
       factor = (zoom / last_zoom)
-      @scrolled_composite.set_origin(factor*@location_x, factor*@location_y)
+      @scrolled_composite.set_origin(factor*@location_x - @scrolled_composite.client_area.width/2.0, factor*@location_y - @scrolled_composite.client_area.height/2.0)
       @location_x = @location_y = nil
     end
     update_mandelbrot_shell_title!
@@ -404,7 +400,7 @@ class MandelbrotFractal
         Left-click to zoom in.
         Right-click to zoom out.
         Scroll or drag to pan.
-        Lower cores to get more responsive interaction.
+        Adjust cores to get a more responsive interaction.
         
         Enjoy!
       MULTI_LINE_STRING

data/samples/elaborate/meta_sample.rb

@@ -219,7 +219,7 @@ class MetaSampleApplication
             SampleDirectory.sample_directories.each { |sample_directory|
               expand_item {
                 layout_data(:fill, :fill, true, true)
-                text " #{sample_directory.name} Samples"
+                text " #{sample_directory.name} Samples (#{sample_directory.samples.count})"
                 
                 radio_group { |radio_group_proxy|
                   row_layout(:vertical) {

data/samples/hello/hello_combo.rb

@@ -46,7 +46,7 @@ class HelloCombo
       text 'Hello, Combo!'
       
       combo(:read_only) {
-        selection bind(person, :country)
+        selection bind(person, :country) # also binds to country_options by convention
       }
       
       button {

data/samples/hello/hello_list_multi_selection.rb

@@ -59,7 +59,7 @@ class HelloListMultiSelection
       text 'Hello, List Multi Selection!'
       
       list(:multi) {
-        selection bind(person, :provinces)
+        selection bind(person, :provinces) # also binds to provinces_options by convention
       }
       
       button {

data/samples/hello/hello_list_single_selection.rb

@@ -44,7 +44,7 @@ class HelloListSingleSelection
       text 'Hello, List Single Selection!'
       
       list {
-        selection bind(person, :country)
+        selection bind(person, :country) # also binds to country_options by convention
       }
       
       button {

data/samples/hello/hello_progress_bar.rb

@@ -110,6 +110,8 @@ class HelloProgressBar
           # (killing is not dangerous since it is only a thread about updating progress)
           @current_thread&.kill
           @current_thread = Thread.new {
+            # GUI updates must happen in sync_exec calls.
+            # Alternatively, add `sync_exec: true` to all the updated property `bind(...)` statements above
             sync_exec { @progress_model.selection = @progress_model.minimum }
             (@progress_model.minimum..@progress_model.maximum).to_a.each do |n|
               sync_exec {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-swt
 version: !ruby/object:Gem::Version
-  version: 4.18.4.10
+  version: 4.18.4.11
 platform: ruby
 authors:
 - AndyMaleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-02-16 00:00:00.000000000 Z
+date: 2021-02-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement