image_paradise 0.1.12

data/lib/image_paradise/svg/svg.rb

@@ -0,0 +1,102 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# Shared coded for the SVG component of the ImageParadise project
+# be stored here.
+# =========================================================================== #
+# require 'image_paradise/svg/svg.rb'
+# =========================================================================== #
+module ImageParadise
+
+module Svg # === ImageParadise::Svg
+
+  require 'image_paradise/project/project.rb'
+  require 'image_paradise/svg/circle.rb'
+  require 'image_paradise/svg/feature.rb'
+  require 'image_paradise/svg/rectangle.rb'
+
+  # ========================================================================= #
+  # === N
+  # ========================================================================= #
+  N = "\n"
+
+  # ========================================================================= #
+  # === @_
+  #
+  # This is a variable that will keep the big String.
+  # ========================================================================= #
+  @_ = ''.dup
+
+  # ========================================================================= #
+  # === Svg.reset
+  # ========================================================================= #
+  def self.reset
+    @_ = ''
+  end
+
+  # ========================================================================= #
+  # === Svg.strip
+  # ========================================================================= #
+  def self.strip(i)
+    return i.squeeze(' ')
+  end
+
+  # ========================================================================= #
+  # === Svg.string?
+  # ========================================================================= #
+  def self.string?
+    @_
+  end; self.instance_eval { alias [] string? } # === Svg[]
+
+  # ========================================================================= #
+  # === Svg.add
+  #
+  # Simply append onto @_.
+  # ========================================================================= #
+  def self.add(i = '')
+    i = i.to_s.dup
+    @_ << i
+  end
+
+  # ========================================================================= #
+  # === Svg.close_svg
+  #
+  # Simply close the <svg> tag here
+  # ========================================================================= #
+  def self.close_svg
+    return '</svg>'+N
+  end
+
+  # ========================================================================= #
+  # === Svg.chart_directory
+  #
+  # Give us the path towards the svg_-charts subdirectory.
+  # ========================================================================= #
+  def self.chart_directory
+    ::ImageParadise.project_base_dir?+'charts/'
+  end
+
+  # ========================================================================= #
+  # === Svg.load_chart_module
+  #
+  # This method will load the individual .rb files from the chart/
+  # subdirectory. Currently this is not in use though - perhaps one
+  # day when I get to use the chart-svg subsection.
+  # ========================================================================= #
+  def self.load_chart_module
+    these_files = Svg.chart_directory+'*.rb'
+    Dir[these_files].each {|file|
+      file = 'image_paradise/svg/charts/'+File.basename(file)
+      require file # And require it.
+    }
+  end; load_chart_module # And call it at once.
+
+  # ========================================================================= #
+  # === Svg.add
+  # ========================================================================= #
+  def self.add_linebreak
+    add "<br>#{N}"
+  end
+
+end; end

data/lib/image_paradise/to_gif.rb

@@ -0,0 +1,91 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === ImageParadise::ToGif
+#
+# This class will simply convert an image file to .gif.
+#
+# Usage example:
+#
+#   ImageParadise::ToGif.new(ARGV)
+#
+# =========================================================================== #
+# require 'image_paradise/to_gif.rb'
+# =========================================================================== #
+require 'image_paradise/base/base.rb'
+
+module ImageParadise
+
+class ToGif < ::ImageParadise::Base # === ImageParadise::ToGif
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    set_input(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+  end
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(i = '')
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup if i
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === run_everything
+  #
+  # This method contains the main logic of the file.
+  # ========================================================================= #
+  def run_everything
+    opn; e 'Next converting '+simp(input?)+' to '+sfile(store_where?)
+    _ = 'convert '+input?+' '+store_where?
+    esystem _
+    if File.exist? store_where?
+      opn; e 'We will next try to optimize '+sfile(store_where?)
+      opn; e 'The old file size is: '+sfancy(File.size(store_where?).to_s)
+      ImageParadise::Optimizer[store_where?]
+      opn; e 'The new file size is: '+sfancy(File.size(store_where?).to_s)
+    end
+  end
+
+  # ========================================================================= #
+  # === input?
+  # ========================================================================= #
+  def input?
+    @input
+  end
+
+  # ========================================================================= #
+  # === store_where?
+  # ========================================================================= #
+  def store_where?
+    input?.gsub(File.extname(input?),'')+'.gif'
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run # (run tag)
+    run_everything
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise::ToGif.new(ARGV)
+end # to_gif

data/lib/image_paradise/to_jpg.rb

@@ -0,0 +1,90 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === ImageParadise::ToJpg
+#
+# This class will simply convert an image file to .jpg format.
+#
+# Usage example:
+#   ImageParadise::ToJpg.new
+# =========================================================================== #
+# require 'image_paradise/to_jpg.rb'
+# =========================================================================== #
+require 'image_paradise/base/base.rb'
+
+module ImageParadise
+
+class ToJpg < ::ImageParadise::Base # === ImageParadise::ToJpg.new
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    set_input(i)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset # (reset tag)
+  end
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(i = '')
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup if i
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === input?
+  # ========================================================================= #
+  def input?
+    @input
+  end
+
+  # ========================================================================= #
+  # === store_where?
+  # ========================================================================= #
+  def store_where?
+    input?.gsub(File.extname(input?),'')+'.jpg'
+  end
+
+  # ========================================================================= #
+  # === run_everything
+  # ========================================================================= #
+  def run_everything
+    opn; e 'Next converting '+simp(input?)+' to '+sfile(store_where?)
+    _ = 'convert '+input?+' '+store_where?
+    esystem _
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    run_everything
+  end
+
+end
+
+# =========================================================================== #
+# === ImageParadise.to_jpg
+# =========================================================================== #
+def self.to_jpg(i = ARGV)
+  ImageParadise::ToJpg.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise::ToJpg.new(ARGV)
+end # to_jpg

data/lib/image_paradise/toplevel_methods/add_black_border_to_this_image.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/add_black_border_to_this_image.rb'
+# =========================================================================== #
+require 'image_paradise/toplevel_methods/e.rb'
+
+module ImageParadise
+
+  begin
+    require 'esystem'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === ImageParadise.add_black_border_to_this_image
+  #
+  # This method will add a (black) border around the given input-image.
+  #
+  # Invocation example:
+  #
+  #   ImageParadise.add_black_border_to_this_image('foobar.png',3)
+  # 
+  # ========================================================================= #
+  def self.add_black_border_to_this_image(
+      file_that_is_to_be_modified = 'foobar.png',
+      n_pixels                    = '1'
+    )
+    n_pixels = n_pixels.to_s
+    if file_that_is_to_be_modified.is_a? Array
+      file_that_is_to_be_modified = file_that_is_to_be_modified.first
+    end
+    if File.exist? file_that_is_to_be_modified
+      extname = File.extname(file_that_is_to_be_modified) # Also has a leading '.' character.
+      new_filename = file_that_is_to_be_modified.sub(/#{File.extname(file_that_is_to_be_modified)}/,'')
+      new_filename << '_black_border_'+n_pixels+'px'
+      new_filename << extname
+      _ = 'convert '+file_that_is_to_be_modified+
+          ' -shave '+n_pixels+'x'+n_pixels+' '\
+          '-bordercolor black '\
+          '-border '+n_pixels+' '+
+          new_filename
+      Esystem.esystem _
+      if File.exist? new_filename
+        e 'The file `'+new_filename+'` has been created.'
+      end
+    else
+      e 'No file exists at `'+file_that_is_to_be_modified+'`.'
+    end
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise.add_black_border_to_this_image(ARGV)
+end # bord_black1 STUDIES.png

data/lib/image_paradise/toplevel_methods/crop.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# We will tap into the project crop next.
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/crop.rb'
+# =========================================================================== #
+require 'image_paradise/crop/crop.rb'
+
+module ImageParadise
+
+  # ========================================================================= #
+  # === crop
+  #
+  # Delegate towards the class-method above, called ImageParadise.crop()
+  # ========================================================================= #
+  def crop(
+      i                   = filename?,
+      crop_command_to_use = nil,
+      optional_hash       = {}
+    )
+    ImageParadise.crop(
+      i, crop_command_to_use, optional_hash
+    )
+  end
+
+end

data/lib/image_paradise/toplevel_methods/e.rb

@@ -0,0 +1,16 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/e.rb'
+# =========================================================================== #
+module ImageParadise
+
+  # ========================================================================= #
+  # === ImageParadise.e
+  # ========================================================================= #
+  def self.e(i = '')
+    puts i
+  end
+
+end

data/lib/image_paradise/toplevel_methods/esystem.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/esystem.rb'
+# =========================================================================== #
+require 'image_paradise/toplevel_methods/e.rb'
+
+module ImageParadise
+
+  # ========================================================================= #
+  # === ImageParadise.esystem
+  # ========================================================================= #
+  def self.esystem(i)
+    e i
+    system(i)
+  end
+
+end

data/lib/image_paradise/toplevel_methods/extract_text_from_this_image.rb

@@ -0,0 +1,56 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/extract_text_from_this_image.rb'
+# =========================================================================== #
+require 'image_paradise/toplevel_methods/esystem.rb'
+
+module ImageParadise
+
+  # ========================================================================= #
+  # === ImageParadise.extract_text_from_this_image
+  #
+  # This method will use tesseract to extract/return text from the
+  # given image at hand.
+  #
+  # Invocation example:
+  #
+  #   ImageParadise.extract_text_from_this_image('foobar.png')
+  #   ImageParadise.extract_text_from_this_image('greyscaled_foo.jpg')
+  #   ImageParadise.extract_text_from_this_image 'greyscaled_image.png'
+  #
+  # ========================================================================= #
+  def self.extract_text_from_this_image(
+      i,
+      use_this_oem_value  = 1, # :default
+      do_show_the_command = false
+    )
+    i = i.join(' ').strip if i.is_a? Array
+    case use_this_oem_value
+    when :default
+      use_this_oem_value = 1
+    end
+    case do_show_the_command
+    when :do_show_the_command
+      do_show_the_command = true
+    end
+    use_this_command = "tesseract #{i} stdout -l eng --oem #{use_this_oem_value} --psm 3 2>&1"
+    if do_show_the_command
+      puts use_this_command
+    end
+    # ========================================================================= #
+    # An alternative to `` may be Open3.capture3(), such as like this:
+    #   require 'open3'
+    #   text, _,  _ = Open3.capture3(use_this_command)
+    #   puts text    
+    # ========================================================================= #
+    result = `#{use_this_command}`
+    return result.strip
+  end; self.instance_eval { alias return_text_from_this_image extract_text_from_this_image } # === ImageParadise.return_text_from_this_image
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise.extract_text_from_this_image(ARGV)
+end # extract_text_from_this_image