gtk_paradise 0.9.120 → 0.11.19

data/lib/gtk_paradise/commandline/commandline.rb

@@ -17,13 +17,19 @@ module Gtk
     else
       case i # case tag
       # ===================================================================== #
-      # === gtkparadise --editor
+      # === gtkpa --conky
+      # ===================================================================== #
+      when /^-?-?conky/i
+        require 'gtk_paradise/widgets/gtk3/conky/conky.rb'
+        ::Gtk::Conky.run
+      # ===================================================================== #
+      # === gtkpa --editor
       # ===================================================================== #
       when /^-?-?editor$/
         require 'gtk_paradise/widgets/gtk3/editor/editor.rb'
         Gtk::Editor.run
       # ===================================================================== #
-      # === gtkparadise --tabble3
+      # === gtkpa --tabble3
       #
       # Note that this variant is the default via "--tabble" since as of
       # January 2021.
@@ -36,7 +42,7 @@ module Gtk
         require 'gtk_paradise/widgets/gtk3/tabble/tabble.rb'
         ::Gtk.start_tabble
       # ===================================================================== #
-      # === gtkparadise --tabble2
+      # === gtkpa --tabble2
       #
       # This variant no longer works as of August 2021. I retain the entry
       # point, though, in the event that we will add support for ruby-gtk2
@@ -53,64 +59,59 @@ module Gtk
         require 'gtk_paradise/widgets/gtk3/control_panel/control_panel.rb'
         ::Gtk::ControlPanel.run
       # ===================================================================== #
-      # === gtkpa --conky
-      # ===================================================================== #
-      when /^-?-?conky/i
-        require 'gtk_paradise/widgets/gtk3/conky/conky.rb'
-        ::Gtk::Conky.run
-      # ===================================================================== #
       # === gtkpa --show-icon-theme
       # ===================================================================== #
       when /^-?-?show(-|_)?icon(-|_)?theme/i
         require 'gtk_paradise/widgets/gtk3/show_icon_theme/show_icon_theme.rb'
         ::Gtk::ShowIconTheme.run
       # ===================================================================== #
-      # === gtkparadise --tabby
+      # === gtkpa --tabby
       # ===================================================================== #
       when /^-?-?tabby$/
         require 'gtk_paradise/widgets/gtk2/tabby/tabby.rb'
         ::Gtk::Tabble::Tabble.run
       # ===================================================================== #
-      # === gtkparadise --mastermind3
+      # === gtkpa --mastermind3
       # ===================================================================== #
       when /^-?-?mastermind3?$/i
         require 'gtk_paradise/games/gtk3/mastermind/mastermind.rb'
         ::Gtk::Mastermind::Mastermind.run
       # ===================================================================== #
-      # === gtkparadise --mastermind2
+      # === gtkpa --mastermind2
       # ===================================================================== #
       when /^-?-?mastermind2$/i
         require 'gtk_paradise/games/mastermind/mastermind.rb'
         Gtk::Mastermind.run
       # ===================================================================== #
-      # === gtkparadise --hello-world2
+      # === gtkpa --hello-world2
       # ===================================================================== #
       when /^-?-?hello(-|_)?world2$/
         require 'gtk_paradise/hello_world/hello_world_gtk2.rb'
         HelloWorldGtk2.new
       # ===================================================================== #
-      # === gtkparadise --hello
+      # === gtkpa --hello
       # ===================================================================== #
       when /^-?-?hello$/i,
            /^-?-?hello(-|_)?world3?$/
         require 'gtk_paradise/hello_world/hello_world_gtk3.rb'
         HelloWorldGtk3.new
        # ===================================================================== #
-      # === gtkparadise --emoji
+      # === gtkpa --emoji
       # ===================================================================== #
       when /^-?-?emojis?$/i
         require 'gtk_paradise/widgets/gtk3/emoji_widget/emoji_widget.rb'
         ::Gtk::EmojiWidget.run
       # ===================================================================== #
-      # === gtkparadise --help
+      # === gtkpa --help
       # ===================================================================== #
       when /^-?-?help$/i
         e 'These options are available right now:'
         e
         e '  gtk_paradise --tabble     # starts the tabble-interface'
-        e '  gtk_paradise --tabble2    # as above ^^^, but ruby-gtk2 is used'
-        e '  gtk_paradise --tabble3    # as above ^^^, but ruby-gtk3 is '\
-          'used (this is the default nowadays)'
+        e '  gtk_paradise --tabble2    # as above ^^^, but ruby-gtk2 '\
+          'is used'
+        e '  gtk_paradise --tabble3    # as above ^^^, but ruby-gtk3 '\
+          'is used (this is the default nowadays)'
         e '  gtk_paradise --mastermind # starts mastermind'
         e '  gtk_paradise --emoji      # starts the emoji-widget '\
           'showing lots of emojis'

data/lib/gtk_paradise/constants/constants.rb

@@ -6,13 +6,233 @@
 # =========================================================================== #
 module Gtk
 
+  require 'gtk_paradise/project/project.rb'
+
+  # ========================================================================= #
+  # === Gtk::ARRAY_CSS_FILES
+  # ========================================================================= #
+  ARRAY_CSS_FILES = 
+  [
+    "#{::Gtk.project_base_directory?}css_files/project.css",
+    "#{::Gtk.project_base_directory?}css_files/colours.css",
+    "#{::Gtk.project_base_directory?}css_files/borders.css",
+    "#{::Gtk.project_base_directory?}css_files/hover_effects.css"
+  ]
+
+  # ========================================================================= #
+  # === N
+  # ========================================================================= #
+  N = "\n"
+
+  # ========================================================================= #
+  # === AVAILABLE_CURSORS
+  #
+  # Specify the available gtk-related cursors.
+  # ========================================================================= #
+  AVAILABLE_CURSORS = %w(
+    x
+    arrow
+    boat
+    down
+    up
+    bogosity
+    left
+    right
+    side
+    tee
+    left
+    angle
+    spiral
+    center
+    circle
+    clock
+    mug
+    gobbler
+    gumby
+    hand1
+    hand2
+    heart
+    icon
+    iron
+    default
+    left_side
+    left_tee
+    leftbutton 
+  )
+
+  # ========================================================================= #
+  # === Gtk.available_cursors?
+  # ========================================================================= #
+  def self.available_cursors?
+    AVAILABLE_CURSORS
+  end
+
+  # ========================================================================= #
+  # === FONT_SIZE
+  #
+  # Uniform default font-size for the whole GUI part. We pick a fairly
+  # large font size, so to honour elderly people who may have a decreased
+  # vision.
+  # ========================================================================= #
+  FONT_SIZE = '22'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT_FAMILY_FOR_GUI_APPLICATIONS
+  #
+  # Here you can specify a certain default font to use for ruby-gtk
+  # applications.
+  # ========================================================================= #
+  USE_THIS_FONT_FAMILY_FOR_GUI_APPLICATIONS =
+    'Bitstream Vera Serif' # 'DejaVu Sans Mono'
+
+  # ========================================================================= #
+  # === USE_THIS_FONT
+  #
+  # This is the aggregate constant, based on the two constants defined
+  # above. The end-result will be a String such as
+  # 'Bitstream Vera Serif 22'.
+  # ========================================================================= #
+  USE_THIS_FONT =
+    "#{USE_THIS_FONT_FAMILY_FOR_GUI_APPLICATIONS} #{FONT_SIZE}"
+
+  # ========================================================================= #
+  # === FILE_ARROW_RIGHT
+  #
+  # This constant refers to an right-arrow image. This can be used if you 
+  # need to present to the user where to "click" or look at. In some ways 
+  # it is a bit like Gtk::Expander, just as an image, and larger.
+  # ========================================================================= #
+  FILE_ARROW_RIGHT =
+    "#{PROJECT_BASE_DIRECTORY}images/misc/ARROW_RIGHT.png"
+
+  # ========================================================================= #
+  # === FILE_PROJECT_CSS
+  # ========================================================================= #
+  FILE_PROJECT_CSS =
+    "#{PROJECT_BASE_DIRECTORY}css_files/project.css"
+
+  # ========================================================================= #
+  # === FILE_TABBLE
+  # ========================================================================= #
+  FILE_TABBLE = 
+    "#{PROJECT_BASE_DIRECTORY}images/misc/tabble.png"
+
+  # ========================================================================= #
+  # === Gtk.user_config_dir
+  #
+  # This method may return a string such as "/root/.config".
+  # ========================================================================= #
+  def self.user_config_dir
+    GLib.user_config_dir
+  end
+
+# =========================================================================== #
+# Store xbm files in this sub-module. Note that this isn't quite as much in
+# use as it was in, say, the year 2002.
+#
+# Listing of the content so far in this file:
+# 
+#   Gtk::XbmIcons::XBM_SWORD_ICON
+#   Gtk::XbmIcons::BOOK_CLOSED_XPM
+#   Gtk::XbmIcons::BOOK_OPENED_XPM
+#
+# =========================================================================== #
+module XbmIcons # Gtk::XbmIcons
+
+  # ========================================================================= #
+  # === XBM_SWORD_ICON
+  #
+  # To see this file, try:
+  #
+  #   puts Gtk::XbmIcons::XBM_SWORD_ICON
+  #
+  # ========================================================================= #
+  XBM_SWORD_ICON = [   
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x08, 0x00, 0x00, 0x00, 0x00, 0x10, 0x00, 0x00, 0x00,
+    0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x20, 0x00, 0x00, 0x00, 0x00, 0x40,
+    0x00, 0x00, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x00,
+    0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+    0x00, 0x04, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x08,
+    0x04, 0x00, 0x00, 0x00, 0x10, 0x07, 0x00, 0x00, 0x00, 0xc0, 0x02, 0x00,
+    0x00, 0x00, 0x60, 0x01, 0x00, 0x00, 0x00, 0xc0, 0x01, 0x00, 0x00, 0x00,
+    0x78, 0x03, 0x00, 0x00, 0x00, 0x58, 0x07, 0x00, 0x00, 0x00, 0x00, 0x0e,
+    0x00, 0x00, 0x00, 0x00, 0x1e, 0x00, 0x00, 0x00, 0x00, 0x1c, 0x00, 0x00,
+    0x00, 0x00, 0x38, 0x00, 0x00, 0x00, 0x00, 0x70, 0x00, 0x00, 0x00, 0x00,
+    0xe0, 0x00, 0x00, 0x00, 0x00, 0xe0, 0x00, 0x00, 0x00, 0x00, 0x40, 0x00
+  ].pack('c*')
+
+  # ========================================================================= #
+  # Next, some XPM Icons.
+  # ========================================================================= #
+
+  # ========================================================================= #
+  # === BOOK_OPENED_XPM
+  # ========================================================================= #
+  BOOK_OPENED_XPM = [
+    "16 16 4 1",
+    "       c None s None",
+    ".      c black",
+    "X      c #808080",
+    "o      c white",
+    "                ",
+    "  ..            ",
+    " .Xo.    ...    ",
+    " .Xoo. ..oo.    ",
+    " .Xooo.Xooo...  ",
+    " .Xooo.oooo.X.  ",
+    " .Xooo.Xooo.X.  ",
+    " .Xooo.oooo.X.  ",
+    " .Xooo.Xooo.X.  ",
+    " .Xooo.oooo.X.  ",
+    "  .Xoo.Xoo..X.  ",
+    "   .Xo.o..ooX.  ",
+    "    .X..XXXXX.  ",
+    "    ..X.......  ",
+    "     ..         ",
+    "                "
+  ]
+
+  # ========================================================================= #
+  # === BOOK_CLOSED_XPM
+  #
+  # This icon represents a closed book.
+  # ========================================================================= #
+  BOOK_CLOSED_XPM = [
+    "16 16 6 1",
+    "       c None s None",
+    ".      c black",
+    "X      c red",
+    "o      c yellow",
+    "O      c #808080",
+    "#      c white",
+    "                ",
+    "       ..       ",
+    "     ..XX.      ",
+    "   ..XXXXX.     ",
+    " ..XXXXXXXX.    ",
+    ".ooXXXXXXXXX.   ",
+    "..ooXXXXXXXXX.  ",
+    ".X.ooXXXXXXXXX. ",
+    ".XX.ooXXXXXX..  ",
+    " .XX.ooXXX..#O  ",
+    "  .XX.oo..##OO. ",
+    "   .XX..##OO..  ",
+    "    .X.#OO..    ",
+    "     ..O..      ",
+    "      ..        ",
+    "                "
+  ]
+
   # ========================================================================= #
-  # Pull in the four other constants-files next.
+  # To use these images, try something like this:
+  #
+  #   @book_open, @book_open_mask     = Gdk::Pixmap.create_from_xpm_d(@notebook.window, nil, $book_open_xpm)
+  #   @book_closed, @book_closed_mask = Gdk::Pixmap.create_from_xpm_d(@notebook.window, nil, $book_closed_xpm)
+  #
   # ========================================================================= #
-  require 'gtk_paradise/constants/available_cursors.rb'
-  require 'gtk_paradise/constants/fonts.rb'
-  require 'gtk_paradise/constants/misc.rb'
-  require 'gtk_paradise/constants/newline.rb'
-  require 'gtk_paradise/constants/xbm_icons.rb'
 
-end
+end; end

data/lib/gtk_paradise/css_files/borders.css

@@ -0,0 +1,81 @@
+/*
+ * border-variants come next.
+ */
+.bcrimson1            { border: 1px solid crimson; }
+.bcrimson2            { border: 2px solid crimson; }
+.bcrimson3            { border: 3px solid crimson; }
+.btomato1             { border: 1px solid tomato; }
+.btomato2             { border: 2px solid tomato; }
+.btomato3             { border: 3px solid tomato; }
+.blightgreen1         { border: 1px solid lightgreen; }
+.bdarkorchid1         { border: 1px solid darkorchid; }
+.bnavy1               { border: 1px solid navy; }
+.bindigo1             { border: 1px solid indigo; }
+.bgreen1              { border: 1px solid green; }
+.bgreen2              { border: 2px solid green; }
+.bgreen3              { border: 3px solid green; }
+.bblack1              { border: 1px solid black; }
+.bblack2              { border: 2px solid black; }
+.bblack3              { border: 3px solid black; }
+.bblack4              { border: 4px solid black; }
+.bblack5              { border: 5px solid black; }
+.bwhite2              { border: 2px solid white; }
+.bsteelblue1          { border: 1px solid steelblue; }
+.bsteelblue2          { border: 2px solid steelblue; }
+.border_steelblue_2px { border: 2px solid steelblue; }
+.border_steelblue_3px { border: 3px solid steelblue; }
+
+#bcrimson1    { border: 1px solid crimson; }
+#bcrimson2    { border: 2px solid crimson; }
+#bcrimson3    { border: 3px solid crimson; }
+#btomato1     { border: 1px solid tomato;  }
+#btomato2     { border: 2px solid tomato;  }
+#btomato3     { border: 3px solid tomato;  }
+#bblack1      { border: 1px solid black;   }
+#bblack2      { border: 2px solid black;   }
+#bblack3      { border: 3px solid black;   }
+#bwhite2      { border: 2px solid white;   }
+#bsteelblue1  { border: 1px solid steelblue; }
+#bsteelblue2  { border: 2px solid steelblue; }
+.border_3px_royalblue { border: 3px solid royalblue; }
+
+.scrollbar.horizontal {
+  border: 5px solid forestgreen;
+}
+
+.scrollbar.vertical {
+  border: 15px solid tomato;
+}
+
+.border_1px_dotted_black    { border: 1px dotted black; }
+.border_2px_dotted_black    { border: 2px dotted black; }
+.border_3px_dotted_black    { border: 3px dotted black; }
+
+.border_1px_solid_steelblue { border: 1px solid steelblue; }
+.border_2px_solid_steelblue { border: 2px solid steelblue; }
+.border_3px_solid_steelblue { border: 3px solid steelblue; }
+.border_4px_solid_steelblue { border: 4px solid steelblue; }
+.border_5px_solid_steelblue { border: 5px solid steelblue; }
+.border_crimson_1px         { border: 1px solid crimson; }
+.border_crimson_2px         { border: 2px solid crimson; }
+.border_crimson_3px         { border: 3px solid crimson; }
+.border_1px_black_dotted {
+  border: 1px dotted black;
+}
+
+.border_2px_black_dotted {
+  border: 2px dotted black;
+}
+
+.border_3px_black_dotted {
+  border: 3px dotted black;
+}
+
+.border_1px_steelblue {
+  border: 1px solid steelblue;
+}
+
+.test1,
+.test2 {
+  border: 50px solid steelblue;
+}