glimmer-dsl-swt 4.18.5.5 → 4.18.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8fb342869be74c6e592466ad89d26798dde5cf8f3d6beb52b5bcf6a6e8f221f6
-  data.tar.gz: c75442b7c5aeac5d77878d52e969669ea677877c12a43c97081155c5412c9c4c
+  metadata.gz: 3b4bc038d1fcf459041884946826daa84949318cd2d588f30bbc91ce9cc343f3
+  data.tar.gz: 143c076d20310e24ca2a6bd5db70f7bd87bd7c7b171a501c23874cdfd1a989f8
 SHA512:
-  metadata.gz: d3e484674be4fa02ea232e1452a80c4fbb2f141bee407ef6ce922dd0f1e3616f6ee420fc57fdd3d9af6c9d993a88705d95e62d9a5573273e63638a5876bf53d9
-  data.tar.gz: 6a76ebd41db15abe32ae22b2c675199595e196251b03a84ddad99a3aa2b254b43b8e50e339579764de667e10e3673814fb4ab3886aa9f27a9f8c43a7ca16bdcd
+  metadata.gz: ae508739a7a491f83853d67867b0c1600323216615909a1cca6aac4b2f373d5d74cad21c6dd08275ed83bc4e537e4b13ef357fdda436cbc6966dec821a3aade7
+  data.tar.gz: 7c8110b246fbc0ee40d99fd930be19d782e75846ada53ad2fe09c742cec5bf2de36f59ccbabd4600d81bc6ac4b7183fae397c6590bce2fd8377d7ca38c89e3f1

data/CHANGELOG.md

@@ -1,5 +1,47 @@
 # Change Log
 
+### 4.18.7.0
+
+- Support direct use of the `shape` keyword as a shape composite that could contain other shapes and shares common attributes (e.g. background color) with all of them
+- Hello, Shape! Sample (implements a method-based custom shape containing other nested shapes)
+- Support custom shapes via including the Glimmer::UI::CustomShape module to add new shape keywords to the Glimmer GUI DSL / Canvas Shape DSL, representing shapes composed of a group of nested shapes (e.g. `car` shape representing a group of nested `polygon` shapes)
+- Hello, Custom Shape! Sample (redoes Hello, Shape! with the use of a class-based custom shape)
+- Support :max value for Canvas Shape DSL width and height, meaning fill up parent (useful for using rectangles as borders)
+- Upgrade to glimmer v1.2.0
+
+### 4.18.6.3
+
+- Support `Glimmer::SWT::Custom::Shape::PathSegment#dispose` method
+- Amend Hello, Canvas Path! sample with ability to regenerate paths
+- Make `tab_folder` preinit all its tabs by default while supporting the SWT style of `:initialize_tabs_on_select` to init tabs on first select instead.
+- Support trimming line style symbols (no need to say line_ before each style. e.g. `:line_solid` becomes `:solid`) in Canvas Shape DSL line_style property
+- Support `antialias true` as an alternative to `antialias :on`, `antialias false` as an alternative to `antialias :off`, and `antialias nil` as an alternative to `antialias :default`
+
+### 4.18.6.2
+
+- Hello, Canvas Data Binding! Sample
+- Update Stock Ticker sample to keep stock names visible when scrolling graphs off the screen
+- `rgb` keyword tolerance of nil values (converts to 0)
+- Canvas Path DSL Data-Binding
+- Added `Glimmer::SWT::Custom::Shape::PathSegment` `#path` and `#root_path` API methods to enable determining what path/root-path the path segment is part of.
+- Fixed issues with geometry calculation of path segments (especially line)
+
+### 4.18.6.1
+
+- Fixed issues with Canvas Path DSL handling of connected vs non-connected path segments (including in geometry calculations)
+- Optimized Canvas Path DSL redraw performance by removing extra redraws
+- Fixed issues in the Hello, Canvas Path! sample and renamed to Stock Ticker
+- Added a new simpler Hello, Canvas Path! sample
+
+### 4.18.6.0
+
+- Canvas Path DSL support (Alpha) for `path` as drawn or filled (`fill: true`) to the Canvas Shape DSL, supporting `point`, `line` (first point is auto-derived from previous point if not specified)
+- Hello, Canvas Path! sample showing a Stock Ticker with line curves for multiple company stocks, animated with randomly generated data, moving to the left out of screen second by second. Has multiple tabs demonstrating different types of paths for graphing/charting of different real world business applications: point, line, quad, cubic.
+- Fix issue to allow invocation of `set_min_size` off of `scrolled_composite` proxy directly (not just swt_widget), thus taking advantage of implicit `auto_exec`
+- Support `Shape#content {}` method just like `WidgetProxy#content` to enable reopening and adding nested shapes at runtime after initial construction
+- Support a path containing a `quad` bezier curve with `point_array` property
+- Support a path containing a `cubic` bezier curve with `point_array` property
+
 ### 4.18.5.5
 
 - Automatically recalculate default size (width/height) to accomodate nested shapes when changing x/y/width/height sticking out of parent from right or bottom.

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.5.5
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for SWT 4.18.7.0
 ## JRuby Desktop Development GUI Framework
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-swt.svg)](http://badge.fury.io/rb/glimmer-dsl-swt)
 [![Travis CI](https://travis-ci.com/AndyObtiva/glimmer-dsl-swt.svg?branch=master)](https://travis-ci.com/github/AndyObtiva/glimmer-dsl-swt)
@@ -13,7 +13,7 @@
 [<img src="https://covers.oreillystatic.com/images/9780596519650/lrg.jpg" width=105 /><br />
 Featured in JRuby Cookbook](http://shop.oreilly.com/product/9780596519650.do) and [Chalmers/Gothenburg University Software Engineering Master's Lecture Material](http://www.cse.chalmers.se/~bergert/slides/guest_lecture_DSLs.pdf)
 
-[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.18.5.5 includes [SWT 4.18](https://download.eclipse.org/eclipse/downloads/drops4/R-4.18-202012021800/), which was released on December 2, 2020. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT.
+[Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) 4.18.7.0 includes [SWT 4.18](https://download.eclipse.org/eclipse/downloads/drops4/R-4.18-202012021800/), which was released on December 2, 2020. Gem version numbers are in sync with the SWT library versions. The first two digits represent the SWT version number. The last two digits represent the minor and patch versions of Glimmer DSL for SWT.
 
 [Glimmer DSL for SWT receives two updates per month](https://rubygems.org/gems/glimmer-dsl-swt/versions). You can trust [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) with your Ruby desktop GUI development needs! [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) brings great ideas to the table, such as declarative programming via domain specific languages, currently under-utilized in the GUI domain. That said, it may not be feature complete enough for everybody's needs, so please help make [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) even better by providing feedback and [contributing](#contributing) when possible. The project is very active, so any feature suggestions that are accepted could be implemented within weeks if not days. Also, you are welcome to [hire me](#hire-me) full-time if you want long-term development of [Glimmer DSL for SWT](https://rubygems.org/gems/glimmer-dsl-swt) for your project needs.
 
@@ -340,7 +340,7 @@ jgem install glimmer-dsl-swt
 
 Or this command if you want a specific version:
 ```
-jgem install glimmer-dsl-swt -v 4.18.5.5
+jgem install glimmer-dsl-swt -v 4.18.7.0
 ```
 
 `jgem` is JRuby's version of `gem` command.
@@ -358,7 +358,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.5.5'
+gem 'glimmer-dsl-swt', '~> 4.18.7.0'
 ```
 
 And, then run:

data/VERSION

@@ -1 +1 @@
-4.18.5.5
+4.18.7.0

data/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md

@@ -39,8 +39,10 @@ This guide should help you get started with Glimmer DSL for SWT. For more advanc
     - [Shapes inside a Shape](#shapes-inside-a-shape)
     - [Shapes inside a Widget](#shapes-inside-a-widget)
     - [Shapes inside an Image](#shapes-inside-an-image)
+    - [Custom Shapes](#custom-shapes)
     - [Canvas Shape API](#canvas-shape-api)
     - [Pixel Graphics](#pixel-graphics)
+  - [Canvas Path DSL](#canvas-path-dsl)
   - [Canvas Transform DSL](#canvas-transform-dsl)
     - [Top-Level Transform Fluent Interface](#top-level-transform-fluent-interface)
   - [Canvas Animation DSL](#canvas-animation-dsl)
@@ -409,6 +411,14 @@ Example (you may copy/paste in [`girb`](GLIMMER_GIRB.md)):
 @shell.open
 ```
 
+##### Tab Folder API
+
+Unlike basic SWT usage, `tab_folder` has the smart default of pre-initializing all tabs so that they are properly sized/filled so no delays occur when a user browses through them for the first time by selecting unselected tabs.
+
+The [Stock Ticker](/docs/reference/GLIMMER_SAMPLES.md#stock-ticker) sample takes advantage of this to ensure all tabs are pre-initialized and filled with rendered data even before the user selects any of them.
+
+That said, `tab_folder` can optionally receive a custom Glimmer SWT style named `:initialize_tabs_on_select`, which disables that behavior by going back to SWT's default of initializing tabs upon first selection (e.g. upon clicking with the mouse).
+
 ##### Shell Icon
 
 To set the shell icon, simply set the `image` property under the `shell` widget. This shows up in the operating system toolbar and app-switcher (e.g. CMD+TAB) (and application window top-left corner in Windows)
@@ -1414,7 +1424,7 @@ Optionally, a shape keyword takes a block that can set any attributes from [org.
 Here is a list of supported attributes nestable within a block under shapes:
 - `advanced` enables advanced graphics subsystem (boolean value). Typically gets enabled automatically when setting alpha, antialias, patterns, interpolation, clipping. Rendering sometimes differs between advanced and non-advanced mode for basic graphics too, so you could enable manually if you prefer its look even for basic graphics.
 - `alpha` sets transparency (integer between `0` and `255`)
-- `antialias` enables antialiasing (SWT style value of `:default`, `:off`, `:on` whereby `:default` applies OS default, which varies per OS)
+- `antialias` enables antialiasing (SWT style value of `:default` (or nil), `:off` (or false), `:on` (or true) whereby `:default` applies OS default, which varies per OS)
 - `background` sets fill color for fillable shapes (standard color symbol (e.g. `:red`), `rgb(red_integer, green_integer, blue_integer)` color, or Color/ColorProxy object directly)
 - `background_pattern` sets fill gradient/image pattern for fillable shape background (takes the same arguments as the SWT [Pattern](https://help.eclipse.org/2020-12/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/graphics/Pattern.html) class [e.g. `background_pattern 2.3, 4.2, 5.4, 7.2, :red, :blue`] / note: this feature isn't extensively tested yet)
 - `clipping` clips area of painting (numeric values for `(x, y, width, height)`)
@@ -1426,7 +1436,7 @@ Here is a list of supported attributes nestable within a block under shapes:
 - `line_cap` sets line cap (SWT style value of `:cap_flat`, `:cap_round`, or `:cap_square`)
 - `line_dash` line dash float values (automatically sets `line_style` to SWT style value of `:line_custom`)
 - `line_join` line join style (SWT style value of `:join_miter`, `:join_round`, or `:join_bevel`)
-- `line_style` line join style (SWT style value of `:line_solid`, `:line_dash`, `:line_dot`, `:line_dashdot`, or `:line_dashdotdot`)
+- `line_style` line join style (SWT style value of `:solid`, `:dash`, `:dot`, `:dashdot`, `:dashdotdot`, or `:custom` while requiring `line_dash` attribute (or alternatively with `line_` prefix as per official SWT docs like `:line_solid` for `:solid`)
 - `line_width` line width in integer (used in draw operations)
 - `text_anti_alias` enables text antialiasing (SWT style value of `:default`, `:off`, `:on` whereby `:default` applies OS default, which varies per OS)
 - `transform` sets transform object using [Canvas Transform DSL](#canvas-transform-dsl) syntax
@@ -1475,7 +1485,7 @@ Screenshot:
 
 If you specify the x and y coordinates as `:default`, `nil`, or leave them out, they get calculated automatically by centering the shape within its parent `canvas`.
 
-Note that you could shift a shape off its centered position within its parent `canvas` by using `x_delta` and `y_delta` instead of `x` and `y`
+Note that you could shift a shape off its centered position within its parent `canvas` by setting `x` to `[:default, x_delta]` and `y` to `[:default, y_delta]`
 
 The round and gradient options could be dropped since Glimmer DSL for SWT supports auto-inference of them based on shape parameters.
 
@@ -1632,9 +1642,11 @@ Shapes can be nested within each other. If you nest a shape within another, its
 
 As such, if you move the parent, it moves all its children with it.
 
-If you specify the x and y coordinates as `:default`, `nil`, or leave them out, they get calculated automatically by centering the shape within its parent shape relatively.
+If you specify the `x` and `y` coordinates as `:default`, `nil`, or leave them out, they get calculated automatically by centering the shape within its parent shape relatively.
+
+If you specify the `width` and `height` parameters as `:default`, `nil`, or leave them out, they get calculated automatically from the shape's nested children shapes (e.g calculating the dimensions of a text from its extent according to its font size).
 
-Note that you could shift a shape off its centered position within its parent shape by using `x_delta` and `y_delta` instead of `x` and `y`
+Note that you could shift a shape off its centered position within its parent shape by setting `x` to `[:default, x_delta]` and `y` to `[:default, y_delta]`
 
 Check [Hello, Canvas!](GLIMMER_SAMPLES.md#hello-canvas) for an example that nests lines, points, a polyline, and an image within a drawn rectangle parent:
 
@@ -1756,6 +1768,21 @@ shell {
 
 ![Image Shape DSL](/images/glimmer-example-image-shape-dsl-app-switcher-icon.png)
 
+#### Custom Shapes
+
+Glimmer enables defining custom shape keywords, which represent shapes made up of other nested shapes.
+
+Custom shapes expand a software engineer's Glimmer GUI DSL vocabulary in their app development to be able to represent
+higher visual concepts like vehicles, scenes, and characters with a single keyword (e.g. `car`, `beach`, `player`),
+which embody and abstract all the details relating to the visual concept. This enables orders of magnitudes in increased
+productivity and readability/maintainability as a result.
+
+Just like [custom widgets](#custom-widgets), custom shapes can be defined in one of two ways:
+- method-based custom shapes: Use the `shape` keyword as a parent to represent a shape composite (similar to widget composite) and include other shapes like rectangles, polygons, and lines within.
+- class-based custom shapes: Include the `Glimmer::UI::CustomShape` supermodule and define the `options`, `body {}` block, and `before_body/after_body` hooks (similar to how it is down with [custom widgets](#custom-widgets))
+
+Check out [Hello, Shape!](/docs/reference/GLIMMER_SAMPLES.md#hello-shape) and [Hello, Custom Shape!](/docs/reference/GLIMMER_SAMPLES.md#hello-custom-shape) for examples of both approaches.
+
 #### Canvas Shape API
 
 These Canvas Shape API methods help with manipulating shapes upon user interaction, such as mouse clicking a specific shape.
@@ -1766,11 +1793,28 @@ They are implemented with the help of the highly robust Java built-in shape geom
 - `Shape#contain?(x, y)` : indicates if shape contains x, y point
 - `Shape#include?(x, y)` : indicates if shape includes x, y point on the edge if drawn or inside if filled (include uses contain for filled shapes)
 - `Shape#move_by(x_delta, y_delta)` : moves shape object at x, y location
+- `Shape#dispose` : disposes of shape, removing it form its parent canvas, widget, or shape
+- `Shape#content {}` : reopens a shape to add more content inside it using the Glimmer GUI DSL (e.g. Canvas Shape DSL) just like `WidgetProxy#content {}`.
 - `Shape#size` : calculated size for shape bounding box (e.g. a polygon with an irregular shape will have its bounding box width and height calculated)
 - `Shape#bounds` : calculated bounds (x, y, width, height) for shape bounding box (e.g. a polygon with an irregular shape will have its bounding box top-left x, y, width and height calculated)
+- `Shape#width` : static (including `:default`) or derived width for shape (including irregular geometric shapes like Polygon)
+- `Shape#height` : static (including `:default`) or derived height for shape (including irregular geometric shapes like Polygon)
+- `Shape#default_width?` : whether `:default` or `[:default, delta]` is set for static width
+- `Shape#default_height?` : whether `:default` or `[:default, delta]` is set for static height
+- `Shape#calculated_width` : calculated width for shape when set to :default to indicate it is sized by its children (e.g. in the case of containing text with a specific font size not knowing its width/height dimensions in advance)
+- `Shape#calculated_height` : calculated height for shape when set to :default to indicate it is sized by its children (e.g. in the case of containing text with a specific font size not knowing its width/height dimensions in advance)
+- `Shape#x` : top-left corner x position, static or `:default` (could be relative if shape is nested within another shape)
+- `Shape#y` : top-left corner y position, static or `:default` (could be relative if shape is nested within another shape)
+- `Shape#absolute_x` : absolute top-left corner x position
+- `Shape#absolute_y` : absolute top-left corner y position
+- `Shape#default_x?` : whether x is specified via `:default` style to indicate centering within parent (or `[:default, offset]`)
+- `Shape#default_y?` : calculated top-left corner y position
+- `Shape#calculated_x` : calculated top-left corner x position when default/delta is set (i.e. centered within parent)
+- `Shape#calculated_y` : calculated top-left corner y position when default/delta is set (i.e. centered within parent)
 
 Check [Hello, Canvas!](GLIMMER_SAMPLES.md#hello-canvas) for an example.
 
+
 #### Pixel Graphics
 
 **(Early Alpha Feature)**
@@ -1953,6 +1997,52 @@ shell {
 
 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 Path DSL
+
+**(ALPHA FEATURE)**
+
+Unlike common imperative GUI graphing toolkits, Glimmer enables declarative rendering of paths with the new Canvas Path DSL (Early Alpha) via the new `path { }` keyword and by nesting one of the following path segment keywords underneath:
+- `point(x1, y1)`: renders a Point (Dot) as part of a path.
+- `line(x1, y1, x2=nil, y2=nil)`: renders a Line as part of a path. If you drop x2, y2, it joins to the previous point automatically. You may repeat for a series of lines forming a curve.
+- `quad(x1, y1, x2, y2, x3=nil, y3=nil)`: renders a Quadratic Bezier Curve. If you drop x3 and y3, it joins to the previous point automatically.
+- `cubic(x1, y1, x2, y2, x3, y3, x4=nil, y4=nil)`: renders a Cubic Bezier Curve. If you drop x4 and y4, it joins to the previous point automatically.
+
+Example:
+
+```ruby
+include Glimmer
+
+shell {
+  text 'Canvas Path Example'
+  minimum_size 300, 300
+  
+  canvas {
+    path {
+      foreground :black
+      250.times {|n|
+        cubic(n + n%30, n+ n%50, 40, 40, 70, 70, n + 20 + n%30, n%30*-1 * n%50)
+      }
+    }
+  }
+  
+}.open
+```
+
+![Canvas Path Example](/images/glimmer-example-canvas-path.png)
+
+Learn more at the [Hello, Canvas Path!](GLIMMER_SAMPLES.md#hello-canvas-path) and [Stock Ticker](GLIMMER_SAMPLES.md#stock-ticker) samples.
+
+![Stock Ticker](/images/glimmer-stock-ticker.gif)
+
+#### Canvas Path API
+
+Every path segment object (mixing in [`Glimmer::SWT::Custom::PathSegment`](/lib/glimmer/swt/custom/shape/path_segment.rb) like `path`, `point`, `line`, `quad`, and `cubic`) has the following API methods:
+- `#path`: indicates which path the segment is part of.
+- `#path_root`: indicates the root path the segment is part of.
+- `#dispose`: disposes a path segment from its path
+- `#content {}` : reopens a path to add more segments inside it using the Glimmer GUI DSL (e.g. Canvas Path DSL) just like `WidgetProxy#content {}`.
+- `#first_path_segment?`: indicates if the path segment is the first in the path
+
 ### Canvas Transform DSL
 
 **(ALPHA FEATURE)**

data/docs/reference/GLIMMER_PACKAGING_AND_DISTRIBUTION.md

@@ -12,6 +12,8 @@ glimmer package
 
 It works out of the box for any application scaffolded by [Glimmer Scaffolding](#scaffolding), generating all available packaging types on the current platform (e.g. `DMG`, `PKG`, `APP` on the Mac) and displaying a message indicating what pre-requisite setup tools are needed if not installed already (e.g. [Wix Toolset](https://wixtoolset.org/) to generate MSI files on Windows). If you install Wix, make sure it is on the system PATH by adding for example "C:\Program Files (x86)\WiX Toolset v3.11\bin" to the Windows Environment Variables.
 
+(note: if you see this error on the Mac 'Error: Bundler "DMG Installer" (dmg) failed to produce a bundle.', ignore it as it should have produced a bundle anyways. It is a harmless issue in 3rd party dependency: javapackager.)
+
 You may choose to generate a specific type of packaging instead by addionally passing in the `[type]` option. For example, this generates an MSI setup file on Windows:
 
 ```

data/docs/reference/GLIMMER_SAMPLES.md

@@ -33,11 +33,15 @@
     - [Hello, Canvas!](#hello-canvas)
     - [Hello, Canvas Animation!](#hello-canvas-animation)
     - [Hello, Canvas Transform!](#hello-canvas-transform)
+    - [Hello, Canvas Path!](#hello-canvas-path)
+    - [Hello, Canvas Data Binding!](#hello-canvas-data-binding)
     - [Hello, Cursor!](#hello-cursor)
     - [Hello, Progress Bar!](#hello-progress-bar)
     - [Hello, Tree!](#hello-tree)
     - [Hello, Color Dialog!](#hello-color-dialog)
     - [Hello, Font Dialog!](#hello-font-dialog)
+    - [Hello, Shape!](#hello-shape)
+    - [Hello, Custom Shape!](#hello-custom-shape)
   - [Elaborate Samples](#elaborate-samples)
     - [User Profile](#user-profile)
     - [Login](#login)
@@ -45,6 +49,7 @@
     - [Contact Manager](#contact-manager)
     - [Glimmer Tetris](#glimmer-tetris)
     - [Mandelbrot Fractal](#mandelbrot-fractal)
+    - [Stock Ticker](#stock-ticker)
   - [External Samples](#external-samples)
     - [Glimmer Calculator](#glimmer-calculator)
     - [Gladiator](#gladiator)
@@ -616,6 +621,32 @@ Hello, Canvas Transform!
 
 ![Hello Canvas Transform](/images/glimmer-hello-canvas-transform.png)
 
+#### Hello, Canvas Path!
+
+This sample demonstrates the use of the `path`, `quad`, `cubic`, `line`, and `point` keywords as part of the [Canvas Path DSL](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-path-dsl) within the [Canvas Shape DSL](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-shape-dsl).
+
+Code:
+
+[samples/hello/hello_canvas_path.rb](/samples/hello/hello_canvas_path.rb)
+
+Hello, Canvas Path!
+
+![Hello Canvas Path](/images/glimmer-hello-canvas-path.png)
+
+#### Hello, Canvas Data Binding!
+
+This sample demonstrates Canvas Shape DSL data-binding.
+
+Code:
+
+[samples/hello/hello_canvas_data_binding.rb](/samples/hello/hello_canvas_data_binding.rb)
+
+Hello, Canvas Data Binding!
+
+![Hello Canvas Data Binding](/images/glimmer-hello-canvas-data-binding.png)
+
+![Hello Canvas Data Binding Line Changed](/images/glimmer-hello-canvas-data-binding-line-changed.png)
+
 #### Hello, Cursor!
 
 This sample demonstrates the use of the `cursor` property keyword to change the mouse cursor.
@@ -688,6 +719,32 @@ Hello, Font Dialog!
 
 ![Hello Font Dialog Font Changed](/images/glimmer-hello-font-dialog-font-changed.png)
 
+#### Hello, Shape!
+
+This sample demonstrates the use of the `shape` keyword, which represents shape composites that contain other nested shapes.
+
+Code:
+
+[samples/hello/hello_shape.rb](/samples/hello/hello_shape.rb)
+
+Hello, Shape!
+
+![Hello Shape](/images/glimmer-hello-shape.png)
+
+#### Hello, Custom Shape!
+
+This sample demonstrates the use of the `Glimmer::UI::CustomShape` module, which is used to author new custom shape keywords.
+It reimplements Hello, Shape! with a class-based custom shape instead of a method-based custom shape.
+Just provides another option that is useful when defining more elaborate shapes to separate them from the main app code.
+
+Code:
+
+[samples/hello/hello_custom_shape.rb](/samples/hello/hello_custom_shape.rb)
+
+Hello, Custom Shape!
+
+![Hello Custom Shape](/images/glimmer-hello-custom-shape.png)
+
 ### Elaborate Samples
 
 For more elaborate samples, check the following:
@@ -812,6 +869,16 @@ Code:
 
 ![Mandelbrot Fractal Help Menu](/images/glimmer-mandelbrot-menu-help.png)
 
+#### Stock Ticker
+
+This sample demonstrates a Stock Ticker that generates random stock price data for 4 different stocks and provides 4 different tab views of the graphed data using the [Canvas Path DSL](/docs/reference/GLIMMER_GUI_DSL_SYNTAX.md#canvas-path-dsl). It leverages a thread that runs in the background and ticks the stocks to generate random new stock prices before amending the graphed paths with them.
+
+Code:
+
+[samples/elaborate/stock_ticker.rb](/samples/elaborate/stock_ticker.rb)
+
+![Stock Ticker](/images/glimmer-stock-ticker.gif)
+
 ### 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.5.5 ruby lib
+# stub: glimmer-dsl-swt 4.18.7.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "glimmer-dsl-swt".freeze
-  s.version = "4.18.5.5"
+  s.version = "4.18.7.0"
 
   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-27"
+  s.date = "2021-03-04"
   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]
@@ -66,6 +66,7 @@ Gem::Specification.new do |s|
     "lib/glimmer/dsl/swt/column_properties_expression.rb",
     "lib/glimmer/dsl/swt/combo_selection_data_binding_expression.rb",
     "lib/glimmer/dsl/swt/cursor_expression.rb",
+    "lib/glimmer/dsl/swt/custom_shape_expression.rb",
     "lib/glimmer/dsl/swt/custom_widget_expression.rb",
     "lib/glimmer/dsl/swt/data_binding_expression.rb",
     "lib/glimmer/dsl/swt/dialog_expression.rb",
@@ -115,13 +116,17 @@ Gem::Specification.new do |s|
     "lib/glimmer/swt/custom/radio_group.rb",
     "lib/glimmer/swt/custom/shape.rb",
     "lib/glimmer/swt/custom/shape/arc.rb",
+    "lib/glimmer/swt/custom/shape/cubic.rb",
     "lib/glimmer/swt/custom/shape/focus.rb",
     "lib/glimmer/swt/custom/shape/image.rb",
     "lib/glimmer/swt/custom/shape/line.rb",
     "lib/glimmer/swt/custom/shape/oval.rb",
+    "lib/glimmer/swt/custom/shape/path.rb",
+    "lib/glimmer/swt/custom/shape/path_segment.rb",
     "lib/glimmer/swt/custom/shape/point.rb",
     "lib/glimmer/swt/custom/shape/polygon.rb",
     "lib/glimmer/swt/custom/shape/polyline.rb",
+    "lib/glimmer/swt/custom/shape/quad.rb",
     "lib/glimmer/swt/custom/shape/rectangle.rb",
     "lib/glimmer/swt/custom/shape/text.rb",
     "lib/glimmer/swt/date_time_proxy.rb",
@@ -144,6 +149,7 @@ Gem::Specification.new do |s|
     "lib/glimmer/swt/style_constantizable.rb",
     "lib/glimmer/swt/styled_text_proxy.rb",
     "lib/glimmer/swt/swt_proxy.rb",
+    "lib/glimmer/swt/tab_folder_proxy.rb",
     "lib/glimmer/swt/tab_item_proxy.rb",
     "lib/glimmer/swt/table_column_proxy.rb",
     "lib/glimmer/swt/table_proxy.rb",
@@ -152,6 +158,7 @@ Gem::Specification.new do |s|
     "lib/glimmer/swt/widget_listener_proxy.rb",
     "lib/glimmer/swt/widget_proxy.rb",
     "lib/glimmer/ui.rb",
+    "lib/glimmer/ui/custom_shape.rb",
     "lib/glimmer/ui/custom_shell.rb",
     "lib/glimmer/ui/custom_widget.rb",
     "lib/glimmer/util/proc_tracker.rb",
@@ -162,6 +169,7 @@ Gem::Specification.new do |s|
     "samples/elaborate/login.rb",
     "samples/elaborate/mandelbrot_fractal.rb",
     "samples/elaborate/meta_sample.rb",
+    "samples/elaborate/stock_ticker.rb",
     "samples/elaborate/tetris.rb",
     "samples/elaborate/tetris/model/block.rb",
     "samples/elaborate/tetris/model/game.rb",
@@ -180,6 +188,8 @@ Gem::Specification.new do |s|
     "samples/hello/hello_button.rb",
     "samples/hello/hello_canvas.rb",
     "samples/hello/hello_canvas_animation.rb",
+    "samples/hello/hello_canvas_data_binding.rb",
+    "samples/hello/hello_canvas_path.rb",
     "samples/hello/hello_canvas_transform.rb",
     "samples/hello/hello_checkbox.rb",
     "samples/hello/hello_checkbox_group.rb",
@@ -189,6 +199,7 @@ Gem::Specification.new do |s|
     "samples/hello/hello_computed.rb",
     "samples/hello/hello_computed/contact.rb",
     "samples/hello/hello_cursor.rb",
+    "samples/hello/hello_custom_shape.rb",
     "samples/hello/hello_custom_shell.rb",
     "samples/hello/hello_custom_widget.rb",
     "samples/hello/hello_date_time.rb",
@@ -209,6 +220,7 @@ Gem::Specification.new do |s|
     "samples/hello/hello_radio.rb",
     "samples/hello/hello_radio_group.rb",
     "samples/hello/hello_sash_form.rb",
+    "samples/hello/hello_shape.rb",
     "samples/hello/hello_spinner.rb",
     "samples/hello/hello_styled_text.rb",
     "samples/hello/hello_tab.rb",
@@ -230,7 +242,7 @@ Gem::Specification.new do |s|
     s.specification_version = 4
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<glimmer>.freeze, ["~> 1.1.2"])
+      s.add_runtime_dependency(%q<glimmer>.freeze, ["~> 1.2.0"])
       s.add_runtime_dependency(%q<super_module>.freeze, [">= 1.4.1", "< 2.0.0"])
       s.add_runtime_dependency(%q<nested_inherited_jruby_include_package>.freeze, [">= 0.3.0", "< 2.0.0"])
       s.add_runtime_dependency(%q<puts_debuggerer>.freeze, [">= 0.11.0", "< 2.0.0"])
@@ -248,7 +260,7 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<simplecov>.freeze, ["~> 0.16.1"])
       s.add_development_dependency(%q<simplecov-lcov>.freeze, ["~> 0.7.0"])
     else
-      s.add_dependency(%q<glimmer>.freeze, ["~> 1.1.2"])
+      s.add_dependency(%q<glimmer>.freeze, ["~> 1.2.0"])
       s.add_dependency(%q<super_module>.freeze, [">= 1.4.1", "< 2.0.0"])
       s.add_dependency(%q<nested_inherited_jruby_include_package>.freeze, [">= 0.3.0", "< 2.0.0"])
       s.add_dependency(%q<puts_debuggerer>.freeze, [">= 0.11.0", "< 2.0.0"])
@@ -267,7 +279,7 @@ Gem::Specification.new do |s|
       s.add_dependency(%q<simplecov-lcov>.freeze, ["~> 0.7.0"])
     end
   else
-    s.add_dependency(%q<glimmer>.freeze, ["~> 1.1.2"])
+    s.add_dependency(%q<glimmer>.freeze, ["~> 1.2.0"])
     s.add_dependency(%q<super_module>.freeze, [">= 1.4.1", "< 2.0.0"])
     s.add_dependency(%q<nested_inherited_jruby_include_package>.freeze, [">= 0.3.0", "< 2.0.0"])
     s.add_dependency(%q<puts_debuggerer>.freeze, [">= 0.11.0", "< 2.0.0"])