glimmer-dsl-libui 0.0.6 → 0.0.10

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.0.6
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.0.10
 ## Prerequisite-Free Ruby Desktop Development GUI Library
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-libui.svg)](http://badge.fury.io/rb/glimmer-dsl-libui)
 [![Maintainability](https://api.codeclimate.com/v1/badges/ce2853efdbecf6ebdc73/maintainability)](https://codeclimate.com/github/AndyObtiva/glimmer-dsl-libui/maintainability)
@@ -6,18 +6,18 @@
 
 [Glimmer](https://github.com/AndyObtiva/glimmer) DSL for [LibUI](https://github.com/kojix2/LibUI) is a prerequisite-free Ruby desktop development GUI library. No need to pre-install any prerequisites. Just install the gem and have platform-independent native GUI that just works!
 
-[LibUI](https://github.com/kojix2/LibUI) is a thin [Ruby](https://www.ruby-lang.org/en/) wrapper around [libui](https://github.com/andlabs/libui), a relatively new C GUI library that renders native widgets on every platform (similar to [SWT](https://www.eclipse.org/swt/), but without the heavy weight of the [Java Virtual Machine](https://www.java.com/en/)).
+[LibUI](https://github.com/kojix2/LibUI) is a thin [Ruby](https://www.ruby-lang.org/en/) wrapper around [libui](https://github.com/andlabs/libui), a relatively new C GUI library that renders native controls on every platform (similar to [SWT](https://www.eclipse.org/swt/), but without the heavy weight of the [Java Virtual Machine](https://www.java.com/en/)).
 
 The main trade-off in using [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) as opposed to [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) or [Glimmer DSL for Tk](https://github.com/AndyObtiva/glimmer-dsl-tk) is the fact that [SWT](https://www.eclipse.org/swt/) and [Tk](https://www.tcl.tk/) are more mature than mid-alpha [libui](https://github.com/andlabs/libui) as GUI toolkits. Still, if there is only a need to build a small simple application, [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) could be a good convenient choice due to having zero prerequisites beyond the dependencies included in the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui). Also, just like [Glimmer DSL for Tk](https://github.com/AndyObtiva/glimmer-dsl-tk), its apps start instantly and have a small memory footprint. [LibUI](https://github.com/kojix2/LibUI) is a promising new GUI toolkit that might prove quite worthy in the future.
 
 [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) aims to provide a DSL similar to the [Glimmer DSL for SWT](https://github.com/AndyObtiva/glimmer-dsl-swt) to enable more productive desktop development in Ruby with:
-- Declarative DSL syntax that visually maps to the GUI widget hierarchy
+- Declarative DSL syntax that visually maps to the GUI control hierarchy
 - Convention over configuration via smart defaults and automation of low-level details
 - Requiring the least amount of syntax possible to build GUI
 - Bidirectional Data-Binding to declaratively wire and automatically synchronize GUI with Business Models
-- Custom Widget support
-- Scaffolding for new custom widgets, apps, and gems
-- Native-Executable packaging on Mac, Windows, and Linux
+- Custom Control support
+- Scaffolding for new custom controls, apps, and gems
+- Native-Executable packaging on Mac, Windows, and Linux.
 
 Example:
 
@@ -26,13 +26,13 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window('hello world', 300, 200, 1).show
+window('hello world').show
 ```
 
 ![glimmer-dsl-libui-mac-basic-window.png](images/glimmer-dsl-libui-mac-basic-window.png)
 ![glimmer-dsl-libui-linux-basic-window.png](images/glimmer-dsl-libui-linux-basic-window.png)
 
-NOTE: [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) is in early alpha mode (only supports included examples). Please help make better by contributing, adopting for small or low risk projects, and providing feedback. It is still an early alpha, so the more feedback and issues you report the better.
+NOTE: [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) is in early alpha mode (only supports included [examples](#examples)). Please help make better by contributing, adopting for small or low risk projects, and providing feedback. It is still an early alpha, so the more feedback and issues you report the better.
 
 Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interested in:
 - [glimmer-dsl-swt](https://github.com/AndyObtiva/glimmer-dsl-swt): Glimmer DSL for SWT (JRuby Desktop Development GUI Framework)
@@ -43,14 +43,18 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
 
 ## Table of Contents
 
-- [Glimmer DSL for LibUI 0.0.6](#-glimmer-dsl-for-libui-006)
+- [Glimmer DSL for LibUI 0.0.10](#-glimmer-dsl-for-libui-0010)
   - [Glimmer GUI DSL Concepts](#glimmer-gui-dsl-concepts)
   - [Usage](#usage)
   - [API](#api)
     - [Supported Controls](#supported-controls)
     - [Common Control Properties](#common-control-properties)
     - [Common Control Operations](#common-control-operations)
+    - [Extra Dialogs](#extra-dialogs)
     - [Extra Operations](#extra-operations)
+    - [Smart Defaults and Conventions](#smart-defaults-and-conventions)
+    - [Original API](#original-api)
+  - [Glimmer Style Guide](#glimmer-style-guide)
   - [Girb (Glimmer IRB)](#girb-glimmer-irb)
   - [Examples](#examples)
     - [Basic Window](#basic-window)
@@ -59,6 +63,7 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
     - [Simple Notepad](#simple-notepad)
     - [Midi Player](#midi-player)
     - [Control Gallery](#control-gallery)
+    - [Font Button](#font-button)
   - [Contributing to glimmer-dsl-libui](#contributing-to-glimmer-dsl-libui)
   - [Help](#help)
     - [Issues](#issues)
@@ -73,14 +78,14 @@ Other [Glimmer](https://rubygems.org/gems/glimmer) DSL gems you might be interes
 
 The Glimmer GUI DSL provides object-oriented declarative hierarchical syntax for [LibUI](https://github.com/kojix2/LibUI) that:
 - Supports smart defaults (e.g. automatic `on_closing` listener that quits `window`)
-- Automates wiring of widgets (e.g. `button` is automatically set as child of `window`)
+- Automates wiring of controls (e.g. `button` is automatically set as child of `window`)
 - Hides lower-level details (e.g. `LibUI.main` loop is started automatically when triggering `show` on `window`)
-- Nests widgets according to their visual hierarchy
+- Nests controls according to their visual hierarchy
 - Requires the minimum amount of syntax needed to describe an app's GUI
 
 The Glimmer GUI DSL follows these simple concepts in mapping from [LibUI](https://github.com/kojix2/LibUI) syntax:
-- **Control**: [LibUI](https://github.com/kojix2/LibUI) controls may be declared by lower-case underscored name (aka keyword) (e.g. `window` or `button`). Behind the scenes, they are represented by keyword methods that map to corresponding `LibUI.new_keyword` methods receiving args (e.g. `window('hello world', 300, 200, 1)`).
-- **Content/Properties/Listeners Block**: Any keyword may be optionally followed by a Ruby curly-brace multi-line-block containing nested controls (content) and/or properties (attributes) (e.g. `window('hello world', 300, 200, 1) {button('greet')}`). It optionally recives one arg representing the control (e.g. `button('greet') {|b| on_clicked { puts b.text}}`)
+- **Control**: [LibUI](https://github.com/kojix2/LibUI) controls may be declared by lower-case underscored name (aka keyword) (e.g. `window` or `button`). Behind the scenes, they are represented by keyword methods that map to corresponding `LibUI.new_keyword` methods receiving args (e.g. `window('hello world', 300, 200, true)`).
+- **Content/Properties/Listeners Block**: Any keyword may be optionally followed by a Ruby curly-brace multi-line-block containing nested controls (content) and/or properties (attributes) (e.g. `window('hello world', 300, 200, true) {button('greet')}`). It optionally receives one arg representing the control (e.g. `button('greet') {|b| on_clicked { puts b.text}}`)
 - **Property**: Control properties may be declared inside keyword blocks with lower-case underscored name followed by property value args (e.g. `title "hello world"` inside `group`). Behind the scenes, properties correspond to `control_set_property` methods.
 - **Listener**: Control listeners may be declared inside keyword blocks with listener lower-case underscored name beginning with `on_` and receiving required block handler (e.g. `on_clicked {puts 'clicked'}` inside `button`). Behind the scenes, listeners correspond to `control_on_event` methods.
 
@@ -122,7 +127,7 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window('hello world', 300, 200, 1) { |w|
+window('hello world', 300, 200) { |w|
   button('Button') {
     on_clicked do
       msg_box(w, 'Information', 'You clicked the button')
@@ -146,7 +151,7 @@ gem install glimmer-dsl-libui
 Or install via Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-dsl-libui', '~> 0.0.6'
+gem 'glimmer-dsl-libui', '~> 0.0.10'
 ```
 
 Add `require 'glimmer-dsl-libui'` at the top, and then `include Glimmer` into the top-level main object for testing or into an actual class for serious usage.
@@ -160,7 +165,7 @@ class Application
   include Glimmer
   
   def launch
-    window('hello world', 300, 200, 1) {
+    window('hello world', 300, 200) {
       button('Button') {
         on_clicked do
           puts 'Button Clicked'
@@ -203,44 +208,44 @@ Control(Args) | Properties | Listeners
 ------------- | ---------- | ---------
 `about_menu_item` | None | `on_clicked`
 `button(text as String)` | `text` (`String`) | `on_clicked`
-`checkbox(text as String)` | `checked` (`1` or `0`), `text` (`String`) | `on_toggled`
-`combobox` | `items` (`Array` of `String`), `selected` (`1` or `0`) | `on_selected`
-`color_button` | `color` (r `Numeric`, g `Numeric`, b `Numeric`, a `Numeric`), `selected` (`1` or `0`) | `on_selected`
-`date_picker` | None | None
-`date_time_picker` | `time` (`UI::FFI::TM`) | `on_changed`
+`checkbox(text as String)` | `checked` (Boolean), `text` (`String`) | `on_toggled`
+`combobox` | `items` (`Array` of `String`), `selected` (`Integer`) | `on_selected`
+`color_button` | `color` (r `Numeric`, g `Numeric`, b `Numeric`, a `Numeric`) | `on_changed`
+`date_picker` | `time` (`LibUI::FFI::TM`) | `on_changed`
+`date_time_picker` | `time` (`LibUI::FFI::TM`) | `on_changed`
 `editable_combobox` | `items` (`Array` of `String`), `text` (`String`) | `on_changed`
-`entry` | `read_only` (`1` or `0`), `text` (`String`) | `on_changed`
-`font_button` | `font` (`UI::FFI::FontDescriptor`) | `on_changed`
-`group(text as String)` | `margined` (`1` or `0`), `title` (`String`) | None
-`horizontal_box` | `padded` (`1` or `0`) | None
+`entry` | `read_only` (Boolean), `text` (`String`) | `on_changed`
+`font_button` | `font` [read-only] (`Hash` of keys: `:family`, `:size`, `:weight`, `:italic`, `:stretch`) | `on_changed`
+`group(text as String)` | `margined` (Boolean), `title` (`String`) | None
+`horizontal_box` | `padded` (Boolean) | None
 `horizontal_separator` | None | None
 `label(text as String)` | `text` (`String`) | None
 `menu(text as String)` | None | None
-`menu_item(text as String)` | `checked` (`1` or `0`) | `on_clicked`
-`multiline_entry` | `read_only` (`1` or `0`), `text` (`String`) | `on_changed`
+`menu_item(text as String)` | `checked` (Boolean) | `on_clicked`
+`multiline_entry` | `read_only` (Boolean), `text` (`String`) | `on_changed`
 `msg_box(window as Glimmer::LibUI::WindowProxy, title as String, description as String)` | None | None
 `msg_box_error(window as Glimmer::LibUI::WindowProxy, title as String, description as String)` | None | None
-`non_wrapping_multiline_entry` | `read_only` (`1` or `0`), `text` (`String`) | `on_changed`
+`non_wrapping_multiline_entry` | `read_only` (Boolean), `text` (`String`) | `on_changed`
 `preferences_menu_item` | None | `on_clicked`
 `progress_bar` | `value` (`Numeric`) | None
 `quit_menu_item` | None | `on_clicked`
-`radio_buttons` | `selected` (`1` or `0`) | `on_selected`
+`radio_buttons` | `selected` (`Integer`) | `on_selected`
 `slider(min as Numeric, max as Numeric)` | `value` (`Numeric`) | `on_changed`
 `spinbox(min as Numeric, max as Numeric)` | `value` (`Numeric`) | `on_changed`
-`tab` | `margined` (`1` or `0`), `num_pages` (`Integer`) | None
-`tab_item(name as String)` | `index` [read-only] (`Integer`), `margined` (`1` or `0`), `name` [read-only] (`String`) | None
-`time_picker` | None | None
-`vertical_box` | `padded` (`1` or `0`) | None
-`window(title as String, width as Integer, height as Integer, has_menubar as 1 or 0)` | `borderless` (`1` or `0`), `content_size` (width `Numeric`, height `Numeric`), `fullscreen` (`1` or `0`), `margined` (`1` or `0`), `title` (`String`) | `on_closing`, `on_content_size_changed`
+`tab` | `margined` (Boolean), `num_pages` (`Integer`) | None
+`tab_item(name as String)` | `index` [read-only] (`Integer`), `margined` (Boolean), `name` [read-only] (`String`) | None
+`time_picker` | `time` (`LibUI::FFI::TM`) | `on_changed`
+`vertical_box` | `padded` (Boolean) | None
+`window(title as String, width as Integer, height as Integer, has_menubar as Boolean)` | `borderless` (Boolean), `content_size` (width `Numeric`, height `Numeric`), `fullscreen` (Boolean), `margined` (Boolean), `title` (`String`) | `on_closing`, `on_content_size_changed`
 
 ### Common Control Properties
-- `enabled` (`1` or `0`)
+- `enabled` (Boolean)
 - `libui` (`Fiddle::Pointer`): returns wrapped [LibUI](https://github.com/kojix2/LibUI) object
 - `parent_proxy` (`Glimmer::LibUI::ControlProxy` or subclass)
 - `parent` (`Fiddle::Pointer`)
-- `toplevel` [read-only] (`1` or `0`)
-- `visible` (`1` or `0`)
-- `stretchy` [dsl-only] (`1` or `0`): available in [Glimmer GUI DSL](#glimmer-gui-dsl-concepts) when nested under `horizontal_box` or `vertical_box`
+- `toplevel` [read-only] (Boolean)
+- `visible` (Boolean)
+- `stretchy` [dsl-only] (Boolean): available in [Glimmer GUI DSL](#glimmer-gui-dsl-concepts) when nested under `horizontal_box` or `vertical_box`
 
 ### Common Control Operations
 - `destroy`
@@ -249,11 +254,45 @@ Control(Args) | Properties | Listeners
 - `hide`
 - `show`
 
-### Extra Operations
+### Extra Dialogs
+
 - `open_file(window as Glimmer::LibUI::WindowProxy)`: returns selected file (`String`) or `nil` if cancelled
 - `save_file(window as Glimmer::LibUI::WindowProxy)`: returns selected file (`String`) or `nil` if cancelled
 
-To learn more about the [LibUI](https://github.com/kojix2/LibUI) API exposed through [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui), check out the [libui C headers](https://github.com/andlabs/libui/blob/master/ui.h)
+### Extra Operations
+
+- `ControlProxy::all_control_proxies`: returns all instantiated control proxies in the application
+- `ControlProxy::main_window_proxy`: returns the first window proxy instantiated in the application
+- `ControlProxy#window_proxy`: returns the window proxy parent for a control
+
+### Smart Defaults and Conventions
+
+- `horizontal_box` and `vertical_box` controls have `padded` as `true` upon instantiation to ensure more user-friendly GUI by default
+- `group` controls have `margined` as `true` upon instantiation to ensure more user-friendly GUI by default
+- All controls nested under a `horizontal_box` or `vertical_box` have `stretchy` property (passed to `box_append` method) as `true` by default (filling maximum space)
+- `window` constructor args can be left off and have the following defaults when unspecified: `title` as `'Glimmer'`, `width` as `150`, `height` as `150`, and `has_menubar` as `true`)
+- `window` has an `on_closing` listener by default that quits application upon hitting the close button (can be overridden with a manual `on_closing` implementation that returns integer `0` for success)
+- `quit_menu_item` has an `on_clicked` listener by default that quits application upon selecting the quit menu item (can be overridden with a manual `on_clicked` implementation that returns integer `0` for success)
+- If an `on_closing` listener was defined on `window` and it does not return an integer, default exit behavior is assumed (`window.destroy` is called followed by `LibUI.quit`, returning `0`).
+- If an `on_clicked` listener was defined on `quit_menu_item` and it does not return an integer, default exit behavior is assumed (`main_window.destroy` is called followed by `LibUI.quit`, returning `0`).
+- All boolean property readers return `true` or `false` in Ruby instead of the [libui](https://github.com/andlabs/libui) original `0` or `1` in C.
+- All boolean property writers accept `true`/`false` in addition to `1`/`0` in Ruby
+- All string property readers return a `String` object in Ruby instead of the [libui](https://github.com/andlabs/libui) Fiddle pointer object.
+- Automatically allocate font descriptors upon instantiating `font_button` controls and free font descriptors when destorying `font_button` controls
+
+### Original API
+
+To learn more about the [LibUI](https://github.com/kojix2/LibUI) API exposed through [Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui),
+check out the [libui C headers](https://github.com/andlabs/libui/blob/master/ui.h)
+
+## Glimmer Style Guide
+
+- Control arguments are always wrapped inside parentheses
+- Control blocks are always declared with curly braces to clearly visualize hierarchical view code and separate from logic code
+- Control property declarations always have arguments and never take a block
+- Control property arguments are never wrapped inside parentheses
+- Control listeners are always declared starting with on_ prefix and affixing listener event method name afterwards in underscored lowercase form. Their multi-line blocks have a `do; end` style.
+- Pure logic multi-line blocks that do not constitute GUI DSL view elements have `do; end` style to clearly separate logic code from view code.
 
 ## Girb (Glimmer IRB)
 
@@ -269,7 +308,96 @@ Gotcha: On the Mac, when you close a window opened in `girb`, it remains open un
 
 ## Examples
 
-These examples reimplement the ones in the [LibUI](https://github.com/kojix2/LibUI) project utilizing the [Glimmer GUI DSL](#glimmer-gui-dsl-concepts).
+These examples include reimplementions of the examples in the [LibUI](https://github.com/kojix2/LibUI) project utilizing the [Glimmer GUI DSL](#glimmer-gui-dsl-concepts).
+
+To browse all examples, simply launch the [Meta-Example](examples/meta_example.rb), which lists all examples and displays each example's code when selected.
+
+[examples/meta_example.rb](examples/meta_example.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/meta_example.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/meta_example'"
+```
+
+Mac
+
+![glimmer-dsl-libui-mac-meta-example.png](images/glimmer-dsl-libui-mac-meta-example.png)
+
+Linux
+
+![glimmer-dsl-libui-linux-meta-example.png](images/glimmer-dsl-libui-linux-meta-example.png)
+
+[Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+require 'glimmer-dsl-libui'
+require 'facets'
+
+class MetaExample
+  include Glimmer
+  
+  def examples
+    if @examples.nil?
+      example_files = Dir.glob(File.join(File.expand_path('.', __dir__), '**', '*.rb'))
+      example_file_names = example_files.map { |f| File.basename(f, '.rb') }
+      example_file_names = example_file_names.reject { |f| f == 'meta_example' }
+      @examples = example_file_names.map { |f| f.underscore.titlecase }
+    end
+    @examples
+  end
+  
+  def file_path_for(example)
+    File.join(File.expand_path('.', __dir__), "#{example.underscore}.rb")
+  end
+  
+  def launch
+    menu('File') {
+      quit_menu_item
+    }
+    
+    window('Meta-Example', 700, 500) { |w|
+      margined true
+      
+      horizontal_box {
+        vertical_box {
+          @rbs = radio_buttons {
+            stretchy false
+            items examples
+            selected 0
+            
+            on_selected do
+              @nwme.text = File.read(file_path_for(@examples[@rbs.selected]))
+            end
+          }
+          button('Launch') {
+            stretchy false
+            
+            on_clicked do
+              system "ruby -r puts_debuggerer -r #{File.expand_path('../lib/glimmer-dsl-libui', __dir__)} #{file_path_for(@examples[@rbs.selected])}"
+            end
+          }
+        }
+        vertical_box {
+          @nwme = non_wrapping_multiline_entry {
+            read_only true
+            text File.read(file_path_for(@examples[@rbs.selected]))
+          }
+        }
+      }
+    }.show
+  end
+end
+
+MetaExample.new.launch
+```
+
 
 ### Basic Window
 
@@ -326,7 +454,7 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window('hello world', 300, 200, 1) {
+window('hello world', 300, 200, true) {
   on_closing do
     puts 'Bye Bye'
   end
@@ -397,7 +525,7 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window('hello world', 300, 200, 1) { |w|
+window('hello world', 300, 200, true) { |w|
   button('Button') {
     on_clicked do
       msg_box(w, 'Information', 'You clicked the button')
@@ -410,6 +538,23 @@ window('hello world', 300, 200, 1) { |w|
 }.show
 ```
 
+[Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version 2:
+
+```ruby
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window { # first 3 args can be set via properties with 4th arg has_menubar=true by default
+  title 'hello world'
+  content_size 300, 200
+  
+  on_closing do
+    puts 'Bye Bye'
+  end
+}.show
+```
+
 ### Basic Entry
 
 [examples/basic_entry.rb](examples/basic_entry.rb)
@@ -484,10 +629,10 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window('Basic Entry', 300, 50, 1) { |w|
+window('Basic Entry', 300, 50) { |w|
   horizontal_box {
     e = entry {
-      # stretchy 1 # Smart default option for appending to horizontal_box
+      # stretchy true # Smart default option for appending to horizontal_box
     
       on_changed do
         puts e.text
@@ -496,7 +641,7 @@ window('Basic Entry', 300, 50, 1) { |w|
     }
     
     button('Button') {
-      stretchy 0
+      stretchy false
       
       on_clicked do
         text = e.text
@@ -570,7 +715,7 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window('Notepad', 500, 300, 1) {
+window('Notepad', 500, 300) {
   on_closing do
     puts 'Bye Bye'
   end
@@ -771,10 +916,10 @@ class TinyMidiPlayer
         end
       }
     }
-    @main_window = window('Tiny Midi Player', 200, 50, 1) {
+    @main_window = window('Tiny Midi Player', 200, 50) {
       horizontal_box {
         vertical_box {
-          stretchy 0
+          stretchy false
           
           button('▶') {
             on_clicked do
@@ -1059,7 +1204,7 @@ menu('Edit') {
   check_menu_item('Checkable Item_')
   separator_menu_item
   menu_item('Disabled Item_') {
-    enabled 0
+    enabled false
   }
 }
 
@@ -1069,27 +1214,19 @@ menu('Help') {
   about_menu_item # Can optionally contain an on_clicked listener
 }
 
-MAIN_WINDOW = window('Control Gallery', 600, 500, 1) {
-  margined 1
+MAIN_WINDOW = window('Control Gallery', 600, 500) {
+  margined true
   
   on_closing do
     puts 'Bye Bye'
   end
   
   vertical_box {
-    padded 1
-
     horizontal_box {
-      padded 1
-
       group('Basic Controls') {
-        margined 1
-
         vertical_box {
-          padded 1
-
           button('Button') {
-            stretchy 0
+            stretchy false
 
             on_clicked do
               msg_box(MAIN_WINDOW, 'Information', 'You clicked the button')
@@ -1097,7 +1234,7 @@ MAIN_WINDOW = window('Control Gallery', 600, 500, 1) {
           }
 
           checkbox('Checkbox') {
-            stretchy 0
+            stretchy false
 
             on_toggled do |c|
               checked = c.checked == 1
@@ -1106,34 +1243,29 @@ MAIN_WINDOW = window('Control Gallery', 600, 500, 1) {
             end
           }
 
-          label('Label') { stretchy 0 }
+          label('Label') { stretchy false }
 
-          horizontal_separator { stretchy 0 }
+          horizontal_separator { stretchy false }
 
-          date_picker { stretchy 0 }
+          date_picker { stretchy false }
 
-          time_picker { stretchy 0 }
+          time_picker { stretchy false }
 
-          date_time_picker { stretchy 0 }
+          date_time_picker { stretchy false }
 
-          font_button { stretchy 0 }
+          font_button { stretchy false }
 
-          color_button { stretchy 0 }
+          color_button { stretchy false }
         }
       }
 
       vertical_box {
-        padded 1
-
         group('Numbers') {
-          stretchy 0
-          margined 1
+          stretchy false
 
           vertical_box {
-            padded 1
-
             spinbox(0, 100) {
-              stretchy 0
+              stretchy false
               value 42
 
               on_changed do |s|
@@ -1142,7 +1274,7 @@ MAIN_WINDOW = window('Control Gallery', 600, 500, 1) {
             }
 
             slider(0, 100) {
-              stretchy 0
+              stretchy false
 
               on_changed do |s|
                 v = s.value
@@ -1151,19 +1283,16 @@ MAIN_WINDOW = window('Control Gallery', 600, 500, 1) {
               end
             }
 
-            @progress_bar = progress_bar { stretchy 0 }
+            @progress_bar = progress_bar { stretchy false }
           }
         }
 
         group('Lists') {
-          stretchy 0
-          margined 1
+          stretchy false
 
           vertical_box {
-            padded 1
-
             combobox {
-              stretchy 0
+              stretchy false
               items 'combobox Item 1', 'combobox Item 2', 'combobox Item 3' # also accepts a single array argument
 
               on_selected do |c|
@@ -1172,7 +1301,7 @@ MAIN_WINDOW = window('Control Gallery', 600, 500, 1) {
             }
 
             editable_combobox {
-              stretchy 0
+              stretchy false
               items 'Editable Item 1', 'Editable Item 2', 'Editable Item 3' # also accepts a single array argument
             }
 
@@ -1211,6 +1340,91 @@ MAIN_WINDOW = window('Control Gallery', 600, 500, 1) {
 MAIN_WINDOW.show
 ```
 
+### Font Button
+
+[examples/font_button.rb](examples/font_button.rb)
+
+Run with this command from the root of the project if you cloned the project:
+
+```
+ruby -r './lib/glimmer-dsl-libui' examples/font_button.rb
+```
+
+Run with this command if you installed the [Ruby gem](https://rubygems.org/gems/glimmer-dsl-libui):
+
+```
+ruby -r glimmer-dsl-libui -e "require 'examples/font_button'"
+```
+
+Mac
+
+![glimmer-dsl-libui-mac-font-button.png](images/glimmer-dsl-libui-mac-font-button.png)
+![glimmer-dsl-libui-mac-font-button-selection.png](images/glimmer-dsl-libui-mac-font-button-selection.png)
+
+Linux
+
+![glimmer-dsl-libui-linux-font-button.png](images/glimmer-dsl-libui-linux-font-button.png)
+![glimmer-dsl-libui-linux-font-button-selection.png](images/glimmer-dsl-libui-linux-font-button-selection.png)
+
+[LibUI](https://github.com/kojix2/LibUI) Original Version:
+
+```ruby
+require 'libui'
+
+UI = LibUI
+
+UI.init
+
+main_window = UI.new_window('hello world', 300, 200, 1)
+
+font_button = UI.new_font_button
+font_descriptor = UI::FFI::FontDescriptor.malloc
+UI.font_button_on_changed(font_button) do
+  UI.font_button_font(font_button, font_descriptor)
+  p family: font_descriptor.Family.to_s,
+    size: font_descriptor.Size,
+    weight: font_descriptor.Weight,
+    italic: font_descriptor.Italic,
+    stretch: font_descriptor.Stretch
+end
+
+UI.window_on_closing(main_window) do
+  puts 'Bye Bye'
+  UI.control_destroy(main_window)
+  UI.quit
+  0
+end
+
+UI.window_set_child(main_window, font_button)
+UI.control_show(main_window)
+
+UI.main
+UI.quit
+
+```
+
+[Glimmer DSL for LibUI](https://rubygems.org/gems/glimmer-dsl-libui) Version:
+
+```ruby
+require 'glimmer-dsl-libui'
+
+include Glimmer
+
+window('hello world', 300, 200) {
+  font_button { |fb|
+    on_changed do
+      font_descriptor = fb.font
+      p font_descriptor
+    end
+  }
+  
+  on_closing do
+    puts 'Bye Bye'
+  end
+}.show
+
+```
+
 ## Contributing to glimmer-dsl-libui
 
 -   Check out the latest master to make sure the feature hasn't been

data/VERSION

@@ -1 +1 @@
-0.0.6
+0.0.10

data/examples/basic_button.rb

@@ -4,7 +4,7 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window('hello world', 300, 200, 1) { |w|
+window('hello world', 300, 200) { |w|
   button('Button') {
     on_clicked do
       msg_box(w, 'Information', 'You clicked the button')

data/examples/basic_entry.rb

@@ -4,10 +4,10 @@ require 'glimmer-dsl-libui'
 
 include Glimmer
 
-window('Basic Entry', 300, 50, 1) { |w|
+window('Basic Entry', 300, 50) { |w|
   horizontal_box {
     e = entry {
-      # stretchy 1 # Smart default option for appending to horizontal_box
+      # stretchy true # Smart default option for appending to horizontal_box
     
       on_changed do
         puts e.text
@@ -16,7 +16,7 @@ window('Basic Entry', 300, 50, 1) { |w|
     }
     
     button('Button') {
-      stretchy 0
+      stretchy false
       
       on_clicked do
         text = e.text