gtk_paradise 0.9.120

data/lib/gtk_paradise/examples/advanced/017_lean_CSS_example.rb

@@ -0,0 +1,247 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Gtk::LeanCSSExample
+# =========================================================================== #
+# require 'gtk_paradise/example/advanced/017_lean_CSS_example.rb'
+# =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
+module Gtk
+
+class LeanCSSExample < ::Gtk::Box
+
+  require 'gtk_paradise/requires/require_the_base_module.rb'
+  include ::Gtk::BaseModule
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Advanced CSS example'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = 1280
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = 580
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_22
+
+  # ========================================================================= #
+  # === 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  = TITLE
+    # ======================================================================= #
+    # === @width
+    # ======================================================================= #
+    set_width(WIDTH)
+    # ======================================================================= #
+    # === @height
+    # ======================================================================= #
+    set_height(HEIGHT)
+    set_use_this_font(USE_THIS_FONT)
+    use_gtk_paradise_project_css_file
+    infer_the_size_automatically
+    # ======================================================================= #
+    # Add more CSS next:
+    # ======================================================================= #
+    more_CSS_then_apply_it '
+.blightgreen5 { border: 8px solid lightgreen; }
+.bblack5      { border: 8px solid black; }
+.bgreen5      { border: 8px solid green; }
+
+.yoda {
+  color: yellow;
+}
+
+.BG_Black {
+  background-color: black;
+}
+
+.hover1 {
+  font-size: 80px;
+  background-image: none;
+  border: 2px solid black;
+}
+
+.hover1:hover {
+  transition: 4000ms linear;
+  background-color: lightblue;
+}
+
+.hover1:focus {
+  transition: border 100ms ease-in;
+  background-color: royalblue;
+}
+
+.slider1 {
+  border-style: solid;
+  border-width: 2px;
+  border-color: #a7a7a7;
+  border-radius: 50% 50% 0 50%;
+  background-image: linear-gradient(15deg, #ededed, steelblue);
+  box-shadow: inset 0 0 0 2px rgba(255,255,255,0.2),
+              2px 2px 2px rgba(0,0,0,0.1);
+}
+
+.box_shadow1 {
+  box-shadow: inset 1px 0 alpha(tomato, 0.10),
+              inset 0 1px alpha(tomato, 0.12),
+              inset -1px 0 alpha(tomato, 0.15),
+              inset 0 -1px alpha(tomato, 0.05);
+}
+
+.foobar       label { color: tomato }
+.foobar:hover label { text-shadow: none; color: steelblue; }
+
+.foobar:hover
+{
+  background-image: none;
+  border-color: shade(darkgreen, 0.7);
+  background-color: shade(lightgreen, 1.10);
+}
+
+'
+    use_lean_CSS_rules
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    2
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
+  # ========================================================================= #
+  # === create_skeleton                                          (create tag)
+  # ========================================================================= #
+  def create_skeleton
+  end
+
+  # ========================================================================= #
+  # === connect_skeleton                                        (connect tag)
+  # ========================================================================= #
+  def connect_skeleton
+    abort_on_exception
+    minimal(gtk_left_aligned_label('Showcasing CSS-buttons next.'))
+
+    button1 = button('Button #1')
+    button1.width_height(30, 30)
+    button1.css_class 'clear_background'
+    button1.css_class 'blightgreen5'
+    button1.disallow_resizing
+
+    button2 = button('Button #2')
+    button2.width_height(30, 30)
+    button2.css_class 'bblack5'
+    button2.disallow_resizing
+
+    button3 = button('Button #3')
+    button3.width_height(30, 30)
+    button3.css_class 'bgreen5'
+    button3.disallow_resizing
+
+    minimal(button1, 3)
+    minimal(button2, 3)
+    minimal(button3, 3)
+    minimal(text('Next, showing a transparent widget'))
+    button4 = button('Button #4')
+    button4.width_height(30, 30)
+    button4.css_class 'bgreen5'
+    button4.css_class 'transparent'
+    button4.disallow_resizing
+    minimal(button4, 3)
+
+    button5 = button('Button #5')
+    button5.width_height(30, 30)
+    button5.css_class 'bgreen5'
+    button5.disallow_resizing
+    button5.use_this_font = 'Cantarell Bold 11'
+    minimal(button5, 3)
+
+    entry = gtk_entry('This is a test for Gtk::Entry.')
+    entry.set_name('hover1')
+    minimal(entry, 2)
+
+    box = hbox
+    box.add(bold_text('This is just some text.'))
+    box.css_class('slider1')
+    minimal(box, 15)
+
+    minimal(box, 25)
+
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    # We have to either manually run the method called apply_the_css_string()
+    # or we will let Gtk::Runner do this for us when .run() is called.
+    apply_the_css_string # For now this has to be called manually.
+    create_skeleton_then_connect_skeleton
+  end
+
+  # ========================================================================= #
+  # === Gtk::LeanCSSExample.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/run'
+    _ = ::Gtk::LeanCSSExample.new(i)
+    r = ::Gtk.run
+    r << _
+    r.automatic
+    r.top_left_then_run
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Gtk::LeanCSSExample.run
+end

data/lib/gtk_paradise/examples/advanced/018_coloured_text_example.rb

@@ -0,0 +1,158 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'gtk_paradise/example/advanced/018_coloured_text_example.rb'
+# =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
+module Gtk
+
+class ColouredTextExample < ::Gtk::Box
+
+  require 'gtk_paradise/requires/require_the_base_module.rb'
+  include ::Gtk::BaseModule
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'Advanced CSS example'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '25% or minimum 200px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '15% or minimum 150px'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :dejavu_condensed_25
+
+  # ========================================================================= #
+  # === TEXT
+  #
+  # This is our text containing the HTML-like tagged colours.
+  # ========================================================================= #
+  TEXT = '
+
+<green>Hello</green><span foreground="blue"> world!</span>
+
+<green>green</green>
+<tomato>tomato</tomato>
+<blue>blue</blue>
+<steelblue>steelblue</steelblue>
+
+
+<steelblue>longer text</steelblue>
+longer text
+
+<green>yo</green><blue> there</blue>
+
+'
+
+  # ========================================================================= #
+  # === 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
+    # ======================================================================= #
+    set_title(TITLE)
+    # ======================================================================= #
+    # === @width
+    # ======================================================================= #
+    set_width(WIDTH)
+    # ======================================================================= #
+    # === @height
+    # ======================================================================= #
+    set_height(HEIGHT)
+    set_use_this_font(USE_THIS_FONT)
+    use_gtk_paradise_project_css_file
+    infer_the_size_automatically
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    8
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    4
+  end
+
+  # ========================================================================= #
+  # === create_skeleton                                          (create tag)
+  # ========================================================================= #
+  def create_skeleton
+  end
+
+  # ========================================================================= #
+  # === connect_skeleton                                        (connect tag)
+  # ========================================================================= #
+  def connect_skeleton
+    abort_on_exception
+    _ = replace_with_proper_tags(TEXT)
+    minimal(_)
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    create_skeleton_then_connect_skeleton
+  end
+
+  # ========================================================================= #
+  # === Gtk::ColouredTextExample.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/run'
+    _ = ::Gtk::ColouredTextExample.new(i)
+    r = ::Gtk.run
+    r << _
+    r.automatic
+    r.top_left_then_run
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  Gtk::ColouredTextExample.run
+end # gtk_coloured_text_example

data/lib/gtk_paradise/examples/advanced/019_gtk_entry_showing_the_cursor_position.rb

@@ -0,0 +1,67 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'gtk_paradise/example/advanced/csv_example.rb'
+# =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+require 'gtk_paradise/run'
+require 'gtk_paradise/toplevel_methods/css.rb'
+
+alias e puts
+
+r = Gtk.run
+r.add_events(:scroll_mask)
+r.set_size_request(500, 100)
+r.use_this_font(:hack_20)
+hbox = Gtk.vbox
+Gtk.project_css_file
+
+hbox.css_class('pad8px')
+hbox.show_all
+
+entry1 = Gtk.entry('This is a simple test string.')
+entry1.enable_all_events
+entry1.signal_connect(:event) {|widget, event|
+  name_of_the_event = event.class.to_s
+  case name_of_the_event
+  # ========================================================================= #
+  # === Gdk::EventKey
+  # ========================================================================= #
+  when 'Gdk::EventKey'
+    e 'A key was pressed.'
+    if Gtk.is_enter_key?(event)
+      e 'It was the enter key!'
+    end
+  # ========================================================================= #
+  # === Gdk::EventButton
+  # ========================================================================= #
+  when 'Gdk::EventButton'
+    if event.name? == 'GDK_BUTTON_RELEASE'
+      e 'A mouse-button was clicked. The cursor '\
+        'position is at: '+entry1.cursor_position.to_s
+    end
+  # ========================================================================= #
+  # === Gdk::EventScroll
+  # ========================================================================= #
+  when 'Gdk::EventScroll'
+    if ::Gtk.scroll_up_event?(event)
+      e 'A scrolling event took place - upwards scroll event.'
+    elsif ::Gtk.scroll_down_event?(event)
+      e 'A scrolling event took place - downwards scroll event.'
+    else
+      e 'It was an unknown event.'
+    end
+  end
+}
+entry1.clear_background
+entry1.bblack1
+entry1.pad10px
+# entry1.background(:lightblue)
+hbox.pack_start(entry1, expand: true, fill: true, padding: 6)
+
+scrolled_window = Gtk.scrolled_window(hbox) { :always }
+scrolled_window.width_height(700, 200)
+r << scrolled_window
+r.modify_background(:normal, :white)
+r.top_left_then_run

data/lib/gtk_paradise/examples/advanced/020_scale_this_image.rb

@@ -0,0 +1,154 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === Gtk::ScaleThisImage
+#
+# This example shows how to scale up an image.
+# =========================================================================== #
+# require 'gtk_paradise/gui/gtk3/advanced/020_scale_this_image.rb'
+# Gtk::ScaleThisImage.run
+# =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
+module Gtk
+
+class ScaleThisImage < ::Gtk::Box # === Gtk::ScaleThisImage 
+
+  require 'gtk_paradise/requires/require_the_base_module.rb'
+  include ::Gtk::BaseModule
+
+  # ========================================================================= #
+  # === 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
+    # ======================================================================= #
+    set_title(TITLE)
+    # ======================================================================= #
+    # === @width
+    # ======================================================================= #
+    set_width(WIDTH)
+    # ======================================================================= #
+    # === @height
+    # ======================================================================= #
+    set_height(HEIGHT)
+    set_use_this_font(USE_THIS_FONT)
+    use_gtk_paradise_project_css_file # or use use_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
+    filename =
+      File.absolute_path(
+        '../../images/internal/directory_content_screenshot.png'
+      )
+    vbox = gtk_vbox
+    original_pixbuf = GdkPixbuf::Pixbuf.new(file: filename)
+    image1 = original_pixbuf.scale_simple(180, 180, :hyper) # Gtk::Gdk::INTERP_BILINEAR)
+    vbox.minimal(
+      ::Gtk::Image.new(pixbuf: image1)
+    )
+    image2 = original_pixbuf.scale(800, 400, :nearest)
+    vbox.add(::Gtk::Image.new(pixbuf: image2))
+
+    scrolled_window = gtk_scrolled_window(vbox)
+    maximal(scrolled_window)
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    create_skeleton_then_connect_skeleton
+  end
+
+  # ========================================================================= #
+  # === Gtk::ScaleThisImage.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/app/app.rb'
+    _ = ::Gtk::ScaleThisImage.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::ScaleThisImage.run
+end

data/lib/gtk_paradise/examples/advanced/021_scroll_events_on_gtk_entry.rb

@@ -0,0 +1,37 @@
+require 'gtk3'
+require 'gtk_paradise/require_gtk3'
+
+alias e puts
+
+def on_destroy(widget)
+  Gtk.main_quit
+  return false
+end
+
+def scroll_notify_event(w, event)
+  if event.direction == Gdk::ScrollDirection::UP
+    puts 'You scrolled up.'
+  elsif event.direction == Gdk::ScrollDirection::DOWN
+    puts 'You scrolled down.'
+  end
+end
+
+window = Gtk::Window.new
+window.signal_connect(:destroy) { |widget| on_destroy(widget) }
+hbox = Gtk::Box.new(:vertical)
+
+entry = Gtk::Entry.new
+entry.make_scrollable
+entry.signal_connect(:event) {|widget, event|
+  if Gtk.scroll_up_event?(event)
+    e 'Scroll up event.'
+  elsif Gtk.scroll_down_event?(event)
+    e 'Scroll down event.'
+  end
+}
+
+hbox.add(entry)
+window.add(hbox)
+window.set_size_request(500, 150)
+window.show_all
+Gtk.main

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

@@ -0,0 +1,4 @@
+This directory may contain more advanced examples, including DSL-centric
+examples that leverage the full possibilities offered by the gtk_paradise
+gem. That, and because I am notoriously lazy, so I wanted to write less,
+but achieve more in this regard.

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

@@ -0,0 +1,7 @@
+This directory is a bit special in that we will mix gtk2 and gtk3 related
+code - as long as it has to do with cairo.
+
+Ideally we could offer variants for both gtk2 and gtk3, and perhaps gtk4
+as well, but I don't fully know all changes that happened in cairo, so
+someone else may have to provide the code for this. Personally I am fine
+that we don't have feature parity in regards to gtk2 and gtk3.