image_paradise 0.4.20

data/lib/image_paradise/toplevel_methods/negate.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/negate.rb'
+# =========================================================================== #
+module ImageParadise
+
+  require 'image_paradise/toplevel_methods/esystem.rb'
+
+  # ========================================================================= #
+  # === ImageParadise.negate
+  # ========================================================================= #
+  def self.negate(
+      i, # <- The name of the file
+      output_filename = :infer
+    )
+    if i.is_a? Array
+      i = i.join(' ').strip
+    end
+    case output_filename
+    when :infer, :default
+      output_filename = 'negated_'+File.basename(i)
+    end
+    _ = 'convert '+i+' -negate '+output_filename
+    e
+    esystem _
+    e
+    return output_filename # We also return the filename here.
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise.negate(ARGV)
+end # negate

data/lib/image_paradise/toplevel_methods/png_to_svg.rb

@@ -0,0 +1,38 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/png_to_svg.rb'
+# =========================================================================== #
+module ImageParadise
+
+  require 'image_paradise/toplevel_methods/esystem.rb'
+
+  # ========================================================================== #
+  # === ImageParadise.png_to_svg
+  #
+  # Use this method to convert a .png file to a .svg file.
+  #
+  # This has several limitations since we use potrace for this.
+  #
+  # potrace can not work with .png files, only with .pnm files, so
+  # we first have to convert these files.
+  #
+  # The biggest limitation here is that it will remove all colours. :)
+  #
+  # Usage example:
+  #
+  #   ImageParadise.png_to_svg 'COOKBOOKS_LOGO.png'
+  #
+  # ========================================================================== #
+  def self.png_to_svg(this_input_file)
+    pnm_file = this_input_file.gsub(/\.png$/,'')+'.pnm'
+    svg_file = this_input_file.gsub(/\.png$/,'')+'.svg'
+    _ = 'convert '+this_input_file+' '+pnm_file
+    esystem _
+    _ = 'potrace '+pnm_file+' -s -o '+svg_file
+    esystem _
+    return svg_file
+  end; self.instance_eval { alias convert_png_to_svg png_to_svg } # === Imageparadise.convert_png_to_svg
+
+end

data/lib/image_paradise/toplevel_methods/quality.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/quality.rb'
+# =========================================================================== #
+module ImageParadise
+
+  require 'image_paradise/toplevel_methods/esystem.rb'
+
+  # ========================================================================= #
+  # === ImageParadise.quality
+  # ========================================================================= #
+  def self.quality(
+      i,
+      n_percent = '30',
+      output_filename = :guess
+    )
+    if output_filename.is_a? Array
+      output_filename = output_filename.first
+    end
+    n_percent = n_percent.to_s 
+    if i.is_a? Array
+      i = i.join(' ').strip
+    end
+    case output_filename
+    when nil, :guess
+      output_file = 'quality_modified_'+File.basename(i)
+    end
+    _ = 'convert -quality '+n_percent.to_s+'% '+i+' '+output_file
+    esystem _
+  end
+
+end # quality foobar.png 30

data/lib/image_paradise/toplevel_methods/resized.rb

@@ -0,0 +1,43 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/resized.rb'
+# =========================================================================== #
+module ImageParadise
+
+  require 'image_paradise/toplevel_methods/esystem.rb'
+
+  # ========================================================================= #
+  # === ImageParadise.resized
+  #
+  # The second argument is n% resized.
+  # ========================================================================= #
+  def self.resized(
+      i, by_n_percent = '35%',
+      output_filename = nil
+    )
+    unless by_n_percent.is_a? String
+      by_n_percent = by_n_percent.to_s
+    end
+    by_n_percent = by_n_percent.dup
+    by_n_percent << '%' unless by_n_percent.end_with? '%'
+    if i.is_a? Array
+      i = i.join(' ').strip
+    end
+    case output_filename
+    when nil
+      output_filename = 'resized_'+File.basename(i)
+    end
+    _ = 'convert '+i+' -resize '+by_n_percent.to_s+' '+output_filename
+    e
+    esystem _
+    e
+    return output_filename # We also return the filename here.
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise.resized(ARGV)
+end # resized

data/lib/image_paradise/toplevel_methods/roebe.rb

@@ -0,0 +1,440 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/roebe.rb'
+# ImageParadise.is_on_roebe?
+# =========================================================================== #
+module ImageParadise
+
+  require 'image_paradise/constants/constants.rb'
+  require 'image_paradise/colours/colours.rb'
+  require 'image_paradise/toplevel_methods/e.rb'
+
+  # ========================================================================= #
+  # === ImageParadise.is_on_roebe?
+  # ========================================================================= #
+  def self.is_on_roebe?
+    ENV['IS_ROEBE'].to_s == '1'
+  end
+
+  # ========================================================================= #
+  # === ImageParadise.create_file_width_and_height_of_images_in_the_fotogallery
+  #
+  # This is a custom method for my home system. Other users won't need
+  # this really.
+  # ========================================================================= #
+  def self.create_file_width_and_height_of_images_in_the_fotogallery
+    require 'yaml'
+    begin
+      require 'colours'
+    rescue LoadError; end
+    require 'image_paradise/toplevel_methods/misc.rb'
+    hash = {}
+    all_images = Dir['/home/x/data/images/fotos/**/**'].select {|entry|
+      is_an_image?(entry)
+    }
+    all_images.each {|this_image_file|
+      # ======================================================================= #
+      # Show some output, as that will take a while to create the .yml file.
+      # ======================================================================= #
+      e grey('Now working on ')+steelblue(this_image_file)+grey(' ...')
+      width_height = ::ImageParadise.width_height_of_this_image?(this_image_file).to_s
+      hash[File.absolute_path(this_image_file)] = width_height
+      e grey('  Width and height is: ')+steelblue(width_height)
+    }
+    # ======================================================================= #
+    # The custom file for my home system is stored via the following method:
+    # ======================================================================= #
+    into = ::ImageParadise.file_width_and_height_of_images_in_the_fotogallery
+    what = YAML.dump(hash)
+    e "#{rev}Now storing into `#{::Colours.sfancy(into)}`."
+    require 'save_file'
+    ::SaveFile.write_what_into(what, into)
+    # ======================================================================= #
+    # Since as of June 2023 we will also store this into a local .js file.
+    # ======================================================================= #
+    if is_on_roebe?
+      e "#{rev}Storing into a local .js file as well:"
+      # do_create_local_javascript_array
+      _ = "const array = [\n".dup
+      hash.keys.each {|key|
+        _ << "\"#{key}\",\n"
+      }
+      _ << "]\n"
+      into = '/Depot/j/foobar.js'
+      e "Now storing into `#{::Colours.sfancy(into)}`."
+      ::SaveFile.write_what_into(_, into)
+    end
+  end
+
+  # ========================================================================= #
+  # === NACHNAME1
+  #
+  # Only used in the following method.
+  # ========================================================================= #
+  NACHNAME1 = 'K*u*n||*z*'.delete('*|')
+  NACHNAME2 = 'W*i*|n*k*l*e*r'.delete('*|')
+  NACHNAME3 = 'R*i*t*z*b|*e*|r*g*e*r'.delete('*|')
+  NACHNAME4 = 'R*a*u*s*c|*h'.delete('*|') # No longer in use.
+  NACHNAME5 = 'T*a*j*m*a|*r'.delete('*|')
+  require 'image_paradise/toplevel_methods/is_an_image_file.rb'
+  # ========================================================================= #
+  # === ImageParadise.return_n_fotos_in
+  #
+  # This method is only useful on my home system.
+  #
+  # The first argument to this method should be the relative path of the
+  # subdirectory at hand. This presently assumes that all these
+  # subdirectories are under the base_dir, which will not be correct
+  # at all times.
+  #
+  # Usage example:
+  #
+  #   ImageParadise.return_n_fotos_in(:mgasse_8)
+  #
+  # ========================================================================= #
+  def self.return_n_fotos_in(
+      this_directory,
+      include_all_subdirectories = true
+    )
+    base_dir = '/home/x/data/images/fotos/' # Hardcoded for now.
+    n_fotos = 0
+    if this_directory.is_a? Symbol # Symbols are treated differently.
+      company = 'K_p_b_u'.tr('_','a')
+      case this_directory
+      # ===================================================================== #
+      # === :tante_theri
+      # ===================================================================== #
+      when :tante_theri,
+           :tante_teri,
+           :theri,
+           :teri
+        this_directory = base_dir+'family/tante_theri/'
+      # ===================================================================== #
+      # === :documents
+      # ===================================================================== #
+      when :documents
+        this_directory = base_dir+'documents/'
+      # ===================================================================== #
+      # === :gebiete_in_wien
+      # ===================================================================== #
+      when :gebiete_in_wien
+        this_directory = base_dir+'areas/wien/'
+      # ===================================================================== #
+      # === :mollardgasse_14
+      # ===================================================================== #
+      when :mollardgasse14,
+           :mollardgasse_14,
+           :mgasse14,
+           :mgasse_14
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/'+
+                         'mollardgasse_'+(10+4).to_s+'/'
+      # ===================================================================== #
+      # === :mollardgasse_22
+      # ===================================================================== #
+      when :mollardgasse22,
+           :mollardgasse_22,
+           :mgasse22,
+           :mgasse_22
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/'+
+                         'mollardgasse_'+(20+2).to_s+'/'
+      # ===================================================================== #
+      # === :büro_kapabau
+      # ===================================================================== #
+      when :büro_kapabau
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/'+
+                         'Büro_Kapabau/'
+      # ===================================================================== #
+      # === :marchettigasse
+      # ===================================================================== #
+      when :marchettigasse
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/'
+      # ===================================================================== #
+      # === :mgasse8
+      # ===================================================================== #
+      when :mgasse8,
+           :mgasse_8
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/'+
+                         'marchettigasse_'+(4+4).to_s+'/'
+      # ===================================================================== #
+      # === :top_1
+      # ===================================================================== #
+      when :top_1
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/TOP_1/'
+      # ===================================================================== #
+      # === :top_5
+      # ===================================================================== #
+      when :top_5
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/TOP_5/'
+      # ===================================================================== #
+      # === :top_14
+      # ===================================================================== #
+      when :top_14
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/TOP_'+(10+4).to_s+'/'
+      # ===================================================================== #
+      # === :top_19
+      # ===================================================================== #
+      when :top_19
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/TOP_'+(15+4).to_s+'/'
+      # ===================================================================== #
+      # === :top_21
+      # ===================================================================== #
+      when :top_21
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/TOP_21_Büro/'
+      # ===================================================================== #
+      # === :vor_dem_umbau
+      # ===================================================================== #
+      when :vor_dem_umbau
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/marchettigasse_2_bis_6_vor_dem_Umbau_durch_die_Firma_'+company+'/'
+      # ===================================================================== #
+      # === :nach_dem_umbau
+      # ===================================================================== #
+      when :nach_dem_umbau
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/marchettigasse_2_bis_6_während_und_kurz_nach_dem_Umbau_durch_die_Firma_'+company+'/'
+      # ===================================================================== #
+      # === :ordination
+      # ===================================================================== #
+      when :ordination
+        this_directory = base_dir+'areas/marchettigasse_und_mollardgasse/Ordination/'
+      # ===================================================================== #
+      # === :oeynhausen
+      # ===================================================================== #
+      when :oeynhausen
+        this_directory = base_dir+'areas/oeynhausen/'
+      # ===================================================================== #
+      # === :klamm_am_semmering
+      # ===================================================================== #
+      when :klamm_am_semmering
+        this_directory = base_dir+'areas/klamm_am_semmering/'
+      # ===================================================================== #
+      # === :sonstige_baustellen
+      # ===================================================================== #
+      when :sonstige_baustellen
+        this_directory = base_dir+'areas/sonstige_baustellen/'
+      # ===================================================================== #
+      # === :hunde_und_katzen
+      # ===================================================================== #
+      when :hunde_und_katzen
+        this_directory = base_dir+'cats_and_dogs/'
+      # ===================================================================== #
+      # === :sheeva
+      # ===================================================================== #
+      when :sheeva
+        this_directory = base_dir+'cats_and_dogs/sheeva/'
+      # ===================================================================== #
+      # === :mädi
+      # ===================================================================== #
+      when :mädi
+        this_directory = base_dir+'cats_and_dogs/mädi/'
+      # ===================================================================== #
+      # === :kapa
+      # ===================================================================== #
+      when :kapa,
+           :kappa
+        this_directory = base_dir+'cats_and_dogs/kapa/'
+      # ===================================================================== #
+      # === :puma
+      # ===================================================================== #
+      when :puma
+        this_directory = base_dir+'cats_and_dogs/puma/'
+      # ===================================================================== #
+      # === :pizzi
+      # ===================================================================== #
+      when :pizzi
+        this_directory = base_dir+'cats_and_dogs/pizzi/'
+      # ===================================================================== #
+      # === :silbernes
+      # ===================================================================== #
+      when :silbernes
+        this_directory = base_dir+'cats_and_dogs/silbernes/'
+      # ===================================================================== #
+      # === :schatzi
+      # ===================================================================== #
+      when :schatzi
+        this_directory = base_dir+'cats_and_dogs/schatzi/'
+      # ===================================================================== #
+      # === :fennek
+      # ===================================================================== #
+      when :fennek
+        this_directory = base_dir+'cats_and_dogs/fennek/'
+      # ===================================================================== #
+      # === :fleckerl
+      # ===================================================================== #
+      when :fleckerl
+        this_directory = base_dir+'cats_and_dogs/fleckerl/'
+      # ===================================================================== #
+      # === :zwetschki
+      # ===================================================================== #
+      when :zwetschki
+        this_directory = base_dir+'cats_and_dogs/zwetschki/'
+      # ===================================================================== #
+      # === :susi
+      # ===================================================================== #
+      when :susi
+        this_directory = base_dir+'cats_and_dogs/susi/'
+      # ===================================================================== #
+      # === :aisha
+      # ===================================================================== #
+      when :aisha
+        this_directory = base_dir+'cats_and_dogs/aisha/'
+      # ===================================================================== #
+      # === :minzi
+      # ===================================================================== #
+      when :minzi
+        this_directory = base_dir+'cats_and_dogs/minzi/'
+      # ===================================================================== #
+      # === :muck
+      # ===================================================================== #
+      when :muck
+        this_directory = base_dir+'cats_and_dogs/muck/'
+      # ===================================================================== #
+      # === :emily
+      # ===================================================================== #
+      when :emily,
+           :amalia
+        this_directory = base_dir+'cats_and_dogs/amalia/'
+      # ===================================================================== #
+      # === :katzen_gemischt
+      # ===================================================================== #
+      when :katzen_gemischt
+        this_directory = base_dir+'cats_and_dogs/gemischt/'
+      # ===================================================================== #
+      # === :familie_alle_bilder
+      # ===================================================================== #
+      when :familie_alle_bilder
+        this_directory = base_dir+'family/'
+      # ===================================================================== #
+      # === :familie_gemischt
+      # ===================================================================== #
+      when :familie_gemischt
+        this_directory = base_dir+'family/gemischt/'
+      # ===================================================================== #
+      # === :wunibald
+      # ===================================================================== #
+      when :wunibald,
+           :wunibald_k
+        this_directory = base_dir+'family/wunibald_'+NACHNAME1.downcase+'/'
+      # ===================================================================== #
+      # === :ingrid_r
+      # ===================================================================== #
+      when :ingrid_r
+        this_directory = base_dir+'family/ingrid_'+NACHNAME3.downcase+'/'
+      # ===================================================================== #
+      # === :manuela_r
+      # ===================================================================== #
+      when :manuela_r
+        this_directory = base_dir+'family/manuela_'+NACHNAME3.downcase+'/'
+      # ===================================================================== #
+      # === :wolfgang_r
+      # ===================================================================== #
+      when :wolfgang_r
+        this_directory = base_dir+'family/wolfgang_'+NACHNAME3.downcase+'/'
+      # ===================================================================== #
+      # === :helmut_r
+      # ===================================================================== #
+      when :helmut_r
+        this_directory = base_dir+'family/helmut_'+NACHNAME3.downcase+'/'
+      # ===================================================================== #
+      # === :monika
+      # ===================================================================== #
+      when :monika
+        this_directory = base_dir+'family/monika_'+NACHNAME5.downcase+'/'
+      # ===================================================================== #
+      # === :emil_r
+      # ===================================================================== #
+      when :emil_r
+        this_directory = base_dir+'family/emil_'+NACHNAME3.downcase+'/'
+      # ===================================================================== #
+      # === :birgit_r
+      # ===================================================================== #
+      when :birgit_r
+        this_directory = base_dir+'family/birgit_'+NACHNAME3.downcase+'/'
+      # ===================================================================== #
+      # === :wulli
+      # ===================================================================== #
+      when :wulli
+        this_directory = base_dir+'family/wulli_'+NACHNAME3.downcase+'/'
+      # ===================================================================== #
+      # === :edeltraud
+      # ===================================================================== #
+      when :edeltraud
+        this_directory = base_dir+'family/edeltraud_'+NACHNAME2.downcase+'/'
+      # ===================================================================== #
+      # === :helmut_w
+      # ===================================================================== #
+      when :helmut_w
+        this_directory = base_dir+'family/helmut_'+NACHNAME2.downcase+'/'
+      # ===================================================================== #
+      # === :natalie
+      # ===================================================================== #
+      when :natalie,
+           :natalie_k
+        this_directory = base_dir+'family/natalie_'+NACHNAME1.downcase+'/'
+      # ===================================================================== #
+      # === :peter_k
+      # ===================================================================== #
+      when :peter_k
+        this_directory = base_dir+'family/peter_'+NACHNAME1.downcase+'/'
+      # ===================================================================== #
+      # === :hertha_k
+      # ===================================================================== #
+      when :hertha_k
+        this_directory = base_dir+'family/hertha_'+NACHNAME1.downcase+'/'
+      # ===================================================================== #
+      # === :magdalena_r
+      # ===================================================================== #
+      when :magdalena_r
+        this_directory = base_dir+'family/magdalena_'+NACHNAME3.downcase+'/'
+      # ===================================================================== #
+      # === :robert
+      # ===================================================================== #
+      when :robert
+        this_directory = base_dir+'family/robert_'+NACHNAME1.downcase+'/'
+      # ===================================================================== #
+      # === :kindergarten_und_schulklasse
+      # ===================================================================== #
+      when :kindergarten_und_schulklasse
+        this_directory = base_dir+'kindergarten_und_schulklasse/'
+      # ===================================================================== #
+      # === :urlaub
+      # ===================================================================== #
+      when :urlaub
+        this_directory = base_dir+'urlaub/'
+      # ===================================================================== #
+      # === :freunde
+      # ===================================================================== #
+      when :freunde,
+           :friends
+        this_directory = base_dir+'friends/'
+      # ===================================================================== #
+      # === :objects
+      # ===================================================================== #
+      when :objects,
+           :objekte
+        this_directory = base_dir+'objects/'
+      else
+        puts 'Unhandled input in the file roebe.rb: '+
+             this_directory.to_s
+        this_directory = nil
+        exit # For now we will exit; at a later time this may be changed.
+      end
+      if this_directory
+        target = "#{this_directory}*".dup
+        if include_all_subdirectories
+          target << '*/**'
+        end
+        all_files = Dir[target].select {|entry|
+          File.file?(entry) and ::ImageParadise.is_this_an_image_file?(entry)
+        }
+        n_fotos = all_files.size
+      end
+    end
+    return n_fotos
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise.create_file_width_and_height_of_images_in_the_fotogallery
+end

data/lib/image_paradise/toplevel_methods/thumbnail.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'image_paradise/toplevel_methods/thumbnail.rb'
+# =========================================================================== #
+module ImageParadise
+
+  require 'image_paradise/toplevel_methods/esystem.rb'
+
+  # ========================================================================= #
+  # === ImageParadise.thumbnail
+  #
+  # This method can be used to generate a thumbnail from a local, existing
+  # image.
+  #
+  # The third argument is the filename for the generated-file. Normally
+  # this is inferred automatically, hence why the symbol :infer is
+  # used for this, but the user can also provide his or her own filename
+  # here.
+  # ========================================================================= #
+  def self.thumbnail(
+      i,
+      width_height    = :default,
+      output_filename = :infer
+    )
+    case width_height
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default,
+         :default_width_and_size
+      width_height = '250x90'
+    end
+    if i.is_a? Array
+      i = i.join(' ').strip
+    end
+    case output_filename
+    when :infer
+      output_filename = 'thumbnail_'+File.basename(i)
+    end
+    _ = 'convert '+i+' -thumbnail '+
+        width_height.to_s+' '+output_filename
+    e
+    esystem _
+    e
+    return output_filename # We also return the filename here.
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  ImageParadise.thumbnail(ARGV)
+end # thumbnail