multimedia_paradise 1.1.314

data/lib/multimedia_paradise/multimedia/base.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === MultimediaParadise::MultimediaBase
+#
+# You can subclass from this class if you have a subclass that somehow has
+# to deal with multimedia related aspects - that is audio and video. For
+# example, class AudioBase will subclass from this class here specifically.
+#
+# This class will also contain audio-specific code, such as the method
+# is_audio_song?().
+#
+# Usage example:
+#
+#   MultimediaParadise::MultimediaBase.new
+#
+# =========================================================================== #
+# require 'multimedia_paradise/multimedia/base.rb'
+# class Foobar < MultimediaParadise::MultimediaBase
+# =========================================================================== #
+require 'multimedia_paradise/base/base.rb'
+
+module MultimediaParadise
+
+class MultimediaBase < ::MultimediaParadise::Base # === MultimediaParadise::MultimediaBase
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize
+    reset
+  end
+
+  # ========================================================================= #
+  # === reset
+  # ========================================================================= #
+  def reset
+    super()
+  end
+
+  # ========================================================================= #
+  # === is_audio_file?
+  # ========================================================================= #
+  def is_audio_file?(i)
+    ::MultimediaParadise.is_audio_file?(i)
+  end; alias is_audio_song?    is_audio_file? # === is_audio_song?
+       alias is_an_audio_file? is_audio_file? # === is_audio_file?
+
+  # ========================================================================= #
+  # === filter_for_audio_files
+  #
+  # We will filter for audio files - so we will keep only files that
+  # are audio files.
+  # ========================================================================= #
+  def filter_for_audio_files(i)
+    i.select {|file| is_audio_file?(file) }
+  end
+
+end; end

data/lib/multimedia_paradise/multimedia/chord.rb

@@ -0,0 +1,174 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This class shall be representative for all Chord objects.
+# =========================================================================== #
+module MultimediaParadise
+
+class Chord # === MultimediaParadise::Chord
+
+  attr_reader :notes
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(notes)
+    if notes.size < 2
+      raise ArgumentError, 'Chords must have at least two notes'
+    end
+    @notes = Set.new(notes) { |note|
+      if note.is_a?(Note)
+        note
+      else
+        Note.new(note)
+      end
+    }
+  end
+
+  # ========================================================================= #
+  # === eql?
+  # ========================================================================= #
+  def eql?(other_chord)
+    @notes == other_chord.notes
+  end
+
+  # ========================================================================= #
+  # === hash
+  # ========================================================================= #
+  def hash
+    @notes.hash
+  end
+
+  # ========================================================================= #
+  # === ==
+  # ========================================================================= #
+  def ==(other_chord)
+    self.eql?(other_chord)
+  end
+
+  # ========================================================================= #
+  # === note_strings
+  #
+  # Spec and implement.
+  # ========================================================================= #
+  def note_strings
+    Set.new(@notes.map(&:note_string))
+  end
+
+  # ========================================================================= #
+  # === describe
+  #
+  # Describe the various minor and major chords.
+  # ========================================================================= #
+  def describe
+    note_array = @notes.to_a.sort
+    distances = (1...note_array.size).map { |i|
+      note_array[0].distance_to(note_array[i])
+    }
+    quality = case distances
+    when [4, 7]
+      :major
+    when [3, 7]
+      :minor
+    when [3, 6]
+      :diminished
+    when [4, 8]
+      :augmented
+    when [4, 7, 11]
+      :major_7
+    when [3, 7, 10]
+      :minor_7
+    when [3, 6, 9]
+      :diminished_7
+    when [3, 6, 10]
+      :half_diminished_7
+    when [4, 8, 10]
+      :augmented_7
+    end
+    [note_array.first.letter, quality]
+  end
+
+  # ========================================================================= #
+  # === to_s
+  # ========================================================================= #
+  def to_s
+    @notes.to_a.sort.map(&:to_s).join(' / ')
+  end
+
+  # ========================================================================= #
+  # === inversion
+  #
+  # Give the n-th inversion of the chord which simply adjusts the lowest
+  # N notes up by one octave.
+  #
+  # @returns [Chord]: the specified inversion of chord
+  # ========================================================================= #
+  def inversion(amount)
+    if amount < 1
+      raise ArgumentError,
+        'Inversion amount must be greater than or equal to 1'
+    end
+    if amount >= @notes.size
+      raise ArgumentError,
+        'Not enough notes in chord for a proper inversion.'
+    end
+    note_array = @notes.to_a.sort
+    notes = (0 .. .amount).map { note_array.shift.adjust_by_semitones(12) }
+    Chord.new(notes + note_array)
+  end
+
+  # ========================================================================= #
+  # === first_inversion
+  #
+  # Calls inversion(1)
+  # ========================================================================= #
+  def first_inversion
+    self.inversion(1)
+  end
+
+  # ========================================================================= #
+  # === second_inversion
+  #
+  # Calls inversion(2)
+  # ========================================================================= #
+  def second_inversion
+    self.inversion(2)
+  end
+
+  # ========================================================================= #
+  # === third_inversion
+  #
+  # Calls inversion(3)
+  # ========================================================================= #
+  def third_inversion
+    self.inversion(3)
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise::Chord.parse_chord_string
+  # ========================================================================= #
+  def self.parse_chord_string(
+      chord_string,
+      assumed_octave = nil
+    )
+    if note_string_match = chord_string.match(/^([A-Ga-g])([#b]?)([^\d]*)(\d*)$/)
+      full_string, note, accidental, interval, octave = note_string_match.to_a
+      if note.empty? && assumed_octave.nil?
+        raise ArgumentError, 'No octave found and no octave assumed.'
+      end
+      # ===================================================================== #
+      # Build a new Note here, which will also be returned.
+      # full_string is irrelevant though.
+      # ===================================================================== #
+      Note.new(
+        note + accidental + octave, assumed_octave
+      ).chord(interval) { full_string }
+    end
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise::Chord.new
+end

data/lib/multimedia_paradise/multimedia/convert_audio_to_video_with_image.rb

@@ -0,0 +1,171 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === MultimediaParadise::::ConvertAudioToVideoWithImage
+#
+# This class can take an audio file, usually a .mp3 file, and combine
+# it with a still image, before outputting an .avi file.
+#
+# The file here was created in July 2018, in order to convert some .mp3
+# files into video files that could then be uploaded.
+#
+# =========================================================================== #
+# Usage examples:
+#
+#   require 'multimedia_paradise/multimedia/convert_audio_to_video_with_image.rb'
+#
+#   MultimediaParadise::ConvertAudioToVideoWithImage.new
+#   MultimediaParadise.to_mp4_with_this_image(ARGV[0], ARGV[1])
+# 
+# =========================================================================== #
+require 'multimedia_paradise/base/base.rb'
+
+module MultimediaParadise
+
+class ConvertAudioToVideoWithImage < ::MultimediaParadise::Base # === MultimediaParadise::ConvertAudioToVideoWithImage.new
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      audio_file  = nil,
+      image_file  = nil,
+      run_already = true
+    )
+    reset
+    set_use_this_audio_file(audio_file)
+    set_use_this_image_file(image_file)
+    if block_given?
+      yielded = yield
+      case yielded
+      # === :to_mp4
+      when :to_mp4
+        do_store_as_mp4_file
+      end
+    end
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    super()
+    # ======================================================================= #
+    # === @use_this_as_file_extension_for_the_output
+    # ======================================================================= #
+    @use_this_as_file_extension_for_the_output = 'avi'
+  end
+
+  # ========================================================================= #
+  # === do_store_as_mp4_file
+  # ========================================================================= #
+  def do_store_as_mp4_file
+    @use_this_as_file_extension_for_the_output = 'mp4'
+  end
+
+  # ========================================================================= #
+  # === set_use_this_audio_file
+  # ========================================================================= #
+  def set_use_this_audio_file(i)
+    i = i.first if i.is_a? Array
+    @use_this_audio_file = i
+  end
+
+  # ========================================================================= #
+  # === audio_file?
+  # ========================================================================= #
+  def audio_file?
+    @use_this_audio_file
+  end
+
+  # ========================================================================= #
+  # === set_use_this_image_file
+  # ========================================================================= #
+  def set_use_this_image_file(i)
+    i = i.first if i.is_a? Array
+    @use_this_image_file = i
+  end
+
+  # ========================================================================= #
+  # === image_file?
+  # ========================================================================= #
+  def image_file?
+    @use_this_image_file
+  end
+
+  # ========================================================================= #
+  # === do_the_conversion
+  #
+  # This is the method that does the actual conversion-step.
+  # ========================================================================= #
+  def do_the_conversion
+    image_file = image_file?
+    e "The image `#{sfile(image_file)}` will be used."
+    output_file_name = audio_file?.dup.
+                       sub(/\.mp3$/,'')+
+                       '.'+
+                       @use_this_as_file_extension_for_the_output
+    # ======================================================================= #
+    # _ = 'ffmpeg -loop 1 -r 1 -i '+image_file+
+    #    ' -i '+audio_file?+' '\
+    #    '-c:a copy -shortest '+
+    #    output_file_name
+    # ======================================================================= #
+    # The next one was added as of 17.05.2020.
+    #
+    # Example:
+    #
+    #   ffmpeg -i pic-0.png -i slide1_audio.mp3 -acodec copy -vcodec libx264 final.mp4
+    #
+    # ======================================================================= #
+    _ = 'ffmpeg'\
+        ' -i '+image_file+
+        ' -i '+audio_file?+
+        ' -acodec copy'+
+        ' -vcodec libx264'+
+        ' '+output_file_name
+    esystem _
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+    do_the_conversion
+  end
+
+  # ========================================================================= #
+  # === MultimediaParadise::ConvertAudioToVideoWithImage[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end
+
+# =========================================================================== #
+# === MultimediaParadise.to_avi_with_this_image
+#
+# Easier toplevel-method to add a static image file to an audio file.
+# =========================================================================== #
+def self.to_avi_with_this_image(audio_file, image_file)
+  MultimediaParadise::ConvertAudioToVideoWithImage.new(audio_file, image_file)
+end
+
+# =========================================================================== #
+# === MultimediaParadise.to_mp4_with_this_image
+#
+# Easier toplevel-method to add a static image file to an audio file.
+# =========================================================================== #
+def self.to_mp4_with_this_image(audio_file = 'slide1_audio.mp3', image_file = 'image.png')
+  MultimediaParadise::ConvertAudioToVideoWithImage.new(audio_file, image_file) { :to_mp4 }
+end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise::ConvertAudioToVideoWithImage.new(ARGV[0], ARGV[1])
+end # convert_audio_to_video_with_image
+    # convert_audio_to_video_with_image /Depot/jjj/Infektionsbio.mp3 /Depot/jjj/A_CAT.jpg

data/lib/multimedia_paradise/multimedia/cut_multimedia/10_minutes_chop.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will cut an audio file into 10 minutes each.
+# =========================================================================== #
+# require '10_minutes_chop.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+module Multimedia
+
+  require 'multimedia_paradise/toplevel_methods/chop_into_segments_of_n_seconds_size.rb'
+
+  # ========================================================================= #
+  # === MultimediaParadise::Audio.chop_this_file_into_ten_minutes_segments
+  #
+  # Note that -segment_time is the amount of time you want per each
+  # file, in seconds.
+  # ========================================================================= #
+  def self.chop_this_file_into_ten_minutes_segments(this_file)
+    ::MultimediaParadise.chop_into_segments_of_n_seconds_size(this_file, 60 * 10)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise::Multimedia.chop_this_file_into_ten_minutes_segments(ARGV.first)  
+end # 10minuteschop

data/lib/multimedia_paradise/multimedia/cut_multimedia/15_minutes_chop.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will cut an audio file into 15 minutes each.
+# =========================================================================== #
+# require '15_minutes_chop.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+module Multimedia
+
+  require 'multimedia_paradise/toplevel_methods/chop_into_segments_of_n_seconds_size.rb'
+
+  # ========================================================================= #
+  # === MultimediaParadise::Audio.chop_this_file_into_fifteen_minutes_segments
+  #
+  # Note that -segment_time is the amount of time you want per each
+  # file, in seconds.
+  # ========================================================================= #
+  def self.chop_this_file_into_fifteen_minutes_segments(this_file)
+    ::MultimediaParadise.chop_into_segments_of_n_seconds_size(this_file, 60 * 15)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise::Multimedia.chop_this_file_into_fifteen_minutes_segments(ARGV.first)  
+end # 15minuteschop

data/lib/multimedia_paradise/multimedia/cut_multimedia/30_minutes_chop.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will cut an audio file into 30 minutes each.
+# =========================================================================== #
+# require '30_minutes_chop.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+module Multimedia
+
+  require 'multimedia_paradise/toplevel_methods/chop_into_segments_of_n_seconds_size.rb'
+
+  # ========================================================================= #
+  # === MultimediaParadise::Audio.chop_this_file_into_thirty_minutes_segments
+  #
+  # Note that -segment_time is the amount of time you want per each
+  # file, in seconds.
+  # ========================================================================= #
+  def self.chop_this_file_into_thirty_minutes_segments(this_file)
+    ::MultimediaParadise.chop_into_segments_of_n_seconds_size(this_file, 60 * 30)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise::Multimedia.chop_this_file_into_thirty_minutes_segments(ARGV.first)  
+end # 30minuteschop

data/lib/multimedia_paradise/multimedia/cut_multimedia/5_minutes_chop.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# This file will cut an audio file into  minutes each.
+# =========================================================================== #
+# require '5_minutes_chop.rb'
+# =========================================================================== #
+module MultimediaParadise
+
+module Multimedia
+
+  require 'multimedia_paradise/toplevel_methods/chop_into_segments_of_n_seconds_size.rb'
+
+  # ========================================================================= #
+  # === MultimediaParadise::Audio.chop_this_file_into_five_minutes_segments
+  #
+  # Note that -segment_time is the amount of time you want per each
+  # file, in seconds.
+  # ========================================================================= #
+  def self.chop_this_file_into_five_minutes_segments(this_file)
+    ::MultimediaParadise.chop_into_segments_of_n_seconds_size(this_file, 60 * 5)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  MultimediaParadise::Multimedia.chop_this_file_into_five_minutes_segments(ARGV.first)  
+end # 15minuteschop