image_paradise 0.1.12

data/lib/image_paradise/confree_generator/constants.rb

@@ -0,0 +1,61 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/confree_generator/constants.rb'
+# =========================================================================== #
+require 'image_paradise/base/base.rb'
+
+module ImageParadise
+
+class ConfreeGenerator < ::ImageParadise::Base # === ImageParadise::ConfreeGenerator
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === ALPHABET
+  # ========================================================================= #
+  ALPHABET = ('a'..'z').to_a
+
+  # ========================================================================= #
+  # === TRY_TO_OPEN_THE_GENERATED_IMAGE_IN_THE_BROWSER
+  # ========================================================================= #
+  TRY_TO_OPEN_THE_GENERATED_IMAGE_IN_THE_BROWSER = true
+
+  # ========================================================================= #
+  # === NAME_OF_OUTPUT_FILE
+  # ========================================================================= #
+  NAME_OF_OUTPUT_FILE = 'output.png'
+
+  # ========================================================================= #
+  # === CREATE_HTML_GALLERY
+  # ========================================================================= #
+  CREATE_HTML_GALLERY = false
+
+  # ========================================================================= #
+  # === GENERATE_THE_IMAGE
+  #
+  # If this constant is false, then we will NOT generate any images.
+  #
+  # But we will auto-generate the html parts still.
+  # ========================================================================= #
+  GENERATE_THE_IMAGE = true
+
+  # ========================================================================= #
+  # === OPTIMIZE_PNG_FILES
+  #
+  # If this constant is set to true, then we will try to run
+  # "pngquant" on the generated .png file.
+  # ========================================================================= #
+  OPTIMIZE_PNG_FILES = true
+
+  # ========================================================================= #
+  # === HARDCODED_PATH_TO_THE_CFDG_IMAGES_DIRECTORY
+  # ========================================================================= #
+  HARDCODED_PATH_TO_THE_CFDG_IMAGES_DIRECTORY =
+    '/home/x/DATA/images/cfdg/'
+
+end; end

data/lib/image_paradise/confree_generator/gui/gtk_confree_generator.rb

@@ -0,0 +1,752 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === GtkConfreeGenerator
+#
+# This is my gtk2 Wrapper for Confree-Generator (cfdg).
+# =========================================================================== #
+# rconfree
+# bl $RSRC/confree_generator/lib/confree_generator/gui/gtk_confree_generator.rb
+# =========================================================================== #
+require 'image_paradise/requires/require_colours.rb'
+begin
+  require 'gtk_module'
+rescue LoadError; end
+begin
+  require 'open_in_browser'
+rescue LoadError; end
+require 'image_paradise/confree_generator/shared/shared.rb'
+require 'image_paradise/confree_generator/gui/insert_button.rb'
+require 'image_paradise/confree_generator/class.rb'
+begin
+  require 'x/tools/imageshack.rb' # bl $RUBY_TOOLS/imageshack.rb
+rescue LoadError; end
+begin
+  require 'gtksourceview2'
+rescue Exception => error
+  p error
+end
+
+module ImageParadise
+
+class ConfreeGenerator < ::ImageParadise::Base 
+
+class GtkConfreeGenerator < ::Gtk::VBox # === ImageParadise::ConfreeGenerator::GtkConfreeGenerator.new
+
+  include Colours
+  include ::ImageParadise::ConfreeGenerator::Shared
+  include ::Gtk
+  include ::Gtk::Colours
+  include Esystem
+
+  attr_accessor :source_buffer
+
+  # ========================================================================= #
+  # === MAIN_WINDOW_WIDTH
+  # ========================================================================= #
+  MAIN_WINDOW_WIDTH  = 950
+
+  # ========================================================================= #
+  # === MAIN_WINDOW_HEIGHT
+  # ========================================================================= #
+  MAIN_WINDOW_HEIGHT = 900
+
+  # ========================================================================= #
+  # === TOOLTIP_EDITOR
+  # ========================================================================= #
+  TOOLTIP_EDITOR        = 'Open the file in '+YOUR_FAVOURITE_EDITOR+'.'
+  # === TOOLTIP_IMAGESHACK
+  TOOLTIP_IMAGESHACK    = 'Upload the image to Imageshack.'
+  DEFAULT_TEXT_FOR_ENTRY_FILE_NAME = MY_CONFREE_DIR+'output.png'
+  IMG = ENV['IMG'].to_s
+
+  # ========================================================================= #
+  # === POSSIBLE_RESOLUTIONS
+  # ========================================================================= #
+  POSSIBLE_RESOLUTIONS = [
+    "#{DEFAULT_WIDTH}x#{DEFAULT_HEIGHT}",
+    '600x300',     '600x400',   '640x480',   
+    '640x640',     '800x300',   '800x800',
+    '900x400',   '1000x1000',  '1024x800',
+    '1200x860',  '1280x1024', '1600x1600', 
+    '2400x2400'
+  ]
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i = nil,
+      run_already = true
+    )
+    super()
+    reset
+    set_file_location(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                    (reset tag)
+  # ========================================================================= #
+  def reset
+    @confree_generator = ConfreeGenerator.new(:batch, false)
+    @last_selected_file = '' # this will contain the last selected file.
+    @source_buffer = nil
+  end
+
+  # ========================================================================= #
+  # === set_file_location
+  #
+  # We will load this cfdg file.
+  # ========================================================================= #
+  def set_file_location(i = nil)
+    # Now, set a default, either if you passed no arg, or 'default':
+    if i.nil? or i == 'default' # default is also allowed
+      i = get_random_cfdg
+    end
+    i = i.to_s.dup
+    @file_location = i
+    opn; e 'The cfdg file was found at: '+sfile(i)+'.'
+    @cfdg_file_content = File.readlines(i) # Bundled.
+  end; alias set_input set_file_location # === set_input
+
+  # ========================================================================= #
+  # === open_random_file
+  #
+  # Open a random cfdg file here. This method will then invoke the
+  # method open_this_file().
+  # ========================================================================= #
+  def open_random_file
+    random_file = get_random_cfdg_file
+    e 'Loading this `'+sfile(random_file)+'` random file now.'
+    open_this_file(random_file)
+  end
+
+  # ========================================================================= #
+  # === open_this_file                                             (open tag)
+  #
+  # Use this method if you want to open a .cfdg file. It will set all
+  # necessary stuff.
+  # ========================================================================= #
+  def open_this_file(i)
+    @last_selected_file = i
+    string = File.read(@last_selected_file)
+    _ = File.basename(@file_location)
+    set_source_buffer(string) # we set source buffer
+    @entry_filename.set_text(@last_selected_file)
+    @file_location = @last_selected_file
+    @label_file_name_top.set_text(_)
+    @label_top.set_text(_)
+    @entry_cfdg_file.set_text(@file_location)
+    update_image # as of 16.01.2008 this is also coupled with updating the image.
+  end
+
+  # ========================================================================= #
+  # === startup_application
+  #
+  # Runs all stuff
+  # ========================================================================= #
+  def startup_application
+    create_callbacks
+    create_confree_textedit
+    create_buttons
+    create_gtk_menubar
+    create_vboxes
+    set_main_image
+    create_gtk_entries_and_checkbox_and_combobox
+    create_table
+    open_this_file(@file_location)
+    connect_skeleton
+    run_main
+  end; alias run startup_application # === run
+
+  # ========================================================================= #
+  # === open_firefox_tab
+  #
+  # Simply opens a firefox tab.
+  # ========================================================================= #
+  def open_firefox_tab(
+      i = DEFAULT_TEXT_FOR_ENTRY_FILE_NAME
+    )
+    e "Opening picture #{sfile(i)}"
+    open_in_browser(i)
+  end
+
+  # ========================================================================= #
+  # === ui_manager?
+  # ========================================================================= #
+  def ui_manager?
+    @ui_manager
+  end; alias ui_manager ui_manager? # === ui_manager
+
+  # ========================================================================= #
+  # === update_image
+  #
+  # The image will be created via this method invocation.
+  # ========================================================================= #
+  def update_image
+    if program_exists? 'cfdg'
+      e "Updating @main_image now: #{sfancy(@main_image)}."
+      e "Saving file: #{@confree_generator.save_file}"
+      save_file(@source_buffer.text, @confree_generator.save_file)
+      @confree_generator.run_sys_cmd(@entry_width.text, @entry_height.text)
+      @main_image.clear
+      @main_image.set(DEFAULT_TEXT_FOR_ENTRY_FILE_NAME) 
+    else
+      ewarn 'Sorry, the program `cfdg` could not be found. Did you install it?'
+    end
+  end
+
+  # ========================================================================= #
+  # === set_main_image
+  # 
+  # zeigt unser image an, unser @main_image. Das ist rechter Hand zu finden.
+  # ========================================================================= #
+  def set_main_image
+    @main_image = Gtk::Image.new(
+      DEFAULT_TEXT_FOR_ENTRY_FILE_NAME
+    )
+    @image_event_box = Gtk::EventBox.new
+    @scrolled_window = Gtk::ScrolledWindow.new
+    @scrolled_window.add_with_viewport(@main_image)
+    @scrolled_window.set_size_request(280,280)
+    @image_event_box.add(@scrolled_window)
+    @image_event_box.signal_connect(:button_press_event) { |widget, event|
+      case event.button
+      when 1
+        @callback_open_file.call
+      when 2
+        open_random_file # just assign a random file on middle-click
+      else
+        @callback_open_file.call
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === create_gtk_entries_and_checkbox_and_combobox
+  # 
+  # Hier legt man width und height des images fest
+  # entries. Zudem wird der Gtk::CheckButton definiert.
+  # ========================================================================= #
+  def create_gtk_entries_and_checkbox_and_combobox
+    # Der check button
+    @button_check_coupled = Gtk::CheckButton.new('Coupled')
+    @button_check_coupled.set_active(false)
+    @combo_box_entry = Gtk::ComboBoxEntry.new(true)
+    ARRAY_POSSIBLE_RESOLUTIONS.each { |val| @combo_box_entry.append_text(val) }
+    @combo_box_entry.active = 0
+    # Popup on button release
+    @combo_box_entry.signal_connect(:event) { |widget, event|
+      case event.event_type # event.event_type.name
+      when Gdk::Event::BUTTON_RELEASE
+        Thread.new { @combo_box_entry.popup }
+      end
+    }
+    # If combo box was changed, do sth
+    @combo_box_entry.signal_connect(:changed) {
+      if @combo_box_entry.active_iter
+        combined = @combo_box_entry.active_iter[0]
+        wid,hei = combined.split('x')
+        @entry_width.text = wid
+        @entry_height.text = hei
+        # also, force a decoupling again
+        @button_check_coupled.active = false
+      end
+    }
+    # Is on the top
+    @entry_width = Gtk::Entry.new
+    @entry_width.set_max_length( 7 )
+    @entry_width.signal_connect(:activate) { |w| enter_callback( w ) }
+    @entry_width.set_text( DEFAULT_WIDTH ) # DEFAULT_WIDTH is in togtk;bl CFDG/confree_shared_data.rb
+    @entry_width.signal_connect(:changed) { |w, event|
+      @entry_height.text = @entry_width.text if @button_check_coupled.active?
+    }
+    # The middle entry.
+    @entry_height = Gtk::Entry.new
+    @entry_height.set_max_length( 7 )
+    @entry_height.signal_connect(:activate) { |w| enter_callback( w ) }
+    @entry_height.set_text( DEFAULT_HEIGHT )
+    @entry_height.signal_connect(:changed) { |w,event|
+      if @button_check_coupled.active?
+        @entry_width.text = @entry_height.text
+      end
+    }
+    # entry file name contains the name of our programs
+    @entry_filename = Gtk::Entry.new
+    @entry_filename.set_max_length( 20 )
+    @entry_filename.signal_connect(:activate) { |w| enter_callback( w ) }
+    @entry_filename.set_text( @last_selected_file )
+    # This entry contains the output.png file name.
+    @entry_file_name = Gtk::Entry.new
+    
+    @entry_file_name.set_text(DEFAULT_TEXT_FOR_ENTRY_FILE_NAME)
+    @entry_file_name.signal_connect(:button_press_event) do |widget, event|
+      @entry_file_name.set_focus( true )
+      @entry_file_name.select_region(0, -1)
+    end 
+    
+    @entry_cfdg_file = Gtk::Entry.new
+    @entry_cfdg_file.set_text('')
+    @vbox_entries_and_checkbox = Gtk::VBox.new
+    vbox = Gtk::VBox.new
+    vbox.pack_start(@entry_width,true,true,0)
+    vbox.pack_start(@entry_height,true,true,0)
+
+    image = Gtk::Image.new
+    image.set(:'gtk-preferences', Gtk::IconSize::MENU)
+    
+    @event_box_for_small_icon = Gtk::EventBox.new.add(image)
+    @event_box_for_small_icon.signal_connect(:event) { |widget, event|
+      case event.event_type
+      when Gdk::Event::BUTTON_PRESS
+        @button_check_coupled.set_active(true)
+      end
+    }
+     
+    hbox_with_checkbox_and_combo_box = Gtk::HBox.new
+    hbox_with_checkbox_and_combo_box.pack_start(vbox,true,true,0)
+    hbox_with_checkbox_and_combo_box.pack_start(@combo_box_entry,false,true,0)
+    hbox_with_checkbox_and_combo_box.pack_start(
+      create_paned_hbox( @button_check_coupled, @event_box_for_small_icon),true,true,0
+    )
+    @vbox_entries_and_checkbox.pack_start(hbox_with_checkbox_and_combo_box)
+    @vbox_entries_and_checkbox.pack_start(@entry_filename,true,true)
+  end
+
+  # ========================================================================= #
+  # === create_buttons                          (button tag butt tag but tag)
+  #
+  # will make our buttons. All buttons. If the update button
+  # is pressed, it will store a temporary file.
+  # ========================================================================= #
+  def create_buttons
+    @button_clear = Gtk::Button.new('_Clear')
+    @button_clear.signal_connect(:clicked) { clear_buffer }
+    @button_clear.set_image(Gtk::Image.new(Gtk::Stock::OK, 
+      Gtk::IconSize::SMALL_TOOLBAR))
+    
+    # exit tag, quit tag
+    @button_quit = Gtk::Button.new(Gtk::Stock::QUIT)
+    @button_quit.signal_connect(:clicked)  { @callback_quit_application.call }
+
+    @button_debug = Gtk::Button.new('_Debug')
+    @button_debug.set_image Gtk::Image.new(Gtk::Stock::INFO, 
+      Gtk::IconSize::SMALL_TOOLBAR)
+    @button_debug.signal_connect(:clicked) { e @source_buffer.text }
+
+    @button_open_random_file = Gtk::Button.new('_OpenRandomFile')
+    @button_open_random_file.set_image Gtk::Image.new(Gtk::Stock::INFO, 
+      Gtk::IconSize::SMALL_TOOLBAR)
+    @button_open_random_file.signal_connect(:clicked) { open_random_file }
+
+    @button_update = Gtk::Button.new('_Update (Create Image)')
+    @button_update.relief = Gtk::RELIEF_HALF
+    @button_update.set_image(Gtk::Image.new(Gtk::Stock::REFRESH,
+      Gtk::IconSize::SMALL_TOOLBAR))
+    @button_update.signal_connect(:clicked) { update_image }
+    [
+      @button_clear,
+      @button_quit,
+      @button_debug,
+      @button_open_random_file,
+      @button_update
+    ].each { |button| button_modify_bg(button) }
+  end
+
+  # ========================================================================= #
+  # === create_batch_gallery
+  # ========================================================================= #
+  def create_batch_gallery
+    @confree_generator.run
+  end
+
+  # ========================================================================= #
+  # === width
+  # ========================================================================= #
+  def width
+    MAIN_WINDOW_WIDTH
+  end
+
+  # ========================================================================= #
+  # === height
+  # ========================================================================= #
+  def height
+    MAIN_WINDOW_HEIGHT
+  end
+
+  # ========================================================================= #
+  # === run_main
+  #
+  # also shows main window
+  # ========================================================================= #
+  def run_main
+    self.show_all
+  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
+
+  # ========================================================================= #
+  # === create_confree_textedit
+  #
+  # Entry so that the context free design can be added here.
+  # ========================================================================= #
+  def create_confree_textedit
+    @source_buffer = Gtk::SourceBuffer.new
+    @text_field = Gtk::SourceView.new(@source_buffer)
+    @text_field.show_line_numbers = true
+    # @text_field.show_line_markers = true
+    # @text_field.smart_home_end = true
+    # @text_field.tabs_width = 2 
+    @scw = Gtk::ScrolledWindow.new
+    @scw.add_with_viewport(@text_field)
+  end
+
+  # ========================================================================= #
+  # === upload_image_to_imageshack
+  #
+  # Upload image to imageshack
+  # ========================================================================= #
+  def upload_image_to_imageshack
+    RImageshack.new(@file_location)
+  end
+
+  # ========================================================================= #
+  # === create_table                        (table tag, tab tag. main table.)
+  #
+  # Creates the tables.
+  # ========================================================================= #
+  def create_table
+    @top_table = Gtk::Table.new(1, 2, true)
+    @top_table.row_spacings = 1
+    @top_table.attach_defaults( @scw, 0,1, 0, 1)
+
+    @label_file_name_top = Gtk::Label.new
+    @label_file_name_top.set_text(File.basename(@file_location))
+    
+    @label_top = Gtk::Label.new
+    @label_top.set_justify(Gtk::JUSTIFY_LEFT)
+    @label_top.set_text(File.basename(@file_location))
+ 
+    vbox_top = VBox.new
+    vbox_top.pack_start(@vbox_for_actions,true,true)
+    vbox_top.pack_start(@label_file_name_top,false,true)
+    hbox = create_paned_hbox(vbox_top, @image_event_box)
+    @top_table.attach_defaults(hbox, 1,2,0,1)
+    
+    @main_table = Gtk::Table.new(4, 2, true)
+    @main_table.row_spacings = 0
+    @main_table.attach_defaults( @button_clear,  0,1, 0, 1)
+    
+    hbox = HBox.new
+    hbox.add @button_debug
+    hbox.add @button_open_random_file
+    @main_table.attach_defaults( hbox,  0,1, 1, 2)
+    @main_table.attach_defaults( @button_quit,   0,1, 2, 3)
+    @main_table.attach_defaults( @button_update, 1,2, 0, 1)
+    @main_table.attach_defaults( @vbox_entries_and_checkbox,1,2, 1,2)
+    
+    @event_box_for_firefox = Gtk::EventBox.new
+    firefox_image = Gtk::Image.new(IMG+'/FF/FIREFOX_FAVICON.png')
+    @event_box_for_firefox.add(firefox_image)
+    @event_box_for_firefox.signal_connect(:button_press_event) { open_firefox_tab }
+    hover_message = 'Opens a firefox tab.'
+    Gtk::Tooltips.new.set_tip(firefox_image, hover_message, nil) 
+
+    label = modify_bold_label('ImagePath ' ,'darkblue',:left)
+    event_box_image_path = Gtk::EventBox.new.add(label)
+    event_box_image_path.signal_connect(:button_press_event) {
+      @entry_file_name.select_region(0, -1)
+      @entry_file_name.set_focus(true)
+      e 'Restoring to default '+DEFAULT_TEXT_FOR_ENTRY_FILE_NAME
+      @entry_file_name.set_text(DEFAULT_TEXT_FOR_ENTRY_FILE_NAME) # restore to default again. 
+    }
+
+    hbox_tiny = create_paned_hbox(
+      event_box_image_path,
+      @event_box_for_firefox
+    )
+
+    image_bluefish = Gtk::Image.new
+    image_bluefish.set( Gdk::Pixbuf.new(
+      IMG+'/PC/EDITORS/BLUEFISH/BLUEFISH.png', 25,25 )
+    )
+    event_box = Gtk::EventBox.new
+    event_box.add(image_bluefish)
+
+    Gtk::Tooltips.new.set_tip(event_box, TOOLTIP_EDITOR, nil)
+    event_box.signal_connect(:event) { |widget, event|
+      case event.event_type # event.event_type.name
+      when Gdk::Event::BUTTON_PRESS
+        open_file_in_editor
+      end
+    }
+    _ = IMG+'/PC/IMAGESHACK/IMAGESHACK_FAVICON.png' # cd $IMG/PC/IMAGESHACK/IMAGESHACK_FAVICON.png
+    if File.exist? _ 
+      image_rshack = Gtk::Image.new
+      pixbuf = Gdk::Pixbuf.new(_, 25, 25)
+      image_rshack.set(pixbuf)
+      event_box_with_imageshack = Gtk::EventBox.new
+      event_box_with_imageshack.add(image_rshack)
+      Gtk::Tooltips.new.set_tip(event_box_with_imageshack, TOOLTIP_IMAGESHACK, nil)
+      event_box_with_imageshack.signal_connect(:event) { |widget, event|
+        case event.event_type
+        when Gdk::Event::BUTTON_PRESS then upload_image_to_imageshack
+        end
+      }
+      vbox = create_paned_vbox(
+        hbox_tiny, @entry_file_name, 
+        create_paned_hbox(@entry_cfdg_file, event_box, event_box_with_imageshack)
+      )
+      # Hier der label zum Pfad
+      @main_table.attach_defaults(vbox,1,2,2,3)
+    end
+  end
+
+  # ========================================================================= #
+  # === create_gtk_menubar                                         (menu tag)
+  #
+  # Makes the menu bar.
+  # ========================================================================= #
+  def create_gtk_menubar
+
+    @menu_ui_design = %Q[
+      <ui>
+        <menubar name='MenuBar'>
+          <menu action='FileMenu'>
+            <separator/>
+            <menuitem action='Open'/>
+            <menuitem action='OpenRandomFile'/>
+            <menuitem action='Save'/>
+            <menuitem action='New'/>
+            <separator/>
+            <menuitem action='Quit'/>
+            <separator/>
+          </menu> 
+          <menu action='FileMenu2'>
+            <separator/>
+            <menuitem action='Scramble'/>
+            <separator/>
+          </menu>
+          <menu action='FileMenu3'>
+            <separator/>
+            <menuitem action='BatchMode'/>
+            <separator/>
+          </menu>
+        </menubar>
+      </ui>
+    ]
+
+    @menu_actions = [
+      [ 'FileMenu', nil, '_File'],
+      # der 4. parameter is leider nil, ansonsten nämlich kann 
+      # man nit mehr ordentlich schreiben
+      [ 'Open',           Gtk::Stock::OPEN, '_Open File', nil, 'Open', @callback_open_file ],
+      [ 'OpenRandomFile', Gtk::Stock::OPEN, 'Open _Random File', '<Control>r', 'OpenRandomFile', @callback_open_random_file ],
+      [ 'Save',           Gtk::Stock::SAVE, '_Save',      nil, 'Save', @callback_save_file ],
+      [ 'Quit',           Gtk::Stock::QUIT, '_Quit',      nil, 'Quit', @callback_quit_application ],
+      [ 'New',            Gtk::Stock::NEW,  '_New',       nil, 'Create a new file', @callback_create_new_file ]
+    ]
+
+    @action_group = Gtk::ActionGroup.new('Actions')
+    @action_group.add_actions( @menu_actions )
+    
+    @menu_actions2 = [
+      [ 'FileMenu2', nil, '_Scramble' ],
+      # der 4. parameter is leider nil, ansonsten nämlich kann 
+      # man nit mehr ordentlich schreiben
+      [ 'Scramble', Gtk::Stock::NO, 
+        '_Scramble Large', nil, 'Scramble', @callback_scramble_image ]
+    ]
+    @action_group.add_actions(@menu_actions2)
+    @menu_actions3 = [
+      [ 'FileMenu3', nil, '_OtherActions' ],
+      [ 'BatchMode', Gtk::Stock::REFRESH,'_BatchMode', nil, 'BatchMode allows you to create a gallery 
+      without questions answered etc...', @callback_create_batch_gallery ]
+    ]
+    @action_group.add_actions(@menu_actions3)
+    
+    @ui_manager = Gtk::UIManager.new
+    @ui_manager.insert_action_group(@action_group, 0)
+    @ui_manager.add_ui(@menu_ui_design)
+    @ui_manager.add_tearoffs = true
+  end
+
+  # ========================================================================= #
+  # === open_file_in_editor
+  # This method opens the cfdg file in your designated editor.
+  # ========================================================================= #
+  def open_file_in_editor
+    _ = YOUR_FAVOURITE_EDITOR+ ' '+@file_location
+    esystem _
+  end
+
+  # ========================================================================= #
+  # === create_callbacks
+  #
+  # Creates the callback objects.
+  # ========================================================================= #  
+  def create_callbacks
+    @callback_create_new_file = Proc.new { |actiongroup, action|
+      e "`#{action.name}' new file created. "
+    }
+    @callback_quit_application     = Proc.new { Gtk.main_quit   }
+    @callback_scramble_image       = Proc.new { scramble_image   }
+    @callback_create_batch_gallery = Proc.new { create_batch_gallery }
+    @callback_open_random_file     = Proc.new { open_random_file }
+    @callback_save_file            = Proc.new { save_file }
+    # ======================================================================= #
+    # Here we decide what will happen when we open a new file. (File Dialog)
+    # ======================================================================= #
+    @callback_open_file            = Proc.new { |actiongroup, action|
+      @file_chooser_dialog = Gtk::FileChooserDialog.new('Open File',
+        nil,  Gtk::FileChooser::ACTION_OPEN,  nil, 
+        [ Gtk::Stock::CANCEL, Gtk::Dialog::RESPONSE_CANCEL], 
+        [ Gtk::Stock::OPEN, Gtk::Dialog::RESPONSE_ACCEPT] )
+      # @file_chooser_dialog.show_hidden=true
+      @file_chooser_dialog.add_shortcut_folder( ENV['CFDG'] )
+      @file_chooser_dialog.add_shortcut_folder( IMG )
+      @file_filter = Gtk::FileFilter.new
+      @file_filter.name = 'CFDG Filter' 
+      @file_filter.add_pattern '*.cfdg'
+      @file_chooser_dialog.add_filter(@file_filter)
+      @file_chooser_dialog.current_folder = CFDG_DIRECTORY
+      if @file_chooser_dialog.run == Gtk::Dialog::RESPONSE_ACCEPT
+        _ = @file_chooser_dialog.filename
+        e "  filename = #{_}"
+        open_this_file(_)
+      end
+      @file_chooser_dialog.destroy
+    }
+  end
+
+  # ========================================================================= #
+  # === scramble_image
+  #
+  # Scrambles your image
+  # ========================================================================= #
+  def scramble_image
+    _ = @source_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)
+    set_source_buffer(_)
+  end
+
+  # ========================================================================= #
+  # === create_vboxes
+  #
+  # This method creates the vbox and the box for our action buttons (filled
+  # with InsertButtons.)
+  #
+  # The InsertButton class can be found in the file insert_button.rb
+  # ========================================================================= #
+  def create_vboxes
+    @v_box = Gtk::VBox.new
+    @v_box.show
+    @vbox_for_actions = Gtk::VBox.new
+    @vbox_for_actions.pack_start InsertButton.new(:comment, self),false,false,0
+    @vbox_for_actions.pack_start InsertButton.new(:background, self),false,false,0
+    @vbox_for_actions.pack_start InsertButton.new(:square, self),false,false,0
+    @vbox_for_actions.pack_start InsertButton.new(:triangle, self),false,false,0
+    @vbox_for_actions.pack_start InsertButton.new(:line, self),false,true,0
+    @vbox_for_actions.pack_start InsertButton.new(:rect, self),false,true,0
+    @vbox_for_actions.pack_start InsertButton.new(:circle, self),false,true,0
+    @vbox_for_actions.pack_start InsertButton.new(:hue, self),false,true,0
+    @vbox_for_actions.pack_start InsertButton.new(:sat, self),false,true,0
+    @vbox_for_actions.pack_start InsertButton.new(:b, self),false,true,0
+    @vbox_for_actions.pack_start InsertButton.new(:n, self),false,true,0
+    @vbox_for_actions.show
+  end
+
+  # ========================================================================= #
+  # === set_source_buffer
+  #
+  # This simply sets the source buffer.
+  # ========================================================================= #
+  def set_source_buffer(i = '')
+    @source_buffer.text = i
+  end
+
+  # ========================================================================= #
+  # === button_modify_bg
+  #
+  # Modifies a button, i.e. background stuff, mouseover event.
+  # ========================================================================= #
+  def button_modify_bg(i)
+    i.modify_bg( Gtk::StateType::NORMAL,   CADETBLUE )
+    i.modify_bg( Gtk::StateType::ACTIVE,   BROWN )
+    i.modify_bg( Gtk::StateType::PRELIGHT, BISQUE )
+  end
+
+  # ========================================================================= #
+  # === clear_buffer
+  #
+  # This method clears the buffer.
+  # ========================================================================= #
+  def clear_buffer
+    @source_buffer.text = ''
+  end
+
+  # ========================================================================= #
+  # === connect_skeleton
+  #
+  # glues the parts together. glue tag.
+  # ========================================================================= #
+  def connect_skeleton
+    @v_box.pack_start( @ui_manager['/MenuBar'], false, false ) # das Menü
+    @v_box.pack_start( @label_top, false, false, 0 )
+    @v_box.pack_start( @top_table,false )
+    @v_box.pack_start( Gtk::HSeparator.new, false, false, 0)
+    @v_box.pack_start( @main_table,false ) # mit den buttons, unten.
+    add(@v_box)
+  end
+
+end; end; end
+
+if __FILE__ == $PROGRAM_NAME
+  confree_generator = ImageParadise::ConfreeGenerator::GtkConfreeGenerator.new(
+    ARGV.first
+  )
+  r = Gtk.run(
+    confree_generator.width,
+    confree_generator.height,
+    '/Users/x/DATA/IMG/ART/NEURONAL_HAND.png',
+    'Confree Design',4
+  )
+  # r.add_accel_group( gtk_confree_generator.ui_manager.accel_group )
+  # ^^^ the above does not work.
+  r << confree_generator
+  r.top_left
+  r.run
+end # gtkconfree
+# =========================================================================== #
+# The first is batch mode, the second is GUI mode.
+#   rconfree b
+#   rconfree
+# =========================================================================== #