glimmer-dsl-swt 4.18.4.8 → 4.18.4.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89ea3be1af753358a8beaffbf28c8dfd6602eae3903b01a884e6999f0dbf6cfb
-  data.tar.gz: 672422abf1637420ac51706373824ac821682eab77afe86b91e22b21f1e00eb6
+  metadata.gz: 641e17b39e98692f1c617da255c89361cdc49431fd77b20304fc08d4dc5fc301
+  data.tar.gz: 69549df2a3bf84d28445a9ba33cac1a3c4fb546927c3cb706c7cf5078e8094bb
 SHA512:
-  metadata.gz: 7b502b353aa06f6b26e39487859ae8f4d9f8ee47d74a4a97a224b14dfa8b18acba6d8e48b6a66ee518a8075cd90a6303f1864726a22812edf98515f6a2754aa2
-  data.tar.gz: a5926f825b0247d4b521bfa2f857d1b1f88d731dba9651690960cf7c516ef2a1c5aca9c6cce86878162358fb416a0913b3ba945b0589be19f78f94454848d0b5
+  metadata.gz: da95d92eadd7d0f768ab4945f57e9a6f582d7de7f1e4ac4eac65acc28de8628549aa2f0575ebbe34b964afb3e8616fe68e99fb8b9cc2084269707bd8edebf501
+  data.tar.gz: 77d070eaccd04104effb26b1fcc6914d5a9a0f4b381950220090293ac1a20cd1d8fe73daf55e00ba677b31a043038f557d75200b610237eec36c8f30893d7bd8

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Change Log
 
+### 4.18.4.9
+
+- Hello, Cursor! Sample
+- Log errors that occur in widget event listener blocks to help with troubleshooting
+- disposed? method for Shape objects
+- Add `dispose_images: false, dispose_patterns: false` options to `Shape#dispose` to avoid disposing images/patterns when needed
+- Mandelbrot background thread pre-calculation of future zoom levels
+- Mandelbrot menu bar menu items
+- Mandelbrot panning via scrollbars or dragging
+
 ### 4.18.4.8
 
 - Make `image` a top-level expression keyword

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.8
+# [<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.9
 ## 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)
@@ -326,14 +326,14 @@ Please follow these instructions to make the `glimmer` command available on your
 
 If you intend to learn the basics of Glimmer but are not ready to build a Glimmer app yet, pick Option 1 ([Direct Install](#option-1-direct-install)).
 
-If you intend to build a Glimmer app from scratch with [scaffolding](#scaffolding), pick Option 1 ([Direct Install](#option-1-direct-install)) as well.
+If you intend to build a Glimmer app from scratch with [scaffolding](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/docs/reference/GLIMMER_COMMAND.md#scaffolding), pick Option 1 ([Direct Install](#option-1-direct-install)) as well.
 
-Otherwise, Option 2 ([Bundler](#option-2-bundler)) can be followed in rare cases where you want to build an app without [scaffolding](#scaffolding).
+Otherwise, Option 2 ([Bundler](#option-2-bundler)) can be followed in rare cases where you want to build an app without [scaffolding](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/docs/reference/GLIMMER_COMMAND.md#scaffolding).
 
 **Note:** if you encounter any [issues](https://github.com/AndyObtiva/glimmer-dsl-swt/issues), please [report](https://github.com/AndyObtiva/glimmer-dsl-swt/issues) and then install a previous version instead from the list of [Glimmer Releases](https://rubygems.org/gems/glimmer-dsl-swt/versions) (keep looking back till you find one that works). Do not be disheartened as nearly everything is only a few days of work away. That said, keep in mind that this project is free and open source, meaning provided as is, so do not expect anything, but if you help with reporting and contributing, you could speed things up or even become part of the project.
 
 ### Option 1: Direct Install
-(Use for [Scaffolding](#scaffolding))
+(Use for [Scaffolding](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/docs/reference/GLIMMER_COMMAND.md#scaffolding))
 
 Run this command to install directly:
 ```
@@ -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.8
+jgem install glimmer-dsl-swt -v 4.18.4.9
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -351,7 +351,7 @@ Otherwise, you may also run `jruby -S gem install ...`
 
 If you are new to Glimmer and would like to continue learning the basics, you may continue to the [Glimmer Command](https://github.com/AndyObtiva/glimmer#glimmer-command) section.
 
-Otherwise, if you are ready to build a Glimmer app, you can jump to the [Glimmer Scaffolding](https://github.com/AndyObtiva/glimmer#scaffolding) section next.
+Otherwise, if you are ready to build a Glimmer app, you can jump to the [Glimmer Scaffolding](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/docs/reference/GLIMMER_COMMAND.md#scaffolding) section next.
 
 Note: if you're using activerecord or activesupport, keep in mind that Glimmer unhooks ActiveSupport::Dependencies as it does not rely on it.
 
@@ -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.8'
+gem 'glimmer-dsl-swt', '~> 4.18.4.9'
 ```
 
 And, then run:
@@ -386,11 +386,12 @@ You can use `girb` as an alternative to `irb` when prototyping Glimmer DSL for S
 
 ## Glimmer GUI DSL Syntax
 
-This guide should help you get started with Glimmer DSL for SWT. For more advanced SWT details, please refer to the [SWT Reference](#swt-reference).
-
+This guide should help you get started with Glimmer DSL for SWT.
 
 [docs/reference/GLIMMER_GUI_DSL_SYNTAX.md](docs/reference/GLIMMER_GUI_DSL_SYNTAX.md)
 
+For more advanced SWT details, please refer to the [SWT Reference](#swt-reference).
+
 ## Glimmer Configuration
 
 Glimmer configuration may be done via the `Glimmer::Config` module.
@@ -425,6 +426,14 @@ If you have a Glimmer app you would like referenced here, please mention in a Pu
 
 [<img alt="Garderie Rainbow Daily Agenda Logo" src="https://github.com/AndyObtiva/garderie_rainbow_daily_agenda/raw/master/images/garderie_rainbow_daily_agenda_logo.png" width="40" />Garderie Rainbow Daily Agenda](https://github.com/AndyObtiva/garderie_rainbow_daily_agenda): A child nursery daily agenda reporting desktop app
 
+### Glimmer Gab
+
+[<img alt="Glimmer Gab Logo" src="https://raw.githubusercontent.com/AndyObtiva/glimmer_gab/master/package/linux/Glimmer%20Gab.png" height=40 /> Glimmer Gab](https://github.com/AndyObtiva/glimmer_gab): Desktop App for Gab.com
+
+### 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
+
 ## Packaging & Distribution
 
 Glimmer simplifies the process of native-executable packaging and distribution on Mac and Windows via a single `glimmer package` command:
@@ -438,7 +447,7 @@ Glimmer already supports automatic (and manual) app updates via the Mac App Stor
 ## Glimmer Supporting Libraries
 
 Here is a list of notable 3rd party gems used by Glimmer:
-- [juwelier](https://rubygems.org/gems/juwelier): generates app gems during [Glimmer Scaffolding](#scaffolding)
+- [juwelier](https://rubygems.org/gems/juwelier): generates app gems during [Glimmer Scaffolding](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/docs/reference/GLIMMER_COMMAND.md#scaffolding)
 - [logging](https://github.com/TwP/logging): provides extra logging capabilities not available in Ruby Logger such as multi-threaded buffered asynchronous logging (to avoid affecting app performance) and support for multiple appenders such as stdout, syslog, and log files (the last one is needed on Windows where syslog is not supported)
 - [nested_inherited_jruby_include_package](https://github.com/AndyObtiva/nested_inherited_jruby_include_package): makes included [SWT](https://www.eclipse.org/swt/)/[Java](https://www.java.com/en/) packages available to all classes/modules that mix in the Glimmer module without having to manually reimport
 - [os](https://github.com/rdp/os): provides OS detection capabilities (e.g. `OS.mac?` or `OS.windows?`) to write cross-platform code inexpensively

data/VERSION

@@ -1 +1 @@
-4.18.4.8
+4.18.4.9

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -284,7 +284,7 @@ Shell widget proxy has extra methods specific to SWT Shell:
 - `#show`: Alias for `#open`
 - `#hide`: Hides a shell setting "visible" property to false
 - `#close`: Closes the shell
-- `#center`: Centers the shell within monitor it is in
+- `#center_within_display`: Centers the shell within monitor it is in
 - `#start_event_loop`: (happens as part of `#open`) Starts SWT Event Loop (you may learn more about it here: https://help.eclipse.org/2019-12/nftopic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/widgets/Display.html). This method is not needed except in rare circumstances where there is a need to start the SWT Event Loop before opening the shell.
 - `#visible?`: Returns whether a shell is visible
 - `#opened_before?`: Returns whether a shell has been opened at least once before (additionally implying the SWT Event Loop has been started already)
@@ -800,7 +800,7 @@ You may check out a more full-fledged example in [Hello, Sash Form!](#hello-sash
 
 ![Hello Browser](/images/glimmer-hello-browser.png)
 
-Glimmer supports the SWT Browser widget, which can load URLs or render HTML. It can even be instrumented with JavaScript when needed (though highly discouraged since it defeats the purpose of using Ruby except in very rare cases like leveraging a pre-existing web codebase in a desktop app).
+Glimmer supports the [SWT Browser widget](https://help.eclipse.org/2020-12/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/browser/Browser.html), which can load URLs or render HTML. It can even be instrumented with JavaScript when needed (though highly discouraged since it defeats the purpose of using Ruby except in very rare cases like leveraging a pre-existing web codebase in a desktop app).
 
 Example loading a URL (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
 
@@ -834,6 +834,8 @@ shell {
 }.open
 ```
 
+Learn more at the [SWT Browser widget](https://help.eclipse.org/2020-12/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/browser/Browser.html) API.
+
 ### Widget Styles
 
 SWT widgets receive `SWT` styles in their constructor as per this guide:
@@ -1471,11 +1473,10 @@ Example (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
 include Glimmer
 
 @the_image = image(250, 250)
-gc = org.eclipse.swt.graphics.GC.new(@the_image)
 250.times {|y|
   250.times {|x|
-    gc.foreground = Color.new(y%255, x%255, (x+y)%255)
-    gc.draw_point(x, y)
+    @the_image.gc.foreground = Color.new(y%255, x%255, (x+y)%255)
+    @the_image.gc.draw_point(x, y)
   }
 }
 

data/docs/reference/GLIMMER_SAMPLES.md

@@ -1,6 +1,55 @@
 ## Samples
 
-Check the [samples](samples) 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` gem first and then use the `glimmer samples` command to run it (alternatively, you may clone the repo, follow [CONTRIBUTING.md](CONTRIBUTING.md) instructions, and run samples locally with development glimmer command: `bin/glimmer`).
+- [Samples](#samples)
+  - [Hello Samples](#hello-samples)
+    - [Hello, World!](#hello-world)
+    - [Hello, Tab!](#hello-tab)
+    - [Hello, Combo!](#hello-combo)
+    - [Hello, List Single Selection!](#hello-list-single-selection)
+    - [Hello, List Multi Selection!](#hello-list-multi-selection)
+    - [Hello, Computed!](#hello-computed)
+    - [Hello, Message Box!](#hello-message-box)
+    - [Hello, Browser!](#hello-browser)
+    - [Hello, Drag and Drop!](#hello-drag-and-drop)
+    - [Hello, Menu Bar!](#hello-menu-bar)
+    - [Hello, Pop Up Context Menu!](#hello-pop-up-context-menu)
+    - [Hello, Custom Widget!](#hello-custom-widget)
+    - [Hello, Custom Shell!](#hello-custom-shell)
+    - [Hello, Sash Form!](#hello-sash-form)
+    - [Hello, Styled Text!](#hello-styled-text)
+    - [Hello, Expand Bar!](#hello-expand-bar)
+    - [Hello, Radio!](#hello-radio)
+    - [Hello, Radio Group!](#hello-radio-group)
+    - [Hello, Group!](#hello-group)
+    - [Hello, Checkbox!](#hello-checkbox)
+    - [Hello, Checkbox Group!](#hello-checkbox-group)
+    - [Hello, Directory Dialog!](#hello-directory-dialog)
+    - [Hello, File Dialog!](#hello-file-dialog)
+    - [Hello, Date Time!](#hello-date-time)
+    - [Hello, Spinner!](#hello-spinner)
+    - [Hello, Table!](#hello-table)
+    - [Hello, Button!](#hello-button)
+    - [Hello, Link!](#hello-link)
+    - [Hello, Dialog!](#hello-dialog)
+    - [Hello, Code Text!](#hello-code-text)
+    - [Hello, Canvas!](#hello-canvas)
+    - [Hello, Canvas Animation!](#hello-canvas-animation)
+    - [Hello, Canvas Transform!](#hello-canvas-transform)
+    - [Hello, Cursor!](#hello-cursor)
+  - [Elaborate Samples](#elaborate-samples)
+    - [User Profile](#user-profile)
+    - [Login](#login)
+    - [Tic Tac Toe](#tic-tac-toe)
+    - [Contact Manager](#contact-manager)
+    - [Glimmer Tetris](#glimmer-tetris)
+    - [Mandelbrot Fractal](#mandelbrot-fractal)
+  - [External Samples](#external-samples)
+    - [Glimmer Calculator](#glimmer-calculator)
+    - [Gladiator](#gladiator)
+    - [Timer](#timer)
+- [License](#license)
+
+Check the [samples](/samples) 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` gem first and then use the `glimmer samples` command to run it (alternatively, you may clone the repo, follow [CONTRIBUTING.md](CONTRIBUTING.md) instructions, and run samples locally with development glimmer command: `bin/glimmer`).
 
 You may run any sample via this command:
 
@@ -8,7 +57,7 @@ You may run any sample via this command:
 glimmer samples
 ```
 
-This brings up the [Glimmer Meta-Sample (The Sample of Samples)](samples/elaborate/meta_sample.rb)
+This brings up the [Glimmer Meta-Sample (The Sample of Samples)](/samples/elaborate/meta_sample.rb)
 
 ![Glimmer Meta-Sample](/images/glimmer-meta-sample.png)
 
@@ -28,7 +77,7 @@ For hello-type simple samples, check the following.
 
 Code:
 
-[samples/hello/hello_world.rb](samples/hello/hello_world.rb)
+[samples/hello/hello_world.rb](/samples/hello/hello_world.rb)
 
 ![Hello World](/images/glimmer-hello-world.png)
 
@@ -36,7 +85,7 @@ Code:
 
 Code:
 
-[samples/hello/hello_tab.rb](samples/hello/hello_tab.rb)
+[samples/hello/hello_tab.rb](/samples/hello/hello_tab.rb)
 
 ![Hello Tab English](/images/glimmer-hello-tab-english.png)
 ![Hello Tab French](/images/glimmer-hello-tab-french.png)
@@ -47,7 +96,7 @@ This sample demonstrates combo data-binding.
 
 Code:
 
-[samples/hello/hello_combo.rb](samples/hello/hello_combo.rb)
+[samples/hello/hello_combo.rb](/samples/hello/hello_combo.rb)
 
 ![Hello Combo](/images/glimmer-hello-combo.png)
 ![Hello Combo Expanded](/images/glimmer-hello-combo-expanded.png)
@@ -58,7 +107,7 @@ This sample demonstrates list single-selection data-binding.
 
 Code:
 
-[samples/hello/hello_list_single_selection.rb](samples/hello/hello_list_single_selection.rb)
+[samples/hello/hello_list_single_selection.rb](/samples/hello/hello_list_single_selection.rb)
 
 ![Hello List Single Selection](/images/glimmer-hello-list-single-selection.png)
 
@@ -68,7 +117,7 @@ This sample demonstrates list multi-selection data-binding.
 
 Code:
 
-[samples/hello/hello_list_multi_selection.rb](samples/hello/hello_list_multi_selection.rb)
+[samples/hello/hello_list_multi_selection.rb](/samples/hello/hello_list_multi_selection.rb)
 
 ![Hello List Multi Selection](/images/glimmer-hello-list-multi-selection.png)
 
@@ -78,7 +127,7 @@ This sample demonstrates computed data-binding.
 
 Code:
 
-[samples/hello/hello_computed.rb](samples/hello/hello_computed.rb)
+[samples/hello/hello_computed.rb](/samples/hello/hello_computed.rb)
 
 ![Hello Browser](/images/glimmer-hello-computed.png)
 
@@ -88,7 +137,7 @@ This sample demonstrates a `message_box` dialog.
 
 Code:
 
-[samples/hello/hello_message_box.rb](samples/hello/hello_message_box.rb)
+[samples/hello/hello_message_box.rb](/samples/hello/hello_message_box.rb)
 
 ![Hello Message Box](/images/glimmer-hello-message-box.png)
 ![Hello Message Box Dialog](/images/glimmer-hello-message-box-dialog.png)
@@ -99,7 +148,7 @@ This sample demonstrates the `browser` widget.
 
 Code:
 
-[samples/hello/hello_browser.rb](samples/hello/hello_browser.rb)
+[samples/hello/hello_browser.rb](/samples/hello/hello_browser.rb)
 
 ![Hello Browser](/images/glimmer-hello-browser.png)
 
@@ -109,7 +158,7 @@ This sample demonstrates drag and drop in Glimmer.
 
 Code:
 
-[samples/hello/hello_drag_and_drop.rb](samples/hello/hello_drag_and_drop.rb)
+[samples/hello/hello_drag_and_drop.rb](/samples/hello/hello_drag_and_drop.rb)
 
 ![Hello Drag and Drop](/images/glimmer-hello-drag-and-drop.gif)
 
@@ -119,7 +168,7 @@ This sample demonstrates menus in Glimmer, including accelerators on the Mac.
 
 Code:
 
-[samples/hello/hello_menu_bar.rb](samples/hello/hello_menu_bar.rb)
+[samples/hello/hello_menu_bar.rb](/samples/hello/hello_menu_bar.rb)
 
 ![Hello Menu Bar](/images/glimmer-hello-menu-bar.png)
 
@@ -163,7 +212,7 @@ This sample demonstrates pop up context menus in Glimmer.
 
 Code:
 
-[samples/hello/hello_pop_up_context_menu.rb](samples/hello/hello_pop_up_context_menu.rb)
+[samples/hello/hello_pop_up_context_menu.rb](/samples/hello/hello_pop_up_context_menu.rb)
 
 ![Hello Pop Up Context Menu](/images/glimmer-hello-pop-up-context-menu.png)
 ![Hello Pop Up Context Menu Popped Up](/images/glimmer-hello-pop-up-context-menu-popped-up.png)
@@ -174,7 +223,7 @@ This sample demonstrates the use of a custom widget in Glimmer.
 
 Code:
 
-[samples/hello/hello_custom_widget.rb](samples/hello/hello_custom_widget.rb)
+[samples/hello/hello_custom_widget.rb](/samples/hello/hello_custom_widget.rb)
 
 ![Hello Custom Widget](/images/glimmer-hello-custom-widget.gif)
 
@@ -184,7 +233,7 @@ This sample demonstrates the use of a custom shell (aka custom window) in Glimme
 
 Code:
 
-[samples/hello/hello_custom_shell.rb](samples/hello/hello_custom_shell.rb)
+[samples/hello/hello_custom_shell.rb](/samples/hello/hello_custom_shell.rb)
 
 ![Hello Custom Shell](/images/glimmer-hello-custom-shell.png)
 ![Hello Custom Shell Email1](/images/glimmer-hello-custom-shell-email1.png)
@@ -197,7 +246,7 @@ This sample demonstrates the use of a `sash_form` in Glimmer.
 
 Code:
 
-[samples/hello/hello_sash_form.rb](samples/hello/hello_sash_form.rb)
+[samples/hello/hello_sash_form.rb](/samples/hello/hello_sash_form.rb)
 
 Hello, Sash Form! Horizontal Orientation
 
@@ -229,7 +278,7 @@ This sample demonstrates the use of a `styled_text` in Glimmer.
 
 Code:
 
-[samples/hello/hello_styled_text.rb](samples/hello/hello_styled_text.rb)
+[samples/hello/hello_styled_text.rb](/samples/hello/hello_styled_text.rb)
 
 Hello, Styled Text!
 
@@ -241,7 +290,7 @@ This sample demonstrates the use of a `expand_bar` and `expand_item` in Glimmer.
 
 Code:
 
-[samples/hello/hello_expand_bar.rb](samples/hello/hello_expand_bar.rb)
+[samples/hello/hello_expand_bar.rb](/samples/hello/hello_expand_bar.rb)
 
 Hello, Expand Bar! All Expanded
 
@@ -265,7 +314,7 @@ This sample demonstrates the use of a `radio` (aka `button(:radio)`) in Glimmer.
 
 Code:
 
-[samples/hello/hello_radio.rb](samples/hello/hello_radio.rb)
+[samples/hello/hello_radio.rb](/samples/hello/hello_radio.rb)
 
 Hello, Radio!
 
@@ -277,7 +326,7 @@ This sample demonstrates the use of a `radio_group` in Glimmer, which provides t
 
 Code:
 
-[samples/hello/hello_radio_group.rb](samples/hello/hello_radio_group.rb)
+[samples/hello/hello_radio_group.rb](/samples/hello/hello_radio_group.rb)
 
 Hello, Radio Group!
 
@@ -289,7 +338,7 @@ This sample demonstrates the use of a `group` in Glimmer (not to be confused wit
 
 Code:
 
-[samples/hello/hello_group.rb](samples/hello/hello_group.rb)
+[samples/hello/hello_group.rb](/samples/hello/hello_group.rb)
 
 Hello, Group!
 
@@ -301,7 +350,7 @@ This sample demonstrates the use of a `checkbox` (aka `check` or `button(:check)
 
 Code:
 
-[samples/hello/hello_checkbox.rb](samples/hello/hello_checkbox.rb)
+[samples/hello/hello_checkbox.rb](/samples/hello/hello_checkbox.rb)
 
 Hello, Checkbox!
 
@@ -313,7 +362,7 @@ This sample demonstrates the use of a `checkbox_group` (aka `check_group`) in Gl
 
 Code:
 
-[samples/hello/hello_checkbox_group.rb](samples/hello/hello_checkbox_group.rb)
+[samples/hello/hello_checkbox_group.rb](/samples/hello/hello_checkbox_group.rb)
 
 Hello, Checkbox Group!
 
@@ -325,7 +374,7 @@ This sample demonstrates the use of a `directory_dialog` in Glimmer.
 
 Code:
 
-[samples/hello/hello_directory_dialog.rb](samples/hello/hello_directory_dialog.rb)
+[samples/hello/hello_directory_dialog.rb](/samples/hello/hello_directory_dialog.rb)
 
 Hello, Directory Dialog!
 
@@ -345,7 +394,7 @@ This sample demonstrates the use of a `file_dialog` in Glimmer.
 
 Code:
 
-[samples/hello/hello_file_dialog.rb](samples/hello/hello_file_dialog.rb)
+[samples/hello/hello_file_dialog.rb](/samples/hello/hello_file_dialog.rb)
 
 Hello, File Dialog!
 
@@ -365,7 +414,7 @@ This sample demonstrates the use of [date_time](#datetime) widget keywords in Gl
 
 Code:
 
-[samples/hello/hello_date_time.rb](samples/hello/hello_date_time.rb)
+[samples/hello/hello_date_time.rb](/samples/hello/hello_date_time.rb)
 
 Hello, Date Time!
 
@@ -377,7 +426,7 @@ This sample demonstrates the use of `spinner` widget in Glimmer
 
 Code:
 
-[samples/hello/hello_spinner.rb](samples/hello/hello_spinner.rb)
+[samples/hello/hello_spinner.rb](/samples/hello/hello_spinner.rb)
 
 Hello, Spinner!
 
@@ -389,7 +438,7 @@ This sample demonstrates the use of [table](#table) widget in Glimmer, including
 
 Code:
 
-[samples/hello/hello_table.rb](samples/hello/hello_table.rb)
+[samples/hello/hello_table.rb](/samples/hello/hello_table.rb)
 
 Hello, Table!
 
@@ -437,7 +486,7 @@ This sample demonstrates the use of the `button` widget in Glimmer, including da
 
 Code:
 
-[samples/hello/hello_button.rb](samples/hello/hello_button.rb)
+[samples/hello/hello_button.rb](/samples/hello/hello_button.rb)
 
 Hello, Button!
 
@@ -453,7 +502,7 @@ This sample demonstrates the use of the `link` widget in Glimmer, including iden
 
 Code:
 
-[samples/hello/hello_link.rb](samples/hello/hello_link.rb)
+[samples/hello/hello_link.rb](/samples/hello/hello_link.rb)
 
 Hello, Link!
 
@@ -469,7 +518,7 @@ This sample demonstrates the use of the `dialog` widget in Glimmer, which provid
 
 Code:
 
-[samples/hello/hello_dialog.rb](samples/hello/hello_dialog.rb)
+[samples/hello/hello_dialog.rb](/samples/hello/hello_dialog.rb)
 
 Hello, Dialog!
 
@@ -485,7 +534,7 @@ This sample demonstrates the Glimmer Built-In [Code Text Custom Widget](#code-te
 
 Code:
 
-[samples/hello/hello_code_text.rb](samples/hello/hello_code_text.rb)
+[samples/hello/hello_code_text.rb](/samples/hello/hello_code_text.rb)
 
 Hello, Code Text! Ruby Language / Glimmer Theme / Show Line Numbers (default width of 4)
 
@@ -505,7 +554,7 @@ This sample demonstrates the use of the `canvas` widget and [Shape DSL](#canvas-
 
 Code:
 
-[samples/hello/hello_canvas.rb](samples/hello/hello_canvas.rb)
+[samples/hello/hello_canvas.rb](/samples/hello/hello_canvas.rb)
 
 Hello, Canvas!
 
@@ -517,7 +566,7 @@ This sample demonstrates the use of the `canvas` widget and [Animation DSL](#can
 
 Code:
 
-[samples/hello/hello_canvas_animation.rb](samples/hello/hello_canvas_animation.rb)
+[samples/hello/hello_canvas_animation.rb](/samples/hello/hello_canvas_animation.rb)
 
 Hello, Canvas Animation!
 
@@ -533,12 +582,24 @@ This sample demonstrates the use of the `transform` keyword as part of the [Tran
 
 Code:
 
-[samples/hello/hello_canvas_transform.rb](samples/hello/hello_canvas_transform.rb)
+[samples/hello/hello_canvas_transform.rb](/samples/hello/hello_canvas_transform.rb)
 
 Hello, Canvas Transform!
 
 ![Hello Canvas Transform](/images/glimmer-hello-canvas-transform.png)
 
+#### Hello, Cursor!
+
+This sample demonstrates the use of the `cursor` property keyword to change the mouse cursor.
+
+Code:
+
+[samples/hello/hello_cursor.rb](/samples/hello/hello_cursor.rb)
+
+Hello, Cursor!
+
+![Hello Cursor](/images/glimmer-hello-cursor.gif)
+
 
 ### Elaborate Samples
 
@@ -552,7 +613,7 @@ Please note that the code has changed since that article was written (the GUI DS
 
 Code:
 
-[samples/elaborate/user_profile.rb](samples/elaborate/user_profile.rb)
+[samples/elaborate/user_profile.rb](/samples/elaborate/user_profile.rb)
 
 ![User Profile](/images/glimmer-user-profile.png)
 
@@ -562,7 +623,7 @@ This sample demonstrates basic data-binding, password and text fields, and field
 
 Code:
 
-[samples/elaborate/login.rb](samples/elaborate/login.rb)
+[samples/elaborate/login.rb](/samples/elaborate/login.rb)
 
 ![Login](/images/glimmer-login.png)
 ![Login Filled In](/images/glimmer-login-filled-in.png)
@@ -576,7 +637,7 @@ Code:
 
 (Please note that on some Linux instances where the display x-axis is set to double-scale, you need to set the `shell` `minimum_size` to `300, 178` instead of `150, 178`)
 
-[samples/elaborate/tic_tac_toe.rb](samples/elaborate/tic_tac_toe.rb)
+[samples/elaborate/tic_tac_toe.rb](/samples/elaborate/tic_tac_toe.rb)
 
 ![Tic Tac Toe](/images/glimmer-tic-tac-toe.png)
 ![Tic Tac Toe In Progress](/images/glimmer-tic-tac-toe-in-progress.png)
@@ -588,7 +649,7 @@ This sample demonstrates table data-binding, sorting, filtering, GUI layout, MVP
 
 Code:
 
-[samples/elaborate/contact_manager.rb](samples/elaborate/contact_manager.rb)
+[samples/elaborate/contact_manager.rb](/samples/elaborate/contact_manager.rb)
 
 Contact Manager
 
@@ -618,7 +679,7 @@ Note that it works optimally on the Mac. It is very new, so it has not been opti
 
 Code:
 
-[samples/elaborate/tetris.rb](samples/elaborate/tetris.rb)
+[samples/elaborate/tetris.rb](/samples/elaborate/tetris.rb)
 
 ![Tetris Icon](/images/glimmer-tetris-icon.png)
 
@@ -638,6 +699,24 @@ Code:
 
 ![Tetris Help Menu](/images/glimmer-tetris-help-menu.png)
 
+#### Mandelbrot Fractal
+
+This sample demonstrates how to render canvas graphics with multi-threaded processing taking advantage of all CPU cores and doing background processing of images.
+
+It renders the famous Mandelbrot Fractal, enabling zooming and panning (go to Help -> Instructions for more details)
+
+The Mandelbrot Fractal is known to take a long time to render, but thanks to multi-core processing, the app starts in about 10 seconds (runs faster the more cores you have)
+
+Code:
+
+[samples/elaborate/mandelbrot_fractal.rb](/samples/elaborate/mandelbrot_fractal.rb)
+
+![Mandelbrot Fractal Zoom 1](/images/glimmer-mandelbrot-zoom1.png)
+
+![Mandelbrot Fractal Zoom 3](/images/glimmer-mandelbrot-zoom3.png)
+
+![Mandelbrot Fractal Zoom 5](/images/glimmer-mandelbrot-zoom5.png)
+
 ### External Samples
 
 #### Glimmer Calculator
@@ -648,7 +727,7 @@ Code:
 
 #### Gladiator
 
-[<img src='https://raw.githubusercontent.com/AndyObtiva/glimmer-cs-gladiator/master/images/glimmer-cs-gladiator-logo.svg' height=40 /> Gladiator](https://github.com/AndyObtiva/glimmer-cs-gladiator) (short for Glimmer Editor) is a Glimmer sample project under on-going development.
+[<img src='https://raw.githubusercontent.com/AndyObtiva/glimmer-cs-gladiator/master/images/glimmer-cs-gladiator-logo.png' height=40 /> Gladiator](https://github.com/AndyObtiva/glimmer-cs-gladiator) (short for Glimmer Editor) is a Glimmer sample project under on-going development.
 You may check it out to learn how to build a Glimmer Custom Shell gem.
 
 [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer-cs-gladiator/master/images/glimmer-gladiator.png" />](https://github.com/AndyObtiva/glimmer-cs-gladiator)

data/glimmer-dsl-swt.gemspec

@@ -2,22 +2,28 @@
 # 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.8 ruby lib
+# stub: glimmer-dsl-swt 4.18.4.9 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "glimmer-dsl-swt".freeze
-  s.version = "4.18.4.8"
+  s.version = "4.18.4.9"
 
   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-11"
+  s.date = "2021-02-16"
   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]
   s.extra_rdoc_files = [
-    "LICENSE.txt",
-    "README.md"
+    "README.md",
+    "docs/reference/GLIMMER_COMMAND.md",
+    "docs/reference/GLIMMER_CONFIGURATION.md",
+    "docs/reference/GLIMMER_GIRB.md",
+    "docs/reference/GLIMMER_GUI_DSL_SYNTAX.md",
+    "docs/reference/GLIMMER_PACKAGING_AND_DISTRIBUTION.md",
+    "docs/reference/GLIMMER_SAMPLES.md",
+    "docs/reference/GLIMMER_STYLE_GUIDE.md"
   ]
   s.files = [
     "CHANGELOG.md",
@@ -171,6 +177,7 @@ Gem::Specification.new do |s|
     "samples/hello/hello_combo.rb",
     "samples/hello/hello_computed.rb",
     "samples/hello/hello_computed/contact.rb",
+    "samples/hello/hello_cursor.rb",
     "samples/hello/hello_custom_shell.rb",
     "samples/hello/hello_custom_widget.rb",
     "samples/hello/hello_date_time.rb",

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

@@ -35,11 +35,12 @@ module Glimmer
         
         def can_interpret?(parent, keyword, *args, &block)
           (keyword == 'image') and
-            (parent.nil? or parent.respond_to?('image='))
+            (parent.nil? or parent.respond_to?('image=') or args.first.is_a?(Numeric))
         end
   
         def interpret(parent, keyword, *args, &block)
-          args.unshift(parent) unless parent.nil?
+          options = args.last.is_a?(Hash) ? args.last : {}
+          args.unshift(parent) unless parent.nil? || options[:top_level]
           Glimmer::SWT::ImageProxy.new(*args, &block)
         end
 

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

@@ -51,6 +51,7 @@ module Glimmer
           widget_binding.call(model_binding.evaluate_property)
           widget_binding.observe(model, model_binding.property_name_expression)
   
+          raise(Glimmer::Error, "No radios found! Make sure radio selection is data-bound to a property having property_options as non-empty array!") if parent.items.empty?
           parent.on_widget_selected do
             model_binding.call(widget_binding.evaluate_property)
           end

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

@@ -46,9 +46,9 @@ module Glimmer
           end
         end
         
-        def clear_shapes
+        def clear_shapes(dispose_images: true, dispose_patterns: true)
           # Optimize further by having a collection of disposable_shapes independent of shapes, which is much smaller and only has shapes that require disposal (shapes with patterns or image)
-          shapes.dup.each(&:dispose) if requires_shape_disposal?
+          shapes.dup.each {|s| s.dispose(dispose_images: dispose_images, dispose_patterns: dispose_patterns) } if requires_shape_disposal?
         end
         
         def deregister_shape_painting

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

@@ -73,7 +73,8 @@ module Glimmer
         end
         
         def can_handle_observation_request?(observation_request)
-          radios.first&.can_handle_observation_request?(observation_request) || super(observation_request)
+          radios.first&.can_handle_observation_request?(observation_request) or
+            super(observation_request)
         end
         
         def handle_observation_request(observation_request, &block)

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

@@ -263,16 +263,20 @@ module Glimmer
           the_pattern
         end
         
-        def dispose
-          @background_pattern&.dispose
-          @background_pattern = nil
-          @foreground_pattern&.dispose
-          @foreground_pattern = nil
-          @image&.dispose
-          @image = nil
+        def dispose(dispose_images: true, dispose_patterns: true)
+          if dispose_patterns
+            @background_pattern&.dispose
+            @background_pattern = nil
+            @foreground_pattern&.dispose
+            @foreground_pattern = nil
+          end
+          if dispose_images
+            @image&.dispose
+            @image = nil
+          end
           @parent.shapes.delete(self)
         end
-        
+                
         def paint(paint_event)
           calculate_paint_args!
           @properties.each do |property, args|

data/lib/glimmer/swt/image_proxy.rb

@@ -97,7 +97,7 @@ module Glimmer
         if shapes.any?
           setup_shape_painting
         end
-        if @parent.respond_to?('image=')
+        if @parent.respond_to?('image=') && !@parent.is_disposed
           @parent&.image = swt_image
         end
       end

data/lib/glimmer/swt/scrolled_composite_proxy.rb

@@ -1,5 +1,5 @@
 # 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
@@ -7,10 +7,10 @@
 # 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
@@ -24,14 +24,23 @@ require 'glimmer/swt/swt_proxy'
 
 module Glimmer
   module SWT
-    class ScrolledCompositeProxy < Glimmer::SWT::WidgetProxy    
+    class ScrolledCompositeProxy < Glimmer::SWT::WidgetProxy
       def post_initialize_child(child)
-        swt_widget.content = child.swt_widget        
+        swt_widget.content = child.swt_widget
+        # TODO consider triggering this method in the future upon resizing of content with a listener (on_control_resized)
+#         child.on_control_resized do
+#           swt_widget.set_min_size(swt_widget.computeSize(child.bounds.width, child.bounds.height))
+#         end
       end
       
       def post_add_content
+        calculate_min_size
+      end
+      
+      def calculate_min_size
         swt_widget.set_min_size(swt_widget.computeSize(SWTProxy[:default], SWTProxy[:default]))
-      end      
+      end
+      alias recalculate_min_size calculate_min_size
     end
   end
 end

data/lib/glimmer/swt/tab_item_proxy.rb

@@ -49,6 +49,7 @@ module Glimmer
         @widget_proxy = SWT::WidgetProxy.new('tab_item', parent, style)
         @swt_tab_item = @widget_proxy.swt_widget
         @swt_tab_item.control = swt_widget
+#         parent.pack # TODO auto fix the tab folder to avoid having to do this manually (including maintaining bounds and minimum size of shell)
       end
 
       def has_attribute?(attribute_name, *args)

data/lib/glimmer/swt/widget_proxy.rb

@@ -719,7 +719,13 @@ module Glimmer
       def add_listener(underscored_listener_name, &block)
         widget_add_listener_method, listener_class, listener_method = self.class.find_listener(@swt_widget.getClass, underscored_listener_name)
         widget_listener_proxy = nil
-        safe_block = lambda { |*args| block.call(*args) unless @swt_widget.isDisposed }
+        safe_block = lambda do |*args|
+          begin
+            block.call(*args) unless @swt_widget.isDisposed
+          rescue => e
+            Glimmer::Config.logger.error {e}
+          end
+        end
         listener = listener_class.new(listener_method => safe_block)
         @swt_widget.send(widget_add_listener_method, listener)
         WidgetListenerProxy.new(swt_widget: @swt_widget, swt_listener: listener, widget_add_listener_method: widget_add_listener_method, swt_listener_class: listener_class, swt_listener_method: listener_method)

data/samples/elaborate/mandelbrot_fractal.rb

@@ -23,35 +23,101 @@ require 'complex'
 require 'bigdecimal'
 require 'concurrent-ruby'
 
-# Mandelbrot implementation
-# Courtesy of open-source code at:
-# https://github.com/gotbadger/ruby-mandelbrot
+# Mandelbrot multi-threaded implementation leveraging all processor cores.
 class Mandelbrot
-
-  attr_accessor :max_iterations
-
-  def initialize(max_iterations)
+  DEFAULT_STEP = 0.0030
+  Y_START = -1.0
+  Y_END = 1.0
+  X_START = -2.0
+  X_END = 0.5
+  
+  class << self
+    def for(max_iterations:, zoom:, background: false)
+      key = [max_iterations, zoom]
+      creation_mutex.synchronize do
+        unless flyweight_mandelbrots.keys.include?(key)
+          flyweight_mandelbrots[key] = new(max_iterations: max_iterations, zoom: zoom, background: background)
+        end
+      end
+      flyweight_mandelbrots[key].background = background
+      flyweight_mandelbrots[key]
+    end
+    
+    def flyweight_mandelbrots
+      @flyweight_mandelbrots ||= {}
+    end
+    
+    def creation_mutex
+      @creation_mutex ||= Mutex.new
+    end
+  end
+  
+  attr_accessor :max_iterations, :background
+  attr_reader :zoom, :points_calculated
+  alias points_calculated? points_calculated
+  
+  # max_iterations is the maximum number of Mandelbrot calculation iterations
+  # zoom is how much zoom there is on the Mandelbrot points from the default view of zoom 1
+  # background indicates whether to do calculation in the background for caching purposes,
+  # thus utilizing less CPU cores to avoid disrupting user experience
+  def initialize(max_iterations:, zoom: 1.0, background: false)
     @max_iterations = max_iterations
+    @zoom = zoom
+    @background = background
+  end
+  
+  def step
+    DEFAULT_STEP / zoom
+  end
+    
+  def y_array
+    @y_array ||= Y_START.step(Y_END, step).to_a
+  end
+  
+  def x_array
+    @x_array ||= X_START.step(X_END, step).to_a
   end
   
-  def calculate_all(x_array, y_array)
-    thread_pool = Concurrent::FixedThreadPool.new(Concurrent.processor_count)
-    width = x_array.size
-    height = y_array.size
-    pixel_rows_array = Concurrent::Array.new(height)
+  def height
+    y_array.size
+  end
+  
+  def width
+    x_array.size
+  end
+  
+  def points
+    @points ||= calculate_points
+  end
+  
+  def thread_count
+    @background ? [Concurrent.processor_count - 1, 1].max : Concurrent.processor_count
+  end
+  
+  def calculate_points
+    puts "Background calculation activated at zoom #{zoom}" if @background
+    if @points_calculated
+      puts "Points calculated already. Returning previously calculated points..."
+      return @points
+    end
+    thread_pool = Concurrent::FixedThreadPool.new(thread_count, fallback_policy: :discard)
+    @points = Concurrent::Array.new(height)
     height.times do |y|
-      pixel_rows_array[y] ||= Concurrent::Array.new(width)
+      @points[y] ||= Concurrent::Array.new(width)
       width.times do |x|
         thread_pool.post do
-          pixel_rows_array[y][x] = calculate(x_array[x], y_array[y]).last
+          @points[y][x] = calculate(x_array[x], y_array[y]).last
         end
       end
     end
     thread_pool.shutdown
     thread_pool.wait_for_termination
-    pixel_rows_array
+    @points_calculated = true
+    @points
   end
-
+  
+  # Calculates a Mandelbrot point, borrowing some open-source code from:
+  # https://github.com/gotbadger/ruby-mandelbrot
   def calculate(x,y)
     base_case = [Complex(x,y), 0]
     Array.new(max_iterations, base_case).inject(base_case) do |prev ,base|
@@ -67,37 +133,222 @@ end
 class MandelbrotFractal
   include Glimmer::UI::CustomShell
   
+  COMMAND = OS.mac? ? :command : :ctrl
+    
+  option :zoom, default: 1.0
+  
   before_body {
-    @colors = [[0, 0, 0]] + 40.times.map { |i| [255 - i*5, 255 - i*5, 55 + i*5] }
-    @colors = @colors.map {|color_data| rgb(*color_data).swt_color}
-    mandelbrot = Mandelbrot.new(@colors.size - 1)
-    @y_array = (1.0).step(-1,-0.0030).to_a
-    @x_array = (-2.0).step(0.5,0.0030).to_a
-    @height = @y_array.size
-    @width = @x_array.size
-    @pixel_rows_array = mandelbrot.calculate_all(@x_array, @y_array)
-    @image = Image.new(display.swt_display, @width, @height)
-    image_gc = org.eclipse.swt.graphics.GC.new(@image)
-    @height.times { |y|
-      @width.times { |x|
-        new_foreground = @colors[@pixel_rows_array[y][x]]
-        image_gc.foreground = @current_foreground = new_foreground unless new_foreground == @current_foreground
-        image_gc.draw_point x, y
+    Display.app_name = 'Mandelbrot Fractal'
+    # pre-calculate mandelbrot image
+    @mandelbrot_image = build_mandelbrot_image
+  }
+  
+  after_body {
+    # pre-calculate zoomed mandelbrot images even before the user zooms in
+    puts 'Starting background calculation thread...'
+    Thread.new {
+      future_zoom = 1.5
+      loop {
+        puts "Creating mandelbrot for background calculation at zoom: #{future_zoom}"
+        the_mandelbrot = Mandelbrot.for(max_iterations: color_palette.size - 1, zoom: future_zoom, background: true)
+        pixels = the_mandelbrot.calculate_points
+        build_mandelbrot_image(mandelbrot_zoom: future_zoom)
+        sync_exec {
+          swt_widget.text = mandelbrot_shell_title
+          @canvas.cursor = :cross
+        }
+        future_zoom += 0.5
       }
     }
   }
-
+  
   body {
-    shell {
-      text 'Mandelbrot Fractal'
-      minimum_size @width, @height + 12
-      image @image
+    shell(:no_resize) {
+      text mandelbrot_shell_title
+      minimum_size mandelbrot.width, mandelbrot.height + 30
+      image @mandelbrot_image
+      
+      @scrolled_composite = scrolled_composite {
+        @canvas = canvas {
+          image @mandelbrot_image
+          cursor :no
+          
+          on_mouse_down {
+            @drag_detected = false
+            @canvas.cursor = :hand
+          }
+          
+          on_drag_detected { |drag_detect_event|
+            @drag_detected = true
+            @drag_start_x = drag_detect_event.x
+            @drag_start_y = drag_detect_event.y
+          }
+          
+          on_mouse_move { |mouse_event|
+            if @drag_detected
+              origin = @scrolled_composite.origin
+              new_x = origin.x - (mouse_event.x - @drag_start_x)
+              new_y = origin.y - (mouse_event.y - @drag_start_y)
+              @scrolled_composite.set_origin(new_x, new_y)
+            end
+          }
+          
+          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
+              if mouse_event.button == 1
+                zoom_in
+              elsif mouse_event.button > 2
+                zoom_out
+              end
+            end
+            @canvas.cursor = can_zoom_in? ? :cross : :no
+            @drag_detected = false
+          }
+          
+        }
+      }
       
-      canvas {
-        image @image
+      menu_bar {
+        menu {
+          text '&View'
+          
+          menu_item {
+            text 'Zoom &In'
+            accelerator COMMAND, '+'
+            
+            on_widget_selected { zoom_in }
+          }
+          
+          menu_item {
+            text 'Zoom &Out'
+            accelerator COMMAND, '-'
+            
+            on_widget_selected { zoom_out }
+          }
+          
+          menu_item {
+            text '&Reset Zoom'
+            accelerator COMMAND, '0'
+            
+            on_widget_selected { perform_zoom(mandelbrot_zoom: 1.0) }
+          }
+        }
+        menu {
+          text '&Help'
+          
+          menu_item {
+            text '&Instructions'
+            accelerator COMMAND, :shift, :i
+            
+            on_widget_selected {
+              display_help_instructions
+            }
+          }
+        }
       }
     }
   }
+  
+  def mandelbrot_shell_title
+    "Mandelbrot Fractal - Zoom #{zoom}x (Calculated Max: #{flyweight_mandelbrot_images.keys.max}x)"
+  end
+  
+  def build_mandelbrot_image(mandelbrot_zoom: nil)
+    mandelbrot_zoom ||= zoom
+    unless flyweight_mandelbrot_images.keys.include?(mandelbrot_zoom)
+      the_mandelbrot = mandelbrot(mandelbrot_zoom: mandelbrot_zoom)
+      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
+      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
+        }
+      }
+      flyweight_mandelbrot_images[mandelbrot_zoom] = new_mandelbrot_image
+    end
+    flyweight_mandelbrot_images[mandelbrot_zoom]
+  end
+  
+  def flyweight_mandelbrot_images
+    @flyweight_mandelbrot_images ||= {}
+  end
+  
+  def mandelbrot(mandelbrot_zoom: nil)
+    mandelbrot_zoom ||= zoom
+    Mandelbrot.for(max_iterations: color_palette.size - 1, zoom: mandelbrot_zoom)
+  end
+  
+  def color_palette
+    if @color_palette.nil?
+      @color_palette = [[0, 0, 0]] + 40.times.map { |i| [255 - i*5, 255 - i*5, 55 + i*5] }
+      @color_palette = @color_palette.map {|color_data| rgb(*color_data).swt_color}
+    end
+    @color_palette
+  end
+    
+  def zoom_in
+    if can_zoom_in?
+      perform_zoom(zoom_delta: 0.5)
+      @canvas.cursor = can_zoom_in? ? :cross : :no
+    end
+  end
+  
+  def can_zoom_in?
+    flyweight_mandelbrot_images.keys.include?(zoom + 0.5)
+  end
+  
+  def zoom_out
+    perform_zoom(zoom_delta: -0.5)
+  end
+  
+  def perform_zoom(zoom_delta: 0, mandelbrot_zoom: nil)
+    mandelbrot_zoom ||= self.zoom + zoom_delta
+    @canvas.cursor = :wait
+    last_zoom = self.zoom
+    self.zoom = [mandelbrot_zoom, 1.0].max
+    @canvas.clear_shapes(dispose_images: false)
+    @mandelbrot_image = build_mandelbrot_image
+    body_root.content {
+      image @mandelbrot_image
+    }
+    @canvas.content {
+      image @mandelbrot_image
+    }
+    @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
+      factor = (zoom / last_zoom)
+      @scrolled_composite.set_origin(factor*@location_x, factor*@location_y)
+      @location_x = @location_y = nil
+    end
+    @canvas.cursor = :cross
+    swt_widget.text = mandelbrot_shell_title
+  end
+  
+  def display_help_instructions
+    message_box(body_root) {
+      text 'Mandelbrot Fractal - Help'
+      message <<~MULTI_LINE_STRING
+        The Mandelbrot Fractal precalculates zoomed renderings in the background. Wait if you hit a zoom level that is not calculated yet.
+
+        Left-click to zoom in.
+        Right-click to zoom out.
+        Scroll or drag to pan.
+        
+        Enjoy!
+      MULTI_LINE_STRING
+    }.open
+  end
+    
 end
 
 MandelbrotFractal.launch

data/samples/hello/hello_cursor.rb

@@ -0,0 +1,57 @@
+# 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.
+
+class HelloCursor
+  include Glimmer::UI::CustomShell
+  
+  attr_accessor :selected_cursor
+  
+  def selected_cursor_options
+    org.eclipse.swt.SWT.constants.select {|c| c.to_s.start_with?('CURSOR_')}.map {|c| c.to_s.sub('CURSOR_', '').downcase}
+  end
+  
+  after_body {
+    observe(self, :selected_cursor) {
+      body_root.cursor = selected_cursor
+    }
+  }
+  
+  body {
+    shell {
+      grid_layout
+      
+      text 'Hello, Cursor!'
+      cursor :wait
+      
+      label {
+        text 'Please select a cursor style and see it change the mouse cursor (varies per platform):'
+        font style: :bold
+        cursor :no
+      }
+      radio_group {
+        grid_layout 5, true
+        selection bind(self, :selected_cursor)
+      }
+    }
+  }
+end
+
+HelloCursor.launch

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-swt
 version: !ruby/object:Gem::Version
-  version: 4.18.4.8
+  version: 4.18.4.9
 platform: ruby
 authors:
 - AndyMaleh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-02-11 00:00:00.000000000 Z
+date: 2021-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -350,8 +350,14 @@ executables:
 - girb
 extensions: []
 extra_rdoc_files:
-- LICENSE.txt
 - README.md
+- docs/reference/GLIMMER_COMMAND.md
+- docs/reference/GLIMMER_CONFIGURATION.md
+- docs/reference/GLIMMER_GIRB.md
+- docs/reference/GLIMMER_GUI_DSL_SYNTAX.md
+- docs/reference/GLIMMER_PACKAGING_AND_DISTRIBUTION.md
+- docs/reference/GLIMMER_SAMPLES.md
+- docs/reference/GLIMMER_STYLE_GUIDE.md
 files:
 - CHANGELOG.md
 - LICENSE.txt
@@ -504,6 +510,7 @@ files:
 - samples/hello/hello_combo.rb
 - samples/hello/hello_computed.rb
 - samples/hello/hello_computed/contact.rb
+- samples/hello/hello_cursor.rb
 - samples/hello/hello_custom_shell.rb
 - samples/hello/hello_custom_widget.rb
 - samples/hello/hello_date_time.rb