rtranscoder 0.1.2 → 0.1.3

data/History.txt

@@ -1,3 +1,10 @@
+== 0.1.3 / 2008-12-29
+
+* MPlayer sub-options must use a ',' as their separator.
+* Added MPEG4IP support.
+  * Currently supports mp4creator.
+  * Added documentation for mp4creator options.
+
 == 0.1.2 / 2008-01-29
 
 * Replaces 'run_with_task' method calls with 'run_task', as that is the

data/Manifest.txt

@@ -2,8 +2,6 @@ History.txt
 Manifest.txt
 README.txt
 Rakefile
-examples/encode_flv.rb
-examples/thumbnail.rb
 lib/rtranscoder.rb
 lib/rtranscoder/version.rb
 lib/rtranscoder/extensions.rb
@@ -19,4 +17,7 @@ lib/rtranscoder/mplayer/mplayer.rb
 lib/rtranscoder/mplayer/mplayer_task.rb
 lib/rtranscoder/mplayer/mencoder.rb
 lib/rtranscoder/mplayer/mencoder_task.rb
-test/test_rtranscoder.rb
+lib/rtranscoder/mpeg4ip/mp4creator.rb
+lib/rtranscoder/mpeg4ip/mp4creator_task.rb
+lib/rtranscoder/mpeg4ip.rb
+lib/rtranscoder/rtranscoder.rb

data/README.txt

@@ -1,6 +1,7 @@
-RTranscoder
-    by Hal Brodigan
-    http://rubyforge.org/projects/rtranscoder/
+= RTranscoder
+
+* http://rtranscoder.rubyforge.org/
+* Postmodern (postmodern.mod3 at gmail.com)
 
 == DESCRIPTION:
   
@@ -20,7 +21,7 @@ to Ruby classes and methods for your convenience.
 
 == REQUIREMENTS:
 
-* RProgram
+* RProgram >= 0.1.3
 
 == INSTALL:
 

data/Rakefile

@@ -6,12 +6,8 @@ require './lib/rtranscoder/version.rb'
 
 Hoe.new('rtranscoder', RTranscoder::VERSION) do |p|
   p.rubyforge_name = 'rtranscoder'
-  p.author = 'Hal Brodigan'
-  p.email = 'postmodern.mod3@gmail.com'
-  p.summary = 'A Rubyful interface to various transcoding utilities using the RProgram library.'
-  p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
-  p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
-  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+  p.developer('Postmodern', 'postmodern.mod3@gmail.com')
+  p.remote_rdoc_dir = ''
   p.extra_deps = [['rprogram', '>=0.1.3']]
 end
 

data/lib/rtranscoder.rb

@@ -1,3 +1,5 @@
 require 'rtranscoder/version'
 require 'rtranscoder/ffmpeg'
 require 'rtranscoder/mplayer'
+require 'rtranscoder/mpeg4ip'
+require 'rtranscoder/rtranscoder'

data/lib/rtranscoder/ffmpeg/ffmpeg_task.rb

@@ -2,7 +2,7 @@ require 'rprogram/task'
 
 module RTranscoder
   #
-  # ==FFmpeg options:
+  # == FFmpeg options:
   #
   # <tt>-refs</tt>:: <tt>ffmpeg.ref_frames_for_motion_compensation</tt>
   # <tt>-subcmp</tt>:: <tt>ffmpeg.sub_full_pel_motion_estimation_compare</tt>
@@ -193,6 +193,7 @@ module RTranscoder
   # <tt>-v</tt>:: <tt>ffmpeg.verbose</tt>
   # <tt>-frame_size</tt>:: <tt>ffmpeg.audio_frame_size</tt>
   # <tt>-vstats</tt>:: <tt>ffmpeg.dump_video_coding_statistics</tt>
+  # <tt>OUTPUT</tt>:: <tt>ffmpeg.output</tt>
   #
   class FFmpegTask < RProgram::Task
 

data/lib/rtranscoder/mpeg4ip.rb

@@ -0,0 +1 @@
+require 'rtranscoder/mpeg4ip/mp4creator'

data/lib/rtranscoder/mpeg4ip/mp4creator.rb

@@ -0,0 +1,91 @@
+require 'rtranscoder/mpeg4ip/mp4creator_task'
+require 'rtranscoder/extensions'
+
+require 'rprogram/program'
+
+module RTranscoder
+  module MPEG4IP
+    class MP4Creator < RProgram::Program
+
+      name_program :mp4creator
+
+      #
+      # Creates a new MP4Creator object with the specified _path_ of the
+      # +mp4creator+ program.
+      #
+      def initialize(path)
+        super(path)
+      end
+
+      #
+      # See MP4Creator#create.
+      #
+      def self.create(options={},&block)
+        self.find.create(options,&block)
+      end
+
+      #
+      # See MP4Creator#mux.
+      #
+      def self.mux(options={})
+        self.find.mux(options)
+      end
+
+      #
+      # Runs the +mp4creator+ program with the given _options_ and the given
+      # _block_ using MP4CreatorTask.
+      #
+      def create(options={},&block)
+        run_task(MP4CreatorTask.new(options,&block))
+      end
+
+      #
+      # Muxes audio and video streams together with the specified _options_.
+      #
+      # _options_ must contain the following keys:
+      # <tt>:audio</tt>:: The audio file to add.
+      # <tt>:video</tt>:: The video file to add.
+      # <tt>:frame_rate</tt>:: The frame rate of the video stream.
+      # <tt>:output</tt>:: The output file.
+      #
+      # _options_ may contain the following key:
+      # <tt>:hint</tt>:: Specifies wether to add hints for QuickTime plugins
+      #                  to the output file.
+      #
+      def mux(options={})
+        if File.file?(options[:output])
+          File.delete(options[:output])
+        end
+
+        create do |mp4creator|
+          mp4creator.create = options[:audio]
+          mp4creator.file = options[:output]
+        end
+
+        create do |mp4creator|
+          mp4creator.create = options[:video]
+          mp4creator.rate = options[:frame_rate].to_f
+          mp4creator.file = options[:output]
+        end
+
+        if options[:hint]
+          create do |mp4creator|
+            mp4creator.hint = 1
+            mp4creator.file = options[:output]
+          end
+
+          create do |mp4creator|
+            mp4creator.hint = 2
+            mp4creator.file = options[:output]
+          end
+
+          create do |mp4creator|
+            mp4creator.optimize = true
+            mp4creator.file = options[:output]
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/rtranscoder/mpeg4ip/mp4creator_task.rb

@@ -0,0 +1,47 @@
+require 'rprogram/task'
+
+module RTranscoder
+  module MPEG4IP
+    #
+    # == MP4Creator Options:
+    #
+    # <tt>-aac-old-file-format</tt>:: <tt>mp4creator.aac_old_file_format</tt>.
+    # <tt>-aac-profile</tt>:: <tt>mp4creator.aac_profile</tt>
+    # <tt>-create</tt>:: <tt>mp4creator.create</tt>
+    # <tt>-extract</tt>:: <tt>mp4creator.extract</tt>
+    # <tt>-delete</tt>:: <tt>mp4creator.delete</tt>
+    # <tt>-hint</tt>:: <tt>mp4creator.hint</tt>
+    # <tt>-interleave</tt>:: <tt>mp4creator.interleave</tt>
+    # <tt>-list</tt>:: <tt>mp4creator.list</tt>
+    # <tt>-mut</tt>:: <tt>mp4creator.mut</tt>
+    # <tt>-mpeg4-video-profile</tt>:: <tt>mp4creator.mpeg4_video_profile</tt>
+    # <tt>-optimize</tt>:: <tt>mp4creator.optimize</tt>
+    # <tt>-rate</tt>:: <tt>mp4creator.rate</tt>
+    # <tt>-use64bitstime</tt>:: <tt>mp4creator.use_64bit_timestamps</tt>
+    # <tt>-verbosity</tt>:: <tt>mp4creator.verbosity</tt>
+    # <tt>-help</tt>:: <tt>mp4creator.help</tt>
+    # <tt>FILE</tt>:: <tt>mp4creator.file</tt>
+    #
+    class MP4CreatorTask < RProgram::Task
+
+      long_option :flag => '-aac-old-file-format'
+      long_option :flag => '-aac-profile', :equals => true
+      long_option :flag => '-create', :equals => true
+      long_option :flag => '-extract', :equals => true
+      long_option :flag => '-delete', :equals => true
+      long_option :flag => '-hint', :equals => true
+      long_option :flag => '-interleave'
+      long_option :flag => '-list'
+      long_option :flag => '-mut', :equals => true
+      long_option :flag => '-mpeg4-video-profile', :equals => true
+      long_option :flag => '-optimize'
+      long_option :flag => '-rate', :equals => true
+      long_option :flag => '-use64bitstime', :name => :use_64bit_timestamps
+      long_option :flag => '-verbosity', :equals => true
+      long_option :flag => '-help'
+
+      non_option :tailing => true, :name => :file
+
+    end
+  end
+end

data/lib/rtranscoder/mplayer/mencoder_task.rb

@@ -37,6 +37,7 @@ module RTranscoder
   # <tt>-x264encopts</tt>:: <tt>mencoder.x264enc</tt>
   # <tt>-vobsuboutid</tt>:: <tt>mencoder.vob_output_subtitle_language</tt>
   # <tt>-noautoexpand</tt>:: <tt>mencoder.disable_auto_expand</tt>
+  # <tt>INPUT</tt>:: <tt>mencoder.input</tt>
   #
   class MEncoderTask < MPlayerCommonTask
 
@@ -84,8 +85,6 @@ module RTranscoder
     codec_options :lavf
 
     non_option :tailing => true, :name => :input
-    non_option :tailing => true, :name => :output_file
-    non_option :tailing => true, :name => :smb_output
 
   end
 end

data/lib/rtranscoder/mplayer/mplayer_common_task.rb

@@ -2,7 +2,7 @@ require 'rprogram/task'
 
 module RTranscoder
   #
-  # MPlayer Common options:
+  # == MPlayer Common options:
   #
   # <tt>-lavdopts</tt>:: <tt>mplayer.libavcodec</tt>
   # <tt>-field-dominance</tt>:: <tt>mplayer.field_dominance</tt>
@@ -108,12 +108,13 @@ module RTranscoder
   # <tt>-fps</tt>:: <tt>mplayer.fps</tt>
   # <tt>-priority</tt>:: <tt>mplayer.priority</tt>
   # <tt>-use-filedir-conf</tt>:: <tt>mplayer.use_filedir_conf</tt>
+  #
   class MPlayerCommonTask < RProgram::Task
 
     protected
 
     def self.sub_options(opts={})
-      long_option :flag => opts[:flag], :name => opts[:name], :separator => ':', :sub_options => true
+      long_option :flag => opts[:flag], :name => opts[:name], :separator => ',', :sub_options => true
     end
 
     def self.priority_list(opts={})

data/lib/rtranscoder/mplayer/mplayer_task.rb

@@ -2,7 +2,7 @@ require 'rtranscoder/mplayer/mplayer_common_task'
 
 module RTranscoder
   #
-  # ==MPlayer options:
+  # == MPlayer options:
   #
   # <tt>-screenw</tt>:: <tt>mplayer.horizontal_resolution</tt>
   # <tt>-dr</tt>:: <tt>mplayer.enable_direct_rendering</tt>
@@ -100,6 +100,7 @@ module RTranscoder
   # <tt>-fstype</tt>:: <tt>mplayer.fs_type</tt>
   # <tt>-idle</tt>:: <tt>mplayer.idle</tt>
   # <tt>-softsleep</tt>:: <tt>mplayer.soft_sleep</tt>
+  # <tt>{file|URL|playlist}</tt>:: <tt>mplayer.media</tt>
   #
   class MPlayerTask < MPlayerCommonTask
 

data/lib/rtranscoder/rtranscoder.rb

@@ -0,0 +1,11 @@
+require 'rprogram/rprogram'
+
+module RTranscoder
+  def RTranscoder.debug
+    RProgram.debug
+  end
+
+  def RTranscoder.debug=(value)
+    RProgram.debug = value
+  end
+end

data/lib/rtranscoder/version.rb

@@ -1,3 +1,3 @@
 module RTranscoder
-  VERSION = '0.1.2'
+  VERSION = '0.1.3'
 end

metadata

@@ -1,40 +1,53 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.4
-specification_version: 1
 name: rtranscoder
 version: !ruby/object:Gem::Version 
-  version: 0.1.2
-date: 2008-01-29 00:00:00 -08:00
-summary: A Rubyful interface to various transcoding utilities using the RProgram library.
-require_paths: 
-- lib
-email: postmodern.mod3@gmail.com
-homepage: "    by Hal Brodigan"
-rubyforge_project: rtranscoder
-description: "No more must one have to provide a shell command in order to run ffmpeg or mencoder for one's transcoding needs. RTranscoder and RProgram have mapped all the command-line options of various transcoding utilities to Ruby classes and methods for your convenience.  == FEATURES/PROBLEMS:  * Supports FFmpeg. * Supports MPlayer. * Supports MEncoder.  == REQUIREMENTS:  * RProgram"
-autorequire: 
-default_executable: 
-bindir: bin
-has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
+  version: 0.1.3
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
 authors: 
-- Hal Brodigan
+- Postmodern
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-12-29 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rprogram
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.1.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.2
+    version: 
+description: A Rubyful interface to various transcoding utilities using the RProgram library.  No more must one have to provide a shell command in order to run ffmpeg or mencoder for one's transcoding needs. RTranscoder and RProgram have mapped all the command-line options of various transcoding utilities to Ruby classes and methods for your convenience.
+email: 
+- postmodern.mod3@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
 files: 
 - History.txt
 - Manifest.txt
 - README.txt
 - Rakefile
-- examples/encode_flv.rb
-- examples/thumbnail.rb
 - lib/rtranscoder.rb
 - lib/rtranscoder/version.rb
 - lib/rtranscoder/extensions.rb
@@ -50,38 +63,36 @@ files:
 - lib/rtranscoder/mplayer/mplayer_task.rb
 - lib/rtranscoder/mplayer/mencoder.rb
 - lib/rtranscoder/mplayer/mencoder_task.rb
-- test/test_rtranscoder.rb
-test_files: 
-- test/test_rtranscoder.rb
+- lib/rtranscoder/mpeg4ip/mp4creator.rb
+- lib/rtranscoder/mpeg4ip/mp4creator_task.rb
+- lib/rtranscoder/mpeg4ip.rb
+- lib/rtranscoder/rtranscoder.rb
+has_rdoc: true
+homepage: http://rtranscoder.rubyforge.org/
+post_install_message: 
 rdoc_options: 
 - --main
 - README.txt
-extra_rdoc_files: 
-- History.txt
-- Manifest.txt
-- README.txt
-executables: []
-
-extensions: []
-
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
 requirements: []
 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: rprogram
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 0.1.3
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: hoe
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Version::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.4.0
-    version: 
+rubyforge_project: rtranscoder
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: A Rubyful interface to various transcoding utilities using the RProgram library
+test_files: []
+

data/examples/encode_flv.rb

@@ -1,20 +0,0 @@
-require 'rtranscoder/ffmpeg'
-
-include RTranscoder
-
-#
-# Encode an video to FLV.
-#
-FFmpeg.encode do |ffmpeg|
-  ffmpeg.input = 'video.avi'
-  ffmpeg.audio_sampling_rate = 22.050.kHz
-  ffmpeg.audio_bitrate = 32 # kbit/s
-  ffmpeg.video_frame_size = '320x240'
-  ffmpeg.output_format = :flv
-  ffmpeg.output = 'video.flv'
-end
-
-#
-# Equivalent to:
-#   $ ffmpeg -i video.avi -ar 22050 -ab 32 -f flv -s 320x240 video.flv
-#

data/examples/thumbnail.rb

@@ -1,33 +0,0 @@
-require 'rtranscoder/ffmpeg'
-
-include RTranscoder
-
-#
-# Extract frames starting at 00:00:03 for 00:00:01.
-#
-FFmpeg.encode do |ffmpeg|
-  ffmpeg.input = 'video.flv'
-  ffmpeg.disable_audio = true
-  ffmpeg.record_start_time = '00:00:03'
-  ffmpeg.record_for = '00:00:01'
-  ffmpeg.fps = 1
-  ffmpeg.overwrite_output_files = true
-  ffmpeg.video_frame_size = '320x240'
-  ffmpeg.output = 'video_thumbnail_%d.jpg'
-end
-
-#
-# Or even simplier...
-#
-RTranscoder.thumbnail(:video => 'video.flv',
-                      :start => '00:00:03',
-                      :length => '00:00:01',
-                      :width => 320,
-                      :height => 240,
-                      :image => 'video_thumbnail_%d.jpg')
-
-#
-# Both equivalent to:
-#   $ ffmpeg -i video.flv -an -ss 00:00:03 -t 00:00:01 -r 1 -y \
-#     -s 320x240 video_thumbnail_%d.jpg
-#