image_paradise 0.4.8

data/lib/image_paradise/identify.rb

@@ -0,0 +1,184 @@
+#!/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
+
+  require 'time'
+
+  # ========================================================================= #
+  # === CMD_TO_RUN
+  # ========================================================================= #
+  CMD_TO_RUN = 'identify -verbose' # Could also be "identify".
+
+  # ========================================================================= #
+  # === REGEX_TO_USE_FOR_EXIF_DATE_TIME
+  #
+  # See: https://rubular.com/r/cKixMejSJ99dOe
+  # ========================================================================= #
+  REGEX_TO_USE_FOR_EXIF_DATE_TIME = /(\d{4}:\d{2}:\d{2} \d{2}:\d{2}:\d{2})/
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      this_image_file = ARGV,
+      run_already     = true
+    )
+    reset
+    set_work_on_these_images(this_image_file)
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === set_work_on_these_images
+  # ========================================================================= #
+  def set_work_on_these_images(i)
+    @work_on_these_images = [i].flatten.compact
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @result
+    # ======================================================================= #
+    @result = nil
+    # ======================================================================= #
+    # === @colorspace
+    # ======================================================================= #
+    @colorspace = nil
+  end
+
+  # ========================================================================= #
+  # === report_result
+  # ========================================================================= #
+  def report_result
+    e @result
+  end
+
+  # ========================================================================= #
+  # === report_everything                                        (report tag)
+  # ========================================================================= #
+  def report_everything
+    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
+    @work_on_these_images.each {|this_image_file|
+      analyze_this_image(this_image_file)
+      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)
+      e steelblue(padding_to_use+'Colorspace: '.ljust(n_just))+
+        mediumseagreen(@colorspace)
+      e steelblue(padding_to_use+'Creation time: '.ljust(n_just))+
+        mediumseagreen(date_time?) unless date_time?.empty?
+    }
+  end; alias report report_everything # === report
+
+  # ========================================================================= #
+  # === analyze_this_image
+  # ========================================================================= #
+  def analyze_this_image(
+      this_image,
+      cmd_to_use = CMD_TO_RUN
+    )
+    e
+    e forestgreen('Analysing the following image (via ')+
+      orange(cmd_to_use)+
+      forestgreen('):')
+    e
+    e "  #{sfile(this_image)}"
+    e
+    @result = nil
+    _ = this_image
+    if _ and File.exist?(_)
+      @result = `#{cmd_to_use} #{_}`
+    else
+      e 'No file could be found. Please provide a valid '\
+        'argument to this class.'
+    end
+    if @result
+      # ===================================================================== #
+      # Next we will scan for useful information.
+      # ===================================================================== #
+      @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
+      @colorspace       = @result.scan(/Colorspace:(.+)$/).flatten.first.strip
+      # ===================================================================== #
+      # We can also obtain the creation time, via exif. Example for this
+      # follows next:
+      #
+      #   exif:DateTime: 2021:06:21 18:26:06
+      #
+      # ===================================================================== #
+      @date_time       = @result.scan(/exif:DateTime: (.+)$/).flatten.first.to_s.strip
+      # ===================================================================== #
+      # Must time-parse it still:
+      # ===================================================================== #
+      unless @date_time.empty?
+        splitted       = @date_time.split(' ') # Input would be: "2021:06:21 18:26:06"
+        splitted[0]    = splitted[0].tr(':','.')
+        @date_time     = ::Time.parse(splitted.reverse.join(' '))
+      end
+    end
+  end
+
+  # ========================================================================= #
+  # === date_time?
+  # ========================================================================= #
+  def date_time?
+    @date_time.to_s
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= # 
+  def run
+    e
+    report_everything {{ padding: 2 }}
+    e
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise::Identify.new(ARGV)
+end # rubyidentify

data/lib/image_paradise/image_paradise.rb

@@ -0,0 +1,153 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === ImageParadise::ImageParadise
+#
+# This project can be used to do fancy image manipulations from the
+# commandline, including the de-novo creation of new images.
+#
+# Usage example:
+#
+#   ImageParadise::ImageParadise.new(ARGV)
+#
+# =========================================================================== #
+# require 'image_paradise'
+# =========================================================================== #
+require 'image_paradise/requires/common_base_requires.rb'
+require 'image_paradise/toplevel_methods/esystem.rb'
+require 'image_paradise/toplevel_methods/crop.rb'
+require 'image_paradise/toplevel_methods/png_to_svg.rb'
+require 'image_paradise/identify.rb'
+require 'image_paradise/graphs.rb'
+require 'image_paradise/confree_generator/confree_generator.rb'
+
+module ImageParadise
+
+class ImageParadise # === ImageParadise::ImageParadise
+
+  require 'image_paradise/constants/constants.rb'
+  require 'image_paradise/toplevel_methods/create_animated_gif.rb'
+  require 'image_paradise/utility_scripts/optimizer.rb'
+
+  # ========================================================================= #
+  # === initialize
+  #
+  # First argument is the filename that we wish to use.
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      run_already = true
+    )
+    reset
+    set_filename(i)
+    if run_already.to_s.include? 'dont'
+      run_already = false
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+  end
+
+  # ========================================================================= #
+  # === set_filename
+  #
+  # This will be the input filename.
+  # ========================================================================= #
+  def set_filename(i = '')
+    i = i.first if i.is_a? Array
+    i = i.to_s.dup if i
+    @filename = i
+  end
+
+  # ========================================================================= #
+  # === filename?
+  # ========================================================================= #
+  def filename?
+    @filename
+  end; alias input? filename? # === input?
+
+  # ========================================================================= #
+  # === ImageParadise.font_tiled
+  # ========================================================================= #
+  def self.font_tiled(i = DEFAULT_TEXT)
+    i = DEFAULT_TEXT if i.nil?
+    width_and_height = '500x250'
+    _ = CONVERT+" -size "+width_and_height+" xc:lightblue -font "+
+        DEFAULT_FONT+" -pointsize 68 
+        -tile pattern:checkerboard -annotate +28+68 '"+i+"' 
+        font_tile.jpg"
+    esys _
+  end
+
+  # ========================================================================= #
+  # === ImageParadise.esys
+  # ========================================================================= #
+  def self.esys(i)
+    i.delete!(N)
+    esystem(i)
+  end
+
+  # ========================================================================= #
+  # === esys
+  # ========================================================================= #
+  def esys(i)
+    ImageParadise.esys(i)
+  end
+
+  # ========================================================================= #
+  # === colourize
+  #
+  # Input should be R,G,B values.
+  # ========================================================================= #
+  def colourize(rgb_values = '2,15,75')
+    case rgb_values
+    when :randomize, :random
+      rgb_values = (rand(255)+1).to_s+','+(rand(255)+1).to_s+','+(rand(255)+1).to_s
+    end
+    _ = CONVERT+' -colorize '+rgb_values+' '+input?+' '+output?
+    ImageParadise.esys _
+  end
+
+  # ========================================================================= #
+  # === output
+  # ========================================================================= #
+  def output?
+    'output.png'
+  end
+
+  # ========================================================================= #
+  # === ImageParadise.resize
+  #
+  # This is equivalent to:
+  #   convert terminal.gif  -resize 64x64  resize_terminal.gif
+  # ========================================================================= #
+  def self.resize(resize_how = '-resize 64x64')
+    _ = CONVERT+' '+resize_how+' '+input_output?
+  end
+
+  # ========================================================================= #
+  # === input_output?
+  # ========================================================================= #
+  def input_output?
+    input?+' '+output?
+  end
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run # (run tag)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  # _ = ImageParadise.new(ARGV, :dont_run_yet)
+  # _.run
+  ImageParadise::ImageParadise.crop('rose.jpg')
+end # rimage
+    # require 'image_paradise'; ImageParadise.new('foo.jpg').colourize :random

data/lib/image_paradise/image_to_ascii/image_to_ascii.rb

@@ -0,0 +1,187 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+module ImageParadise
+
+class ImageToAscii # === ImageParadise::ImageToAscii
+
+  require 'uri'
+  require 'open-uri'
+
+  begin
+    require 'rmagick' unless Object.const_defined? :Magick
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === HTML
+  # ========================================================================= #
+  HTML = 'html'
+
+  # ========================================================================= #
+  # === BR
+  # ========================================================================= #
+  BR = '<br/>'
+
+  attr_writer :image_chars
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      path_to_file,
+      run_already = true
+    )
+    reset
+    # open-uri open will fallback to IO open.
+    path_to_file = [path_to_file] if path_to_file.is_a? String
+    if path_to_file
+      path_to_file.each {|path|
+        open(path) { |file| @data = file.read }
+      }
+    end
+    self
+  end
+
+  # ========================================================================= #
+  # === result?
+  # ========================================================================= #
+  def result?
+    @result
+  end; alias result result? # === result
+
+  # ========================================================================= #
+  # === ImageToAscii[]
+  #
+  # Usage example:
+  #
+  #   require 'image_to_ascii'
+  #   ImageToAscii['screenshot_2014.png']
+  #
+  # ========================================================================= #
+  def self.[](i)
+    _ = ImageToAscii.new(i)
+    _.to_ascii
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    @data = nil
+  end
+
+  # ========================================================================= #
+  # === to_ascii
+  # ========================================================================= #
+  def to_ascii(options = {})
+    options = {
+      width: 100, color: false, format: 'text'
+    }.merge(options)
+
+    img = Magick::Image.from_blob(@data).first
+
+    width  = options[:width]
+    scale  = (width.to_f / img.columns)
+    height = ((img.rows * scale) / 2).to_i
+
+    img.resize!(width, height)
+    # ======================================================================= #
+    # Check whether we wish to add colours.
+    # ======================================================================= #
+    color_image   = img.dup if options[:color]
+    img           = img.quantize(
+                      image_chars.length, Magick::GRAYColorspace
+                    ).normalize
+    quantum_calc  = Magick::QuantumRange / Magick::QuantumPixel.to_i
+    image_chars.map! {|char|
+      char == ' ' ? '&nbsp;' : char
+    } if options[:format] == HTML
+
+    border = "+#{'-' * width}+#{line_break(options[:format])}"
+    border = html_char(border) if options[:format] == HTML
+
+    output = border.dup
+
+    img.view(0, 0, width, height) { |view|
+      height.times { |i|
+        output << '|'
+        width.times { |j|
+          character = image_chars[view[i][j].red/quantum_calc]
+          if options[:format] == HTML
+            if options[:color]
+              pix = color_image.pixel_color(j,i)
+              color_string = "color: #{pix.to_color( Magick::AllCompliance,false,8, true)};"
+            else
+              color_string = ''
+            end
+            character = html_char(character, color_string)
+          else
+            # text-format
+            if options[:color]
+              pix       = color_image.pixel_color(j,i)
+              character = character.color(
+                unified_rgb_value(pix.red),
+                unified_rgb_value(pix.green),
+                unified_rgb_value(pix.blue)
+              )
+            end
+          end
+          output << character
+        }
+        output << "|#{line_break(options[:format])}"
+      }
+    }
+    @result = output + border
+    return @result
+  end
+
+  # ========================================================================= #
+  # === image_chars
+  # ========================================================================= #
+  def image_chars
+    @image_chars ||= ' .~:+=o*x^%#@$MW'.chars.to_a
+  end
+
+  # ========================================================================= #
+  # === inspect
+  # ========================================================================= #
+  def inspect
+    "#<#{self.class.to_s}>"
+  end
+
+  # ========================================================================= #
+  # === line_break
+  # ========================================================================= #
+  def line_break(format)
+    (format == 'text') ? "\n" : BR
+  end; private :line_break
+
+  # ========================================================================= #
+  # === unified_rgb_value
+  # ========================================================================= #
+  def unified_rgb_value(number)
+    (Magick::QuantumDepth == 16) ? (number / 256) : number
+  end; private :unified_rgb_value
+
+  # ========================================================================= #
+  # === html_char
+  # ========================================================================= #
+  def html_char(char, additional_style = '')
+    "<span style=\"font-family: 'Lucida Console', Monaco, monospace; #{additional_style}\">#{char}</span>"
+  end; private :html_char
+
+end
+
+# =========================================================================== #
+# === ImageParadise.image_to_ascii
+# =========================================================================== #
+def self.image_to_ascii(i = ARGV)
+  ImageParadise::ImageToAscii.new(i)
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise::ImageToAscii.new(ARGV)
+end

data/lib/image_paradise/image_to_pdf/image_to_pdf.rb

@@ -0,0 +1,99 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === ImageParadise::ImageToPdf
+#
+# This class will simply convert an image-file into a .pdf "file".
+#
+# Usage example:
+#
+#   ImageParadise::ImageToPdf.new(ARGV)
+#
+# =========================================================================== #
+# require 'image_paradise/image_to_pdf/image_to_pdf.rb'
+# =========================================================================== #
+require 'image_paradise/base/base.rb'
+
+module ImageParadise
+
+class ImageToPdf < Base # === ImageParadise::ImageToPdf
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+  end
+
+  # ========================================================================= #
+  # === set_commandline_arguments
+  # ========================================================================= #
+  def set_commandline_arguments(i = '')
+    i = [i].flatten.compact
+    @commandline_arguments = i
+  end
+
+  # ========================================================================= #
+  # === first_argument?
+  # ========================================================================= #
+  def first_argument?
+    @commandline_arguments.first
+  end; alias first? first_argument? # === first?
+       alias input? first_argument? # === input?
+
+  # ========================================================================= #
+  # === output?
+  # ========================================================================= #
+  def output?
+    input?.gsub(/#{extname?}/,'')+'.pdf'
+  end
+
+  # ========================================================================= #
+  # === commandline_arguments?
+  # ========================================================================= #
+  def commandline_arguments?
+    @commandline_arguments
+  end
+
+  # ========================================================================= #
+  # === extname?
+  # ========================================================================= #
+  def extname?
+    File.extname(input?)
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    _ = "convert #{input?} #{output?}"
+    esystem _
+  end
+
+  # ========================================================================= #
+  # === ImageParadise::ImageToPdf[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise::ImageToPdf.new(ARGV)
+end # image_to_pdf

data/lib/image_paradise/label/README.md

@@ -0,0 +1,2 @@
+This directory will have label-specific code. This allows you
+to automatically create certain text in imagemagic.