image_paradise 0.1.12

data/lib/image_paradise/gui/gtk/control_panel.rb

@@ -0,0 +1,126 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === ImageParadise::GUI::Gtk::ControlPanel
+# =========================================================================== #
+# require 'image_paradise/gui/gtk/control_panel.rb'
+# =========================================================================== #
+require 'gtk_paradise/requires/require_the_base_module.rb'
+
+module ImageParadise
+
+module GUI
+
+module Gtk
+
+class ControlPanel < ::Gtk::VBox # === ImageParadise::GUI::Gtk::ControlPanel
+
+  require 'image_paradise/toplevel_methods/merge_these_images.rb'
+
+  include ::Gtk::BaseModule
+
+  # ========================================================================= #
+  # === WIDTH
+  # ========================================================================= #
+  WIDTH = 1020
+
+  # ========================================================================= #
+  # === HEIGHT
+  # ========================================================================= #
+  HEIGHT = 420
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    super()
+    reset
+    connect_skeleton
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    increase_font_size
+    set_size_request(
+      WIDTH,
+      HEIGHT
+    )
+  end
+
+  # ========================================================================= #
+  # === connect_skeleton
+  # ========================================================================= #
+  def connect_skeleton
+    try_to_change_directory
+    @gtk_entry_working_directory = gtk_entry(return_pwd)
+    hbox1 = gtk_hbox(
+      bold_label: 'Working directory is:',
+      entry: @gtk_entry_working_directory
+    )
+    pack_start(
+      hbox1, false, false, 0
+    )
+
+    @gtk_entry_for_merging_images = gtk_entry
+    hbox2 = gtk_hbox(
+      bold_label: 'Merge these images together:',
+      entry: @gtk_entry_for_merging_images
+    )
+    pack_start(
+      hbox2, false, false, 0
+    )
+    @button_merge_these_images = gtk_button('_Merge these images together.')
+    @button_merge_these_images.signal_connect(:clicked) {
+      do_merge_these_images
+    }
+    pack_start(
+      @button_merge_these_images, false, false
+    )
+    @gtk_entry_this_image_was_merged = gtk_entry
+    pack_start(
+      @gtk_entry_this_image_was_merged, false, false
+    )
+  end
+
+  # ========================================================================= #
+  # === try_to_change_directory
+  # ========================================================================= #
+  def try_to_change_directory
+    cd '/Depot/j' if File.directory? '/Depot/j'
+  end
+
+  # ========================================================================= #
+  # === do_merge_these_images
+  # ========================================================================= #
+  def do_merge_these_images
+    cd @gtk_entry_working_directory.text
+    _ = @gtk_entry_for_merging_images.text
+    if _.include? ' '
+      _ = _.split(' ')
+    end
+    result = ::ImageParadise.merge_these_images(_)
+    @gtk_entry_this_image_was_merged.set_text(result)
+  end
+
+end; end; end
+
+# =========================================================================== #
+# === ImageParadise.gtk_widget
+# =========================================================================== #
+def self.gtk_widget
+  ::ImageParadise::GUI::Gtk::ControlPanel.new
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  require 'gtk_paradise/run.rb'
+  r = Gtk.run
+  r.title = 'Control Panel for the ImageParadise project'
+  x = ImageParadise::GUI::Gtk::ControlPanel.new
+  r << x
+  r.top_left_then_run
+end

data/lib/image_paradise/identify.rb

@@ -0,0 +1,145 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === ImageParadise::Identify
+#
+# The purpose of this class is to simply gather all information that
+# we can obtain by ImageMagick's identify command.
+#
+# Currently, we use the plain "identify" binary. We could also use
+# RMagick, but for now we shall not do so.
+# =========================================================================== #
+# require 'image_paradise/identify.rb'
+# =========================================================================== #
+require 'image_paradise/base/base.rb'
+
+module ImageParadise
+
+class Identify < ::ImageParadise::Base
+
+  # ========================================================================= #
+  # === CMD_TO_RUN
+  # ========================================================================= #
+  CMD_TO_RUN = 'identify -verbose' # Could also be "identify".
+  
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      this_image_file = 'test.png',
+      run_already     = true
+    )
+    reset
+    set_use_this_image_file(this_image_file)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === set_use_this_image_file
+  # ========================================================================= #
+  def set_use_this_image_file(i)
+    if i.is_a? Array
+      i = i.first
+    end
+    @use_this_image_file = i
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @result
+    # ======================================================================= #
+    @result = nil
+  end
+
+  # ========================================================================= #
+  # === report_result
+  # ========================================================================= #
+  def report_result
+    e @result
+  end
+
+  # ========================================================================= #
+  # === report_everything
+  # ========================================================================= #
+  def report_everything
+    report_internal_attributes
+    report_result
+  end
+
+  # ========================================================================= #
+  # === report
+  # ========================================================================= #
+  def report
+    e
+    report_internal_attributes {{ padding: 2 }}
+    e
+  end
+
+  # ========================================================================= #
+  # === report_internal_attributes
+  # ========================================================================= #
+  def report_internal_attributes
+    padding_to_use = ''.dup
+    if block_given?
+      yielded = yield
+      if yielded.is_a? Hash
+        # =================================================================== #
+        # === :padding
+        # =================================================================== #
+        if yielded.has_key? :padding
+          padding_to_use << ' ' * yielded[:padding]
+        end
+      end
+    end
+    n_just = 18
+    e steelblue(padding_to_use+'Mime type: '.ljust(n_just))+
+      mediumseagreen(@mime_type)
+    e steelblue(padding_to_use+'Width: '.ljust(n_just))+
+      mediumseagreen(@width)
+    e steelblue(padding_to_use+'Height: '.ljust(n_just))+
+      mediumseagreen(@height)
+    e steelblue(padding_to_use+'Background color: '.ljust(n_just))+
+      mediumseagreen(@background_color)
+    e steelblue(padding_to_use+'Resolution: '.ljust(n_just))+
+      mediumseagreen(@resolution)
+    e steelblue(padding_to_use+'Quality: '.ljust(n_just))+
+      mediumseagreen(@quality)
+  end
+
+  # ========================================================================= #
+  # === analyze_result
+  # ========================================================================= #
+  def analyze_result
+    _ = @use_this_image_file
+    if _ and File.exist?(_)
+      @result = `#{CMD_TO_RUN} #{_}`
+    else
+      e 'No file could be found. Please provide a valid '\
+        'argument to this class.'
+    end
+    if @result
+      @mime_type        = @result.scan(/Mime type:(.+)$/).flatten.first.strip
+      @width, @height   = @result.scan(/Geometry:(.+)$/).flatten.first.split('x').map(&:strip)
+      @resolution       = @result.scan(/Resolution:(.+)$/).flatten.first.strip
+      @background_color = @result.scan(/Background color:(.+)$/).flatten.first.strip
+      @quality          = @result.scan(/Quality:(.+)$/).flatten.first.strip
+      report
+    end
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= # 
+  def run
+    analyze_result
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise::Identify.new(ARGV)
+end # ruby_identify

data/lib/image_paradise/image_border.rb

@@ -0,0 +1,231 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === ImageParadise::ImageBorder
+#
+# This class will create a border around a given image.
+#
+# The syntax should be:
+#
+#   image_border foobar.png --colour red --dimension 50x20
+#
+# Usage example:
+#   ImageParadise::ImageBorder.new
+# =========================================================================== #
+# require 'image_paradise/image_border.rb'
+# =========================================================================== #
+require 'image_paradise/base/base.rb'
+
+module ImageParadise
+
+class ImageBorder < ::ImageParadise::Base # === ImageParadise::ImageBorder.new
+
+  # ========================================================================= #
+  # === DELETE_OUTPUT_FILE_IF_IT_EXISTS
+  # ========================================================================= #
+  DELETE_OUTPUT_FILE_IF_IT_EXISTS = true
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    set_this_image_file(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    set_border_colour :random # Initialize as default border-colour.
+    @dimension = '10x10'
+  end
+
+  # ========================================================================= #
+  # === colour?
+  # ========================================================================= #
+  def colour?
+    @border_colour
+  end
+
+  # ========================================================================= #
+  # === set_this_image_file
+  # ========================================================================= #
+  def set_this_image_file(i = '')
+    i = i.join(' ').strip if i.is_a? Array
+    i.squeeze!(' ')
+    i = parse_this_input(i)
+    i.strip!
+    menu(i)
+    @this_image_file = i
+  end
+
+  # ========================================================================= #
+  # === show_help                                                  (help tag)
+  # ========================================================================= #
+  def show_help
+    help_string = <<-EOF
+
+These options are available:
+
+  image_border foobar.png --colour RANDOM --dimension 50x25
+
+EOF
+    e help_string
+  end
+
+  # ========================================================================= #
+  # === menu                                                       (menu tag)
+  # ========================================================================= #
+  def menu(i)
+    case i # case tag
+    # ======================================================================= #
+    # === image_border --help
+    # ======================================================================= #
+    when /--help/
+      show_help
+      exit
+    end
+  end
+
+  # ========================================================================= #
+  # === parse_this_input
+  #
+  # This method will parse the commandline options.
+  # ========================================================================= #
+  def parse_this_input(i)
+    if i =~ /(--colour (\S{1,25}))/
+      set_colour($2.to_s.dup)
+      i.sub!(/#{$1.to_s}/,'')
+    end
+    if i =~ /(--dimension (\S{1,25}))/
+      set_dimension($2.to_s.dup)
+      i.sub!(/#{$1.to_s}/,'')
+    end
+    return i
+  end
+
+  # ========================================================================= #
+  # === set_dimension
+  # ========================================================================= #
+  def set_dimension(i)
+    @dimension = i
+  end
+
+  # ========================================================================= #
+  # === set_border_colour
+  # ========================================================================= #
+  def set_border_colour(i = 'SkyBlue')
+    case i.to_s
+    when 'default'
+      i = 'black'
+    when 'RANDOM','random'
+      require 'colours' unless Object.const_defined? :Colours
+      i = Colours.random_html_colour
+    end
+    @border_colour = i
+  end; alias set_colour set_border_colour # === set_colour
+
+  # ========================================================================= #
+  # === this_image_file?
+  # ========================================================================= #
+  def this_image_file?
+    @this_image_file
+  end; alias input?      this_image_file? # === input?
+       alias input_file? this_image_file? # === input_file?
+
+  # ========================================================================= #
+  # === name_of_the_output_file?
+  # ========================================================================= #
+  def name_of_the_output_file?
+    'OUTPUT_'+input_file?.sub(/\.png$/,'').sub(/\.jpg$/,'')+'.png'
+  end; alias output_file? name_of_the_output_file? # === output_file?
+
+  # ========================================================================= #
+  # === determine_name_of_the_output_file
+  #
+  # Use this method to determine the name of the output file that will
+  # be created de-novo.
+  # ========================================================================= #
+  def determine_name_of_the_output_file
+    _ = name_of_the_output_file?
+    if File.exist?(_) and !DELETE_OUTPUT_FILE_IF_IT_EXISTS
+      # ===================================================================== #
+      # In this case use a randomized name.
+      # ===================================================================== #
+      sample = ''
+      20.times { sample << ALPHABET.sample }
+      _ = 'OUTPUT_'+sample+input_file?.sub(/\.png$/,'').sub(/\.jpg$/,'')+'.png'
+    end
+    return _
+  end
+
+  # ========================================================================= #
+  # === cmd?
+  # ========================================================================= #
+  def cmd?
+    @cmd
+  end
+
+  # ========================================================================= #
+  # === run_main_command
+  # ========================================================================= #
+  def run_main_command
+    _ = cmd?
+    if DELETE_OUTPUT_FILE_IF_IT_EXISTS and output_file_exists?
+      File.delete output_file?
+    end
+    e _
+    system _
+  end
+
+  # ========================================================================= #
+  # === output_file_exists?
+  # ========================================================================= #
+  def output_file_exists?
+    File.exist? name_of_the_output_file?
+  end
+
+  # ========================================================================= #
+  # === assemble_main_command
+  # ========================================================================= #
+  def assemble_main_command
+    @cmd = CONVERT+' '
+    @cmd << input_file?+' '
+    @cmd << '-bordercolor '+colour?+' '
+    @cmd << '-border '+@dimension+' '
+    name_of_the_output_file = determine_name_of_the_output_file
+    @cmd << name_of_the_output_file
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    _ = input_file?
+    if File.exist? _
+      assemble_main_command
+      run_main_command
+    else
+      opn; e 'No file called '+sfile(_)+' exists.'
+    end
+  end
+
+  # ========================================================================= #
+  # === ImageParadise::ImageBorder[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise::ImageBorder.new(ARGV)
+end # image_border foobar.png --colour RANDOM --dimension 50x25