multimedia_paradise 1.1.344

data/lib/multimedia_paradise/audio/waveform/constants.rb

@@ -0,0 +1,38 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/audio/waveform/constants.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+class Waveform < ::MultimediaParadise::Base # === MultimediaParadise::Waveform
+
+  # ========================================================================= #
+  # === MultimediaParadise::Waveform::DEFAULT_OPTIONS
+  #
+  # Specify some default options to use for class Waveform.
+  # ========================================================================= #
+  DEFAULT_OPTIONS = {
+    :method           => :peak,
+    :width            => 1800,
+    :height           =>  280,
+    :background_color => '#666666',
+    :color            => '#00ccff',
+    :force            => false,
+    :logger           => nil
+  }
+
+  # ========================================================================= #
+  # === MultimediaParadise::Waveform::TRANSPARENCY_MASK
+  # ========================================================================= #
+  TRANSPARENCY_MASK = '#00ff00'
+
+  # ========================================================================= #
+  # === MultimediaParadise::Waveform::TRANSPARENCY_ALTERNATE
+  #
+  # In case the mask is the background color!
+  # ========================================================================= #
+  TRANSPARENCY_ALTERNATE = '#ffff00'
+
+end; end

data/lib/multimedia_paradise/audio/waveform/log.rb

@@ -0,0 +1,101 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === MultimediaParadise::Waveform::Log
+#
+# The purpose of this class is to log and provide benchmarks.
+#
+# This may be important for lengthy batch operations.
+# 
+# There may be other, better benchmark classes, but it is fairly trivial
+# code - not mandatory to google for better solutions.
+# =========================================================================== #
+# require 'multimedia_paradise/audio/waveform/log.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+class Waveform < ::MultimediaParadise::Base
+
+class Log # === MultimediaParadise::Waveform::Log
+
+  attr_accessor :io
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(io = $stdout)
+    @io = io
+  end
+
+  # ========================================================================= #
+  # === out
+  #
+  # Prints the given message to the log.
+  # ========================================================================= #
+  def out(i)
+    io.print(i) if io
+  end
+
+  # ========================================================================= #
+  # === done!
+  #
+  # Prints the given message to the log followed by the most recent
+  # benchmark (note that it calls .end! which will stop the benchmark)
+  # ========================================================================= #
+  def done!(message = '')
+    out "#{message} (#{self.end!}s)\n"
+  end
+
+  # ========================================================================= #
+  # === start!
+  #
+  # Starts a new benchmark clock and returns the index of the new clock.
+  # 
+  # If .start! is called again before .end! then the time returned will
+  # be the elapsed time from the next call to start!, and calling .end!
+  # again will return the time from *this* call to start! (that is, the
+  # clocks are LIFO).
+  # ========================================================================= #
+  def start!
+    (@benchmarks ||= []) << Time.now
+    @current = @benchmarks.size - 1
+  end
+
+  # ========================================================================= #
+  # === end!
+  #
+  # Returns the elapsed time from the most recently started benchmark clock
+  # and ends the benchmark, so that a subsequent call to .end! will return
+  # the elapsed time from the previously started benchmark clock.
+  # ========================================================================= #
+  def end!
+    elapsed = (Time.now - @benchmarks[@current])
+    @current -= 1
+    elapsed
+  end
+
+  # ========================================================================= #
+  # === time?
+  #
+  # Returns the elapsed time from the benchmark clock w/ the given index
+  # (as returned from when .start! was called).
+  # ========================================================================= #
+  def time?(index)
+    Time.now - @benchmarks[index]
+  end
+
+  # ========================================================================= #
+  # === timed
+  #
+  # Benchmarks the given block, printing out the given message first
+  # (if given).
+  # ========================================================================= #
+  def timed(message = nil, &block)
+    start!
+    out(message) if message
+    yield
+    done!
+  end
+
+end; end; end

data/lib/multimedia_paradise/autoinclude.rb

@@ -0,0 +1,3 @@
+require 'multimedia_paradise'
+
+include MultimediaParadise

data/lib/multimedia_paradise/autoinclude_remove_audio.rb

@@ -0,0 +1,6 @@
+# =========================================================================== #
+# You can require this file if you only need class RemoveAudio.
+# =========================================================================== #
+require 'multimedia_paradise/audio/remove_audio.rb'
+
+include MultimediaParadise

data/lib/multimedia_paradise/base/base.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === MultimediaParadise::Base
+#
+# All .rb files that are part of the MultimediaParadise project can
+# subclass from this file here. This is the preferred way, too.
+# =========================================================================== #
+# require 'multimedia_paradise/base/base.rb'; class Foo < ::MultimediaParadise::Base
+# =========================================================================== #
+require 'multimedia_paradise/toplevel_methods/misc.rb'
+require 'multimedia_paradise/base/constants.rb'
+require 'multimedia_paradise/base/colours.rb'
+require 'multimedia_paradise/base/encoding.rb'
+require 'multimedia_paradise/base/misc.rb'
+require 'multimedia_paradise/base/namespace.rb'
+require 'multimedia_paradise/toplevel_methods/e.rb'
+require 'multimedia_paradise/toplevel_methods/files_and_directories.rb'
+require 'multimedia_paradise/toplevel_methods/is_audio_file.rb'
+require 'multimedia_paradise/toplevel_methods/is_video_file.rb'
+require 'multimedia_paradise/toplevel_methods/output_directory.rb'
+require 'multimedia_paradise/toplevel_methods/return_all_video_files.rb'
+require 'multimedia_paradise/toplevel_methods/player_in_use.rb'
+
+module MultimediaParadise
+
+class Base # === MultimediaParadise::Base
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise::Base.new(ARGV)
+end # multimedia_paradise_base

data/lib/multimedia_paradise/base/colours.rb

@@ -0,0 +1,391 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/base/colours.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+class Base
+
+  require 'multimedia_paradise/colours/colours.rb'
+
+  # ========================================================================= #
+  # === USE_THIS_NAMESPACE_FOR_THE_COLOURS
+  #
+  # Add a "pointer" to the colours gem, via its namespace "Colours".
+  # ========================================================================= #
+  USE_THIS_NAMESPACE_FOR_THE_COLOURS = COLOURS # Defined in multimedia_paradise/colours/colours.rb.
+
+  # ========================================================================= #
+  # === USE_THIS_NAMESPACE_FOR_THE_CORE_COLOURS
+  # ========================================================================= #
+  USE_THIS_NAMESPACE_FOR_THE_CORE_COLOURS = ::Colours
+
+  # ========================================================================= #
+  # === use_colours?
+  # ========================================================================= #
+  def use_colours?
+    @use_colours
+  end
+
+  # ========================================================================= #
+  # === set_use_colours
+  # ========================================================================= #
+  def set_use_colours
+    @use_colours = true
+  end
+
+  # ========================================================================= #
+  # === true_rev
+  # ========================================================================= #
+  def true_rev
+    return ::Colours.rev if @use_colours # This will always refer to ::Colours.rev directly.
+    return '' # And this one here without colours available.
+  end
+
+  # ========================================================================= #
+  # === eparse
+  # ========================================================================= #
+  def eparse(i)
+    if @use_colours
+      USE_THIS_NAMESPACE_FOR_THE_COLOURS.eparse(i)
+    else
+      e i
+    end
+  end
+
+  # ========================================================================= #
+  # === simp
+  # ========================================================================= #
+  def simp(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.olivedrab(i) if use_colours?
+    i
+  end
+
+  # ========================================================================= #
+  # === slateblue
+  # ========================================================================= #
+  def slateblue(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.slateblue(i) if @use_colours and
+           USE_THIS_NAMESPACE_FOR_THE_COLOURS.respond_to? :slateblue
+    i
+  end
+
+  # ========================================================================= #
+  # === indianred
+  # ========================================================================= #
+  def indianred(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.indianred(i) if @use_colours
+    i
+  end
+
+  # ========================================================================= #
+  # === palegreen
+  # ========================================================================= #
+  def palegreen(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.palegreen(i) if @use_colours
+    i
+  end
+
+  # ========================================================================= #
+  # === orange
+  # ========================================================================= #
+  def orange(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.orange(i) if @use_colours
+    i
+  end
+
+  # ========================================================================= #
+  # === mediumpurple
+  # ========================================================================= #
+  def mediumpurple(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.mediumpurple(i) if @use_colours
+    i
+  end
+
+  # ========================================================================= #
+  # === tomato
+  # ========================================================================= #
+  def tomato(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.tomato(i) if @use_colours
+    i
+  end
+
+  # ========================================================================= #
+  # === olive
+  # ========================================================================= #
+  def olive(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.olive(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumslateblue
+  # ========================================================================= #
+  def mediumslateblue(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.mediumslateblue(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === violet
+  # ========================================================================= #
+  def violet(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.violet(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === powderblue
+  # ========================================================================= #
+  def powderblue(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.powderblue(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === lightgreen
+  # ========================================================================= #
+  def lightgreen(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.lightgreen(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === skyblue
+  # ========================================================================= #
+  def skyblue(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.skyblue(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === springgreen
+  # ========================================================================= #
+  def springgreen(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.springgreen(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === dodgerblue
+  # ========================================================================= #
+  def dodgerblue(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.dodgerblue(i) if @use_colours
+    i
+  end
+
+  # ========================================================================= #
+  # === royalblue
+  # ========================================================================= #
+  def royalblue(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.royalblue(i) if @use_colours
+    i
+  end
+
+  # ========================================================================= #
+  # === konsole_colour_peru
+  # ========================================================================= #
+  def konsole_colour_peru(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.peru(i) if @use_colours
+    i
+  end
+
+  # ========================================================================= #
+  # === sfile
+  # ========================================================================= #
+  def sfile(i)
+    return USE_THIS_NAMESPACE_FOR_THE_CORE_COLOURS.sfile(i) if use_colours?
+    i
+  end
+
+  # ========================================================================= #
+  # === sfancy
+  # ========================================================================= #
+  def sfancy(i)
+    return USE_THIS_NAMESPACE_FOR_THE_CORE_COLOURS.sfancy(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === rev                                                         (rev tag)
+  # ========================================================================= #
+  def rev
+    USE_THIS_NAMESPACE_FOR_THE_CORE_COLOURS.rev
+  end
+
+  # ========================================================================= #
+  # === erev
+  # ========================================================================= #
+  def erev(i = '')
+    e "#{rev}#{i}"
+  end
+
+  # ========================================================================= #
+  # === yel
+  # ========================================================================= #
+  def yel(i)
+    USE_THIS_NAMESPACE_FOR_THE_COLOURS.yellow(i) if use_colours?
+  end
+
+  # ========================================================================= #
+  # === sdir
+  # ========================================================================= #
+  def sdir(i)
+    return USE_THIS_NAMESPACE_FOR_THE_CORE_COLOURS.sdir(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === swarn
+  # ========================================================================= #
+  def swarn(i)
+    return USE_THIS_NAMESPACE_FOR_THE_CORE_COLOURS.swarn(i) if use_colours?
+    return i
+  end
+
+  # ========================================================================= #
+  # === ewarn
+  # ========================================================================= #
+  def ewarn(i)
+    e swarn(i)
+  end
+
+  # ========================================================================= #
+  # === olivedrab
+  # ========================================================================= #
+  def olivedrab(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.olivedrab(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === mediumorchid
+  # ========================================================================= #
+  def mediumorchid(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.mediumorchid(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === teal
+  # ========================================================================= #
+  def teal(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.teal(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === steelblue
+  # ========================================================================= #
+  def steelblue(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.teal(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === forestgreen
+  # ========================================================================= #
+  def forestgreen(
+      i, use_colours = @use_colours
+    )
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.teal(i) if use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === crimson
+  # ========================================================================= #
+  def crimson(i = '')
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.crimson(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === ecrimson
+  # ========================================================================= #
+  def ecrimson(i = '')
+    e crimson(i)
+  end
+
+  # ========================================================================= #
+  # === palegoldenrod
+  # ========================================================================= #
+  def palegoldenrod(i)
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.palegoldenrod(i) if @use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === gold
+  # ========================================================================= #
+  def gold(
+      i,  use_colours = use_colours?
+    )
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.gold(i) if use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === grey
+  # ========================================================================= #
+  def grey(
+      i,  use_colours = use_colours?
+    )
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.grey(i) if use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === seagreen
+  # ========================================================================= #
+  def seagreen(
+      i,  use_colours = use_colours?
+    )
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.seagreen(i) if use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === lightblue
+  # ========================================================================= #
+  def lightblue(
+      i, use_colours = use_colours?
+    )
+    return USE_THIS_NAMESPACE_FOR_THE_COLOURS.lightblue(i) if use_colours
+    return i
+  end
+
+  # ========================================================================= #
+  # === colourized_comment
+  # ========================================================================= #
+  def colourized_comment(i)
+    if i.include? '#'
+      splitted = i.split('#')
+      splitted[0] = steelblue(splitted[0])
+      splitted[1] = lightgreen(splitted[1])
+      e splitted.join(grey('#'))
+    else
+      e i
+    end
+  end
+
+  # ========================================================================= #
+  # === ecomment
+  # ========================================================================= #
+  def ecomment(
+      i, use_colours = use_colours?
+    )
+    if use_colours
+      if USE_THIS_NAMESPACE_FOR_THE_COLOURS.respond_to?(:ecomment)
+        USE_THIS_NAMESPACE_FOR_THE_COLOURS.ecomment(i)
+      else
+        ::Colours.ecomment(i)
+      end
+    else
+      e i
+    end
+  end
+
+end; end

data/lib/multimedia_paradise/base/commandline_arguments.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/base/commandline_arguments.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+class Base # === MultimediaParadise::Base
+
+  # ========================================================================= #
+  # === first_argument?
+  # ========================================================================= #
+  def first_argument?
+    @commandline_arguments.first
+  end; alias first? first_argument? # === first?
+
+  # ========================================================================= #
+  # === set_commandline_arguments
+  # ========================================================================= #
+  def set_commandline_arguments(i)
+    @commandline_arguments = [i].flatten.compact
+  end
+
+  # ========================================================================= #
+  # === commandline_arguments?
+  # ========================================================================= #
+  def commandline_arguments?
+    @commandline_arguments
+  end; alias input? commandline_arguments? # === input?
+
+  # ========================================================================= #
+  # === commandline_arguments_as_a_string
+  # ========================================================================= #
+  def commandline_arguments_as_a_string
+    @commandline_arguments.join(' ').strip
+  end; alias commandline_arguments_as_string commandline_arguments_as_a_string # === commandline_arguments_as_string
+
+  # ========================================================================= #
+  # === all_input_starts_with_a_number?
+  #
+  # Determine whether the given input starts with a number.
+  # ========================================================================= #
+  def all_input_starts_with_a_number?(
+      i = @commandline_arguments
+    )
+    !i.empty? and i.all? {|entry|
+      entry =~ /^\d+$/
+    }
+  end
+
+  # ========================================================================= #
+  # === first_non_hyphened_commandline_argument?
+  # ========================================================================= #
+  def first_non_hyphened_commandline_argument?
+    _ = @commandline_arguments.reject {|entry| entry.start_with?('--') }
+    return _.first
+  end
+
+end; end

data/lib/multimedia_paradise/base/constants.rb

@@ -0,0 +1,19 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'multimedia_paradise/base/constants.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+class Base # === MultimediaParadise::Base
+
+  require 'multimedia_paradise/constants/my_video_directory.rb'
+  require 'multimedia_paradise/constants/directory_constants.rb'
+
+  # ========================================================================= #
+  # === N
+  # ========================================================================= #
+  N = "\n"
+
+end; end

data/lib/multimedia_paradise/base/encoding.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# Encoding-related code should be stored in this file here.
+# =========================================================================== #
+module MultimediaParadise
+
+class Base
+
+  require 'multimedia_paradise/constants/encodings.rb'
+
+  # ========================================================================= #
+  # === ensure_main_encoding
+  #
+  # This method can ensure that a String has the proper encoding that
+  # we will use for the MultimediaParadise project.
+  # ========================================================================= #
+  def ensure_main_encoding(
+      i, use_this_encoding = USE_THIS_ENCODING
+    )
+    if i.is_a? String
+      unless i.encoding.to_s.include? use_this_encoding
+        i = i.dup if i.frozen?
+        i = i.force_encoding(use_this_encoding)
+      end
+    end
+    i
+  end
+
+end; end