gtk_paradise 0.9.120 → 0.11.19

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
+    ) 
+  }
+}

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

@@ -0,0 +1,38 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'gtk_paradise/drawing/drawing.rb'
+
+L = 300
+O = L / 2
+R = 140
+step = 20
+
+i = 0
+
+Drawing.app(width: L, height: L) {
+  N_TIMES = 5
+  draw {
+    clear
+    color(0x87 * 256, 0xce * 256, 0xeb * 256)   #skyblue
+    arc(false, O - R, O - R, R * 2, R * 2, 0, 64 * 360)
+  }
+  
+  id = timer(500) do
+    ar = []
+    θ = i * step * Math::PI / 180
+    x = R * Math.cos(θ)
+    y = R * Math.sin(θ)
+    ar << [O + x, O - y]
+    N_TIMES.times {
+      x, y = -y, x
+      ar << [O + x, O - y]
+    }
+    color(0x22 * 256, 0x8b * 256, 0x22 * 256)    #forestgreen
+    polygon(false, ar)
+    i += 1
+    timer_stop(id) if i * step > 180
+    true
+  end
+}

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

@@ -0,0 +1,36 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'gtk_paradise/drawing/drawing.rb'
+
+HEIGHT_AND_WIDTH = 400
+R1 = 150
+R2 = (HEIGHT_AND_WIDTH - R1 * 2) / 2 - 5
+STP1 = (Math::PI / 180) * 0.5
+STP2 = (Math::PI / 180) * 10
+
+Drawing.app(width: HEIGHT_AND_WIDTH, height: HEIGHT_AND_WIDTH) {
+  # ========================================================================= #
+  # === TIMER_ANIMATION_SPEED
+  # ========================================================================= #
+  TIMER_ANIMATION_SPEED = 20
+  draw {
+    clear(color(5000, 0, 10000))
+  }
+
+  i = 0
+  
+  # ========================================================================= #
+  # The higher the timer-value, the faster the animation.
+  # ========================================================================= #
+  id = timer(TIMER_ANIMATION_SPEED) {
+    x = HEIGHT_AND_WIDTH / 2 + (R1 * Math.cos(STP1 * i) + R2 * Math.cos(STP2 * i))
+    y = HEIGHT_AND_WIDTH / 2 - (R1 * Math.sin(STP1 * i) + R2 * Math.sin(STP2 * i))
+    color(0, 65535, 0)
+    arc(false, x, y, 3, 3, 0, 64 * 360)
+    i += 1
+    timer_stop(id) if STP1 * i > Math::PI * 2
+    true
+  }
+}

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

@@ -0,0 +1,92 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'gtk_paradise/drawing/drawing.rb'
+
+L = 400
+C_MAX = 65536
+
+class Field
+
+  attr_reader :x
+  attr_reader :y
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    @x = rand(L)
+    @y = rand(L)
+    n = Vector[rand, rand]
+    @n = [n[0] * 2 / n.norm, n[1] * 2 / n.norm]
+  end
+
+  # ========================================================================= #
+  # === next
+  # ========================================================================= #
+  def next
+    @x, @y = @x + @n[0], @y + @n[1]
+    @n[0] = -@n[0] if @x < 2 or @x >= L - 2
+    @n[1] = -@n[1] if @y < 2 or @y >= L - 2
+  end
+end
+
+class Color
+
+  # ========================================================================= #
+  # === C_STEP
+  # ========================================================================= #
+  C_STEP = 1000
+
+  attr_reader :x
+  attr_reader :y
+  attr_reader :z
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      run_already = true
+    )
+    run if run_already
+  end
+  
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run
+    @x = rand(C_MAX)
+    @y = rand(C_MAX)
+    @z = rand(C_MAX)
+    cn = Vector[rand, rand, rand]
+    @cn = [cn[0] / cn.norm, cn[1] / cn.norm, cn[2]/ cn.norm]
+  end
+
+  # ========================================================================= #
+  # === next
+  # ========================================================================= #
+  def next
+    @x, @y, @z = @x + @cn[0] * C_STEP, @y + @cn[1] * C_STEP, @z + @cn[2] * C_STEP
+    @cn[0] = -@cn[0] if @x < C_STEP or @x >= C_MAX - C_STEP
+    @cn[1] = -@cn[1] if @y < C_STEP or @y >= C_MAX - C_STEP
+    @cn[2] = -@cn[2] if @z < C_STEP or @z >= C_MAX - C_STEP
+    init if rand < 0.001
+  end
+
+end
+
+pos = Field.new
+col = Color.new
+
+Drawing.app(width: L, height: L) {
+  draw { clear }
+
+  timer(20) {
+    color(col.x.to_i, col.y.to_i, col.z.to_i)
+    arc(true, pos.x.to_i + 2, pos.y.to_i + 2, 4, 4, 0, 64 * 360)
+    pos.next
+    col.next
+    true
+  }
+}

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

@@ -0,0 +1,58 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This example will draw some stars.
+# =========================================================================== #
+require 'gtk_paradise/drawing/drawing.rb'
+
+# =========================================================================== #
+# === DIMENSION
+# =========================================================================== #
+DIMENSION = 400
+
+Drawing.app(width: DIMENSION, height: DIMENSION) {
+
+  # ========================================================================= #
+  # === BASE_FACTOR_USED_BY_GTK_FOR_RGB_VALUES
+  # ========================================================================= #
+  BASE_FACTOR_USED_BY_GTK_FOR_RGB_VALUES = 65535
+
+  # ========================================================================= #
+  # === USE_THIS_COLOUR_IN_RGB_VALUE
+  #
+  #   255 ... 65535
+  #     0 ...   0
+  #
+  # ========================================================================= #
+  USE_THIS_COLOUR_IN_RGB_VALUE = [
+    BASE_FACTOR_USED_BY_GTK_FOR_RGB_VALUES / 255 *  63.8,
+    BASE_FACTOR_USED_BY_GTK_FOR_RGB_VALUES / 255 * 100.0,
+    BASE_FACTOR_USED_BY_GTK_FOR_RGB_VALUES / 255 *  94.9
+  ] # R: 21.0, G: 71.0, B: 64.0 (is teal)
+
+  draw {
+    clear
+    color(*USE_THIS_COLOUR_IN_RGB_VALUE)
+    po = Vector[0, 50]
+    θ = Math::PI / 15
+    a = Matrix[
+      [
+        Math.cos(θ),
+        -Math.sin(θ)
+      ],
+      [
+        Math.sin(θ),
+        Math.cos(θ)
+      ]
+    ]
+    for y in 0..3
+      for x in 0..3
+        x1 = x * 100 + 50
+        y1 = y * 100 + 50
+        star(false, x1, y1, x1 + po[0], y1 - po[1])
+        po = a * po
+      end
+    end
+  }
+}

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

@@ -0,0 +1,22 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'gtk_paradise/drawing/drawing.rb'
+
+Drawing.app {
+  draw { clear }
+
+  po = Vector[0, 150]
+  θ = Math::PI / 50
+  a = Matrix[
+    [Math.cos(θ), -Math.sin(θ)], [Math.sin(θ), Math.cos(θ)]
+  ]
+  
+  timer(20) {
+    clear
+    color(0, 65535, 0)
+    star(false, 150, 150, 150 + po[0], 150 - po[1])
+    po = a * po
+  }
+}

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

@@ -0,0 +1,43 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+require 'gtk_paradise/drawing/drawing.rb'
+
+Width  = 400
+Height = 300
+Turn   =  20
+Length =  40
+Ratio  =   0.9
+Depth  =   8
+
+θ = Math::PI * Turn / 180
+left  = Matrix[[Math.cos(θ),  -Math.sin(θ)],  [Math.sin(θ),  Math.cos(θ)]]
+right = Matrix[[Math.cos(-θ), -Math.sin(-θ)], [Math.sin(-θ), Math.cos(-θ)]]
+
+Drawing.app(width: Width, height: Height, title: 'tree') {
+  draw {
+    clear
+  }
+
+  ar = [[Vector[Width / 2, 1], Vector[0, Length]]]
+  branch_num = 0
+
+  id = timer(80) {
+    ob = ar.shift
+    v1 = left  * ob[1]
+    v2 = right * ob[1]
+    p1 = ob[0] + v1
+    p2 = ob[0] + v2
+
+    color(0, 65535, 0)
+    line(ob[0][0], Height - ob[0][1], p1[0], Height - p1[1])
+    line(ob[0][0], Height - ob[0][1], p2[0], Height - p2[1])
+
+    ar << [p1, v1 * Ratio]
+    ar << [p2, v2 * Ratio]
+    branch_num += 2
+    timer_stop(id) if branch_num >= 2 ** (Depth + 1) - 2
+    true
+  }
+}