gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/base_module/gtk_grid.rb

@@ -1,61 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/gtk_grid.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  require 'gtk_paradise/gtk_classes/grid.rb'
-
-  # ========================================================================= #
-  # === gtk_grid
-  #
-  # Usage examples:
-  #
-  #   g = Gtk::Grid.new
-  #   g.attach(Gtk::Button.new(label: 'Button'), 0, 0, 1, 1)
-  #   g.attach(Gtk::CheckButton.new(''), 1, 0, 1, 1)
-  #
-  # Or:
-  #
-  #   grid = gtk_grid { :default }
-  #   grid.left(text('This is left.'))
-  #   grid.middle(text('This is middle.'))
-  #   grid.right(text('This is right.'))
-  #
-  # ========================================================================= #
-  def gtk_grid(&block)
-    _ = ::Gtk::Grid.new
-    # ======================================================================= #
-    # === Handle blocks given to this method next
-    # ======================================================================= #
-    if block_given?
-      yielded = yield
-      case yielded
-      # ===================================================================== #
-      # === :default
-      #
-      # This entry point specifies a few defaults that I consider somewhat
-      # useful.
-      # ===================================================================== #
-      when :default
-        _.set_column_spacing(2)
-        _.set_row_spacing(2)
-      end
-    end
-    return _
-  end
-
-  # ========================================================================= #
-  # === return_default_grid
-  # ========================================================================= #
-  def return_default_grid
-    return gtk_grid { :default }
-  end; alias default_grid     return_default_grid # === default_grid
-       alias default_gtk_grid return_default_grid # === default_gtk_grid
-       alias gtk_default_grid return_default_grid # === gtk_default_grid
-
-end; end

data/lib/gtk_paradise/base_module/gtk_image.rb

@@ -1,501 +0,0 @@
-#!/usr/bin/ruby -w
-# Encoding: UTF-8
-# frozen_string_literal: true
-# =========================================================================== #
-# require 'gtk_paradise/base_module/gtk_image.rb'
-# =========================================================================== #
-module Gtk
-
-module BaseModule
-
-  # ========================================================================= #
-  # bl $RUBY_GTK_PARADISE/base_module/return_corresponding_gtk_stock_item.rb
-  # ========================================================================= #
-  require 'gtk_paradise/constants/misc.rb'
-  require 'gtk_paradise/toplevel_methods/determine_which_gtk_version_is_in_use.rb'
-  require 'gtk_paradise/emojis/emojis.rb'
-
-  # ========================================================================= #
-  # === return_pixbuf_based_on_the_default_icon_theme
-  #
-  # The first argument to this method should be the name for the icon
-  # at hand.
-  # ========================================================================= #
-  def return_pixbuf_based_on_the_default_icon_theme(
-      i           = :application_exit,
-      size_to_use = 32,
-      whatever    = 0
-    )
-    # ======================================================================= #
-    # Do some ad-hoc sanitizing next.
-    # ======================================================================= #
-    case i
-    when :image_computer
-      i = :computer
-    end
-    pixbuf = ::Gtk::IconTheme.default.load_icon(i, size_to_use, whatever)
-    return pixbuf
-  end
-
-  # ========================================================================= #
-  # === icon_theme_default
-  #
-  # This method will return an instance of class GdkPixbuf::Pixbuf, if
-  # the image is found.
-  # ========================================================================= #
-  def icon_theme_default(
-      i, size_to_use = 16, whatever = 0
-    )
-    _ = ::Gtk::IconTheme.default.load_icon(
-      i.to_s.tr('_','-'), size_to_use, whatever
-    )
-    return _
-  end
-
-  # ========================================================================= #
-  # === return_this_image_based_on_the_default_icon_theme
-  #
-  # This method can be used to return a default icon from the main
-  # IconTheme installed.
-  #
-  # The method will return a Gtk::Image instance, thus an image.
-  # ========================================================================= #
-  def return_this_image_based_on_the_default_icon_theme(
-      i           = :application_exit,
-      size_to_use = 32,
-      whatever    = 0
-    )
-    i = i.to_s.tr('_','-') # target should be like this: application-exit
-    # ======================================================================= #
-    # Fix "-symbolic-symbolic" into "-symbolic.symbolic" next.
-    # ======================================================================= #
-    if i.include? '-symbolic-symbolic'
-      i = i.reverse.sub(/-/,'.').reverse
-    end
-    begin
-      _ = ::Gtk::IconTheme.default.load_icon(i, size_to_use, whatever)
-      result = ::Gtk::Image.new(pixbuf: _)
-    rescue Gtk::IconThemeError::NotFound
-      result = ::Gtk::Image.new
-    end
-    return result
-  end; alias load_icon return_this_image_based_on_the_default_icon_theme # === load_icon
-       alias gtk_icon  return_this_image_based_on_the_default_icon_theme # === gtk_icon
-
-  # ========================================================================= #
-  # === button_themed_icon
-  # ========================================================================= #
-  def button_themed_icon(
-      i = 'edit-paste-symbolic.symbolic'
-    )
-    button = gtk_button
-    use_this_icon = gtk_themed_icon(i)
-    button.set_image(use_this_icon)
-    return button
-  end; alias button_with_image button_themed_icon # === button_with_image
-
-  require 'gtk_paradise/base_module/return_corresponding_gtk_stock_item.rb'
-  # ========================================================================= #
-  # === gtk_image
-  #
-  # This method allows the user to make use of some Symbols.
-  # ========================================================================= #
-  def gtk_image(
-      this_image         = '',
-      optional_icon_size = nil
-    )
-    if this_image == :random
-      # ===================================================================== #
-      # Handle this variant quickly here.
-      # ===================================================================== #
-      this_image = FILE_TABBLE
-    end
-    if this_image.is_a? Symbol
-      # ===================================================================== #
-      # This may be a stock-item, or something like :weather_icon. Or it
-      # may be an Emoji. Since as of December 2020, we will preferentially
-      # use an emoji first.
-      # ===================================================================== #
-      if ::Gtk::Emojis.is_this_an_emoji_symbol?(this_image, :be_quiet)
-        this_image = ::Gtk::Emojis.map_emoji(this_image, :be_quiet)
-      else
-        this_image = return_corresponding_gtk_stock_item(this_image)
-      end
-    end
-    # ======================================================================= #
-    # Next, we will intercept GdkPixbuf::Pixbuf and GdkPixbuf::PixbufAnimation
-    # ======================================================================= #
-    if this_image.is_a?(GdkPixbuf::Pixbuf) or
-       this_image.is_a?(GdkPixbuf::PixbufAnimation)
-      image = ::Gtk::Image.new
-      if ::Gtk.use_gtk2?
-        image.set(this_image, optional_icon_size)
-      else
-        image.set_pixbuf(this_image)
-      end
-      return image
-    end
-    # ======================================================================= #
-    # Next assume a remote image. This will be downloaded into /tmp/.
-    # ======================================================================= #
-    if this_image.start_with?('http')
-      if File.exist?('/tmp/'+File.basename(this_image))
-        this_image = '/tmp/'+File.basename(this_image)
-      else
-        Dir.chdir('/tmp/')
-        esystem 'wget '+this_image
-        this_image = File.absolute_path(File.basename(this_image))
-      end
-    end
-    # ======================================================================= #
-    # The next if-clause is entered when an argument was supplied to this
-    # method.
-    # ======================================================================= #
-    if this_image and this_image.respond_to?(:empty?) and !this_image.empty?
-      # ===================================================================== #
-      # The next assumes that gtk-related symbols look like this:
-      #
-      #   :"gtk-open"
-      #
-      # Hopefully this assumption will work; if not we may have to re-evaluate
-      # it at a later time (written in November 2020).
-      # ===================================================================== #
-      if this_image.is_a?(Symbol) and this_image.start_with?('gtk-')
-        image = ::Gtk::Image.new
-        # =================================================================== #
-        # In that case we will modify optional_icon_size if it is nil.
-        # =================================================================== #
-        if optional_icon_size.nil?
-          optional_icon_size = ::Gtk::IconSize::SMALL_TOOLBAR # BUTTON # MENU
-        end
-      end
-      if optional_icon_size
-        image.set(this_image, optional_icon_size)
-      else
-        # =================================================================== #
-        # === Handle gtk2 first
-        # =================================================================== #
-        if ::Gtk.use_gtk2?
-          image = ::Gtk::Image.new(this_image)
-        else # else it is for ruby-gtk3.
-          if this_image.is_a? String
-            # =============================================================== #
-            # We must rescue a few errors next, because handling images is
-            # quite error-prone from my experience.
-            # =============================================================== #
-            begin
-              this_image = GdkPixbuf::Pixbuf.new(file: this_image)
-            rescue GLib::FileError => error
-              pp error if is_on_roebe?
-              if this_image.is_a? String
-                this_image = { file: this_image }
-              end
-              return ::Gtk::Image.new(this_image)
-            rescue Exception => error
-              pp error if is_on_roebe?
-              pp error.class if is_on_roebe?
-              if this_image.is_a? String
-                this_image = { file: this_image }
-              end
-              return ::Gtk::Image.new(this_image)
-            end
-          end
-          image = ::Gtk::Image.new(pixbuf: this_image)
-        end
-      end
-    else
-      image = ::Gtk::Image.new
-    end
-    return image
-  end; alias image gtk_image # === image
-
-  # ========================================================================= #
-  # Next we will have some methods that quickly tap to useful images.
-  # ========================================================================= #
-
-  # ========================================================================= #
-  # === image_input_mouse
-  # ========================================================================= #
-  def image_input_mouse
-    return_this_image_based_on_the_default_icon_theme(:input_mouse)
-  end
-
-  # ========================================================================= #
-  # === image_audio_volume_high
-  # ========================================================================= #
-  def image_audio_volume_high
-    return_this_image_based_on_the_default_icon_theme(:audio_volume_high)
-  end
-
-  # ========================================================================= #
-  # === image_audio_volume_low
-  # ========================================================================= #
-  def image_audio_volume_low
-    return_this_image_based_on_the_default_icon_theme(:audio_volume_low)
-  end
-
-  # ========================================================================= #
-  # === image_quit_action
-  #
-  # This shows a "quit-image", or at the least it seems to be related
-  # to a quit-action.
-  # ========================================================================= #
-  def image_quit_action
-    return_this_image_based_on_the_default_icon_theme(:application_exit)
-  end
-
-  # ========================================================================= #
-  # === image_starred
-  #
-  # This is a "star" image essentially.
-  # ========================================================================= #
-  def image_starred
-    return_this_image_based_on_the_default_icon_theme(:starred)
-  end
-
-  # ========================================================================= #
-  # === image_from_file
-  # ========================================================================= #
-  def image_from_file(this_file)
-    ::Gtk::Image.new(
-      file: this_file
-    )
-  end; alias gtk_image_from_file image_from_file # === gtk_image_from_file
-
-  # ========================================================================= #
-  # === image_emblem_urgent
-  # ========================================================================= #
-  def image_emblem_urgent
-    return_this_image_based_on_the_default_icon_theme(:emblem_urgent)
-  end
-
-  # ========================================================================= #
-  # === image_computer
-  #
-  # This uses a cute little computer-image, if the icon theme supports
-  # it.
-  # ========================================================================= #
-  def image_computer
-    return_this_image_based_on_the_default_icon_theme(:computer)
-  end
-
-  # ========================================================================= #
-  # === image_application_exit
-  # ========================================================================= #
-  def image_application_exit
-    return_this_image_based_on_the_default_icon_theme(:application_exit)
-  end
-
-  # ========================================================================= #
-  # === image_document_revert
-  # ========================================================================= #
-  def image_document_revert
-    return_this_image_based_on_the_default_icon_theme(:document_revert)
-  end; alias document_revert image_document_revert # === document_revert
-
-  # ========================================================================= #
-  # === image_system_search
-  # ========================================================================= #
-  def image_system_search
-    return_this_image_based_on_the_default_icon_theme(:system_search)
-  end; alias system_search image_system_search # === system_search
-
-  # ========================================================================= #
-  # === image_audio_speakers
-  # ========================================================================= #
-  def image_audio_speakers
-    return_this_image_based_on_the_default_icon_theme(:audio_speakers)
-  end
-
-  # ========================================================================= #
-  # === image_audio_x_generic_symbolic
-  # ========================================================================= #
-  def image_audio_x_generic_symbolic
-    return_this_image_based_on_the_default_icon_theme('audio-x-generic-symbolic.symbolic')
-  end
-
-  # ========================================================================= #
-  # === image_from_pixbuf
-  # ========================================================================= #
-  def image_from_pixbuf(i)
-    ::Gtk::Image.new(
-      pixbuf: i
-    )
-  end; alias gtk_image_from_pixbuf image_from_pixbuf # === gtk_image_from_pixbuf
-       alias gtk_image_pixbuf      image_from_pixbuf # === gtk_image_pixbuf
-
-  # ========================================================================= #
-  # === image_applications_system
-  # ========================================================================= #
-  def image_applications_system
-    return_this_image_based_on_the_default_icon_theme(:image_applications_system)
-  end
-
-  # ========================================================================= #
-  # === image_accessories_text_editor_symbolic_symbolic
-  # ========================================================================= #
-  def image_accessories_text_editor_symbolic_symbolic
-    return_this_image_based_on_the_default_icon_theme(:accessories_text_editor_symbolic_symbolic)
-  end
-
-  # ========================================================================= #
-  # === image_inode_directory
-  # ========================================================================= #
-  def image_inode_directory
-    return_this_image_based_on_the_default_icon_theme(:inode_directory)
-  end; alias image_directory image_inode_directory # === image_directory
-
-  # ========================================================================= #
-  # === image_network_cellular_connected_symbolic_symbolic
-  # ========================================================================= #
-  def image_network_cellular_connected_symbolic_symbolic
-    return_this_image_based_on_the_default_icon_theme(:network_cellular_connected_symbolic_symbolic)
-  end
-
-  # ========================================================================= #
-  # === image_cellular_signal_excellent_symbolic_symbolic
-  # ========================================================================= #
-  def image_cellular_signal_excellent_symbolic_symbolic
-    return_this_image_based_on_the_default_icon_theme(:network_cellular_signal_excellent_symbolic_symbolic)
-  end; alias network_cellular_signal_excellent_symbolic_symbolic image_cellular_signal_excellent_symbolic_symbolic # === network_cellular_signal_excellent_symbolic_symbolic
-
-  # ========================================================================= #
-  # === image_trophy_gold
-  # ========================================================================= #
-  def image_trophy_gold
-    return_this_image_based_on_the_default_icon_theme(:trophy_gold)
-  end
-
-  # ========================================================================= #
-  # === image_view_refresh_symbolic_symbolic
-  # ========================================================================= #
-  def image_view_refresh_symbolic_symbolic
-    return_this_image_based_on_the_default_icon_theme('view-refresh-symbolic.symbolic')
-  end
-
-  # ========================================================================= #
-  # === image_avatar_default
-  # ========================================================================= #
-  def image_avatar_default
-    return_this_image_based_on_the_default_icon_theme('avatar-default')
-  end
-
-  # ========================================================================= #
-  # === image_applications_system_symbolic_symbolic
-  # ========================================================================= #
-  def image_applications_system_symbolic_symbolic
-    return_this_image_based_on_the_default_icon_theme('applications-system-symbolic.symbolic')
-  end
-
-  # ========================================================================= #
-  # === image_play_button
-  # ========================================================================= #
-  def image_play_button
-    return_this_image_based_on_the_default_icon_theme(:video_x_generic)
-  end
-
-  # ========================================================================= #
-  # === image_left_arrow
-  #
-  # There are several left-arrows, at the least 3, in adwaita-icon-theme.
-  #
-  # This method here refers to the, in my opinion, "best" looking left
-  # arrow image.
-  # ========================================================================= #
-  def image_left_arrow
-    return_this_image_based_on_the_default_icon_theme('application-exit-symbolic.symbolic')
-  end
-
-  # ========================================================================= #
-  # === image_software_update_urgent
-  # ========================================================================= #
-  def image_software_update_urgent
-    return_this_image_based_on_the_default_icon_theme(:software_update_urgent)
-  end
-
-  # ========================================================================= #
-  # === image_accessories_text_editor
-  # ========================================================================= #
-  def image_accessories_text_editor
-    return_this_image_based_on_the_default_icon_theme(:accessories_text_editor)
-  end; alias image_text_editor image_accessories_text_editor # === image_text_editor
-
-  # ========================================================================= #
-  # === image_document_open
-  # ========================================================================= #
-  def image_document_open
-    return_this_image_based_on_the_default_icon_theme(:document_open)
-  end; alias document_open   image_document_open # === document_open
-       alias image_open_file image_document_open # === image_open_file
-       alias image_file_open image_document_open # === image_file_open
-
-  # ========================================================================= #
-  # === image_bookmark_new
-  # ========================================================================= #
-  def image_bookmark_new
-    return_this_image_based_on_the_default_icon_theme(:bookmark_new)
-  end
-
-  # ========================================================================= #
-  # === image_list_remove
-  # ========================================================================= #
-  def image_list_remove
-    return_this_image_based_on_the_default_icon_theme('list-remove')
-  end
-
-  # ========================================================================= #
-  # === image_media_optical
-  # ========================================================================= #
-  def image_media_optical
-    return_this_image_based_on_the_default_icon_theme('media-optical')
-  end
-
-  # ========================================================================= #
-  # === image_go_up
-  # ========================================================================= #
-  def image_go_up
-    return_this_image_based_on_the_default_icon_theme('go-up')
-  end; alias arrow_up image_go_up # === arrow_up
-
-  # ========================================================================= #
-  # === image_go_down
-  # ========================================================================= #
-  def image_go_down
-    return_this_image_based_on_the_default_icon_theme('go-down')
-  end; alias arrow_down image_go_down # === arrow_down
-
-  # ========================================================================= #
-  # === image_dialog_question
-  # ========================================================================= #
-  def image_dialog_question
-    return_this_image_based_on_the_default_icon_theme(:dialog_question)
-  end; alias image_question image_dialog_question # === image_question
-
-  # ========================================================================= #
-  # === image_information
-  # ========================================================================= #
-  def image_information
-    return_this_image_based_on_the_default_icon_theme(
-      'dialog-information'
-    )
-  end
-
-  # ========================================================================= #
-  # === image_network_wireless_signal_excellent_symbolic
-  # ========================================================================= #
-  def image_network_wireless_signal_excellent_symbolic
-    return_this_image_based_on_the_default_icon_theme(
-      'network-wireless-signal-excellent-symbolic.symbolic'
-    )
-  end
-
-  # ========================================================================= #
-  # === image_folder_visiting_symbolic
-  # ========================================================================= #
-  def image_folder_visiting_symbolic
-    return_this_image_based_on_the_default_icon_theme(
-      'folder-visiting-symbolic.symbolic'
-    )
-  end
-
-end; end