gtk_paradise 0.9.120 → 0.12.25

data/lib/gtk_paradise/examples/advanced/029_entry_completion_example.rb

@@ -0,0 +1,141 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Gtk::EntryCompletionExample
+#
+# This example shows how to scale up an image.
+# =========================================================================== #
+# require 'gtk_paradise/gui/gtk3/advanced/020_scale_this_image.rb'
+# Gtk::EntryCompletionExample.run
+# =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
+module Gtk
+
+class EntryCompletionExample < ::Gtk::BaseModuleBox # === Gtk::EntryCompletionExample 
+
+  begin
+    require 'studium/toplevel_methods/available_topics.rb'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Scale This Image'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '55% or minimum 200px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '55% or minimum 100px'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_20
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = ARGV,
+      run_already           = true
+    )
+    super(:vertical)
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    reset_the_internal_variables
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, NAMESPACE]
+    # ======================================================================= #
+    # === @title
+    # ======================================================================= #
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    use_gtk_paradise_project_css_file
+    infer_the_size_automatically
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    12
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    8
+  end
+
+  # ========================================================================= #
+  # === create_skeleton                                          (create tag)
+  # ========================================================================= #
+  def create_skeleton
+  end
+
+  # ========================================================================= #
+  # === connect_skeleton                                        (connect tag)
+  # ========================================================================= #
+  def connect_skeleton
+    abort_on_exception
+    vbox = create_vbox
+    vbox.left_aligned_text('This shows an example how to use a completable entry.')
+    entry = create_entry
+    array = []
+    array << ['andy','andrew','john','joe','fox','cat','dog','dave']
+    array << Studium.available_exam_topics_in_short_form? if Object.const_defined?(:Studium)
+    entry.completion = create_entry_completion(array)
+    vbox.minimal(entry, 25)
+    scrolled_window = create_scrolled_window(vbox)
+    maximal(scrolled_window)
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    super()
+  end
+
+  # ========================================================================= #
+  # === Gtk::EntryCompletionExample.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/app/app.rb'
+    _ = ::Gtk::EntryCompletionExample.new(i)
+    r = ::Gtk.run
+    r << _
+    r.automatic_size_then_automatic_title
+    r.top_left_then_run
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Gtk::EntryCompletionExample.run
+end

data/lib/gtk_paradise/examples/cairo/basic_cairo_shapes.rb

@@ -117,7 +117,7 @@ class BasicCairoShapes < Gtk::Window
     set_title TITLE
     signal_connect(:destroy) { Gtk.main_quit }
     initialize_the_drawing_area
-    set_default_size(1000, 800)
+    set_default_size(800, 500)
     set_window_position :center
     show_all
     move(0, 0)

data/lib/gtk_paradise/examples/cairo/cairo_transparent_rectangles.rb

@@ -8,20 +8,24 @@
 # alpha compositing. 
 #
 # Usage example:
-#   CairoTransparentRectangles.new
+#
+#   CairoTransparentRectangles.new(ARGV)
+#
 # =========================================================================== #
-# require 'cairo_transparent_rectangles.rb'
+# require 'gtk_paradise/examples/cairo_transparent_rectangles.rb'
 # =========================================================================== #
 require 'gtk3'
 
-class CairoTransparentRectangles < Gtk::Window
+class CairoTransparentRectangles < Gtk::Window # === CairoTransparentRectangles
 
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
-  def initialize
+  def initialize(
+      run_already = true
+    )
     super()
-    run
+    run if run_already
   end
 
   # ========================================================================= #

data/lib/gtk_paradise/examples/cairo/cairo_write_via_custom_font.rb

@@ -0,0 +1,81 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'gtk3'
+
+class CairoWriteviaCustomFont < Gtk::Window
+
+  # ========================================================================= #
+  # === USE_THIS_FONT_FACE
+  # ========================================================================= #
+  USE_THIS_FONT_FACE = 'Hack' # 'Chandas'
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    super()
+    run
+  end
+  
+  # ========================================================================= #
+  # === init_ui
+  # ========================================================================= #
+  def init_ui
+    @darea = Gtk::DrawingArea.new  
+    @darea.signal_connect(:draw) { on_draw }
+    add @darea 
+  end
+  
+  # ========================================================================= #
+  # === on_draw
+  # ========================================================================= #
+  def on_draw
+    cr = @darea.window.create_cairo_context  
+    draw_lyrics(cr)
+  end
+  
+  # ========================================================================= #
+  # === draw_lyrics
+  # ========================================================================= #
+  def draw_lyrics(cr)
+    cr.set_source_rgb 0.1, 0.1, 0.1
+    # ======================================================================= #
+    # Select the font to use next.
+    # ======================================================================= #
+    cr.select_font_face USE_THIS_FONT_FACE, Cairo::FONT_SLANT_NORMAL, 
+                        Cairo::FONT_WEIGHT_NORMAL
+    cr.set_font_size 35
+    cr.move_to 20, 30
+    cr.show_text 'Most relationships seem so transitory'
+    cr.move_to 20, 60
+    cr.show_text "They're all good but not the permanent one"
+    cr.move_to 20, 120
+    cr.show_text "Who doesn't long for someone to hold"
+    cr.move_to 20, 150
+    cr.show_text 'Who knows how to love without being told'
+    cr.move_to 20, 180
+    cr.show_text "Somebody tell me why I'm on my own"
+    cr.move_to 20, 210
+    cr.show_text "If there's a soulmate for everyone"
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    set_title 'Soulmate'
+    signal_connect(:destroy) { Gtk.main_quit }
+    init_ui
+    set_default_size(1024, 640)
+    set_window_position :center
+    show_all
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  CairoWriteviaCustomFont.new
+  Gtk.main
+end

data/lib/gtk_paradise/examples/cairo/donut_shape.rb

@@ -16,6 +16,7 @@ class CairoDonut < Gtk::Window
   # ========================================================================= #
   def initialize
     super
+    reset
     set_title 'Donut'
     signal_connect(:destroy) { Gtk.main_quit }
     init_ui
@@ -24,28 +25,40 @@ class CairoDonut < Gtk::Window
     show_all
   end
 
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    @line_width_to_use = 0.85
+  end
+
   # ========================================================================= #
   # === init_ui
   # ========================================================================= #
   def init_ui
-    @darea = Gtk::DrawingArea.new  
-    @darea.signal_connect(:draw) { on_draw }
-    add @darea
+    # ======================================================================= #
+    # === @drawing_area
+    #
+    # We will draw onto this area.
+    # ======================================================================= #
+    @drawing_area = Gtk::DrawingArea.new  
+    @drawing_area.signal_connect(:draw) { on_draw }
+    add(@drawing_area)
   end
 
   # ========================================================================= #
   # === on_draw
   # ========================================================================= #
   def on_draw
-    cr = @darea.window.create_cairo_context  
+    cr = @drawing_area.window.create_cairo_context  
     draw_donut(cr)
   end
   
   # ========================================================================= #
   # === draw_donut
   # ========================================================================= #
-  def draw_donut(cr)
-    cr.set_line_width 0.5
+  def draw_donut(cr = @drawing_area.window.create_cairo_context)
+    cr.set_line_width @line_width_to_use
     w = allocation.width
     h = allocation.height
     # First, we draw the outer ellipse.

data/lib/gtk_paradise/examples/cairo/ping_pong_game.rb

@@ -4,13 +4,12 @@
 # =========================================================================== #
 require 'gtk2'
 
-#require 'gtk_paradise'
-
 module Pong
 
 class CenteredItem
 
-  attr_accessor :x, :y
+  attr_accessor :x
+  attr_accessor :y
 
   # ========================================================================= #
   # === initialize

data/lib/gtk_paradise/examples/controller/README.md

@@ -1,3 +1,7 @@
 The idea for the controller (the file called controller.rb) is to load
 up all the different examples that are available for either ruby-gtk3
 or ruby-gtk2, and allow the user to have a look at each one of them.
+
+It does not work that well, because several examples have not been
+ported to a class-centric structure, but in the future we may want
+to fix these issues, so the code will remain here.

data/lib/gtk_paradise/examples/controller/controller.rb

@@ -40,6 +40,7 @@ display_these_files << 'gtk_paradise/examples/gtk3/020_radio_button_window.rb'
 display_these_files << 'gtk_paradise/examples/gtk3/021_scale_button_demo.rb'
 display_these_files << 'gtk_paradise/examples/gtk3/026_hover_button_example_via_css.rb'
 display_these_files << 'gtk_paradise/examples/gtk3/027_spin_button_example.rb'
+display_these_files << 'gtk_paradise/examples/gtk3/071_search_bar_example.rb'
 
 # =========================================================================== #
 # This example only works on ruby-gtk3, as Gtk::Switch is not part of gtk2.
@@ -73,6 +74,7 @@ notebook.append_page(Gtk::HoverButtonExampleViaCss.new,   Gtk::Label.new('(12) G
 notebook.append_page(Gtk::SpinButtonExample.new,          Gtk::Label.new('(13) Gtk::SpinButtonExample'))
 notebook.append_page(Gtk::SmallPanedExample.new,          Gtk::Label.new('(14) Gtk::SmallPanedExample'))
 notebook.append_page(Gtk::SpinnerExample.new,             Gtk::Label.new('(15) Gtk::SpinnerExample'))
+notebook.append_page(Gtk::SearchBarExample.new,           Gtk::Label.new('(16) Gtk::SearchBarExample'))
 
 notebook.show_all
 window.add(notebook)

data/lib/gtk_paradise/examples/css/001_border_examples.rb

@@ -13,7 +13,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
   # ========================================================================= #
   # === USE_THIS_FONT
   # ========================================================================= #
-  USE_THIS_FONT = :hack_17
+  USE_THIS_FONT = :hack_18
 
   # ========================================================================= #
   # === initialize
@@ -94,7 +94,11 @@ class BorderExamples < ::Gtk::ScrolledWindow
   border:  25px solid '+random_html_colour6+';
   border-radius:  16px;
   box-shadow:inset rgba(15,55,123, .8) 1.5em .2em 5em;
+}
 
+.border12 {
+  border: 12px solid steelblue;
+  border-radius: 25px;
 }
 
     '
@@ -114,9 +118,9 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border1 = gtk_hbox
     hbox_border1.css_class('border1')
-    hbox_border1.css_class('pad8px')
+    hbox_border1.pad8px
     hbox_border1.add(
-      text('This is inside of a box with border-bottom: 3px solid darkblue.')
+      selectable_text('This is inside of a box with border-bottom: 3px solid darkblue.')
     )
     @outer_vbox.minimal(hbox_border1, 10)
 
@@ -125,7 +129,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border2 = gtk_hbox
     hbox_border2.css_class('border2')
-    hbox_border2.css_class('pad8px')
+    hbox_border2.pad8px
     hbox_border2.add(
       text('This one makes use of differential side borders.')
     )
@@ -136,7 +140,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border3 = gtk_hbox
     hbox_border3.css_class('border3')
-    hbox_border3.css_class('pad8px')
+    hbox_border3.pad8px
     hbox_border3.add(
       text('This one shows a rounded border.')
     )
@@ -147,7 +151,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border4 = gtk_hbox
     hbox_border4.css_class('border4')
-    hbox_border4.css_class('pad8px')
+    hbox_border4.pad8px
     hbox_border4.add(
       text('As above but with a solid border.')
     )
@@ -158,7 +162,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border5 = gtk_hbox
     hbox_border5.css_class('border5')
-    hbox_border5.css_class('pad8px')
+    hbox_border5.pad8px
     hbox_border5.add(
       text('As above but with an inset border.')
     )
@@ -169,7 +173,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border6 = gtk_hbox
     hbox_border6.css_class('border6')
-    hbox_border6.css_class('pad8px')
+    hbox_border6.pad8px
     hbox_border6.add(
       text('As above but with an outset border.')
     )
@@ -181,7 +185,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
     hbox_border7 = gtk_hbox
     hbox_border7 = gtk_hbox
     hbox_border7.css_class('border7')
-    hbox_border7.css_class('pad8px')
+    hbox_border7.pad8px
     hbox_border7.add(
       text('As above but with a dashed border.')
     )
@@ -192,7 +196,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border8 = gtk_hbox
     hbox_border8.css_class('border8')
-    hbox_border8.css_class('pad8px')
+    hbox_border8.pad8px
     hbox_border8.add(
       text('As above but with a double border.')
     )
@@ -203,7 +207,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border9 = gtk_hbox
     hbox_border9.css_class('border9')
-    hbox_border9.css_class('pad8px')
+    hbox_border9.pad8px
     hbox_border9.add(
       text('As above but with a groove border.')
     )
@@ -214,7 +218,7 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border10 = gtk_hbox
     hbox_border10.css_class('border10')
-    hbox_border10.css_class('pad8px')
+    hbox_border10.pad8px
     hbox_border10.add(
       text('As above but with a ridge border.')
     )
@@ -225,12 +229,23 @@ class BorderExamples < ::Gtk::ScrolledWindow
     # ======================================================================= #
     hbox_border11 = gtk_hbox
     hbox_border11.css_class('border11')
-    hbox_border11.css_class('pad8px')
+    hbox_border11.pad8px
     hbox_border11.add(
       text('This one also shows a shadow.')
     )
     @outer_vbox.minimal(hbox_border11, 10)
 
+    # ======================================================================= #
+    # === hbox_border12
+    # ======================================================================= #
+    hbox_border12 = gtk_hbox
+    hbox_border12.css_class('border12')
+    hbox_border12.pad8px
+    hbox_border12.add(
+      text('This one shows a rounded border.')
+    )
+    @outer_vbox.minimal(hbox_border12, 10)
+
     add(@outer_vbox)
     set_size_request(1400, 900)
   end
@@ -241,6 +256,8 @@ if __FILE__ == $PROGRAM_NAME
   require 'gtk_paradise/run'
   _ = Gtk::BorderExamples.new
   r = Gtk.runner
+  r.title = 'Showcasing CSS borders in GTK'
   r << _
+  r.padding 18
   r.top_left_then_run
 end

data/lib/gtk_paradise/examples/css/002_import_CSS_file.rb

@@ -33,6 +33,9 @@ class ImportCSSFile < ::Gtk::ScrolledWindow
     reset_the_internal_variables
     set_use_this_font(USE_THIS_FONT)
     # random_html_colour1 = random_html_colour
+    # ======================================================================= #
+    # Next load the colours.css file via an @import statement:
+    # ======================================================================= #
     more_CSS_then_apply_it '
 
 @import url("'+Gtk.project_base_directory?+'css_files/colours.css");
@@ -62,12 +65,13 @@ class ImportCSSFile < ::Gtk::ScrolledWindow
     sample_widget.css_class('fancy_border')
     text = left_aligned_text(
       "This text will appear in crimson colour if a certain .css file "\
-      "has been found.\n\nSo if you see this in a reddish colour then "\
-      "that step has worked properly.\n\nThe CSS code in use will tap into "\
-      "<b>@import url()</b>.\n\nThe code to the CSS in use for this "\
-      "widget is shown below this box."
+      "has been found.\n\nSo if you see this in a ~reddish colour then "\
+      "that step has worked properly.\n\nThe CSS code in use will tap "\
+      "into <b>@import url()</b>.\n\nThe code to the CSS in use for "\
+      "this widget is shown below this box."
     )
     sample_widget.add(text)
+    sample_widget.set_border_width(15)
     @outer_vbox.minimal(sample_widget, 10)
     scrolled_widget = return_scrollable_CSS_in_use_widget
     scrolled_widget.use_this_font = :dejavu_15
@@ -81,7 +85,8 @@ end; end
 if __FILE__ == $PROGRAM_NAME
   require 'gtk_paradise/run'
   _ = Gtk::ImportCSSFile.new
-  r = Gtk.runner
+  r = Gtk.run(title: 'Importing .css files example')
   r << _
+  r.apply_the_internal_title
   r.top_left_then_run
 end

data/lib/gtk_paradise/examples/drawing/001_example.rb

@@ -0,0 +1,61 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'gtk_paradise/drawing/drawing.rb'
+
+include Math
+
+WIDTH  = 600
+HEIGHT = 400
+V0     = 10.0
+A      = 0.75
+G      = 5.0
+
+v = lambda {|n|
+  - A ** n * sqrt(2 * G * HEIGHT)
+}
+
+t = lambda { |n|
+  if n.zero?
+    sqrt(2 * HEIGHT / G)
+  else
+    array = [1]
+    n.times {|i|
+      array << 2 * A ** (i + 1)
+    }
+    sqrt(2 * HEIGHT / G) * array.inject(:+)
+  end
+}
+
+y = lambda { |n, t1|
+  if n.zero?
+    HEIGHT - G * t1 ** 2 / 2
+  else
+    t2 = t1 - t.call(n - 1)
+    - v.call(n) * t2 - G * t2 ** 2 / 2
+  end
+}
+
+x = lambda {|t1| V0 * t1}
+
+num = lambda { |tm|
+  1000.times {|i| return i if tm <= t.call(i)}
+}
+
+i = 0
+
+Drawing.app(width: WIDTH, height: HEIGHT) {
+  draw { clear }
+
+  id = timer(20) {
+    tm = i / V0
+    x1 = x.call(tm)
+    y1 = HEIGHT - y.call(num[tm], tm)
+    color(65535, 0, 0)
+    arc(false, x1, y1, 4, 4, 0, 64 * 360)
+    timer_stop(id) if i >= WIDTH
+    i += 1
+  }
+
+}

data/lib/gtk_paradise/examples/drawing/002_example.rb

@@ -0,0 +1,51 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'gtk_paradise/drawing/drawing.rb'
+
+include Math
+
+L = 500
+
+# =========================================================================== #
+# === RADIUS_TO_USE
+# =========================================================================== #
+RADIUS_TO_USE = 25
+
+Drawing.app(width: L, height: L) {
+  draw { clear }
+
+  quit_window = proc { 
+    make_window { |window|
+      set_title('')
+      add(
+        button {
+          set_size_request(120, 40)
+          text = ::Gtk::Label.new.set_markup('<span size="x-large">Quit!</span>')
+          add(text)
+          signal_connect(:clicked) { ::Gtk.main_quit }
+        }
+      )
+    }
+  }
+  
+  mouse_button { |w, e|
+    quit_window.call if e.button != 1
+    # ======================================================================= #
+    # Find some random RGB colours next:
+    # ======================================================================= #
+    color(
+      rand(65536), rand(65536), rand(65536)
+    )
+    arc(
+      true,
+      e.x - RADIUS_TO_USE,
+      e.y - RADIUS_TO_USE,
+      RADIUS_TO_USE * 2,
+      RADIUS_TO_USE * 2,
+      0,
+      64 * 360
+    ) 
+  }
+}