libui_paradise 0.2.47 → 0.2.48

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fab1c58cac6e317237a99b41a688b30ac2608af85c59e875f833d686d73e9f7f
-  data.tar.gz: 2dfb6e810f4f36228210903f025626d8f9c67b54f24abed0614c27250b80ced9
+  metadata.gz: 015e2bdf5347c46f0626f2c85986c1ff78a6ba012bdc93bcd155ec03d0119fd4
+  data.tar.gz: ec220a3ab72d23b380f13514385b77c0502ca2551307319c616323c607d6814c
 SHA512:
-  metadata.gz: fc594f56cf0510b19988aed6478fad45b10dd4d272780e75dfded90e845faf440002f98842151b55d2a4e418ed20f684f944892c45a746497b0839195e991acb
-  data.tar.gz: 7a15dd21e92dbb412d8cffbc47b0dfd8396596917ea4887c298a9a1ff66fad37beb072d1307060a9472986f5731ac45a3044b97aad6d5369a0fda581659f714d
+  metadata.gz: 63ac2173d296097061f9acc5785de0a7023312e4e5d8aa8397536c388059a8d6ffaa4b4f087374f1ef540d5d0ce99000fe410f450d8637ecc84fd56015a54302
+  data.tar.gz: 9d427d5b2f98585eb5960b14d070ace27ff802f2c09abda741a7c110f27ef9b5e6d2435240985ad92556b1648a040deaed608d5c0cbd25b672c95dae5c07e917

data/README.md

@@ -2,7 +2,7 @@
 [![forthebadge](https://forthebadge.com/images/badges/made-with-ruby.svg)](https://www.ruby-lang.org/en/)
 [![Gem Version](https://badge.fury.io/rb/libui_paradise.svg)](https://badge.fury.io/rb/libui_paradise)
 
-This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">04.09.2022</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">19:16:10</span> o'clock.
+This gem was <b>last updated</b> on the <span style="color: darkblue; font-weight: bold">09.09.2022</span> (dd.mm.yyyy notation), at <span style="color: steelblue; font-weight: bold">15:44:15</span> o'clock.
 
 ## The libui_paradise project
 
@@ -749,6 +749,29 @@ not necessarily recommending this be done, but **if** you ever have
 such a use case then you can use it - which is another reason why
 I added this screenshot, so that I don't forget. :)
 
+## Padding elements in LibUI
+
+The general API for setting padding to a container in LibUI
+goes via:
+
+    LibUI.box_set_padded(box, 1) # The value is usually either 0 or 1.
+
+The alignment value may be as follows:
+
+    0: Fill
+    1: Start
+    2: Center
+    3: End
+
+Positioning values may typically be:
+
+    0: Left
+    1: Top
+    2: Right
+
+Have a look at the example file <b>libui_paradise/examples/simple/007_control_gallery.rb</b>
+to see how this could be used.
+
 ## LibUI::FFI::DrawTextLayoutParams.malloc
 
 LibUI::FFI::DrawTextLayoutParams.malloc can be used to draw
@@ -1087,19 +1110,6 @@ subsequently removed one day.
   UI.control_show(main_window)
   main_window.show_the_controls # Or use this one here.
 
-# How to set a padded box:
-
-  UI.box_set_padded(box, 1) # The value is either 0 or 1.
-
-  Alignment may be:
-    0: Fill
-    1: Start
-    2: Center
-    3: End
- Positioning:
-    0: Left
-    1: Top
-    2: Right
 
 # Add a checkbox (checkbox tag, checkbutton)
 
@@ -1553,6 +1563,15 @@ Use the following API for this:
 
     image = LibUI.new_image(width, height)
 
+You can use external libraries to determine the width
+and height of an image, such as ChunkyPNG.
+
+Example for this:
+
+    canvas = ChunkyPNG::Canvas.from_io(this_file)
+    width = canvas.width
+    height = canvas.height
+
 ## Horizontal boxes
 
 A HBox represents a horizontal box. The API for putting 

data/doc/README.gen

@@ -746,6 +746,29 @@ not necessarily recommending this be done, but **if** you ever have
 such a use case then you can use it - which is another reason why
 I added this screenshot, so that I don't forget. :)
 
+## Padding elements in LibUI
+
+The general API for setting padding to a container in LibUI
+goes via:
+
+    LibUI.box_set_padded(box, 1) # The value is usually either 0 or 1.
+
+The alignment value may be as follows:
+
+    0: Fill
+    1: Start
+    2: Center
+    3: End
+
+Positioning values may typically be:
+
+    0: Left
+    1: Top
+    2: Right
+
+Have a look at the example file <b>libui_paradise/examples/simple/007_control_gallery.rb</b>
+to see how this could be used.
+
 ## LibUI::FFI::DrawTextLayoutParams.malloc
 
 LibUI::FFI::DrawTextLayoutParams.malloc can be used to draw
@@ -1439,6 +1462,15 @@ Use the following API for this:
 
     image = LibUI.new_image(width, height)
 
+You can use external libraries to determine the width
+and height of an image, such as ChunkyPNG.
+
+Example for this:
+
+    canvas = ChunkyPNG::Canvas.from_io(this_file)
+    width = canvas.width
+    height = canvas.height
+
 ## Horizontal boxes
 
 A HBox represents a horizontal box. The API for putting 

data/doc/SNIPPETS.md

@@ -26,19 +26,6 @@
   UI.control_show(main_window)
   main_window.show_the_controls # Or use this one here.
 
-# How to set a padded box:
-
-  UI.box_set_padded(box, 1) # The value is either 0 or 1.
-
-  Alignment may be:
-    0: Fill
-    1: Start
-    2: Center
-    3: End
- Positioning:
-    0: Left
-    1: Top
-    2: Right
 
 # Add a checkbox (checkbox tag, checkbutton)
 

data/lib/libui_paradise/base/base.rb

@@ -113,6 +113,16 @@ class Base # === LibuiParadise::Base
     # ======================================================================= #
     outer_vbox.add_hsep
     i.flatten.each {|this_widget|
+      # ===================================================================== #
+      # Some symbols exist as special keywords:
+      # ===================================================================== #
+      case this_widget
+      # ===================================================================== #
+      # === :create_a_quit_button
+      # ===================================================================== #
+      when :create_a_quit_button
+        this_widget = quit_button
+      end
       outer_vbox.minimal(this_widget)
     }
     @window.add(outer_vbox)

data/lib/libui_paradise/examples/complex/026_basic_table_image.rb

@@ -28,24 +28,26 @@ main_window.child = hbox
 # =========================================================================== #
 IMAGES = []
 
-N_TIMES.times do |i|
+N_TIMES.times { |i|
   url = format(REMOTE_URL, (i + 1))
   this_file = URI.open(url)
+  # =========================================================================== #
   # Use ChunkyPNG::Canvas to get information about the image at hand.
+  # =========================================================================== #
   canvas = ChunkyPNG::Canvas.from_io(this_file)
   this_file.close
   data = canvas.to_rgba_stream
   width = canvas.width
   height = canvas.height
   # ========================================================================= #
-  # Add a new image here:
+  # Add a new image next:
   # ========================================================================= #
   image = UI.new_image(width, height)
   UI.image_append(image, data, width, height, width * 4)
   IMAGES << image # Store all images in the following area.
 rescue StandardError => error
   warn url, error.message
-end
+}
 
 # =========================================================================== #
 # Protects BlockCaller objects from garbage collection.
@@ -61,18 +63,18 @@ def rbcallback(*args, &block)
   blockcaller
 end
 
-model_handler = UI::FFI::TableModelHandler.malloc
+model_handler = LibUI::FFI::TableModelHandler.malloc
 model_handler.NumColumns   = rbcallback(4) { 1 }
 model_handler.ColumnType   = rbcallback(4) { 1 } # Image
 model_handler.NumRows      = rbcallback(4) { IMAGES.size }
 model_handler.CellValue    = rbcallback(1, [1, 1, 4, 4]) do |_, _, row, _column|
-  UI.new_table_value_image(IMAGES[row])
+  LibUI.new_table_value_image(IMAGES[row])
 end
 model_handler.SetCellValue = rbcallback(0, [0]) {}
 
-model = UI.new_table_model(model_handler)
+model = LibUI.new_table_model(model_handler)
 
-table_params = UI::FFI::TableParams.malloc
+table_params = LibUI::FFI::TableParams.malloc
 table_params.Model = model
 table_params.RowBackgroundColorModelColumn = -1
 

data/lib/libui_paradise/version/version.rb

@@ -7,11 +7,11 @@ module LibuiParadise
   # ========================================================================= #
   # === VERSION
   # ========================================================================= #
-  VERSION = '0.2.47'
+  VERSION = '0.2.48'
 
   # ========================================================================= #
   # === LAST_UPDATE
   # ========================================================================= #
-  LAST_UPDATE = '04.09.2022'
+  LAST_UPDATE = '09.09.2022'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: libui_paradise
 version: !ruby/object:Gem::Version
-  version: 0.2.47
+  version: 0.2.48
 platform: ruby
 authors:
 - Robert A. Heiler
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-09-04 00:00:00.000000000 Z
+date: 2022-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: libui
@@ -139,9 +139,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.3.20
+      version: 3.3.22
 requirements: []
-rubygems_version: 3.3.20
+rubygems_version: 3.3.22
 signing_key:
 specification_version: 4
 summary: 'This project bundles together some custom bindings and code to the official