ez_video 1.0.0

data/lib/rvideo/tools/abstract_tool.rb

@@ -0,0 +1,339 @@
+module RVideo # :nodoc:
+  module Tools # :nodoc:
+    class AbstractTool
+      
+      #
+      # AbstractTool is an interface to every transcoder tool class (e.g. 
+      # ffmpeg, flvtool2). Called by the Transcoder class.
+      #
+      
+      def self.assign(cmd, options = {})
+        tool_name = File.split(cmd.split(" ").first).last
+        begin
+          tool = "RVideo::Tools::#{tool_name.classify}".constantize.send(:new, cmd, options)
+        # rescue NameError, /uninitialized constant/
+          # raise TranscoderError::UnknownTool, "The recipe tried to use the '#{tool_name}' tool, which does not exist."
+        rescue => e
+          LOGGER.info $!
+          LOGGER.info e.backtrace.join("\n")
+        end
+      end
+      
+      
+      module InstanceMethods
+        attr_reader :options, :command, :raw_result
+        attr_writer :original
+        
+        def initialize(raw_command, options = {})
+          @raw_command = raw_command
+          @options = HashWithIndifferentAccess.new(options)
+          @command = interpolate_variables(raw_command)
+        end
+
+        #
+        # Execute the command and parse the result.
+        #
+        # def execute
+        #   @output_params = {}
+        #   final_command = "#{@command} 2>&1"
+        #   Transcoder.logger.info("\nExecuting Command: #{final_command}\n")
+        #   @raw_result = `#{final_command}`
+        #   Transcoder.logger.info("Result: \n#{@raw_result}")
+        #   parse_result(@raw_result)
+        # end
+
+        def execute
+          @output_params = {}
+          
+          # Dump the log output into a temp file
+          log_temp_file_name = "/tmp/transcode_output_#{Time.now.to_i}.txt"
+        
+          final_command = "#{@command} 2>#{log_temp_file_name}"
+          Transcoder.logger.info("\nExecuting Command: #{final_command}\n")
+          `#{final_command}`
+          
+          populate_raw_result(log_temp_file_name)
+          
+          Transcoder.logger.info("Result: \n#{@raw_result}")
+          parse_result(@raw_result)
+          
+          # Cleanup log file
+          begin
+            File.delete(log_temp_file_name)
+          rescue Exception  => e
+            Transcoder.logger.error("Failed to delete output log file: #{log_temp_file_name}, e=#{e}")
+          end
+        end
+        
+        #
+        # Magic parameters
+        #
+        def temp_dir
+          if @options['output_file']
+            "#{File.dirname(@options['output_file'])}/"
+          else
+            ""
+          end
+        end
+        
+        
+        def fps
+          format_fps(get_fps)
+        end
+        
+        def get_fps
+          inspect_original if @original.nil?
+          fps = @options['fps'] || ""
+          case fps
+          when "copy"
+            get_original_fps
+          else
+            get_specific_fps
+          end
+        end
+        
+        
+        def resolution
+          format_resolution(get_resolution)
+        end
+        
+        def get_resolution
+          inspect_original if @original.nil?
+          resolution_setting = @options['resolution'] || ""
+          case resolution_setting
+          when "copy"
+            get_original_resolution
+          when "width"
+            get_fit_to_width_resolution
+          when "height"
+            get_fit_to_height_resolution
+          when "letterbox"
+            get_letterbox_resolution
+          else
+            get_specific_resolution
+          end
+        end
+        
+        
+        def audio_channels
+          format_audio_channels(get_audio_channels)
+        end
+
+        def get_audio_channels
+          channels = @options['audio_channels'] || ""
+          case channels
+          when "stereo"
+            get_stereo_audio
+          when "mono"
+            get_mono_audio
+          else
+            {}
+          end
+        end  
+        
+        def audio_bit_rate
+          format_audio_bit_rate(get_audio_bit_rate)
+        end
+        
+        def get_audio_bit_rate
+          bit_rate = @options['audio_bit_rate'] || ""
+          case bit_rate
+          when ""
+            {}
+          else
+            get_specific_audio_bit_rate
+          end
+        end
+        
+        def audio_sample_rate
+          format_audio_sample_rate(get_audio_sample_rate)
+        end
+        
+        def get_audio_sample_rate
+          sample_rate = @options['audio_sample_rate'] || ""
+          case sample_rate
+          when ""
+            {}
+          else
+            get_specific_audio_sample_rate
+          end
+        end
+        
+        def video_quality
+          format_video_quality(get_video_quality)
+        end
+        
+        def get_video_quality
+          inspect_original if @original.nil?
+          quality = @options['video_quality'] || 'medium'
+          video_bit_rate = @options['video_bit_rate'] || nil
+          h = {:video_quality => quality, :video_bit_rate => video_bit_rate}
+          h.merge!(get_fps).merge!(get_resolution)
+        end
+        
+        
+        
+        def get_fit_to_width_resolution
+          w = @options['width']
+          raise TranscoderError::ParameterError, "invalid width of '#{w}' for fit to width" unless valid_dimension?(w)
+          h = calculate_height(@original.width, @original.height, w)
+          {:scale => {:width => w, :height => h}}
+        end
+        
+        def get_fit_to_height_resolution
+          h = @options['height']
+          raise TranscoderError::ParameterError, "invalid height of '#{h}' for fit to height" unless valid_dimension?(h)
+          w = calculate_width(@original.width, @original.height, h)
+          {:scale => {:width => w, :height => h}}
+        end
+        
+        def get_letterbox_resolution
+          lw = @options['width'].to_i
+          lh = @options['height'].to_i
+          raise TranscoderError::ParameterError, "invalid width of '#{lw}' for letterbox" unless valid_dimension?(lw)
+          raise TranscoderError::ParameterError, "invalid height of '#{lh}' for letterbox" unless valid_dimension?(lh)
+          w = calculate_width(@original.width, @original.height, lh)
+          h = calculate_height(@original.width, @original.height, lw)
+          if w > lw
+            w = lw
+            h = calculate_height(@original.width, @original.height, lw)
+          else
+            h = lh
+            w = calculate_width(@original.width, @original.height, lh)
+          end
+          {:scale => {:width => w, :height => h}, :letterbox => {:width => lw, :height => lh}}
+        end
+        
+        def get_original_resolution
+          {:scale => {:width => @original.width, :height => @original.height}}
+        end
+
+        def get_specific_resolution
+          w = @options['width']
+          h = @options['height']
+          raise TranscoderError::ParameterError, "invalid width of '#{w}' for specific resolution" unless valid_dimension?(w)
+          raise TranscoderError::ParameterError, "invalid height of '#{h}' for specific resolution" unless valid_dimension?(h)
+          {:scale => {:width => w, :height => h}}
+        end
+        
+        def get_original_fps
+          return {} if @original.fps.nil?
+          {:fps => @original.fps}
+        end
+        
+        def get_specific_fps
+          {:fps => @options['fps']}
+        end
+        
+        # def get_video_quality
+        #   fps = @options['fps'] || @original.fps
+        #   raise TranscoderError::ParameterError, "could not find fps in order to determine video quality" if fps.nil?
+        #   width = @original.width
+        #   height = @
+        #   format_video_quality({:quality => @options['video_quality'], :bit_rate => @options['video_bit_rate']})
+        # end
+        
+        def get_stereo_audio
+          {:channels => "2"}
+        end
+        
+        def get_mono_audio
+          {:channels => "1"}
+        end
+        
+        def get_specific_audio_bit_rate
+          {:bit_rate => @options['audio_bit_rate']}
+        end
+        
+        def get_specific_audio_sample_rate
+          {:sample_rate => @options['audio_sample_rate']}
+        end
+        
+        def calculate_width(ow, oh, h)
+          w = ((ow.to_f / oh.to_f) * h.to_f).to_i
+          (w.to_f / 16).round * 16
+        end
+
+        def calculate_height(ow, oh, w)
+          h = (w.to_f / (ow.to_f / oh.to_f)).to_i
+          (h.to_f / 16).round * 16
+        end
+          
+
+        def valid_dimension?(dim)
+          return false if dim.to_i <= 0
+          return true
+        end
+        
+        def format_resolution(params={})
+          raise ParameterError, "The #{self.class} tool has not implemented the format_resolution method."
+        end
+
+        def format_fps(params={})
+          raise ParameterError, "The #{self.class} tool has not implemented the format_fps method."
+        end
+
+        def format_audio_channels(params={})
+          raise ParameterError, "The #{self.class} tool has not implemented the format_audio_channels method."
+        end
+
+        def format_audio_bit_rate(params={})
+          raise ParameterError, "The #{self.class} tool has not implemented the format_audio_bit_rate method."
+        end
+
+        def format_audio_sample_rate(params={})
+          raise ParameterError, "The #{self.class} tool has not implemented the format_audio_sample_rate method."
+        end
+
+        private
+        
+        
+        #
+        # Look for variables surrounded by $, and interpolate with either 
+        # variables passed in the options hash, or special methods provided by
+        # the tool class (e.g. "$original_fps$" with ffmpeg).
+        #
+        # $foo$ should match
+        # \$foo or $foo\$ or \$foo\$ should not
+
+        def interpolate_variables(raw_command)
+          raw_command.scan(/[^\\]\$[-_a-zA-Z]+\$/).each do |match|
+            match = match[0..0] == "$" ? match : match[1..(match.size - 1)]
+            match.strip!
+            raw_command.gsub!(match, matched_variable(match))
+          end
+          raw_command.gsub("\\$", "$")
+        end
+        
+        #
+        # Strip the $s. First, look for a supplied option that matches the
+        # variable name. If one is not found, look for a method that matches.
+        # If not found, raise ParameterError exception.
+        # 
+        
+        def matched_variable(match)
+          variable_name = match.gsub("$","")
+          if self.respond_to? variable_name
+            self.send(variable_name)
+          elsif @options.key?(variable_name) 
+            @options[variable_name] || ""
+          else
+            raise TranscoderError::ParameterError, "command is looking for the #{variable_name} parameter, but it was not provided. (Command: #{@raw_command})"
+          end
+        end
+        
+        def inspect_original
+          @original = Inspector.new(:file => options[:input_file])
+        end
+        
+        # Pulls the interesting bits of the temp log file into memory.  This is fairly tool-specific, so
+        # it's doubtful that this default version is going to work without being overridded.
+        def populate_raw_result(temp_file_name)
+          @raw_result = `tail -n 500 #{temp_file_name}`
+        end
+        
+      end
+    
+    end
+  end
+end

data/lib/rvideo/tools/ffmpeg.rb

@@ -0,0 +1,208 @@
+module RVideo
+  module Tools
+    class Ffmpeg
+      include AbstractTool::InstanceMethods
+      
+      attr_reader :frame, :q, :size, :time, :output_bitrate, :video_size, :audio_size, :header_size, :overhead, :psnr, :output_fps
+      
+      # Not sure if this is needed anymore...
+      def tool_command
+        'ffmpeg'
+      end
+      
+      def format_fps(params={})
+        " -r #{params[:fps]}"
+      end
+      def format_video_quality(params={})
+        bitrate = params[:video_bit_rate].blank? ? nil : params[:video_bit_rate]
+        factor = (params[:scale][:width].to_f * params[:scale][:height].to_f * params[:fps].to_f)
+        case params[:video_quality]
+        when 'low'
+          bitrate ||= (factor / 12000).to_i
+          " -v #{bitrate}k -crf 30 -me zero -subq 1 -refs 1 -threads auto "
+        when 'medium'
+          bitrate ||= (factor / 9000).to_i
+          " -v #{bitrate}k -crf 22 -flags +loop -cmp +sad -partitions +parti4x4+partp8x8+partb8x8 -flags2 +mixed_refs -me hex -subq 3 -trellis 1 -refs 2 -bf 3 -b_strategy 1 -coder 1 -me_range 16 -g 250"
+        when 'high'
+          bitrate ||= (factor / 3600).to_i
+          " -v #{bitrate}k -crf 18 -flags +loop -cmp +sad -partitions +parti4x4+partp8x8+partb8x8 -flags2 +mixed_refs -me full -subq 6 -trellis 1 -refs 3 -bf 3 -b_strategy 1 -coder 1 -me_range 16 -g 250 -keyint_min 25 -sc_threshold 40 -i_qfactor 0.71"
+        else
+          ""
+        end
+      end  
+      
+      
+      def format_resolution(params={})
+        p = " -s #{params[:scale][:width]}x#{params[:scale][:height]} "
+        if params[:letterbox]
+          plr = ((params[:letterbox][:width] - params[:scale][:width]) / 2).to_i
+          ptb = ((params[:letterbox][:height] - params[:scale][:height]) / 2).to_i
+          p += " -padtop #{ptb} -padbottom #{ptb} -padleft #{plr} -padright #{plr} "
+        end
+        p
+      end
+
+      def format_audio_channels(params={})
+        " -ac #{params[:channels]}"
+      end
+      
+      def format_audio_bit_rate(params={})
+        " -ab #{params[:bit_rate]}k"
+      end
+      
+      def format_audio_sample_rate(params={})
+        " -ar #{params[:sample_rate]}"
+      end
+      
+      
+      private
+      
+      # Turns the temp log file into a useful string, from which we can parse the 
+      # transcoding results.
+      # These log files can be enormous, so pulling the whole thing into memory is not an 
+      # option.
+      def populate_raw_result(temp_file_name)
+        @raw_result = ""
+        
+        # Is the log file exceptionally long?  It's really not a big deal to pull in a thousand lines or so
+        # into memory.  It's the gigantic files that cause problems.  If the files isn't too large, 
+        # just pull it in.
+        line_count = 0
+        if m = /^\s*(\d+)/.match(`wc -l #{temp_file_name}`)
+          line_count = m[1].to_i
+        end
+        
+        if line_count > 500
+          # Find the message indicating that the command is actually running.
+          running_string = "Press .* to stop encoding"
+          @raw_result << `grep "#{running_string}" #{temp_file_name}`
+        end
+
+        # Append the bottom of the log file, where the interesting bits live.
+        @raw_result << `tail -n 500 #{temp_file_name}`
+      end
+      
+      def parse_result(result)
+        
+        if m = /Unable for find a suitable output format for.*$/.match(result)
+          raise TranscoderError::InvalidCommand, m[0]
+        end
+        
+        if m = /Unknown codec \'(.*)\'/.match(result)
+          raise TranscoderError::InvalidFile, "Codec #{m[1]} not supported by this build of ffmpeg"
+       end
+        
+        if m = /could not find codec parameters/.match(result)
+          raise TranscoderError::InvalidFile, "Codec not supported by this build of ffmpeg"
+        end
+        
+        if m = /I\/O error occured\n(.*)$/.match(result)
+          raise TranscoderError::InvalidFile, "I/O error: #{m[1].strip}"
+        end
+          
+        if m = /\n(.*)Unknown Format$/.match(result)
+          raise TranscoderError::InvalidFile, "unknown format (#{m[1]})"
+        end
+        
+        if m = /\nERROR.*/m.match(result)
+          raise TranscoderError::InvalidFile, m[0]
+        end
+        
+        if result =~ /usage: ffmpeg/
+          raise TranscoderError::InvalidCommand, "must pass a command to ffmpeg"
+        end
+        
+        if result =~ /Output file does not contain.*stream/
+          raise TranscoderError, "Output file does not contain any video or audio streams."
+        end
+        
+        if m = /Unsupported codec.*id=(.*)\).*for input stream\s*(.*)\s*/.match(result) 
+          inspect_original if @original.nil?
+          case m[2]
+          when @original.audio_stream_id
+            codec_type = "audio"
+            codec = @original.audio_codec
+          when @original.video_stream_id
+            codec_type = "video"
+            codec = @original.video_codec
+          else
+            codec_type = "video or audio"
+            codec = "unknown"
+          end
+          
+          raise TranscoderError::InvalidFile, "Unsupported #{codec_type} codec: #{codec} (id=#{m[1]}, stream=#{m[2]})"
+          #raise TranscoderError, "Codec #{m[1]} not supported (in stream #{m[2]})"
+        end
+        
+        # Could not open './spec/../config/../tmp/processed/1/kites-1.avi'
+        if result =~ /Could not open .#{@output_file}.\Z/
+          raise TranscoderError, "Could not write output file to #{@output_file}"
+        end
+          
+        full_details = /Press .* to stop encoding\n(.*)/m.match(result)
+        raise TranscoderError, "Unexpected result details (#{result})" if full_details.nil?
+        details = full_details[1].strip.gsub(/\s*\n\s*/," - ")
+        
+        if details =~ /Could not write header/
+          raise TranscoderError, details
+        end
+        
+        #frame=  584 q=6.0 Lsize=     708kB time=19.5 bitrate= 297.8kbits/s    
+        #video:49kB audio:153kB global headers:0kB muxing overhead 250.444444%
+        
+        #frame= 4126 q=31.0 Lsize=    5917kB time=69.1 bitrate= 702.0kbits/s    
+        #video:2417kB audio:540kB global headers:0kB muxing overhead 100.140277%
+        
+        #frame=  273 fps= 31 q=10.0 Lsize=     398kB time=5.9 bitrate= 551.8kbits/s
+        #video:284kB audio:92kB global headers:0kB muxing overhead 5.723981%
+        
+        #mdb:94, lastbuf:0 skipping granule 0
+        #size=    1080kB time=69.1 bitrate= 128.0kbits /s    
+        #video:0kB audio:1080kB global headers:0kB muxing overhead 0.002893%
+        
+        #size=      80kB time=5.1 bitrate= 128.0kbits/s    ^Msize=     162kB time=10.3 bitrate= 128.0kbits/s    ^Msize=     241kB time=15.4 bitrate= 128.0kbits/s    ^Msize=     329kB time=21.1 bitrate= 128.0kbits/s    ^Msize=     413kB time=26.4 bitrate= 128.0kbits/s    ^Msize=     506kB time=32.4 bitrate= 128.0kbits/s    ^Msize=     591kB time=37.8 bitrate= 128.0kbits/s    ^Msize=     674kB time=43.2 bitrate= 128.0kbits/s    ^Msize=     771kB time=49.4 bitrate= 128.0kbits/s    ^Msize=     851kB time=54.5 bitrate= 128.0kbits/s    ^Msize=     932kB time=59.6 bitrate= 128.0kbits/s    ^Msize=    1015kB time=64.9 bitrate= 128.0kbits/s    ^Msize=    1094kB time=70.0 bitrate= 128.0kbits/s    ^Msize=    1175kB time=75.2 bitrate= 128.0kbits/s    ^Msize=    1244kB time=79.6 bitrate= 128.0kbits/s    ^Msize=    1335kB time=85.4 bitrate= 128.0kbits/s    ^Msize=    1417kB time=90.7 bitrate= 128.0kbits/s    ^Msize=    1508kB time=96.5 bitrate= 128.0kbits/s    ^Msize=    1589kB time=101.7 bitrate= 128.0kbits/s    ^Msize=    1671kB time=106.9 bitrate= 128.0kbits/s    ^Msize=    1711kB time=109.5 bitrate= 128.0kbits/s - video:0kB audio:1711kB global headers:0kB muxing overhead 0.001826%
+        
+        #mdb:14, lastbuf:0 skipping granule 0 - overread, skip -5 enddists: -2 -2 - overread, skip -5 enddists: -2 -2 - size=      90kB time=5.7 bitrate= 128.0kbits/s    \nsize=     189kB time=12.1 bitrate= 128.0kbits/s
+        
+        #size=      59kB time=20.2 bitrate=  24.0kbits/s    \nsize=     139kB time=47.4 bitrate=  24.0kbits/s    \nsize=     224kB time=76.5 bitrate=  24.0kbits/s    \nsize=     304kB time=103.7 bitrate=  24.0kbits/s    \nsi
+        
+        #mdb:14, lastbuf:0 skipping granule 0 - overread, skip -5 enddists: -2 -2 - overread, skip -5 enddists: -2 -2 - size=      81kB time=10.3 bitrate=  64.0kbits/s    \nsize=     153kB time=19.6 bitrate=  64.0kbits/s 
+        
+        #size=      65kB time=4.1 bitrate= 128.1kbits/s    \nsize=     119kB time=7.6 bitrate= 128.0kbits/s    \nsize=     188kB time=12.0 bitrate= 128.0kbits/s    \nsize=     268kB time=17.1 bitrate= 128.0kbits/s    \nsize=
+        
+        #Error while decoding stream #0.1     [mpeg4aac @ 0xb7d089f0]faac: frame decoding failed: Gain control not yet implementedError while decoding stream #0.1frame= 2143 fps= 83 q=4.0 size=    4476kB time=71.3 bitrate= 514.5kbits/s    ^M[mpeg4aac @ 0xb7d089f0]faac: frame decoding failed: Gain control not yet implementedError while decoding stream #0.1
+        
+        # NOTE: had to remove "\s" from "\s.*L.*size=" from this regexp below.
+        # Not sure why. Unit tests were succeeding, but hand tests weren't.
+        if details =~ /video:/ 
+          #success = /^frame=\s*(\S*)\s*q=(\S*).*L.*size=\s*(\S*)\s*time=\s*(\S*)\s*bitrate=\s*(\S*)\s*/m.match(details)
+          @frame = sanitary_match(/frame=\s*(\S*)/, details)
+          @output_fps = sanitary_match(/fps=\s*(\S*)/, details)
+          @q = sanitary_match(/\s+q=\s*(\S*)/, details)
+          @size = sanitary_match(/size=\s*(\S*)/, details)
+          @time = sanitary_match(/time=\s*(\S*)/, details)
+          @output_bitrate = sanitary_match(/bitrate=\s*(\S*)/, details)
+          
+          @video_size = /video:\s*(\S*)/.match(details)[1]
+          @audio_size = /audio:\s*(\S*)/.match(details)[1]
+          @header_size = /headers:\s*(\S*)/.match(details)[1]
+          @overhead = /overhead[:]*\s*(\S*)/.match(details)[1]
+          psnr_match = /PSNR=(.*)\s*size=/.match(details)
+          @psnr = psnr_match[1].strip if psnr_match
+          return true
+        end
+        
+        #[mp3 @ 0x54340c]flv doesnt support that sample rate, choose from (44100, 22050, 11025)
+        #Could not write header for output file #0 (incorrect codec parameters ?)
+        
+        raise TranscoderError::UnexpectedResult, details
+      end
+
+      def sanitary_match(regexp, string)
+        match = regexp.match(string)
+        return match[1] if match
+      end
+      
+    end
+  end
+end