libui_paradise 0.2.49

data/lib/libui_paradise/examples/complex/013_form_example.rb

@@ -0,0 +1,38 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'libui_paradise/examples/complex/013_form_example.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+window = margined_window('Form Example', 250, 150, 0)
+
+outer_vbox = padded_vbox
+
+hbox1 = padded_hbox
+hbox1.minimal(text('First Name'), 0)
+@first_name_entry = entry
+hbox1.minimal(@first_name_entry, 0)
+outer_vbox.minimal(hbox1, 0)
+
+hbox2 = padded_hbox
+hbox2.minimal(text('Last Name'), 0)
+@last_name_entry = entry
+hbox2.minimal(@last_name_entry, 0)
+outer_vbox.minimal(hbox2, 0)
+
+button_display_name = button('Display Name')
+button_display_name.on_clicked {
+  ui_msg_box(
+    :default,
+    'Name',
+    "#{@first_name_entry.text?} #{@last_name_entry.text?}"
+  )
+}
+
+outer_vbox.minimal(hsep, 0)
+outer_vbox.minimal(button_display_name, 1)
+
+window.child = outer_vbox
+window.intelligent_quit

data/lib/libui_paradise/examples/complex/014_text_example.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# '014_text_example.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+window = padded_main_window('Text Example', 200, 100, 1)
+
+outer_vbox = padded_vbox
+text = ui_text
+
+outer_vbox.minimal(text, 1)
+
+text.set_text('Hello world!')
+window.child = outer_vbox
+window.intelligent_quit

data/lib/libui_paradise/examples/complex/015_text_view_example.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# 024_text_view_example.rb
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+window = padded_main_window('Text View Example', 500, 300, 0)
+
+outer_vbox = padded_vbox
+text = multiline_entry('Hello world! This can be set to read only via .is_read_only().')
+# text.is_read_only
+outer_vbox.minimal(text, 1)
+window.child = outer_vbox
+window.intelligent_quit

data/lib/libui_paradise/examples/complex/016_grid_example.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This example shows how to use the grid-related aspects of ruby-libui.
+# =========================================================================== #
+# require 'libui_paradise/016_grid_example.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+window = padded_main_window('A simple grid-example', 1200, 200, 15)
+
+grid = ui_padded_grid
+UI.grid_append(grid, text('Yo1'), 0, 0, 1, 1, 0, 0, 1, 0)
+UI.grid_append(grid, text('Yo2'), 1, 0, 1, 1, 0, 0, 1, 0)
+UI.grid_append(grid, text('Yo3'), 2, 0, 1, 1, 0, 0, 1, 0)
+
+UI.grid_append(grid, text('Yo4'), 0, 1, 1, 1, 0, 0, 1, 0)
+UI.grid_append(grid, text('Yo5'), 1, 1, 1, 1, 0, 0, 1, 0)
+UI.grid_append(grid, text('Yo6'), 2, 1, 1, 1, 0, 0, 1, 0)
+
+grid.hash_grid(
+  text('Yo7'),
+  { left: 2, top: 3, xspan: 3, yspan: 3, hexpand: 0, halign: 0, vexpand: 0, valign: 0 }
+)
+
+vbox = padded_vbox
+vbox << grid
+
+window.child = vbox
+window.intelligent_exit

data/lib/libui_paradise/examples/complex/017_unicode_text_example.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This example just shows that unicode text works.
+# =========================================================================== #
+# require 'examples/complex/017_unicode_text_example.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+window = ui_margined_main_window('Unicode Text Example', 1200, 200, 15)
+
+outer_vbox = padded_vbox
+text = text(
+"This is some text. You do not even have to wrap it - the newlines will
+appear in the text as-is.
+
+If something is supported then unicode should be able to show that.
+
+Let's test this next with some unicode:
+
+  🎉 用户界面 사용자 인터페이스
+    ₀₁₂₃₄₅₆₇₈₉
+
+")
+
+outer_vbox << text
+
+window.child = outer_vbox
+window.intelligent_quit

data/lib/libui_paradise/examples/complex/018_spinbutton_example.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This example just shows a spinbutton example.
+# =========================================================================== #
+# require '018_spinbutton_example.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+window = padded_main_window('Spinbutton Example', 250, 70, 1)
+
+outer_vbox = padded_vbox
+spinbutton = ui_spinbutton(0, 100)
+spinbutton.set_value(42)
+
+# =========================================================================== #
+# Add the on-spin event next:
+# =========================================================================== #
+spinbox_changed_callback = proc { |pointer|
+  # ========================================================================= #
+  # Notify the user that the spinbox-value has changed.
+  # ========================================================================= #
+  puts "Changed value to: #{UI.spinbox_value(pointer)}"
+  0
+}
+
+LibUI.spinbox_on_changed(spinbutton, spinbox_changed_callback, nil)
+
+outer_vbox << spinbutton
+
+window.child = outer_vbox
+window.intelligent_quit

data/lib/libui_paradise/examples/complex/019_combo_box_example.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require '019_combo_box_example.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+TITLE  = 'Combo Box Example'
+WIDTH  = 500
+HEIGHT = 250
+main_window = ui_main_window(TITLE, WIDTH, HEIGHT, 0)
+
+@entry = ui_entry
+
+@combo_box = ui_combobox(
+  [
+    'combobox Item 1',
+    'combobox Item 2',
+    'combobox Item 3'
+  ]
+)
+
+# =========================================================================== #
+# The next code used to be in place until September 2021. I will retain it
+# here in the event that we need to use it again one day.
+# =========================================================================== #
+
+# combobox_selected_callback = proc { |pointer|
+#   e "New combobox selection: #{UI.combobox_selected(pointer)}"
+#   @entry.set_text(selected?(pointer))
+# }
+# 
+# UI.combobox_on_selected(@combo_box, combobox_selected_callback, nil)
+
+ui_sync_connect(@combo_box, @entry)
+
+box = padded_vbox
+box << @combo_box
+box << @entry
+
+button_clear_the_combo_box = LibuiParadise.button('Clear the combo box')
+button_clear_the_combo_box.on_clicked {
+  e 'Trying to clear the combo-box next.'
+  @combo_box.clear
+}
+
+box.minimal(button_clear_the_combo_box)
+main_window.child = box
+main_window.intelligent_exit

data/lib/libui_paradise/examples/complex/020_checkbox_example.rb

@@ -0,0 +1,81 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require '020_checkbox_example'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+# =========================================================================== #
+# === HEIGHT
+# =========================================================================== #
+HEIGHT = 120
+
+should_quit_callback = proc {
+  LibUI.control_destroy(MAIN_WINDOW)
+  LibUI.quit
+  0
+}
+
+open_menu_item_clicked = proc {
+  puts "Clicked 'Open'"
+  0
+}
+
+save_menu_item_clicked = proc {
+  puts "Clicked 'Save'"
+  0
+}
+
+# =========================================================================== #
+# Create 'File' menu with a few items and callbacks when the items are
+# clicked.
+# =========================================================================== #
+menu = UI.menu('File')
+open_menu_item = UI.menu_append_item(menu, 'Open')
+UI.menu_item_on_clicked(open_menu_item, open_menu_item_clicked, nil)
+save_menu_item = UI.menu_append_item(menu, 'Save')
+UI.menu_item_on_clicked(save_menu_item, save_menu_item_clicked, nil)
+UI.menu_append_quit_item(menu)
+UI.on_should_quit(should_quit_callback, nil)
+
+# =========================================================================== #
+# Create the 'Help' menu
+# =========================================================================== #
+help_menu = UI.menu('Help')
+UI.menu_append_item(help_menu, 'Help')
+UI.menu_append_about_item(help_menu)
+
+vbox = UI.vbox
+
+a_hbox = UI.hbox
+UI.box_set_padded(vbox, 1)
+UI.box_set_padded(a_hbox, 1)
+
+vbox << a_hbox
+
+group = UI.new_group('Top Group')
+UI.group_set_margined(group, 1)
+a_hbox.add(group, 0)
+
+inner = UI.vbox
+UI.box_set_padded(inner, 1)
+UI.group_set_child(group, inner)
+
+checkbox = UI.checkbox('Checkbox')
+checkbox_toggle_callback = proc { |ptr|
+  checked = UI.checkbox_checked(ptr) == 1
+  UI.checkbox_set_text(ptr, "I am the checkbox (#{checked})")
+}
+
+UI.checkbox_on_toggled(checkbox, checkbox_toggle_callback, nil)
+inner.add(checkbox, 0)
+
+MAIN_WINDOW = UI.window('hello world', 600, HEIGHT, 1)
+
+UI.window_set_margined(MAIN_WINDOW, 1)
+UI.window_set_child(MAIN_WINDOW, vbox)
+
+UI.window_on_closing(MAIN_WINDOW, should_quit_callback, nil)
+MAIN_WINDOW.control_show
+UI.main_then_quit

data/lib/libui_paradise/examples/complex/021_font_example.rb

@@ -0,0 +1,115 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === 021_font_example.rb
+# =========================================================================== #
+# This example shows how to display coloured text.
+#
+# An AttributedString is a string which also contains information
+# about styles such as text color, font, font size. It will be
+# drawn in an UiArea element.
+# =========================================================================== #
+# require 'libui_paradise/examples/complex/021_font_example.rb'
+# =========================================================================== #
+class FontExample
+
+  require 'libui_paradise'
+  include LibuiParadise::Extensions
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  #
+  # Specify a certain font to use.
+  # ========================================================================= #
+  USE_THIS_FONT = 'Georgia'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT_SIZE
+  # ========================================================================= #
+  USE_THIS_FONT_SIZE = 25
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Font Example'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = 500
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    handler = LibUI::FFI::AreaHandler.malloc
+    area    = LibUI.new_area(handler)
+    str1 = 'At last Ygramul sensed that something was coming toward her.'
+    attr_str = LibuiParadise.fancy_text('')
+    def attr_str.append(what)
+      color_attribute = LibUI.new_color_attribute(0.5, 0.0, 0.25, 0.7)
+      start = LibUI.attributed_string_len(self)
+      LibUI.attributed_string_append_unattributed(self, what)
+      LibUI.attributed_string_set_attribute(self, color_attribute, start, start + what.size)
+      LibUI.attributed_string_append_unattributed(self, "\n\n")
+    end
+    attr_str.append(str1)
+    handler_draw_event = Fiddle::Closure::BlockCaller.new(0, [1, 1, 1]) { |_, _, adp|
+      area_draw_params = LibUI::FFI::AreaDrawParams.new(adp)
+      default_font = font {{
+        font_size:   USE_THIS_FONT_SIZE,
+        font_family: USE_THIS_FONT,
+        italic:      false,
+        stretch:     2,
+        weight:      500
+      }}
+
+      params = ui_draw_text_layout_params
+
+      params.String = attr_str
+      params.DefaultFont = default_font
+      params.Width = area_draw_params.AreaWidth
+      params.Align = 0
+      text_layout = LibUI.draw_new_text_layout(params)
+      LibUI.draw_text(area_draw_params.Context, text_layout, 0, 0)
+      LibUI.draw_free_text_layout(text_layout)
+    }
+    # =========================================================================== #
+    # Assigning to local variables:
+    #
+    # This is intended to protect Fiddle::Closure from garbage collection.
+    #
+    # =========================================================================== #
+    handler.Draw         = handler_draw_event
+    handler.MouseEvent   = (c1 = Fiddle::Closure::BlockCaller.new(0, [0]) {})
+    handler.MouseCrossed = (c2 = Fiddle::Closure::BlockCaller.new(0, [0]) {})
+    # handler.DragBroken   = (c3 = Fiddle::Closure::BlockCaller.new(0, [0]) {})
+    # handler.KeyEvent     = (c4 = Fiddle::Closure::BlockCaller.new(0, [0]) {})
+
+    box = ui_padded_vbox
+    box.maximal(area)
+    box.maximal(ui_hseparator)
+
+    main_window = ui_main_window(TITLE, WIDTH, 400, 1)
+    LibUI.window_set_margined(main_window, 1)
+    main_window.child = box
+    main_window.simple_exit
+    main_window.control_show
+    main_window.intelligent_exit
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  FontExample.new
+end

data/lib/libui_paradise/examples/complex/022_simple_notepad_example.rb

@@ -0,0 +1,25 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'libui_paradise/examples/022_simple_notepad_example.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+window = padded_window('Notepad', 500, 300, 1)
+
+vbox = ui_vbox
+
+text_view = ui_text_view
+text_view.set_text(
+  "This is an example.\nAs can be seen, text has been assigned to this.\n"
+)
+vbox << text_view
+button_show_content = button('Paste the content of the text-buffer above')
+button_show_content.on_clicked {
+  e text_view.text?.to_s
+}
+
+vbox << button_show_content
+window.child = vbox
+window.intelligent_exit

data/lib/libui_paradise/examples/complex/023_msg_box_error.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require '005_msg_box_error.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+TITLE = 'msg box error'
+main_window = ui_padded_window(TITLE, 300, 200, 1)
+
+button1 = ui_button('Text (click me)')
+button1.on_clicked {
+  LibuiParadise::Extensions.message_box_error(
+    main_window,
+    'Error',
+    "You clicked \nthe button"
+  )
+  0
+}
+
+hbox = padded_hbox
+hbox << button1
+main_window.close_properly
+main_window.child = hbox
+main_window.control_show
+UI.main_then_quit

data/lib/libui_paradise/examples/complex/024_parse_config_file_example.config

@@ -0,0 +1,6 @@
+width:                                      1000
+height:                                      150
+padding:                                       5
+title:                 Parse Config File Example
+favicon:                                 :tabble
+font_in_use:                             Sans 22

data/lib/libui_paradise/examples/complex/024_parse_config_file_example.rb

@@ -0,0 +1,15 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require '022_'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+use_this_config_file = '024_parse_config_file_example.config'
+window = LibuiParadise.parse_this_config_file(use_this_config_file)
+outer_vbox = padded_vbox
+text = text('The config file was '+use_this_config_file)
+outer_vbox << text
+window.child = outer_vbox
+window.intelligent_quit

data/lib/libui_paradise/examples/complex/025_colour_button.rb

@@ -0,0 +1,53 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This button doesn't work properly right now. :(
+# =========================================================================== #
+# require '025_colour_button.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+window = main_window('Colour Button', 500, 300, 0)
+outer_vbox = padded_vbox
+our_colour_button = ui_colour_button
+
+# colour_button.on_changed {|callback|
+#   pp callback.class
+#   rgba = callback.color
+#   pp rgba
+# }
+
+# on_changed_proc = proc {|callback|
+#   rgba = callback.color
+#   pp rgba
+# }
+
+xyz = proc {|pointer|
+  # rgba = pointer.color
+  #pp rgba
+  pp pointer.to_s
+  nil
+}
+
+LibUI.color_button_on_changed(our_colour_button, xyz, nil)
+#   # rgba = pointer.color
+#   # pp rgba
+#   pp pointer
+#   pp pointer.to_s
+# }
+
+
+# UI.color_button_on_changed(color_button) do
+#   UI.area_queue_redraw_all(histogram)
+# end
+
+#, on_changed_proc.call, nil)
+
+#UI.spinbox_on_changed(spinbox) do |ptr|
+#  puts "New Spinbox value: #{UI.spinbox_value(ptr)}"
+#end
+
+outer_vbox.minimal(our_colour_button, 1)
+window.child = outer_vbox
+window.intelligent_quit

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

@@ -0,0 +1,96 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This example displays images that can be freely downloaded from the
+# Studio Ghibli website.
+# =========================================================================== #
+# require 'examples/complex/026_basic_table_image.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+require 'chunky_png'
+require 'open-uri'
+
+N_TIMES = 10
+# =========================================================================== #
+# === REMOTE_URL
+# =========================================================================== #
+REMOTE_URL = 'https://www.ghibli.jp/gallery/thumb-redturtle%03d.png'
+
+main_window = ui_main_window('The Red Turtle', 310, 350, 0)
+
+hbox = ui_padded_hbox
+main_window.simple_exit
+main_window.child = hbox
+
+# =========================================================================== #
+# === IMAGES
+# =========================================================================== #
+IMAGES = []
+
+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 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
+}
+
+# =========================================================================== #
+# Protects BlockCaller objects from garbage collection.
+# =========================================================================== #
+@blockcaller = []
+# =========================================================================== #
+# === rbcallback
+# =========================================================================== #
+def rbcallback(*args, &block)
+  args << [0] if args.size == 1 # Argument types are ommited
+  blockcaller = Fiddle::Closure::BlockCaller.new(*args, &block)
+  @blockcaller << blockcaller
+  blockcaller
+end
+
+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|
+  LibUI.new_table_value_image(IMAGES[row])
+end
+model_handler.SetCellValue = rbcallback(0, [0]) {}
+
+model = LibUI.new_table_model(model_handler)
+
+table_params = LibUI::FFI::TableParams.malloc
+table_params.Model = model
+table_params.RowBackgroundColorModelColumn = -1
+
+table = ui_table(table_params)
+UI.table_append_image_column(table, 'www.ghibli.jp/works/red-turtle', -1)
+hbox.maximal(table)
+
+main_window.show_the_controls
+
+UI.window_on_closing(main_window) {
+  e 'Bye Bye'
+  UI.control_destroy(main_window)
+  UI.free_table_model(model)
+  IMAGES.each { |i| UI.free_image(i) }
+  UI.quit
+  0
+}
+
+UI.main_then_quit

data/lib/libui_paradise/examples/complex/027_basic_button_example.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'complex/027_basic_button_example.rb'
+# =========================================================================== #
+require 'libui_paradise/autoinclude'
+
+main_window = main_window('hello world', 300, 200, 0)
+
+button = button('Button')
+button.on_clicked {|widget| # is a <Fiddle::Pointer:0x00005590774f1ca0 ptr=0x0000559077484c90 size=0 free=0x0000000000000000>
+  e 'The main button was clicked.'
+  ui_msg_box(main_window, 'Information', 'You clicked the button')
+  0
+}
+
+main_window.child = button
+main_window.intelligent_exit