gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/drawing/tool.rb

@@ -0,0 +1,268 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Drawing::Tool
+# =========================================================================== #
+# require 'gtk_paradise/drawing/tool.rb'
+# =========================================================================== #
+module Drawing
+
+class Tool # === Drawing::Tool
+
+  attr_accessor :width
+
+  alias e puts
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(i = W)
+    @window = i
+    @drawable = @window.window
+    @gc = Gdk::GC.new(@drawable)
+    reset
+  end
+
+  # ========================================================================= #
+  # === reset                                                   (reset tag)
+  # ========================================================================= #
+  def reset
+    # ===================================================================== #
+    # === @font_description
+    # ===================================================================== #
+    @font_description = Pango::FontDescription.new
+    # ===================================================================== #
+    # === @colormap
+    # ===================================================================== #
+    @colormap = Gdk::Colormap.system
+    # ===================================================================== #
+    # === @width
+    # ===================================================================== #
+    @width  = 0
+    # ===================================================================== #
+    # === @height
+    # ===================================================================== #    
+    @height = 0
+    # ===================================================================== #
+    # === @color
+    # ===================================================================== #
+    @color = Gdk::Color.new(0, 0, 0)
+  end
+
+  # ========================================================================= #
+  # === window?
+  # ========================================================================= #
+  def window?
+    @window
+  end; alias window window? # === window
+
+  # ========================================================================= #
+  # === rectangle
+  # ========================================================================= #
+  def rectangle(
+      fill, x, y, width, height, color = nil
+    )
+    set_color(color)
+    # ======================================================================= #
+    # Note that @drawable is a Gtk::Window.
+    # ======================================================================= #
+    @drawable.draw_rectangle(@gc, fill, x, y, width, height)
+  end
+
+  # ========================================================================= #
+  # === clear
+  #
+  # This kind of resets the whole area.
+  # ========================================================================= #
+  def clear(color = nil)
+    colour ||= Gdk::Color.new(0, 0, 0)
+    set_colour(colour)
+    rectangle(true, 0, 0, @width, @height)
+  end
+
+  # ========================================================================= #
+  # === colour
+  # ========================================================================= #
+  def colour(r, g, b)
+    @color = Gdk::Color.new(r, g, b)
+    @colormap.alloc_color(@color, false, true)
+    @color
+  end; alias color colour # === color
+
+  # ========================================================================= #
+  # === arc
+  # ========================================================================= #
+  def arc(
+      fill,
+      x,
+      y,
+      width,
+      height,
+      d1,
+      d2,
+      color = nil
+    )
+    set_color(color)
+    @drawable.draw_arc(@gc, fill, x, y, width, height, d1, d2)
+  end
+
+  # ========================================================================= #
+  # === circle
+  # ========================================================================= #
+  def circle(
+      fill,
+      x,
+      y,
+      r,
+      color = nil
+    )
+    arc(fill, x - r, y - r, 2 * r, 2 * r, 0, 64 * 360, color)
+  end
+
+  # ========================================================================= #
+  # === point
+  # ========================================================================= #
+  def point(
+      x,
+      y,
+      color = nil
+    )
+    set_color(color)
+    @drawable.draw_point(@gc, x, y)
+  end
+ 
+  # ========================================================================= #
+  # === line
+  # ========================================================================= #
+  def line(
+      x1,
+      y1,
+      x2,
+      y2,
+      color = nil
+    )
+    set_color(color)
+    @drawable.draw_lines(@gc, [[x1, y1], [x2, y2]])
+  end
+
+  # ========================================================================= #
+  # === lines
+  # ========================================================================= #
+  def lines(
+      array,
+      color = nil
+    )
+    set_color(color)
+    @drawable.draw_lines(@gc, array)
+  end
+
+  # ========================================================================= #
+  # === polygon
+  # ========================================================================= #
+  def polygon(fill, array, color = nil)
+    set_color(color)
+    @drawable.draw_polygon(@gc, fill, array)
+  end
+
+  # ========================================================================= #
+  # === text
+  # ========================================================================= #
+  def text(
+      str,
+      x,
+      y,
+      size,
+      color = nil
+    )
+    set_color(color)
+    # ===================================================================== #
+    # Set the new size here:
+    # ===================================================================== #
+    @font_description.set_size(size)
+    layout = Pango::Layout.new(W.pango_context)
+    layout.font_description = @font_description
+    layout.text = str
+    @drawable.draw_layout(@gc, x, y, layout)
+  end
+
+  # ========================================================================= #
+  # === set_colour
+  # ========================================================================= #
+  def set_colour(color)
+    @color = color if color
+    @gc.set_foreground(@color)
+  end; private :set_colour
+    alias set_color set_colour # === set_color
+    
+  # ========================================================================= #
+  # === load_pic
+  # ========================================================================= #
+  def load_pic(use_this_filename)
+    GdkPixbuf::Pixbuf.new(file: use_this_filename)
+  end
+
+  # ========================================================================= #
+  # === save_pic
+  # ========================================================================= #
+  def save_pic(
+      img, filename, type = 'png'
+    )
+    img.save(filename, type)
+  end
+
+  # ========================================================================= #
+  # === show_pic
+  # ========================================================================= #
+  def show_pic(img, x, y)
+    @drawable.draw_pixbuf(
+      @gc, img, 0, 0, x, y, img.width, img.height, Gdk::RGB::DITHER_NONE, 0, 0
+    )
+  end
+
+  # ========================================================================= #
+  # === get_pic
+  # ========================================================================= #
+  def get_pic(x, y, width, height)
+    GdkPixbuf::Pixbuf.from_drawable(nil, @drawable, x, y, width, height)
+  end
+    
+  # ========================================================================= #
+  # === timer_stop
+  # ========================================================================= #
+  def timer_stop(id)
+    Gtk.timeout_remove(id)
+  end
+
+  # ========================================================================= #
+  # === star
+  # ========================================================================= #
+  def star(
+      fill, x1, y1, x2, y2, color = nil
+    )
+    set_color(color)
+    Star.new(fill, x1, y1, x2, y2, @color).draw
+  end
+
+  # ========================================================================= #
+  # === get_window_size
+  # ========================================================================= #
+  def get_window_size
+    W.size
+  end
+
+  # ========================================================================= #
+  # === height?
+  # ========================================================================= #
+  def height?
+    @height
+  end; alias height height? # === height
+
+  # ========================================================================= #
+  # === set_height
+  # ========================================================================= #
+  def set_height(i)
+    @height = i
+  end; alias height= set_height # === height=
+
+end; end

data/lib/gtk_paradise/drawing/turtle.rb

@@ -0,0 +1,138 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Drawing::Turtle
+# =========================================================================== #
+# require 'gtk_paradise/drawing/turtle.rb'
+# =========================================================================== #
+module Drawing
+
+require 'gtk_paradise/drawing/tool.rb'
+
+# =========================================================================== #
+# The turtle can move to the left and to the right.
+# =========================================================================== #
+class Turtle < Tool
+
+  attr_accessor :pen_po
+  attr_accessor :dir
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    super()
+    reset
+    @pen_po = Vector[0, 0]
+    @dir    = Vector[1, 0]
+    @width, @height = @pen.get_window_size
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @pen
+    #
+    # The pen is used to "draw" on the area.
+    # ======================================================================= #
+    @pen = Tool.new
+    # ======================================================================= #
+    # === @color_to_use
+    # ======================================================================= #
+    @color_to_use = [65535, 65535, 65535]
+  end
+
+  # ========================================================================= #
+  # === left
+  # ========================================================================= #
+  def left(deg)
+    # ======================================================================= #
+    # The Greek letter θ (theta) is used in math as a variable to represent
+    # a measured angle.
+    # ======================================================================= #
+    θ = Math::PI * deg / 180
+    @dir = Matrix[
+      [
+        Math.cos(θ),
+        -Math.sin(θ)
+      ],
+      [
+        Math.sin(θ),
+        Math.cos(θ)
+      ]
+    ] * @dir
+  end
+
+  # ========================================================================= #
+  # === right
+  # ========================================================================= #
+  def right(deg)
+    left(-deg)
+  end
+
+  # ========================================================================= #
+  # === forward
+  #
+  # Let the turtle move forward.
+  # ========================================================================= #
+  def forward(
+      length,
+      shall_we_draw = true
+    )
+    next_po = @pen_po + @dir * length
+    if shall_we_draw
+      @pen.color(*@color_to_use)
+      @pen.line(
+        @width / 2 + next_po[0], @height / 2 - next_po[1],
+        @width / 2 + @pen_po[0], @height / 2 - @pen_po[1]
+      )
+    end
+    @pen_po = next_po
+  end
+
+  # ========================================================================= #
+  # === back
+  # ========================================================================= #
+  def back(length)
+    forward(-length, false)
+  end
+
+  # ========================================================================= #
+  # === color
+  #
+  # The method accepts three arguments: r, g and b.
+  # ========================================================================= #
+  def color(r, g, b)
+    @color_to_use = [r, g, b]
+    # Delegate the colour onto the pen-tool.
+    @pen.color(*@color_to_use)
+  end
+
+  # ========================================================================= #
+  # === circle
+  # ========================================================================= #
+  def circle(
+      radius, fill = false
+    )
+    @pen.color(*@color_to_use)
+    @pen.circle(
+      fill,
+      @width / 2 + @pen_po[0],
+      @height / 2 - @pen_po[1],
+      radius
+    )
+  end
+
+  # ========================================================================= #
+  # === move
+  #
+  # Position the turtle via Vector.
+  # ========================================================================= #    
+  def move(x, y)
+     @pen_po = Vector[x, y]
+  end
+
+end; end

data/lib/gtk_paradise/emojis/emojis.rb

@@ -6,14 +6,15 @@
 #
 # This file contains emojis, in a "hardcoded" manner. These emojis can be
 # used in gtk-related applications. Keep in mind, however had, that these
-# emojis may not be available on every computer system.
+# emojis may not be available on every computer system and they may appear
+# differently on different computers.
 #
 # The emojis were initially manually copy-pasted into this file here,
-# starting from December 2020 (05.12.2020).
+# starting from December 2020 (05.12.2020 to be precise).
 #
-# It may be that they will become outdated, or changed, so the time stamp
-# for the file here should then also be modified, IF these emojis are
-# changed as well. Just keep in mind that this is subject to change.
+# It may be that these emojis will become outdated, or changed, so the time
+# stamp for the file here should then also be modified, IF these emojis
+# are changed as well. Just keep in mind that this is subject to change.
 #
 # Note that not all emojis are gathered here in this file, and it is
 # very unlikely that all emojis will ever be collected here. The
@@ -33,7 +34,7 @@ module Gtk
 
 module Emojis # === Gtk::Emojis
  	
-  SMILEY_1    = '😀️'
+  SMILEY_1    = '😀️' # === SMILEY_1
   SMILEY_2    = '😁️'
   SMILEY_3    = '😂️'
   SMILEY_4    = '😃️'
@@ -464,11 +465,11 @@ module Emojis # === Gtk::Emojis
   # ========================================================================= #
   # === Money tag
   # ========================================================================= #
-  EURO = '€'
+  EURO  = '€'
   POUND = '£'
-  LIRA = '₤'
-  YEN = '¥'
-  CENT = '¢'
+  LIRA  = '₤'
+  YEN   = '¥'
+  CENT  = '¢'
 
   # ========================================================================= #
   # === Misc tag
@@ -505,13 +506,13 @@ module Emojis # === Gtk::Emojis
   THREE_STARS  = '✨️' # Three small stars.
   OPEN_BOX     = '🗃️'
   FIRE         = '🔥' # This is the fire emoji.
-  SWORDS       = '⚔️'  # Two swords.
+  SWORDS       = '⚔️' # Two swords.
   CLOVER       = '☘️' # Brings luck. :)
   NEWLINE      = '↳'  # A newline.
   DIRECTORY    = '🗀' # This is, sort of, a directory; also called a "folder".
   DETECTIVE    = '🕵️' # Sherlock Holmes is in the house!
-  ONE_HUNDRED_POINTS = '💯' # 100 points. Works in the browser.
-  DOCUMENT     = '' # Some document.
+  ONE_HUNDRED_POINTS = '💯' # 100 points. Works in the browser. Code is 1F4AF.
+  DOCUMENT     = ''  # Some document.
   FOLDED_HANDS = '🙏' # This is the folded hands emoji.
 
   # ========================================================================= #

data/lib/gtk_paradise/examples/advanced/001_5x5_grid_example.rb

@@ -16,11 +16,6 @@ class GridExample < ::Gtk::Box # === Gtk::GridExample
   require 'gtk_paradise/requires/require_the_base_module.rb'
   include ::Gtk::BaseModule
 
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
-
   # ========================================================================= #
   # === TITLE
   # ========================================================================= #
@@ -61,23 +56,15 @@ class GridExample < ::Gtk::Box # === Gtk::GridExample
   # ========================================================================= #
   def reset
     reset_the_internal_variables
+    infer_the_namespace
     # ======================================================================= #
     # === @configuration
     # ======================================================================= #
-    @configuration = [true, __dir__, NAMESPACE]
+    @configuration = [true, __dir__, namespace?]
     # ======================================================================= #
     # === @title
     # ======================================================================= #
-    @title  = TITLE
-    # ======================================================================= #
-    # === @width
-    # ======================================================================= #
-    set_width(WIDTH)
-    # ======================================================================= #
-    # === @height
-    # ======================================================================= #
-    set_height(HEIGHT)
-    set_use_this_font(USE_THIS_FONT)
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
     use_gtk_paradise_project_css_file
     infer_the_size_automatically
   end
@@ -86,14 +73,14 @@ class GridExample < ::Gtk::Box # === Gtk::GridExample
   # === padding?
   # ========================================================================= #
   def padding?
-    0
+    8
   end
 
   # ========================================================================= #
   # === border_size?
   # ========================================================================= #
   def border_size?
-    0
+    4
   end
 
   # ========================================================================= #
@@ -112,35 +99,35 @@ class GridExample < ::Gtk::Box # === Gtk::GridExample
     grid.css_class('pad10px')
     grid.set_border_width(20)
 
-    grid.left(gtk_text('1'))
-    grid.middle(gtk_text('2'))
-    grid.middle(gtk_text('3'))
-    grid.middle(gtk_text('4'))
-    grid.right(gtk_text('5'))
-
-    grid.left(gtk_text('1'))
-    grid.middle(gtk_text('2'))
-    grid.middle(gtk_text('3'))
-    grid.middle(gtk_text('4'))
-    grid.right(gtk_text('5'))
-
-    grid.left(gtk_text('1'))
-    grid.middle(gtk_text('2'))
-    grid.middle(gtk_text('3'))
-    grid.middle(gtk_text('4'))
-    grid.right(gtk_text('5'))
-
-    grid.left(gtk_text('1'))
-    grid.middle(gtk_text('2'))
-    grid.middle(gtk_text('3'))
-    grid.middle(gtk_text('4'))
-    grid.right(gtk_text('5'))
-
-    grid.left(gtk_text('1'))
-    grid.middle(gtk_text('2'))
-    grid.middle(gtk_text('3'))
-    grid.middle(gtk_text('4'))
-    grid.right(gtk_text('5'))
+    grid.left(button('1'))
+    grid.middle(button('2'))
+    grid.middle(button('3'))
+    grid.middle(button('4'))
+    grid.right(button('5'))
+
+    grid.left(button('1'))
+    grid.middle(button('2'))
+    grid.middle(button('3'))
+    grid.middle(button('4'))
+    grid.right(button('5'))
+
+    grid.left(button('1'))
+    grid.middle(button('2'))
+    grid.middle(button('3'))
+    grid.middle(button('4'))
+    grid.right(button('5'))
+
+    grid.left(button('1'))
+    grid.middle(button('2'))
+    grid.middle(button('3'))
+    grid.middle(button('4'))
+    grid.right(button('5'))
+
+    grid.left(button('1'))
+    grid.middle(button('2'))
+    grid.middle(button('3'))
+    grid.middle(button('4'))
+    grid.right(button('5'))
 
     maximal(grid, 20)
   end
@@ -163,8 +150,6 @@ class GridExample < ::Gtk::Box # === Gtk::GridExample
     r = ::Gtk.run
     r << _
     r.automatic_size_then_automatic_title
-    r.set_size_request(_.width?, _.height?)
-    r.set_default_size(_.width?, _.height?) 
     r.top_left_then_run
   end
 
@@ -172,4 +157,4 @@ end; end
 
 if __FILE__ == $PROGRAM_NAME
   Gtk::GridExample.run
-end
+end # ruby 001_5x5_grid_example.rb

data/lib/gtk_paradise/examples/advanced/002_advanced_drag_and_drop_example.rb

@@ -14,7 +14,7 @@ class SourceWindow < Gtk::Window
   # ========================================================================= #
   def initialize
     super('Source Window')
-    @label = gtk_label("Drag here!")
+    @label = gtk_label('Drag start here!')
     add(@label)
     set_default_size(125, 125)
     drag_source_set(Gdk::ModifierType::BUTTON1_MASK |
@@ -41,8 +41,6 @@ end
 
 class DestinationWindow < Gtk::Window
 
-  alias e puts
-
   require 'gtk_paradise/requires/require_the_base_module.rb'
   include ::Gtk::BaseModule
 
@@ -51,7 +49,7 @@ class DestinationWindow < Gtk::Window
   # ========================================================================= #
   def initialize
     super('Dest Window')
-    @counter_n_drop_events_occurred = 0
+    reset
     @label = gtk_label('Drop here!')
     add(@label)
     set_default_size(125, 125)
@@ -62,10 +60,10 @@ class DestinationWindow < Gtk::Window
                   Gdk::DragAction::MOVE)
 
     signal_connect(:drag_data_received) { |widget, context, x, y, selection_data, info, time|
-      e 'A drop event occurred.'
+      e steelblue('A drop event occurred.')
       @counter_n_drop_events_occurred += 1
       @label.set_text(
-        'Drop more onto me!!! I am hungry! Now I have been '\
+        'Drop more onto me!!! I am sooooo hungry! Now I have been '\
         'fed '+@counter_n_drop_events_occurred.to_s+' times.'
       )
       # pp context.targets
@@ -84,20 +82,30 @@ class DestinationWindow < Gtk::Window
     run
   end
 
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    @counter_n_drop_events_occurred = 0
+  end
+
   # ========================================================================= #
   # === run
   # ========================================================================= #
   def run
     move(125, 125)
   end
+
 end
 
-win1 = SourceWindow.new
-win1.move(0, 0)
-win2 = DestinationWindow.new
-win2.move(135, 0)
+if __FILE__ == $PROGRAM_NAME
+  win1 = SourceWindow.new
+  win1.move(0, 0)
+  win1.show_all.signal_connect(:destroy) { Gtk.main_quit }
 
-win1.show_all.signal_connect(:destroy) { Gtk.main_quit }
-win2.show_all.signal_connect(:destroy) { Gtk.main_quit }
+  win2 = DestinationWindow.new
+  win2.move(135, 0)
+  win2.show_all.signal_connect(:destroy) { Gtk.main_quit }
 
-Gtk.main
+  Gtk.main  
+end