image_paradise 0.4.8

data/lib/image_paradise/gui/gtk3/cfdg_widget/cfdg_widget.rb

@@ -0,0 +1,1452 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === ImageParadise::GUI::Gtk::CfdgWidget
+# =========================================================================== #
+# require 'image_paradise/gui/gtk3/gtk3_standalone/gtk3_standalone.rb'
+# ImageParadise::GUI::Gtk::CfdgWidget.run
+# =========================================================================== #
+require 'gtk_paradise/require_gtk3'
+
+module ImageParadise
+
+module GUI
+
+module Gtk
+
+class CfdgWidget < ::Gtk::Box # === ImageParadise::GUI::Gtk::CfdgWidget 
+
+  require 'gtk_paradise/requires/require_the_base_module.rb'
+  include ::Gtk::BaseModule
+
+  require 'gtk_paradise/widgets/gtk3/numbered_lines/numbered_lines.rb'
+
+  require 'image_paradise/project/project.rb'
+  require 'image_paradise/toplevel_methods/file_related_code.rb'
+  require 'image_paradise/confree_generator/confree_generator.rb'
+  require 'image_paradise/gui/gtk3/cfdg_widget/connect_skeleton.rb'
+
+  # ========================================================================= #
+  # === TITLE
+  # ========================================================================= #
+  TITLE = 'CFDG Widget'
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = '95% or minimum 680px'
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = '65% or minimum 300px'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  # ========================================================================= #
+  USE_THIS_FONT = :hack_16
+
+  # ========================================================================= #
+  # === LARGE_FONT
+  # ========================================================================= #
+  LARGE_FONT = :hack_28
+
+  # ========================================================================= #
+  # === SMALLER_FONT
+  # ========================================================================= #
+  SMALLER_FONT = :hack_14
+
+  # ========================================================================= #
+  # === IMG_DIRECTORY
+  #
+  # This constant only works for my home setup.
+  # ========================================================================= #
+  IMG_DIRECTORY = '/home/x/data/images/'
+
+  # ========================================================================= #
+  # === YOUR_FAVOURITE_EDITOR
+  #
+  # Easier constant "alias" to the editor in use.
+  # ========================================================================= #
+  YOUR_FAVOURITE_EDITOR = ::ImageParadise::ConfreeGenerator::YOUR_FAVOURITE_EDITOR
+
+  # ========================================================================= #
+  # === TOOLTIP_EDITOR
+  # ========================================================================= #
+  TOOLTIP_EDITOR = "Open the current <b>.cfdg</b> file in "\
+                   "#{YOUR_FAVOURITE_EDITOR}."
+
+  # ========================================================================= #
+  # === 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
+    infer_the_namespace
+    # ======================================================================= #
+    # === @configuration
+    # ======================================================================= #
+    @configuration = [true, __dir__, namespace?]
+    # ======================================================================= #
+    # === Set the title, width, height and the font in use.
+    # ======================================================================= #
+    title_width_height_font(TITLE, WIDTH, HEIGHT, USE_THIS_FONT)
+    handle_CSS_rules
+    infer_the_size_automatically
+    reset_the_internal_state
+    # ======================================================================= #
+    # === @numbered_lines
+    # ======================================================================= #
+    @numbered_lines = return_numbered_lines_widget
+  end
+
+  # ========================================================================= #
+  # === reset_the_internal_state
+  # ========================================================================= #
+  def reset_the_internal_state
+    # ======================================================================= #
+    # === @show_this_cfdg_file
+    # ======================================================================= #
+    @show_this_cfdg_file = path_to_the_cfdg_directory+'water_ink.cfdg'
+    # ======================================================================= #
+    # === @possible_resolutions
+    #
+    # The first entry should be the default variant. It presently defaults
+    # to the max-width and max-height.
+    # ======================================================================= #
+    @possible_resolutions = [
+      "#{width?}x#{height?}",
+      '600x300',
+      '600x400',
+      '640x480',   
+      '640x640',
+      '800x300',
+      '800x800',
+      '900x400',
+      '1000x1000',
+      '1024x800',
+      '1200x860',
+      '1280x1024',
+      '1600x1600',
+      '1920x1080',
+      '2400x2400'
+    ]
+    # ======================================================================= #
+    # === @output_file_location
+    # ======================================================================= #
+    @output_file_location = nil
+    # ======================================================================= #
+    # === @event_box_for_firefox
+    #
+    # The following event-box is only used on my home setup for now.
+    # ======================================================================= #
+    @event_box_for_firefox = nil
+  end
+
+  # ========================================================================= #
+  # === create_combo_box
+  # ========================================================================= #
+  def create_combo_box
+    # ======================================================================= #
+    # === @combo_box
+    # ======================================================================= #
+    @combo_box = combo_box_text
+    #@combo_box.bblack1
+    @possible_resolutions.each { |entry|
+      @combo_box.append_text(entry)
+    }
+    @combo_box.active = 0
+    # @combo_box.set_halign(:center)
+    # @combo_box.set_hexpand(true)
+  end
+
+  # ========================================================================= #
+  # === padding?
+  # ========================================================================= #
+  def padding?
+    0
+  end
+
+  # ========================================================================= #
+  # === border_size?
+  # ========================================================================= #
+  def border_size?
+    2
+  end
+
+  # ========================================================================= #
+  # === do_generate_all_cfdg_images
+  #
+  # This is the batch-generation part.
+  # ========================================================================= #
+  def do_generate_all_cfdg_images
+    ::ImageParadise::ConfreeGenerator.batch_generate_all_images    
+  end; alias create_batch_gallery do_generate_all_cfdg_images # === create_batch_gallery
+
+  # ========================================================================= #
+  # === create_image1
+  # ========================================================================= #
+  def create_image1
+    # ======================================================================= #
+    # === @image1
+    # ======================================================================= #
+    @image1 = image
+    @image1.bblack1
+    @image1.mar8px
+    @image1.hint =
+      'This area will show the main (rendered) '\
+      'image at hand.'
+  end
+
+  # ========================================================================= #
+  # === create_skeleton                            (create tag, skeleton tag)
+  # ========================================================================= #
+  def create_skeleton
+    create_image1
+    create_combo_box
+    create_the_entries       # Must come before we create the top-bar.
+    create_the_check_buttons # Must come before we create the top-bar.
+    create_the_buttons
+    create_the_checkboxes
+    create_the_labels
+    create_the_text_buffer
+    create_the_event_box_for_the_bluefish_editor
+    create_the_context_menu
+    create_the_text_view
+    create_the_event_box_for_the_browser
+    create_the_top_bar # Have this here last.
+  end
+
+  # ========================================================================= #
+  # === create_the_widget_showing_the_rendered_image
+  # ========================================================================= #
+  def create_the_widget_showing_the_rendered_image
+    # ======================================================================= #
+    # Put that image, aka @image1, into the second scrolled window.
+    # ======================================================================= #
+    vbox = create_vbox
+    small_hbox = padded_hbox
+    small_hbox.minimal(return_the_spinner_on_top, 5)
+    tiny_hbox = create_hbox
+    tiny_hbox.maximal(@button_render_again)
+    tiny_hbox.minimal(@checkbox_automatically_render_this_cfdg)
+    small_hbox.maximal(tiny_hbox)
+    vbox.minimal(small_hbox)
+    vbox.maximal(@image1)
+    @scrolled_window2 = scrolled_window(vbox) { :always }
+    @scrolled_window2.width_height(300, 300)
+    @scrolled_window2.pad5px
+    return @scrolled_window2
+  end; alias return_widget2 create_the_widget_showing_the_rendered_image # === return_widget2
+
+  # ========================================================================= #
+  # === return_widget1
+  # ========================================================================= #
+  def return_widget1
+    hbox_containing_the_numbered_lines_and_text_view = hbox
+    # ======================================================================= #
+    # Add the widget containing the numbered lines and the text view.
+    # Then add the widget showing the rendered image.
+    # ======================================================================= #
+    hbox_containing_the_numbered_lines_and_text_view.maximal(return_the_widget_containing_the_numbered_lines_and_the_text_view,   1)
+    return hbox_containing_the_numbered_lines_and_text_view
+  end
+
+  # ========================================================================= #
+  # === return_the_widget_containing_the_numbered_lines_and_the_text_view
+  # ========================================================================= #
+  def return_the_widget_containing_the_numbered_lines_and_the_text_view
+    outer_vbox = vbox
+    mini_hbox_containing_the_numbered_lines_and_the_text_view = gtk_hbox
+    _ = @numbered_lines
+    _.set_use_this_font(USE_THIS_FONT) # Sync the font in use here.
+    mini_hbox_containing_the_numbered_lines_and_the_text_view.minimal(_)
+    mini_hbox_containing_the_numbered_lines_and_the_text_view.maximal(@text_view)
+    # ======================================================================= #
+    # === @scrolled_window1
+    # ======================================================================= #
+    @scrolled_window1 = gtk_scrolled_window(
+      mini_hbox_containing_the_numbered_lines_and_the_text_view
+    ) { :always }
+    @scrolled_window1.width_height(400, 800)
+    @scrolled_window1.bblack1
+    @scrolled_window1.pad2px
+    outer_vbox.minimal(@label_file_name_top, 1)
+    outer_vbox.maximal(@scrolled_window1)
+    return outer_vbox
+  end
+
+  # ========================================================================= #
+  # === create_the_text_view
+  # ========================================================================= #
+  def create_the_text_view
+    # ======================================================================= #
+    # === @text_view
+    # ======================================================================= #
+    @text_view = text_view(@text_buffer)
+  end
+
+  # ========================================================================= #
+  # === create_the_context_menu
+  # ========================================================================= #
+  def create_the_context_menu
+    # ======================================================================= #
+    # === @context_menu
+    # ======================================================================= #
+    @context_menu = create_context_menu(self) {{
+      actions: {
+        '• Render again':              :do_render_again,
+        '• Render a random cfdg file': :do_use_a_new_random_cfdg_file
+      }
+    }}
+    @context_menu.use_this_font = main_font?
+    @context_menu.css_class('bblack3_and_padding')
+  end
+
+  # ========================================================================= #
+  # === create_the_text_buffer
+  # ========================================================================= #
+  def create_the_text_buffer
+    @text_buffer = text_buffer
+  end
+
+  # ========================================================================= #
+  # === create_the_event_box_for_the_bluefish_editor
+  # ========================================================================= #
+  def create_the_event_box_for_the_bluefish_editor
+    image_bluefish = gtk_image # Will be "filled" lateron.
+    target_file = IMG_DIRECTORY+'/PC/EDITORS/BLUEFISH/BLUEFISH.png'
+    if File.exist? target_file
+      image_bluefish.set_from_file(target_file)
+    else
+      # ===================================================================== #
+      # In this case we will use a custom image from the stock-items. This
+      # will be the default for other users.
+      # ===================================================================== #
+      # image_bluefish.set(image_document_open, 25,25)
+      image_bluefish.set_pixbuf(
+        icon_theme_default(:document_open, 25), 25, 25
+      )
+    end
+    # ======================================================================= #
+    # === @event_box_for_the_bluefish_editor
+    # ======================================================================= #
+    @event_box_for_the_bluefish_editor = event_box
+    @event_box_for_the_bluefish_editor.add(image_bluefish)
+    @event_box_for_the_bluefish_editor.bblack2
+    @event_box_for_the_bluefish_editor.hint = TOOLTIP_EDITOR
+    @event_box_for_the_bluefish_editor.on_clicked {
+      open_file_in_editor
+    }
+  end
+
+  # ========================================================================= #
+  # === do_use_a_new_random_cfdg_file
+  # ========================================================================= #
+  def do_use_a_new_random_cfdg_file
+    random_file = return_random_cfdg_file
+    use_this_cfdg_file(random_file)
+    if @checkbox_automatically_render_this_cfdg.is_checked?
+      do_render_the_cfdg_file
+    end
+  end
+
+  # ========================================================================= #
+  # === do_style_all_the_buttons_uniformly
+  # ========================================================================= #
+  def do_style_all_the_buttons_uniformly
+    return_all_buttons.each {|this_button|
+      this_button.bblack1
+    }
+  end
+
+  # ========================================================================= #
+  # === current_buffer?
+  # ========================================================================= #
+  def current_buffer?
+    @text_buffer.text?
+  end
+
+  # ========================================================================= #
+  # === do_open_the_current_image_in_the_browser
+  # ========================================================================= #
+  def do_open_the_current_image_in_the_browser(
+      _ = @output_file_location
+    ) 
+    require 'open'
+    if _ and !_.empty?
+      e "Opening the image at #{_} next."
+      Open.in_browser(_)
+    else
+      e 'You first have to create a new image file. Click '\
+        'the run-button to generate a new image.'
+    end
+  end; alias open_firefox_tab do_open_the_current_image_in_the_browser # === open_firefox_tab
+
+  # ========================================================================= #
+  # === clear_buffer
+  #
+  # This method clears the buffer.
+  # ========================================================================= #
+  def clear_buffer
+    @text_buffer.text = ''
+  end
+
+  # ========================================================================= #
+  # === favicon?
+  # ========================================================================= #
+  def favicon?
+    '/home/x/data/images/ART/NEURONAL_HAND.png'
+  end
+
+  # ========================================================================= #
+  # === open_file_in_editor
+  #
+  # This method opens the cfdg file in your designated editor.
+  # ========================================================================= #
+  def open_file_in_editor(
+      this_file = @show_this_cfdg_file
+    )
+    _ = "#{YOUR_FAVOURITE_EDITOR} #{this_file}"
+    esystem _
+  end
+
+  # ========================================================================= #
+  # === set_source_buffer
+  #
+  # This simply sets the content for the @text_buffer variable.
+  # ========================================================================= #
+  def set_source_buffer(i = '')
+    @text_buffer.text = i
+  end
+
+  # ========================================================================= #
+  # === do_scramble_the_cfdg_content
+  #
+  # This will randomly "scramble" the cfdg content, then run the
+  # cfdg binary.
+  # ========================================================================= #
+  def do_scramble_the_cfdg_content
+    _ = @text_buffer.text?.dup
+    _.gsub!(/260/,'268')
+    _.gsub!(/100/,'105')
+    _.gsub!(/110/,'115')
+    _.gsub!(/#{rand(300)}/,"#{rand(300)}")
+    _.gsub!(/#{rand(300)}/,"#{rand(300)}")
+    _.gsub!(/#{rand(300)}/,"#{rand(300)}")
+    _.gsub!(/#{rand(300)}/,"#{rand(300)}")
+    _.gsub!(/#{rand(300)}/,"#{rand(300)}")
+    _.gsub!(/#{rand(300)}/,"#{rand(300)}")
+    _.gsub!(/#{rand(300)}/,"#{rand(300)}")
+    _.gsub!(/#{rand(300)}/,"#{rand(300)}")
+    _.gsub!(/90/,(95+rand(60)).to_s)
+    _.gsub!(/80/,(85+rand(50)).to_s)
+    _.gsub!(/70/,(70+rand(40)).to_s)
+    _.gsub!(/240/,(220+rand(40)).to_s)
+    _.gsub!(
+      /0.15/,
+      (0.10 + ( rand(100) /100.0 ) ).to_s
+    )
+    set_source_buffer(_)
+    do_run
+  end
+
+  # ========================================================================= #
+  # === create_the_labels
+  # ========================================================================= #
+  def create_the_labels
+    create_the_label_file_name_on_top
+  end
+
+  # ========================================================================= #
+  # === create_the_checkboxes
+  # ========================================================================= #
+  def create_the_checkboxes
+    # ======================================================================= #
+    # === @checkbox_automatically_render_this_cfdg
+    # ======================================================================= #
+    @checkbox_automatically_render_this_cfdg = checkbox { :is_checked }
+    @checkbox_automatically_render_this_cfdg.hint = 
+      'If this checkbox is active then the image will be '\
+      'automatically rendered when a new .cfdg file is '\
+      'opened in the main buffer.'
+  end
+
+  # ========================================================================= #
+  # === set_width_and_height
+  # ========================================================================= #
+  def set_width_and_height(
+      i = '640x480'
+    )
+    if i.include?('x')
+      splitted = i.split('x')
+      width  = splitted.first
+      height = splitted.last
+      @entry_width.set_text(width.to_s)
+      @entry_height.set_text(height.to_s)
+    end
+  end
+
+  # ========================================================================= #
+  # === create_the_entries                           (entries tag, entry tag)
+  # ========================================================================= #
+  def create_the_entries
+    # ======================================================================= #
+    # @entry_width is on the top.
+    # ======================================================================= #
+    @entry_width = entry
+    @entry_width.set_max_length(8)
+    @entry_width.center
+    # @entry_width.on_click_select_everything
+    @entry_width.lightgreen_background
+    @entry_width.bblack2
+    @entry_width.set_text(
+      ::ImageParadise::ConfreeGenerator::DEFAULT_WIDTH.to_s
+    )
+    @entry_width.on_changed { |widget, event|
+      @entry_height.text = @entry_width.text if @button_check_coupled.active?
+    }
+    # ======================================================================= #
+    # === @entry_height
+    #
+    # The height entry comes next.
+    # ======================================================================= #
+    @entry_height = entry
+    @entry_height.set_max_length(8)
+    @entry_height.center
+    # @entry_height.on_click_select_everything
+    @entry_height.lightgreen_background
+    @entry_height.bblack2
+    @entry_height.set_text(
+      ::ImageParadise::ConfreeGenerator::DEFAULT_HEIGHT.to_s
+    )
+    @entry_height.on_changed { |w,event|
+      if @button_check_coupled.active?
+        @entry_width.text = @entry_height.text
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === create_the_check_buttons
+  # ========================================================================= #
+  def create_the_check_buttons
+    # ======================================================================= #
+    # === @button_check_coupled
+    # ======================================================================= #
+    @button_check_coupled = check_button('Coupled')
+    @button_check_coupled.set_active(false)
+    @button_check_coupled.hint =
+      'Enabling this check-button will ensure that the width and height '\
+      'setting will remain the same (in sync). So if the width will be '\
+      'set to 500px then this means the height will also be set '\
+      'to 500px.'
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    super()
+    allow_the_combo_box_to_change_the__width_and_height_settings_on_changed_event
+    menu
+    # do_style_all_the_buttons_uniformly # This is no longer in use.
+  end
+
+  # ========================================================================= #
+  # === return_open_in_browser_widget
+  # ========================================================================= #
+  def return_open_in_browser_widget
+    # ======================================================================= #
+    # Next add the open-in-the-browser button
+    # ======================================================================= #
+    hbox = create_hbox
+    hbox.maximal(@button_open_in_the_browser, 1)
+    hbox.minimal(@event_box_for_firefox, 1) if @event_box_for_firefox
+    return hbox
+  end
+
+  # ========================================================================= #
+  # === program_exists?
+  #
+  # Find out whether a program exists or not.
+  # ========================================================================= #
+  def program_exists?(this_program)
+    does_program_exist = false # default is false
+    array_available_paths = [ ENV['SYSBIN'].to_s, '/usr/bin/']
+    array_available_paths.each { |path|
+      _ = path+'/'+this_program
+      does_program_exist = true if File.exist? _
+    }
+    return does_program_exist
+  end
+
+  # ========================================================================= #
+  # === use_this_cfdg_file
+  # ========================================================================= #
+  def use_this_cfdg_file(i = nil)
+    case i
+    when nil, 'default'
+      i = return_random_cfdg
+    end
+    if i and File.exist?(i)
+      # ===================================================================== #
+      # Update the @show_this_cfdg_file variable.
+      # ===================================================================== #
+      @show_this_cfdg_file = i
+      opn; e "A .cfdg file was found at: #{sfile(i)}."
+      @label_file_name_top.set_text(File.basename(i))
+      @label_file_name_top.is_selectable
+      dataset = File.read(i)
+      n_lines = dataset.split("\n").size
+      if n_lines < @numbered_lines.n_entries?
+        # =================================================================== #
+        # Chop it down in this case. This has a bug right now; I may have
+        # to improve on this at a later time.
+        # =================================================================== #
+        new_amount_of_lines = @numbered_lines.n_entries? - n_lines
+        @numbered_lines.hide_the_last_n_lines(
+          new_amount_of_lines
+        )
+        @numbered_lines.set_use_n_lines(n_lines)
+      end
+      @text_buffer.set_text(dataset) # Sync the content onto the main buffer as well.
+    end
+  end; alias set_file_location use_this_cfdg_file # === set_file_location
+
+  # ========================================================================= #
+  # === create_the_label_file_name_on_top
+  # ========================================================================= #
+  def create_the_label_file_name_on_top(
+      i = @show_this_cfdg_file
+    )
+    @label_file_name_top = label
+    @label_file_name_top.css_class('royalblue')
+    @label_file_name_top.set_font(:hack_20)
+    @label_file_name_top.make_bold
+    @label_file_name_top.left_align
+    @label_file_name_top.hint = 'This text will show the current '\
+      'active .cfdg file assigned. The text-view widget below '\
+      'this text holds the content of the .cfdg file.'
+    @label_file_name_top.set_text(
+      File.basename(i).to_s
+    )
+  end
+
+  # ========================================================================= #
+  # === return_all_cfdg_files
+  #
+  # This method will try to get all .cfdg files, except for
+  # all entries we stored in our Array at the top.
+  # ========================================================================= #
+  def return_all_cfdg_files(
+      i = path_to_the_cfdg_directory
+    )
+    Dir["#{i}*.cfdg"].sort
+  end
+
+  # ========================================================================= #
+  # === main_buffer?
+  # ========================================================================= #
+  def main_buffer?
+    @text_buffer
+  end; alias text_buffer? main_buffer? # === text_buffer?
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(
+      i = commandline_arguments?
+    )
+    if i.is_a? Array
+      i.each {|entry| menu(entry) }
+    else
+      if i and File.exist?(i)
+        # =================================================================== #
+        # Load existing .cfdg files directly
+        # =================================================================== #
+        if i.end_with? '.cfdg'
+          use_this_cfdg_file(i)  
+        end
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === return_widget4
+  # ========================================================================= #
+  def return_widget4
+    mini_vbox_with_several_buttons = default_grid
+    mini_vbox_with_several_buttons.left(
+      @button_batch_generate_all_cfdg_images
+    )
+    mini_vbox_with_several_buttons.middle(
+      @button_scramble
+    )
+    mini_vbox_with_several_buttons.right(
+      @event_box_for_the_bluefish_editor # This should come last.
+    )
+    # mini_vbox_with_several_buttons.new_row # .right() already does this.
+    mini_vbox_with_several_buttons.left(
+      @button_clear
+    )
+    mini_vbox_with_several_buttons.middle(
+      @button_run_cfdg
+    )
+    
+    vbox_containing_the_insert_buttons_widget = create_vbox
+    vbox_containing_the_insert_buttons_widget.minimal(mini_vbox_with_several_buttons)
+    vbox_containing_the_insert_buttons_widget.minimal(gtk_hseparator, 1)
+    vbox_containing_the_insert_buttons_widget.minimal(return_the_insert_buttons_widget)
+    return vbox_containing_the_insert_buttons_widget
+  end
+
+  # ========================================================================= #
+  # === return_the_insert_buttons_widget
+  # ========================================================================= #
+  def return_the_insert_buttons_widget
+    # ======================================================================= #
+    # Next add a frame 
+    # ======================================================================= #
+    frame = create_frame
+    # ======================================================================= #
+    # This frame is for the various insert-buttons. These insert-buttons
+    # will insert (or modify) lines at the current iter of the text-buffer.
+    # ======================================================================= #
+    frame.label = ' Insert Buttons '
+    frame.label_widget.make_bold
+    frame.set_border_width(2)
+    frame.pad5px
+    frame.hint = 'These small buttons allow you to insert '\
+                 'commands into the text-buffer.'
+
+    small_hbox1 = gtk_hbox
+    # ======================================================================= #
+    # === :comment
+    #
+    # This method will insert a comment in the current iter.
+    # ======================================================================= #
+    button1 = button('A comment')
+    button1.use_this_font = SMALLER_FONT
+    button1.on_clicked {
+      main_buffer?.insert_at_cursor(
+        '# ============================================= #'+N
+      )
+      main_buffer?.insert_at_cursor('# '+N)
+      main_buffer?.insert_at_cursor(
+        '# ============================================= #'+N
+      )
+    }
+    small_hbox1.minimal(button1, 0)
+
+    # ======================================================================= #
+    # === :rect
+    # ======================================================================= #
+    button2 = button('A rectangle')
+    button2.use_this_font = SMALLER_FONT
+    button2.on_clicked {
+      main_buffer?.insert_at_cursor("RECT {}\n")
+    }
+    small_hbox1.minimal(button2, 0)
+
+    # ======================================================================= #
+    # === :triangle
+    # ======================================================================= #
+    button3 = button('A triangle')
+    button3.use_this_font = SMALLER_FONT
+    button3.on_clicked {
+      main_buffer?.insert_at_cursor("TRIANGLE {}\n")
+    }
+    small_hbox1.minimal(button3, 0)
+
+    small_hbox2 = gtk_hbox
+    # ======================================================================= #
+    # === :line
+    # ======================================================================= #
+    button4 = button('A line')
+    button4.use_this_font = SMALLER_FONT
+    button4.on_clicked {
+      main_buffer?.insert_at_cursor("LINE {}\n")
+    }
+    small_hbox2.minimal(button4, 0)
+
+    # ======================================================================= #
+    # === :circle
+    # ======================================================================= #
+    button5 = button('A circle')
+    button5.use_this_font = SMALLER_FONT
+    button5.on_clicked {
+      main_buffer?.insert_at_cursor("CIRCLE {}\n")
+    }
+    small_hbox2.minimal(button5, 0)
+
+    # ======================================================================= #
+    # === :hue
+    # ======================================================================= #
+    button6 = button('Hue setting')
+    button6.use_this_font = SMALLER_FONT
+    button6.on_clicked {
+      main_buffer?.insert_at_cursor(" hue 10 ")
+    }
+    small_hbox2.minimal(button6, 0)
+
+    small_hbox3 = gtk_hbox
+
+    # ======================================================================= #
+    # === :sat
+    # ======================================================================= #
+    button7 = button('Saturation setting')
+    button7.use_this_font = SMALLER_FONT
+    button7.on_clicked {
+      main_buffer?.insert_at_cursor(' sat 0.995 ')
+    }
+    small_hbox3.minimal(button7, 0)
+
+    # ======================================================================= #
+    # === :bold
+    # ======================================================================= #
+    button8 = button('Bold')
+    button8.use_this_font = SMALLER_FONT
+    button8.on_clicked {
+      main_buffer?.insert_at_cursor(' b 0.995 ')
+    }
+    small_hbox3.minimal(button8, 0)
+
+    # ======================================================================= #
+    # === :square
+    # ======================================================================= #
+    button9 = button('square')
+    button9.use_this_font = SMALLER_FONT
+    button9.on_clicked {
+      main_buffer?.insert_at_cursor('SQUARE {}')
+    }
+    small_hbox3.minimal(button9, 0)
+
+    small_hbox4 = gtk_hbox
+    # ======================================================================= #
+    # === :background
+    # ======================================================================= #
+    button10 = button('background')
+    button10.use_this_font = SMALLER_FONT
+    button10.on_clicked {
+      main_buffer?.insert_at_cursor('background { b -0.95 sat 1 hue 180 }')
+    }
+    small_hbox4.minimal(button10, 0)
+
+    # ======================================================================= #
+    # === :newline
+    # ======================================================================= #
+    button11 = button('newline')
+    button11.use_this_font = SMALLER_FONT
+    button11.on_clicked {
+      main_buffer?.insert_at_cursor("\n")
+    }
+    small_hbox4.minimal(button11, 0)
+
+    # ======================================================================= #
+    # Colourize these buttons next:
+    # ======================================================================= #
+    [ button1,  button2, button3,
+      button4,  button5, button6,
+      button7,  button8, button9,
+      button10, button11
+    ].each {|this_button|
+      this_button.clear_background
+      this_button.modify_background(:normal,   :lightsteelblue)
+      this_button.modify_background(:active,   :brown)
+      this_button.modify_background(:prelight, :bisque)
+    }
+
+    frame_padded_vbox = padded_vbox
+    frame_padded_vbox.minimal(small_hbox1, 4)
+    frame_padded_vbox.minimal(small_hbox2, 4)
+    frame_padded_vbox.minimal(small_hbox3, 4)
+    frame_padded_vbox.minimal(small_hbox4, 4)
+    frame.add(frame_padded_vbox)
+    mini_vbox = create_vbox
+    mini_vbox.minimal(frame, 1) # First add the frame.
+    mini_vbox.minimal(return_widget_containing_buttons_to_randomize_the_text_buffer, 5)
+    return mini_vbox
+  end
+
+  # ========================================================================= #
+  # === return_widget_containing_buttons_to_randomize_the_text_buffer
+  # ========================================================================= #
+  def return_widget_containing_buttons_to_randomize_the_text_buffer
+    _ = gtk_vbox
+    button1 = button('Randomize <b>hue</b>')
+    button1.clear_background
+    button1.on_hover(:lightgreen)
+    button1.on_clicked {
+      do_randomize_all_hue_entries
+    }
+    button1.do_markify
+    button1.hint = 'Click this button to randomly change all <b>hue</b> '\
+                   'entries in the text-buffer.'
+    small_hbox1 = hbox
+    small_hbox1.minimal(button1, 0)
+    _.minimal(small_hbox1)
+    return _
+  end
+
+  # ========================================================================= #
+  # === update_the_main_image_with_this_path
+  # ========================================================================= #
+  def update_the_main_image_with_this_path(i)
+    @image1.set_file(i)
+  end
+
+  # ========================================================================= #
+  # === create_the_event_box_for_the_browser
+  # ========================================================================= #
+  def create_the_event_box_for_the_browser
+    _ = IMG_DIRECTORY+'firefox/FIREFOX_FAVICON.png'
+    if File.exist? _
+      @event_box_for_firefox = event_box
+      firefox_image = gtk_image_from_file(_)
+      firefox_image.hint = 'Opens a tab in the browser.'
+      @event_box_for_firefox.add(firefox_image) # Add the firefox image here.
+      @event_box_for_firefox.on_button_press_event {
+        do_open_the_current_image_in_the_browser
+      }
+    end
+  end
+
+  # ========================================================================= #
+  # === large_font?
+  # ========================================================================= #
+  def large_font?
+    LARGE_FONT
+  end
+
+
+  # ========================================================================= #
+  # === main_font?
+  # ========================================================================= #
+  def main_font?
+    USE_THIS_FONT
+  end
+
+  # ========================================================================= #
+  # === context_menu?
+  # ========================================================================= #
+  def context_menu?
+    @context_menu
+  end
+
+  # ========================================================================= #
+  # === do_randomize_all_hue_entries
+  # ========================================================================= #
+  def do_randomize_all_hue_entries
+    old_content = text_buffer?.text?.dup
+    if old_content.include? 'hue '
+      regex = /(hue \d{1,3})/ # See: https://rubular.com/r/nLkepmPs8U8WRe
+      scanned_results = old_content.scan(regex)
+      # The results may look like this:
+      #
+      #  [["hue 270"], ["hue 75"]]
+      #
+      scanned_results.flatten.each {|this_hue_related_entry| # "hue 270"
+        number = this_hue_related_entry.split(' ').last.to_i
+        case rand(2)
+        when 0 # For minus.
+          number = number - rand(number)
+          number = 1 if number < 0
+        when 1 # For upper.
+          number = number + rand(250)
+          number = 255 if number > 255
+        end
+        old_content.gsub!(/#{this_hue_related_entry}/, 'hue '+number.to_s)
+      }
+      @text_buffer.set_text(old_content)
+      render_anew # This may be commented out at some later point in time.
+    end
+  end
+
+  # ========================================================================= #
+  # === do_create_a_new_file_chooser_dialog_and_then_set_the_main_entry_to
+  # ========================================================================= #
+  def do_create_a_new_file_chooser_dialog_and_then_set_the_main_entry_to(
+      i = main_file?.to_s
+    )
+    create_a_new_file_chooser_dialog(self) {{
+      filter:             '.cfdg',
+      additional_folders: ::ImageParadise.project_base_directory?+'cfdg/',
+      start_dir:          ::ImageParadise.project_base_directory?+'cfdg/'
+    }}
+    _ = ::Gtk.main_file?
+    if _ and File.exist?(_)
+      use_this_cfdg_file(_)
+    end
+  end
+
+  # ========================================================================= #
+  # === allow_the_combo_box_to_change_the__width_and_height_settings_on_changed_event
+  # ========================================================================= #
+  def allow_the_combo_box_to_change_the__width_and_height_settings_on_changed_event
+    @combo_box.on_changed {
+      _ = @combo_box.text?
+      set_width_and_height(_)
+    }
+  end
+
+  # ========================================================================= #
+  # === do_use_the_current_buffer_for_creating_a_new_image_file
+  # ========================================================================= #
+  def do_use_the_current_buffer_for_creating_a_new_image_file(
+      i = nil
+    )
+    _ = current_buffer?
+    # ======================================================================= #
+    # We will create a new file and use that.
+    # ======================================================================= #
+    @home_dir = ENV['HOME'].to_s+'/image_paradise/'
+    ::ImageParadise.mkdir(@home_dir) unless File.directory?(@home_dir)
+    @into = @home_dir+'default_cfdg_file.cfdg'
+    ::ImageParadise.write_what_into(_, @into)
+    # ======================================================================= #
+    # We need to use a consistent output-file here, as an image.
+    # ======================================================================= #
+    @output_file_location = @home_dir+'output.png'
+    Thread.new {
+      case i
+      when :make_use_of_the_spinner_as_well
+        the_spinner_is_now_active
+      end
+      result = ::ImageParadise.confreegenerator(@into) {{
+        output_location:     @output_file_location,
+        open_in_browser_tab: false,
+        width:               @entry_width.text?,
+        height:              @entry_height.text?
+      }}
+      if result.was_an_error_encountered?
+        notify_the_user_that_the_text_view_contains_an_error
+      end
+      update_the_main_image_with_this_path(@output_file_location)
+      case i
+      # === :make_use_of_the_spinner_as_well
+      when :make_use_of_the_spinner_as_well
+        the_spinner_is_now_inactive
+      end
+    }
+  end; alias do_run                     do_use_the_current_buffer_for_creating_a_new_image_file # === do_run
+       alias do_create_the_image        do_use_the_current_buffer_for_creating_a_new_image_file # === do_create_the_image
+       alias do_render_the_cfdg_file    do_use_the_current_buffer_for_creating_a_new_image_file # === do_render_the_cfdg_file
+       alias render_the_cfdg_file_again do_use_the_current_buffer_for_creating_a_new_image_file # === render_the_cfdg_file_again
+
+  # ========================================================================= #
+  # === notify_the_user_that_the_text_view_contains_an_error
+  # ========================================================================= #
+  def notify_the_user_that_the_text_view_contains_an_error
+    popup_over_this_widget(
+      text_view?,
+      'The buffer (text content) contains some error. Have a '\
+      'look at it and correct the error, if possible.'
+    ).popup
+  end
+
+  # ========================================================================= #
+  # === text_view?
+  # ========================================================================= #
+  def text_view?
+    @text_view
+  end; alias main_textview? text_view? # === main_textview?
+
+  # ========================================================================= #
+  # === the_spinner_is_now_active
+  # ========================================================================= #
+  def the_spinner_is_now_active
+    @spinner_on_top.is_active
+    # ======================================================================= #
+    # Whenever the spinner is spinning, such as defined in the line above,
+    # the render-again button becomes inactive (aka insensitive).
+    # ======================================================================= #
+    @button_render_again.is_inactive
+  end
+
+  # ========================================================================= #
+  # === the_spinner_is_now_inactive
+  # ========================================================================= #
+  def the_spinner_is_now_inactive
+    @spinner_on_top.is_inactive
+    @button_render_again.is_active
+  end
+
+  # ========================================================================= #
+  # === return_the_spinner_on_top
+  # ========================================================================= #
+  def return_the_spinner_on_top
+    # ======================================================================= #
+    # === @spinner_on_top
+    # ======================================================================= #
+    @spinner_on_top = gtk_spinner
+    return @spinner_on_top
+  end
+
+  # ========================================================================= #
+  # === return_open_file_widget
+  # ========================================================================= #
+  def return_open_file_widget
+    # ======================================================================= #
+    # === Add the "Open File" button
+    # ======================================================================= #
+    hbox = create_hbox
+    event_box1 = event_box(document_open)
+    event_box1.on_clicked {
+      do_create_a_new_file_chooser_dialog_and_then_set_the_main_entry_to(main_file?)
+    }
+    hbox.minimal(event_box1,          1)
+    # ======================================================================= #
+    # Create the file-chooser dialog.
+    # ======================================================================= #
+    button_file_chooser = return_file_chooser_button
+    button_file_chooser.on_clicked {
+      do_create_a_new_file_chooser_dialog_and_then_set_the_main_entry_to(main_file?)
+    }
+    hbox.maximal(button_file_chooser, 1)
+    return hbox
+  end
+
+  # ========================================================================= #
+  # === create_the_top_bar                                          (top tag)
+  # ========================================================================= #
+  def create_the_top_bar
+    # ======================================================================= #
+    # === @top_bar
+    # ======================================================================= #
+    @top_bar = return_default_top_bar { :with_close_button }
+    @top_bar.spacing = 2
+    # @top_bar.title = title?
+    label_description = text(title?)
+    label_description.use_this_font = large_font?
+    label_description.make_bold
+    @top_bar.set_custom_title(label_description)
+    @top_bar.add_left(return_open_file_widget)
+    event_box_open_a_random_cfdg_file = event_box(document_open)
+    event_box_open_a_random_cfdg_file.on_clicked {
+      open_a_random_cfdg_file
+    }
+    @top_bar.add_left(event_box_open_a_random_cfdg_file)
+    @top_bar.add_left(@button_open_a_random_cfdg_file)
+    @top_bar.add_left(return_open_in_browser_widget)
+    @top_bar.add_left(
+      return_widget_for_the_imgur_functionality
+    )
+    # ======================================================================= #
+    # == The quit-button                                 (exit tag, quit tag)
+    # ======================================================================= #
+    a_quit_button = simple_quit_button 
+    a_quit_button.clear_background
+    a_quit_button.on_hover(:lightpink)
+    a_quit_button.bblack1
+    @top_bar.add_right(a_quit_button)
+    @top_bar.add_right(@button_check_coupled)
+    # ======================================================================= #
+    # === Add the "Height:" text next:
+    # ======================================================================= #
+    label_height = text('Height:')
+    label_height.width_height(100, 40)
+    @top_bar.add_right(
+      hbox(label_height, @entry_height)
+    )
+    # ======================================================================= #
+    # === Add the "Width:" text next:
+    # ======================================================================= #
+    label_width = text('Width:')
+    label_width.width_height(100, 40)
+    @top_bar.add_right(
+      hbox(label_width, @entry_width)
+    )
+    @top_bar.add_right(@combo_box)
+  end
+
+  # ========================================================================= #
+  # === open_a_random_cfdg_file
+  #
+  # Open a random cfdg file here. This method will then invoke the
+  # method open_this_file().
+  # ========================================================================= #
+  def open_a_random_cfdg_file(
+      random_file = return_random_cfdg_file
+    )
+    use_this_cfdg_file(random_file)
+    e "Loading this `#{sfile(random_file)}` random file now."
+    open_file_in_editor(random_file)
+    if @checkbox_automatically_render_this_cfdg.is_checked?
+      do_render_the_cfdg_file
+    end
+  end
+
+  # ========================================================================= #
+  # === return_random_cfdg_file
+  # ========================================================================= #
+  def return_random_cfdg_file(
+      i = path_to_the_cfdg_directory
+    )
+    Dir["#{i}*.cfdg"].sort.sample
+  end
+
+  # ========================================================================= #
+  # === path_to_the_cfdg_directory
+  # ========================================================================= #
+  def path_to_the_cfdg_directory
+    "#{::ImageParadise.project_base_directory?}cfdg/"
+  end
+
+  # ========================================================================= #
+  # === create_the_buttons                                      (buttons tag)
+  # ========================================================================= #
+  def create_the_buttons
+    # ======================================================================= #
+    # === @button_open_a_random_cfdg_file
+    # ======================================================================= #
+    @button_open_a_random_cfdg_file = button('_Open a random file')
+    @button_open_a_random_cfdg_file.on_clicked {
+      open_a_random_cfdg_file
+    }
+    @button_open_a_random_cfdg_file.hint =
+      "Click this button to open a random .cfdg file. These have "\
+      "to exist locally, in order for this functionality to work.\n\n"\
+      "The local directory should be at: \n\n"\
+      "  <span weight=\"bold\" color=\"darkgreen\" size=\"x-large\">#{path_to_the_cfdg_directory}</span>\n\n"
+    # ======================================================================= #
+    # === @button_open_in_the_browser
+    # ======================================================================= #
+    @button_open_in_the_browser = button('Open in the browser')
+    @button_open_in_the_browser.hint =
+      "Click on this button if you want to open the image in "\
+      "a browser-tab.\nNote that this refers to the rendered image "\
+      "that would show up in the center-widget, so you may have to "\
+      "render a new image first."
+    @button_open_in_the_browser.set_font(SMALLER_FONT)
+    @button_open_in_the_browser.on_clicked {
+      do_open_the_current_image_in_the_browser
+    }
+    # ======================================================================= #
+    # === @button_scramble
+    # ======================================================================= #
+    @button_scramble = button('_Scramble')
+    @button_scramble.on_clicked { do_scramble_the_cfdg_content }
+    @button_scramble.clear_background
+    @button_scramble.on_hover(:lightgoldenrodyellow)
+    @button_scramble.bblack2
+    # ======================================================================= #
+    # === @button_batch_generate_all_cfdg_images
+    # ======================================================================= #
+    @button_batch_generate_all_cfdg_images = button(
+      'Generate all cfdg-images'
+    )
+    @button_batch_generate_all_cfdg_images.clear_background
+    @button_batch_generate_all_cfdg_images.on_hover(:lightgoldenrodyellow)
+    @button_batch_generate_all_cfdg_images.hint =
+      'This button can be used to <b>generate all images</b>. '\
+      'This will take a while, though.'
+    @button_batch_generate_all_cfdg_images.on_clicked {
+      do_generate_all_cfdg_images
+    }
+    @button_batch_generate_all_cfdg_images.clear_background
+    @button_batch_generate_all_cfdg_images.bblack2
+    # ======================================================================= #
+    # == The clear-button
+    # ======================================================================= #
+    @button_clear = button('_Clear')
+    @button_clear.clear_background
+    @button_clear.on_hover(:lightgoldenrodyellow)
+    @button_clear.bblack2
+    @button_clear.on_clicked { clear_buffer }
+    @button_clear.hint = 'Click this button to clear the content of '\
+      'the text-view area on the left hand side. This is the area '\
+      'where the content of a .cfdg file usually appears.'
+    @button_clear.set_image(
+      ::Gtk::Image.new(
+        stock: ::Gtk::Stock::OK,
+        size:  ::Gtk::IconSize::SMALL_TOOLBAR
+      )
+    )
+    # ======================================================================= #
+    # === @button_run_cfdg
+    # ======================================================================= #
+    @button_run_cfdg = button('_Run cfdg')
+    @button_run_cfdg.hint = 'Click on this button '\
+      'to generate a new image from the .cfdg dataset '\
+      'shown to the left side. Keep in mind that this may '\
+      'take up to a few seconds, depending on how complex '\
+      'the context-free rules are. Once the image was '\
+      'generated, it will be shown to the left side '\
+      'as well.' 
+    @button_run_cfdg.clear_background
+    @button_run_cfdg.on_hover(:lightgoldenrodyellow)
+    @button_run_cfdg.bblack2
+    @button_run_cfdg.on_clicked {
+      do_use_the_current_buffer_for_creating_a_new_image_file
+    }
+    # ======================================================================= #
+    # === @button_render_again
+    # ======================================================================= #
+    @button_render_again = button('_Render again')
+    @button_render_again.clear_background
+    @button_render_again.on_hover(:lightblue)
+    @button_render_again.hint = 'Click this button to render the .cfdg '\
+      'file (on the left) again. The new image will then be displayed '\
+      'in the image-box below this button.'
+    @button_render_again.rounded_border(
+      '6px', :default, '4px solid darkgreen'
+    )
+    @button_render_again.on_clicked {
+      do_render_again
+    }
+  end
+
+  # ========================================================================= #
+  # === handle_CSS_rules                                            (CSS tag)
+  # ========================================================================= #
+  def handle_CSS_rules
+    use_gtk_paradise_project_css_file
+  end
+
+  # ========================================================================= #
+  # === return_scrolled_window_widget_containing_each_cfdg_file_as_a_button
+  #
+  # This method will create the widget that contains all .cfdg files
+  # as a button.
+  # ========================================================================= #
+  def return_scrolled_window_widget_containing_each_cfdg_file_as_a_button
+    vbox = create_vbox
+    vbox.set_font(:hack_9)
+    vbox.width_height(48, 44)
+    sorted_array = return_all_cfdg_files
+    sorted_array.each_with_index {|this_cfdg_file, index| index += 1
+      _ = File.basename(this_cfdg_file).delete_suffix('.cfdg') # We want to use a shorter name.
+      _ = _[0 .. 20]+' [...]' if _.size > 20
+      # ===================================================================== #
+      # Next, the button will use that name specified above, without
+      # the .cfdg suffix.
+      # ===================================================================== #
+      button = button(_)
+      button.make_bold
+      button.left_align
+      button.width_height(48, 22)
+      button.bblack1
+      button.clear_background
+      button.on_hover(:aliceblue)
+      button.on_clicked {
+        use_this_cfdg_file(this_cfdg_file)
+        do_create_the_image
+      }
+      # ===================================================================== #
+      # Show tooltip markup next:
+      # ===================================================================== #
+      button.hint =
+        '<span size="xx-large">This button (file position '\
+        '<span weight="bold" color="lightblue">'+index.to_s+
+        '</span>) will create the image described by <b>'+
+        this_cfdg_file+'</b>.</span>'
+      vbox.minimal(button, 1)
+    }
+    scrolled_window = gtk_scrolled_window(vbox) { :only_top_down_bar }
+    scrolled_window.width_height(78, 48)
+    frame = gtk_frame(scrolled_window)
+    frame.set_title('Available .cfdg files ')
+    frame.set_border_width(2)
+    return frame
+  end; alias return_widget3 return_scrolled_window_widget_containing_each_cfdg_file_as_a_button # === return_widget3
+
+  begin
+    require 'roebe/classes/upload_to_imgur.rb'
+  rescue LoadError; end
+  # ========================================================================= #
+  # === return_widget_for_the_imgur_functionality
+  # ========================================================================= #
+  def return_widget_for_the_imgur_functionality
+    hbox1 = create_hbox
+    imgur_logo = image(
+      ImageParadise.project_base_directory?+'logo/IMGUR_LOGO.png'
+    )
+    another_event_box = event_box(imgur_logo)
+    another_event_box.on_clicked {
+      if Object.const_defined?(:Roebe) and
+         Roebe.const_defined?(:UploadToImgur)
+        uploaded_image = Roebe::UploadToImgur.new(output_file?)
+        notify_the_user_about_this_uploaded_image(uploaded_image.remote_url?)
+      end
+    }
+    hbox1.minimal(another_event_box, 5)
+    return hbox1
+  end 
+
+  # ========================================================================= #
+  # === output_file_location?
+  # ========================================================================= #
+  def output_file_location?
+    @output_file_location
+  end; alias output_file? output_file_location? # === output_file?
+
+  # ========================================================================= #
+  # === notify_the_user_about_this_uploaded_image
+  # ========================================================================= #
+  def notify_the_user_about_this_uploaded_image(
+      remote_URL
+    )
+    pop_up_widget(
+      over_this_widget: main_textview?,
+      text:             "The image has been uploaded to:\n\n"+
+                        "  #{remote_URL}\n\n"
+    ) { :make_selectable }
+    try_to_set_the_xorg_buffer(remote_URL)
+  end
+
+  # ========================================================================= #
+  # === do_render_again
+  #
+  # The alias update_image() has originally been added at 16.01.2008,
+  # in the old code base.
+  # ========================================================================= #
+  def do_render_again
+    render_the_cfdg_file_again(:make_use_of_the_spinner_as_well)
+  end; alias render_anew  do_render_again # === render_anew
+       alias update_image do_render_again # === update_image
+
+  # ========================================================================= #
+  # === ImageParadise::GUI::Gtk::CfdgWidget.run
+  # ========================================================================= #
+  def self.run(
+      i = ARGV
+    )
+    require 'gtk_paradise/app/app.rb'
+    _ = ::ImageParadise::GUI::Gtk::CfdgWidget.new(i)
+    r = ::Gtk.run
+    r << _
+    r.enable_context_menu
+    r.on_button_press_event { |widget, event|
+      if ::Gtk.right_mouse_click?(event) # right mouse click event.
+        _.context_menu?.popup_based_on_this_event(event)
+      end
+    }
+    r.automatic_size_then_automatic_title
+    r.enable_quick_exit
+    r.do_maximize
+    # r.middle_of_the_screen_then_run # Or this variant.
+    r.automatic_size_and_automatic_title
+    r.top_left_then_run
+  end
+
+end; end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise::GUI::Gtk::CfdgWidget.run
+end