rmov 0.1.4 → 0.1.5

data/CHANGELOG

@@ -1,9 +1,25 @@
+0.1.5 (July 28, 2009)
+
+* fixing saving export settings - closes #8
+
+* improving how movie selection process happens providing more flexibility - closes #4 and #5
+
+* adding enable_alpha method to enable alpha transparency for compositing - closes #3
+
+* adding track transformations (rotation, scaling, and translation) - closes #1 and #2
+
+* adding movie.save method to save a movie in place
+
+* supporting .pict extension when exporting frame
+
+
 0.1.4 (October 3rd, 2008)
 
 * adding support for several export_image formats (PNG, JPEG, TIFF, TGA, BMP, PSD)
 
 * adding movie.export_image as a generic way to export a frame to multiple formats
 
+
 0.1.3 (October 3rd, 2008)
 
 * some support for text tracks
@@ -12,6 +28,7 @@
 
 * changing Quicktime module name to QuickTime to match proper casing
 
+
 0.1.2 (October 3rd, 2008)
 
 * movie.poster_time and movie.poster_time=(seconds) for getting and setting a movie's poster time
@@ -22,12 +39,14 @@
 
 * QuickTime settings dialog comes into the forground properly
 
+
 0.1.1 (October 3rd, 2008)
 
 * RubyGems 1.3 compatibility (updated Echoe)
 
 * fixing inline RDocs so call sequence is handled properly
 
+
 0.1.0 (October 2nd, 2008)
 
 * initial release

data/Manifest

@@ -13,6 +13,7 @@ LICENSE
 Manifest
 Rakefile
 README.rdoc
+spec/fixtures/dot.png
 spec/fixtures/settings.st
 spec/quicktime/exporter_spec.rb
 spec/quicktime/movie_spec.rb

data/README.rdoc

@@ -17,7 +17,9 @@ And then load it in your project:
 
 == Usage
 
-Use this gem to open QuickTime movies and edit them to your liking.
+There are many methods for editing, compositing, and exporting movies. Here are some examples.
+
+=== Editing
 
   movie1 = QuickTime::Movie.open("path/to/movie.mov")
   movie2 = QuickTime::Movie.open("path/to/another_movie.mov")
@@ -32,12 +34,33 @@ Use this gem to open QuickTime movies and edit them to your liking.
   # You can insert that part back into the movie at 8 seconds in
   movie1.insert_movie(movie3, 8)
 
-Now you can export the movie. Usually this is done through a user 
-interface the first time around. The settings can then be saved to
-a file. After that you can load these settings without interfering
-the user with the dialog again.
+=== Compositing
 
-  exporter = movie1.exporter
+  movie = QuickTime::Movie.open("path/to/movie.mov")
+  watermark_movie = QuickTime::Movie.open("path/to/watermark.png")
+  
+  # add watermark track onto the entire length of the movie
+  movie.composite_movie(watermark_movie, 0, movie.duration)
+  
+  # grab the watermark track
+  watermark = movie.video_tracks.last
+  
+  # enable the alpha transparency of the png
+  watermark.enable_alpha
+  
+  # make the watermark half the size
+  watermark.scale(0.5, 0.5)
+  
+  # offset into lower left corner
+  watermark.translate(10, movie.height - watermark.height - 10)
+
+=== Exporting
+
+Usually exporting is done through a user interface the first time.
+The settings can then be saved to a file. After that you can load
+these settings without interfering the user with the dialog again.
+
+  exporter = movie.exporter
   
   # if we already have saved the settings, load those
   if File.exist? "settings.st"
@@ -56,7 +79,10 @@ the user with the dialog again.
     puts "#{percent}% complete"
   end
 
-See QuickTime::Movie in the RDoc for more information.
+
+== Documentation
+
+See QuickTime::Movie and QuickTime::Track in the RDoc for more information.
 
 http://rmov.rubyforge.org
 

data/Rakefile

@@ -2,7 +2,7 @@ require 'rubygems'
 require 'rake'
 require 'echoe'
 
-Echoe.new('rmov', '0.1.4') do |p|
+Echoe.new('rmov', '0.1.5') do |p|
   p.summary        = "Ruby wrapper for the QuickTime C API."
   p.description    = "Ruby wrapper for the QuickTime C API."
   p.url            = "http://github.com/ryanb/rmov"

data/ext/exporter.c

@@ -93,7 +93,7 @@ static VALUE exporter_open_settings_dialog(VALUE obj)
   // Bring this process to the front
   err = TransformProcessType(&current_process, kProcessTransformToForegroundApplication);
   if (err != noErr) {
-    rb_raise(eQuickTime, "Error %d occurred while brining this application to the forground.", err);
+    rb_raise(eQuickTime, "Error %d occurred while bringing this application to the forground.", err);
   }
   SetFrontProcess(&current_process);
   
@@ -176,7 +176,7 @@ static VALUE exporter_save_settings(VALUE obj, VALUE filepath)
   if (!file) {
     rb_raise(eQuickTime, "Unable to open file for saving at %s.", RSTRING(filepath)->ptr);
   }
-  fwrite(&settings, GetHandleSize((Handle)settings), 1, file);
+  fwrite(*settings, GetHandleSize((Handle)settings), 1, file);
   fclose(file);
   
   return Qnil;

data/ext/movie.c

@@ -64,27 +64,29 @@ static VALUE movie_load_from_file(VALUE obj, VALUE filepath)
   } else {
     OSErr err;
     FSSpec fs;
-    short frefnum = -1;
-    short movie_resid = 0;
+    short resRefNum = -1;
+    short resId = 0;
     Movie *movie = ALLOC(Movie);
     
     err = NativePathNameToFSSpec(RSTRING(filepath)->ptr, &fs, 0);
     if (err != 0)
       rb_raise(eQuickTime, "Error %d occurred while reading file at %s", err, RSTRING(filepath)->ptr);
     
-    err = OpenMovieFile(&fs, &frefnum, fsRdPerm);
+    err = OpenMovieFile(&fs, &resRefNum, fsRdPerm);
     if (err != 0)
       rb_raise(eQuickTime, "Error %d occurred while opening movie at %s", err, RSTRING(filepath)->ptr);
     
-    err = NewMovieFromFile(movie, frefnum, &movie_resid, 0, newMovieActive, 0);
+    err = NewMovieFromFile(movie, resRefNum, &resId, 0, newMovieActive, 0);
     if (err != 0)
       rb_raise(eQuickTime, "Error %d occurred while loading movie at %s", err, RSTRING(filepath)->ptr);
     
-    err = CloseMovieFile(frefnum);
+    err = CloseMovieFile(resRefNum);
     if (err != 0)
       rb_raise(eQuickTime, "Error %d occurred while closing movie file at %s", err, RSTRING(filepath)->ptr);
     
     RMOVIE(obj)->movie = *movie;
+    RMOVIE(obj)->filepath = RSTRING(filepath)->ptr;
+    RMOVIE(obj)->resId = resId;
     
     return obj;
   }
@@ -158,44 +160,32 @@ static VALUE movie_track_count(VALUE obj)
 }
 
 /*
-  call-seq: composite_movie(movie, position)
+  call-seq: select(position, duration)
   
-  Adds the tracks of given movie into called movie at given position (in seconds).
-  
-  You can track the progress of this operation by passing a block to this 
-  method. It will be called regularly during the process and pass the 
-  percentage complete (0.0 to 1.0) as an argument to the block.
+  Select a portion of a movie. Both position and duration should be
+  floats representing seconds.
 */
-static VALUE movie_composite_movie(VALUE obj, VALUE src, VALUE position)
+static VALUE movie_select(VALUE obj, VALUE position, VALUE duration)
 {
-  if (rb_block_given_p())
-    SetMovieProgressProc(MOVIE(obj), (MovieProgressUPP)movie_progress_proc, rb_block_proc());
-  
-  SetMovieSelection(MOVIE(obj), MOVIE_TIME(obj, position), 0);
-  AddMovieSelection(MOVIE(obj), MOVIE(src));
-  
-  if (rb_block_given_p())
-    SetMovieProgressProc(MOVIE(obj), 0, 0);
-  
+  SetMovieSelection(MOVIE(obj), MOVIE_TIME(obj, position), MOVIE_TIME(obj, duration));
   return obj;
 }
 
 /*
-  call-seq: append_movie(movie, position)
+  call-seq: add_into_selection(movie)
+  
+  Adds the tracks of given movie into called movie's current selection.
   
-  Inserts given movie into called movie at given position (in seconds).
-
   You can track the progress of this operation by passing a block to this 
   method. It will be called regularly during the process and pass the 
   percentage complete (0.0 to 1.0) as an argument to the block.
 */
-static VALUE movie_insert_movie(VALUE obj, VALUE src, VALUE position)
+static VALUE movie_add_into_selection(VALUE obj, VALUE src)
 {
   if (rb_block_given_p())
     SetMovieProgressProc(MOVIE(obj), (MovieProgressUPP)movie_progress_proc, rb_block_proc());
   
-  SetMovieSelection(MOVIE(obj), MOVIE_TIME(obj, position), 0);
-  PasteMovieSelection(MOVIE(obj), MOVIE(src));
+  AddMovieSelection(MOVIE(obj), MOVIE(src));
   
   if (rb_block_given_p())
     SetMovieProgressProc(MOVIE(obj), 0, 0);
@@ -204,20 +194,19 @@ static VALUE movie_insert_movie(VALUE obj, VALUE src, VALUE position)
 }
 
 /*
-  call-seq: append_movie(movie)
+  call-seq: insert_into_selection(movie)
+  
+  Inserts the given movie into called movie, replacing any current selection.
   
-  Adds given movie to the end of movie which this method is called on.
-
   You can track the progress of this operation by passing a block to this 
   method. It will be called regularly during the process and pass the 
   percentage complete (0.0 to 1.0) as an argument to the block.
 */
-static VALUE movie_append_movie(VALUE obj, VALUE src)
+static VALUE movie_insert_into_selection(VALUE obj, VALUE src)
 {
   if (rb_block_given_p())
     SetMovieProgressProc(MOVIE(obj), (MovieProgressUPP)movie_progress_proc, rb_block_proc());
   
-  SetMovieSelection(MOVIE(obj), GetMovieDuration(MOVIE(obj)), 0);
   PasteMovieSelection(MOVIE(obj), MOVIE(src));
   
   if (rb_block_given_p())
@@ -227,37 +216,22 @@ static VALUE movie_append_movie(VALUE obj, VALUE src)
 }
 
 /*
-  call-seq: delete_section(start_time, duration)
+  call-seq: clone_selection()
   
-  Deletes given section from movie. Both start_time and duration 
-  should be floats representing seconds.
-*/
-static VALUE movie_delete_section(VALUE obj, VALUE start, VALUE duration)
-{
-  SetMovieSelection(MOVIE(obj), MOVIE_TIME(obj, start), MOVIE_TIME(obj, duration));
-  ClearMovieSelection(MOVIE(obj));
-  return obj;
-}
-
-/*
-  call-seq: clone_section(start_time, duration) -> movie
+  Returns a new movie from the current selection. Does not modify original 
+  movie. 
   
-  Returns a new movie in the given section. Does not modify original 
-  movie. Both start_time and duration should be floats representing 
-  seconds.
-
   You can track the progress of this operation by passing a block to this 
   method. It will be called regularly during the process and pass the 
   percentage complete (0.0 to 1.0) as an argument to the block.
 */
-static VALUE movie_clone_section(VALUE obj, VALUE start, VALUE duration)
+static VALUE movie_clone_selection(VALUE obj)
 {
   VALUE new_movie_obj = rb_obj_alloc(cMovie);
   
   if (rb_block_given_p())
     SetMovieProgressProc(MOVIE(obj), (MovieProgressUPP)movie_progress_proc, rb_block_proc());
   
-  SetMovieSelection(MOVIE(obj), MOVIE_TIME(obj, start), MOVIE_TIME(obj, duration));
   RMOVIE(new_movie_obj)->movie = CopyMovieSelection(MOVIE(obj));
   
   if (rb_block_given_p())
@@ -267,24 +241,22 @@ static VALUE movie_clone_section(VALUE obj, VALUE start, VALUE duration)
 }
 
 /*
-  call-seq: clip_section(start_time, duration) -> movie
+  call-seq: clip_selection()
+  
+  Deletes current selection on movie and returns a new movie with that 
+  content.
   
-  Deletes given section on movie and returns a new movie with that 
-  section. Both start_time and duration should be floats representing 
-  seconds.
-
   You can track the progress of this operation by passing a block to this 
   method. It will be called regularly during the process and pass the 
   percentage complete (0.0 to 1.0) as an argument to the block.
 */
-static VALUE movie_clip_section(VALUE obj, VALUE start, VALUE duration)
+static VALUE movie_clip_selection(VALUE obj)
 {
   VALUE new_movie_obj = rb_obj_alloc(cMovie);
   
   if (rb_block_given_p())
     SetMovieProgressProc(MOVIE(obj), (MovieProgressUPP)movie_progress_proc, rb_block_proc());
   
-  SetMovieSelection(MOVIE(obj), MOVIE_TIME(obj, start), MOVIE_TIME(obj, duration));
   RMOVIE(new_movie_obj)->movie = CutMovieSelection(MOVIE(obj));
   
   if (rb_block_given_p())
@@ -293,6 +265,17 @@ static VALUE movie_clip_section(VALUE obj, VALUE start, VALUE duration)
   return new_movie_obj;
 }
 
+/*
+  call-seq: delete_selection()
+  
+  Removes the portion of the movie which is selected.
+*/
+static VALUE movie_delete_selection(VALUE obj)
+{
+  ClearMovieSelection(MOVIE(obj));
+  return obj;
+}
+
 /*
   call-seq: changed?() -> bool
   
@@ -345,6 +328,41 @@ static VALUE movie_flatten(VALUE obj, VALUE filepath)
   return new_movie_obj;
 }
 
+
+/*
+  call-seq: save()
+  
+  Saves the movie to the current file.
+*/
+static VALUE movie_save(VALUE obj)
+{
+  OSErr err;
+  FSSpec fs;
+  short resRefNum = -1;
+  
+  if (!RMOVIE(obj)->filepath || !RMOVIE(obj)->resId) {
+    rb_raise(eQuickTime, "Unable to save movie because it does not have an associated file.");
+  } else {
+    err = NativePathNameToFSSpec(RMOVIE(obj)->filepath, &fs, 0);
+    if (err != 0)
+      rb_raise(eQuickTime, "Error %d occurred while reading file at %s", err, RMOVIE(obj)->filepath);
+    
+    err = OpenMovieFile(&fs, &resRefNum, fsWrPerm);
+    if (err != 0)
+      rb_raise(eQuickTime, "Error %d occurred while opening movie at %s", err, RMOVIE(obj)->filepath);
+    
+    err = UpdateMovieResource(MOVIE(obj), resRefNum, RMOVIE(obj)->resId, 0);
+    if (err != 0)
+      rb_raise(eQuickTime, "Error %d occurred while saving movie file", err);
+    
+    err = CloseMovieFile(resRefNum);
+    if (err != 0)
+      rb_raise(eQuickTime, "Error %d occurred while closing movie file at %s", err, RMOVIE(obj)->filepath);
+    
+    return Qnil;
+  }
+}
+
 /*
   call-seq: export_image_type(filepath, time, ostype)
   
@@ -440,12 +458,12 @@ void Init_quicktime_movie()
   rb_define_method(cMovie, "time_scale", movie_time_scale, 0);
   rb_define_method(cMovie, "bounds", movie_bounds, 0);
   rb_define_method(cMovie, "track_count", movie_track_count, 0);
-  rb_define_method(cMovie, "composite_movie", movie_composite_movie, 2);
-  rb_define_method(cMovie, "insert_movie", movie_insert_movie, 2);
-  rb_define_method(cMovie, "append_movie", movie_append_movie, 1);
-  rb_define_method(cMovie, "delete_section", movie_delete_section, 2);
-  rb_define_method(cMovie, "clone_section", movie_clone_section, 2);
-  rb_define_method(cMovie, "clip_section", movie_clip_section, 2);
+  rb_define_method(cMovie, "select", movie_select, 2);
+  rb_define_method(cMovie, "add_into_selection", movie_add_into_selection, 1);
+  rb_define_method(cMovie, "insert_into_selection", movie_insert_into_selection, 1);
+  rb_define_method(cMovie, "clone_selection", movie_clone_selection, 0);
+  rb_define_method(cMovie, "clip_selection", movie_clip_selection, 0);
+  rb_define_method(cMovie, "delete_selection", movie_delete_selection, 0);
   rb_define_method(cMovie, "changed?", movie_changed, 0);
   rb_define_method(cMovie, "clear_changed_status", movie_clear_changed_status, 0);
   rb_define_method(cMovie, "flatten", movie_flatten, 1);
@@ -454,4 +472,5 @@ void Init_quicktime_movie()
   rb_define_method(cMovie, "poster_time", movie_get_poster_time, 0);
   rb_define_method(cMovie, "poster_time=", movie_set_poster_time, 1);
   rb_define_method(cMovie, "new_track", movie_new_track, 2);
+  rb_define_method(cMovie, "save", movie_save, 0);
 }

data/ext/rmov_ext.h

@@ -17,6 +17,8 @@ OSErr movie_progress_proc(Movie movie, short message, short operation, Fixed per
 
 struct RMovie {
   Movie movie;
+  short resId;
+  char *filepath;
 };
 
 

data/ext/track.c

@@ -191,7 +191,7 @@ static VALUE track_set_offset(VALUE obj, VALUE seconds)
 }
 
 /*
-  call-seq: new_video_media
+  call-seq: new_video_media()
   
   Creates a new video media for this track.
   
@@ -205,7 +205,7 @@ static VALUE track_new_video_media(VALUE obj)
 }
 
 /*
-  call-seq: new_audio_media
+  call-seq: new_audio_media()
   
   Creates a new audio media for this track.
   
@@ -219,7 +219,7 @@ static VALUE track_new_audio_media(VALUE obj)
 }
 
 /*
-  call-seq: new_text_media
+  call-seq: new_text_media()
   
   Creates a new text media for this track.
   
@@ -232,6 +232,101 @@ static VALUE track_new_text_media(VALUE obj)
   return obj;
 }
 
+/*
+  call-seq: enable_alpha()
+  
+  Enable the straight alpha graphic mode for this track.
+  
+  This is best used on an overlayed video track which includes some
+  alpha transparency (such as in a PNG image).
+*/
+static VALUE track_enable_alpha(VALUE obj)
+{
+  MediaSetGraphicsMode(GetMediaHandler(TRACK_MEDIA(obj)), graphicsModeStraightAlpha, 0);
+  return obj;
+}
+
+/*
+  call-seq: scale(width, height)
+  
+  Scale the track's size by width and height respectively.
+  
+  The value passed is a relative float where "1" is the current size.
+*/
+static VALUE track_scale(VALUE obj, VALUE width, VALUE height)
+{
+  MatrixRecord matrix;
+  GetTrackMatrix(TRACK(obj), &matrix);
+  ScaleMatrix(&matrix, FloatToFixed(NUM2DBL(width)), FloatToFixed(NUM2DBL(height)), 0, 0);
+  SetTrackMatrix(TRACK(obj), &matrix);
+  return obj;
+}
+
+/*
+  call-seq: translate(x, y)
+  
+  Offset a track's position by x and y values respectively.
+  
+  Values should be in pixels.
+*/
+static VALUE track_translate(VALUE obj, VALUE x, VALUE y)
+{
+  MatrixRecord matrix;
+  GetTrackMatrix(TRACK(obj), &matrix);
+  TranslateMatrix(&matrix, FloatToFixed(NUM2DBL(x)), FloatToFixed(NUM2DBL(y)));
+  SetTrackMatrix(TRACK(obj), &matrix);
+  return obj;
+}
+
+/*
+  call-seq: rotate(degrees)
+  
+  Rotate the track by the given number of degrees.
+*/
+static VALUE track_rotate(VALUE obj, VALUE degrees)
+{
+  MatrixRecord matrix;
+  GetTrackMatrix(TRACK(obj), &matrix);
+  RotateMatrix(&matrix, FloatToFixed(NUM2DBL(degrees)), 0, 0);
+  SetTrackMatrix(TRACK(obj), &matrix);
+  return obj;
+}
+
+/*
+  call-seq: bounds() -> bounds_hash
+  
+  Returns a hash of boundaries. The hash contains four keys: :left, :top, 
+  :right, :bottom. Each holds an integer representing the pixel value.
+*/
+static VALUE track_bounds(VALUE obj)
+{
+  VALUE bounds_hash = rb_hash_new();
+  RgnHandle region;
+  Rect bounds;
+  region = GetTrackDisplayBoundsRgn(TRACK(obj));
+  GetRegionBounds(region, &bounds);
+  DisposeRgn(region);
+  rb_hash_aset(bounds_hash, ID2SYM(rb_intern("left")), INT2NUM(bounds.left));
+  rb_hash_aset(bounds_hash, ID2SYM(rb_intern("top")), INT2NUM(bounds.top));
+  rb_hash_aset(bounds_hash, ID2SYM(rb_intern("right")), INT2NUM(bounds.right));
+  rb_hash_aset(bounds_hash, ID2SYM(rb_intern("bottom")), INT2NUM(bounds.bottom));
+  return bounds_hash;
+}
+
+/*
+  call-seq: reset_transformations()
+  
+  Revert any transformations (scale, translate, rotate) performed on this track.
+*/
+static VALUE track_reset_transformations(VALUE obj)
+{
+  MatrixRecord matrix;
+  GetTrackMatrix(TRACK(obj), &matrix);
+  SetIdentityMatrix(&matrix);
+  SetTrackMatrix(TRACK(obj), &matrix);
+  return obj;
+}
+
 void Init_quicktime_track()
 {
   VALUE mQuickTime;
@@ -255,4 +350,10 @@ void Init_quicktime_track()
   rb_define_method(cTrack, "new_video_media", track_new_video_media, 0);
   rb_define_method(cTrack, "new_audio_media", track_new_audio_media, 0);
   rb_define_method(cTrack, "new_text_media", track_new_text_media, 0);
+  rb_define_method(cTrack, "enable_alpha", track_enable_alpha, 0);
+  rb_define_method(cTrack, "scale", track_scale, 2);
+  rb_define_method(cTrack, "translate", track_translate, 2);
+  rb_define_method(cTrack, "rotate", track_rotate, 1);
+  rb_define_method(cTrack, "bounds", track_bounds, 0);
+  rb_define_method(cTrack, "reset_transformations", track_reset_transformations, 0);
 }

data/lib/quicktime/movie.rb

@@ -87,10 +87,10 @@ module QuickTime
     def export_image(filepath, seconds)
       # TODO support more file types
       type = case File.extname(filepath).downcase
-        when '.pct'          then 'PICT'
-        when '.png'          then 'PNGf'
+        when '.pct', '.pict' then 'PICT'
         when '.tif', '.tiff' then 'TIFF'
         when '.jpg', '.jpeg' then 'JPEG'
+        when '.png'          then 'PNGf'
         when '.tga'          then 'TPIC'
         when '.bmp'          then 'BMPf'
         when '.psd'          then '8BPS'
@@ -98,5 +98,77 @@ module QuickTime
       end
       export_image_type(filepath, seconds, type)
     end
+    
+    # Reset selection to beginning
+    def deselect
+      select(0, 0)
+    end
+    
+    # Adds the tracks of given movie into called movie. Position will default to
+    # beginning of movie. Duration will default to length of given movie.
+    # 
+    # You can track the progress of this operation by passing a block to this 
+    # method. It will be called regularly during the process and pass the 
+    # percentage complete (0.0 to 1.0) as an argument to the block.
+    def composite_movie(movie, position = 0, duration = 0, &block)
+      select(position, duration)
+      add_into_selection(movie, &block)
+      deselect
+    end
+    
+    # Adds given movie to the end of movie which this method is called on.
+    # 
+    # You can track the progress of this operation by passing a block to this 
+    # method. It will be called regularly during the process and pass the 
+    # percentage complete (0.0 to 1.0) as an argument to the block.
+    def append_movie(movie, &block)
+      select(duration, 0)
+      insert_into_selection(movie, &block)
+      deselect
+    end
+    
+    # Inserts given movie into called movie. The position defaults to the beginning
+    # of the movie. If a duration is passed, that amount of the movie will be replaced.
+    # 
+    # You can track the progress of this operation by passing a block to this 
+    # method. It will be called regularly during the process and pass the 
+    # percentage complete (0.0 to 1.0) as an argument to the block.
+    def insert_movie(movie, position = 0, duration = 0, &block)
+      select(position, duration)
+      insert_into_selection(movie, &block)
+      deselect
+    end
+    
+    # Returns a new movie from the specified portion of called movie.
+    # 
+    # You can track the progress of this operation by passing a block to this 
+    # method. It will be called regularly during the process and pass the 
+    # percentage complete (0.0 to 1.0) as an argument to the block.
+    def clone_section(position = 0, duration = 0, &block)
+      select(position, duration)
+      movie = clone_selection(&block)
+      deselect
+      movie
+    end
+    
+    # Deletes the specified section on movie and returns a new movie
+    # with that content.
+    # 
+    # You can track the progress of this operation by passing a block to this 
+    # method. It will be called regularly during the process and pass the 
+    # percentage complete (0.0 to 1.0) as an argument to the block.
+    def clip_section(position = 0, duration = 0, &block)
+      select(position, duration)
+      movie = clip_selection(&block)
+      deselect
+      movie
+    end
+    
+    # Deletes the specified section on movie.
+    def delete_section(position = 0, duration = 0)
+      select(position, duration)
+      delete_selection
+      deselect
+    end
   end
 end

data/lib/quicktime/track.rb

@@ -26,5 +26,15 @@ module QuickTime
     def text?
       media_type == :text
     end
+    
+    # Returns the bounding width of this track in number of pixels.
+    def width
+      bounds[:right] - bounds[:left]
+    end
+    
+    # Returns the bounding height of this track in number of pixels.
+    def height
+      bounds[:bottom] - bounds[:top]
+    end
   end
 end

data/rmov.gemspec

@@ -1,99 +1,31 @@
+# -*- encoding: utf-8 -*-
 
-# Gem::Specification for Rmov-0.1.4
-# Originally generated by Echoe
+Gem::Specification.new do |s|
+  s.name = %q{rmov}
+  s.version = "0.1.5"
 
---- !ruby/object:Gem::Specification 
-name: rmov
-version: !ruby/object:Gem::Version 
-  version: 0.1.4
-platform: ruby
-authors: 
-- Ryan Bates
-autorequire: 
-bindir: bin
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ryan Bates"]
+  s.date = %q{2009-07-28}
+  s.description = %q{Ruby wrapper for the QuickTime C API.}
+  s.email = %q{ryan (at) railscasts (dot) com}
+  s.extensions = ["ext/extconf.rb"]
+  s.extra_rdoc_files = ["CHANGELOG", "ext/exporter.c", "ext/extconf.rb", "ext/movie.c", "ext/rmov_ext.c", "ext/rmov_ext.h", "ext/track.c", "lib/quicktime/exporter.rb", "lib/quicktime/movie.rb", "lib/quicktime/track.rb", "lib/rmov.rb", "LICENSE", "README.rdoc", "tasks/setup.rake", "tasks/spec.rake", "TODO"]
+  s.files = ["CHANGELOG", "ext/exporter.c", "ext/extconf.rb", "ext/movie.c", "ext/rmov_ext.c", "ext/rmov_ext.h", "ext/track.c", "lib/quicktime/exporter.rb", "lib/quicktime/movie.rb", "lib/quicktime/track.rb", "lib/rmov.rb", "LICENSE", "Manifest", "Rakefile", "README.rdoc", "spec/fixtures/dot.png", "spec/fixtures/settings.st", "spec/quicktime/exporter_spec.rb", "spec/quicktime/movie_spec.rb", "spec/quicktime/track_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "tasks/setup.rake", "tasks/spec.rake", "TODO", "rmov.gemspec"]
+  s.homepage = %q{http://github.com/ryanb/rmov}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Rmov", "--main", "README.rdoc"]
+  s.require_paths = ["lib", "ext"]
+  s.rubyforge_project = %q{rmov}
+  s.rubygems_version = %q{1.3.3}
+  s.summary = %q{Ruby wrapper for the QuickTime C API.}
 
-date: 2008-10-03 00:00:00 -07:00
-default_executable: 
-dependencies: []
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
 
-description: Ruby wrapper for the QuickTime C API.
-email: ryan (at) railscasts (dot) com
-executables: []
-
-extensions: 
-- ext/extconf.rb
-extra_rdoc_files: 
-- CHANGELOG
-- ext/exporter.c
-- ext/extconf.rb
-- ext/movie.c
-- ext/rmov_ext.c
-- ext/rmov_ext.h
-- ext/track.c
-- lib/quicktime/exporter.rb
-- lib/quicktime/movie.rb
-- lib/quicktime/track.rb
-- lib/rmov.rb
-- LICENSE
-- README.rdoc
-- tasks/setup.rake
-- tasks/spec.rake
-- TODO
-files: 
-- CHANGELOG
-- ext/exporter.c
-- ext/extconf.rb
-- ext/movie.c
-- ext/rmov_ext.c
-- ext/rmov_ext.h
-- ext/track.c
-- lib/quicktime/exporter.rb
-- lib/quicktime/movie.rb
-- lib/quicktime/track.rb
-- lib/rmov.rb
-- LICENSE
-- Manifest
-- Rakefile
-- README.rdoc
-- spec/fixtures/settings.st
-- spec/quicktime/exporter_spec.rb
-- spec/quicktime/movie_spec.rb
-- spec/quicktime/track_spec.rb
-- spec/spec.opts
-- spec/spec_helper.rb
-- tasks/setup.rake
-- tasks/spec.rake
-- TODO
-- rmov.gemspec
-has_rdoc: true
-homepage: http://github.com/ryanb/rmov
-post_install_message: 
-rdoc_options: 
-- --line-numbers
-- --inline-source
-- --title
-- Rmov
-- --main
-- README.rdoc
-require_paths: 
-- lib
-- ext
-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: "1.2"
-  version: 
-requirements: []
-
-rubyforge_project: rmov
-rubygems_version: 1.2.0
-specification_version: 2
-summary: Ruby wrapper for the QuickTime C API.
-test_files: []
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/spec/quicktime/exporter_spec.rb

@@ -26,4 +26,22 @@ describe QuickTime::Exporter do
       lambda { @exporter.save_settings('foo/bar/baz') }.should raise_error(QuickTime::Error)
     end
   end
+  describe "example.mov" do
+    before(:each) do
+      @movie = QuickTime::Movie.open(File.dirname(__FILE__) + '/../fixtures/example.mov')
+      @exporter = @movie.exporter
+    end
+    
+    it "should be able to export from loaded settings.st" do
+      load_path = File.dirname(__FILE__) + '/../fixtures/settings.st'
+      path = File.dirname(__FILE__) + '/../output/loaded_exported_example.mov'
+      File.delete(path) rescue nil
+      
+      @exporter.load_settings(load_path)
+      @exporter.export(path)
+      exported_movie = QuickTime::Movie.open(path)
+      exported_movie.duration.should == @movie.duration
+      exported_movie.tracks.size == @movie.tracks.size
+    end
+  end
 end

data/spec/quicktime/movie_spec.rb

@@ -111,12 +111,28 @@ describe QuickTime::Movie do
     
     it "flatten should save movie into file" do
       path = File.dirname(__FILE__) + '/../output/flattened_example.mov'
-      File.delete(path) rescue nil
+      File.delete(path) if File.exist?(path)
       @movie.flatten(path)
       mov = QuickTime::Movie.open(path)
       mov.duration.should == 3.1
     end
     
+    it "save should update movie in current file" do
+      path = File.dirname(__FILE__) + '/../output/saved_example.mov'
+      File.delete(path) if File.exist?(path)
+      @movie.flatten(path)
+      mov = QuickTime::Movie.open(path)
+      mov.audio_tracks.each { |t| t.delete } # delete track to demonstrate change
+      mov.save
+      mov2 = QuickTime::Movie.open(path)
+      mov2.audio_tracks.should be_empty
+    end
+    
+    it "save should raise exception when saving new movie without filepath" do
+      mov = QuickTime::Movie.empty
+      lambda { mov.save }.should raise_error
+    end
+    
     it "export_pict should output a pict file at a given duration" do
       path = File.dirname(__FILE__) + '/../output/example.pct'
       File.delete(path) rescue nil
@@ -137,6 +153,15 @@ describe QuickTime::Movie do
       @movie.poster_time = 2.1
       @movie.poster_time.should == 2.1
     end
+    
+    it "should overlay 2nd movie with transparency" do
+      m2 = QuickTime::Movie.open(File.dirname(__FILE__) + '/../fixtures/dot.png')
+      @movie.composite_movie(m2, 0)
+      @movie.video_tracks.last.enable_alpha
+      File.delete(File.dirname(__FILE__) + '/../output/transparent.mov') rescue nil
+      @movie.flatten(File.dirname(__FILE__) + '/../output/transparent.mov')
+      # this test needs to be checked manually by looking at the output movie
+    end
   end
   
   describe "empty movie" do

data/spec/quicktime/track_spec.rb

@@ -6,7 +6,7 @@ describe QuickTime::Track do
       @movie = QuickTime::Movie.open(File.dirname(__FILE__) + '/../fixtures/example.mov')
     end
   
-    describe "example.mov video track" do
+    describe "video track" do
       before(:each) do
         @track = @movie.video_tracks.first
       end
@@ -49,9 +49,37 @@ describe QuickTime::Track do
         @track.offset = 2.5
         @track.offset.should == 2.5
       end
+    
+      it "should be able to scale size of track" do
+        @track.scale(0.5, 0.5)
+        @track.width.should == 30
+        @track.height.should == 25
+      end
+    
+      it "should be able to move (translate) position of track" do
+        @track.translate(10, 20)
+        @track.bounds[:left].should == 10
+        @track.bounds[:top].should == 20
+      end
+    
+      it "should reset transformations" do
+        @track.scale(0.5, 0.5)
+        @track.translate(10, 20)
+        @track.reset_transformations
+        @track.bounds[:left].should == 0
+        @track.bounds[:top].should == 0
+        @track.bounds[:right].should == 60
+        @track.bounds[:bottom].should == 50
+      end
+    
+      it "should rotate track" do
+        @track.rotate(90)
+        @track.width.should == 50
+        @track.height.should == 60
+      end
     end
-  
-    describe "example.mov audio track" do
+    
+    describe "audio track" do
       before(:each) do
         @track = @movie.audio_tracks.first
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rmov
 version: !ruby/object:Gem::Version 
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors: 
 - Ryan Bates
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-10-03 00:00:00 -07:00
+date: 2009-07-28 00:00:00 -07:00
 default_executable: 
 dependencies: []
 
@@ -52,6 +52,7 @@ files:
 - Manifest
 - Rakefile
 - README.rdoc
+- spec/fixtures/dot.png
 - spec/fixtures/settings.st
 - spec/quicktime/exporter_spec.rb
 - spec/quicktime/movie_spec.rb
@@ -64,6 +65,8 @@ files:
 - rmov.gemspec
 has_rdoc: true
 homepage: http://github.com/ryanb/rmov
+licenses: []
+
 post_install_message: 
 rdoc_options: 
 - --line-numbers
@@ -90,9 +93,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: rmov
-rubygems_version: 1.2.0
+rubygems_version: 1.3.3
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: Ruby wrapper for the QuickTime C API.
 test_files: []