Changeset 387

Timestamp:

01/08/2008 01:39:59 (8 months ago)

Author:

why

Message:

• shoes/ruby.c: added length, time, time=, position and position= methods for seeking within videos.
  
• samples/video.rb: added a link for seeking the video.
  
• lib/shoes/help.rb: added docs for all the video methods.
  

Location:

trunk

Files:

• lib/shoes/help.rb (modified) (1 diff)
• samples/video.rb (modified) (1 diff)
• shoes/ruby.c (modified) (3 diffs)

trunk/lib/shoes/help.rb

@@ -507 +507 @@
 The horizontal screen size of the image in pixels.
 
+== Video ==
+
+Shoes supports embedding of QuickTime, Flash video (FLV), DivX, Xvid and various other popular video formats.  This is all thanks to VideoLAN and ffmpeg, two sensational open source libraries.  Use the `video` method on a slot to setup a Shoes::Video object.
+
+In addition to video formats, some audio formats are also supported, such as MP3, WAV and Ogg Vorbis.
+
+Video support is optional in Shoes and some builds do not support video.  For example, video support is unavailable for PowerPC.  When you download Shoes, the build for your platform will be marked `novideo` in the filename if no video support is available.
+
+=== hide() » self ===
+
+Hides the video.  If already playing, the video will continue to play.  This just turns off display of the video.  One possible use of this method is to collapse the video area when it is playing an audio file, such as an MP3.
+
+=== length() » a number ===
+
+The full length of the video in milliseconds.  Returns nil if the video is not yet loaded.
+
+=== move(x, y) » self ===
+
+Moves the video to specific coordinates, the (x, y) being the upper left hand corner of the video.
+
+=== pause() » self ===
+
+Pauses the video, if it is playing.
+
+=== playing?() » true of false ===
+
+Returns true if the video is currently playing.  Or, false if the video is paused or stopped.
+
+=== play() » self ===
+
+Starts playing the video, if it isn't already playing.  If already playing, the video is restarted from the beginning.
+
+=== position() » a decimal ===
+
+The position of the video as a decimanl number (a Float) between the beginning (0.0) and the end (1.0).  For instance, a Float value of 0.5 indicates the halfway point of the video.
+
+=== position = a decimal ===
+
+Sets the position of the video using a Float value.  To move the video to its 25% position: `@video.position = 0.25`.
+
+=== remove() » self ===
+
+Removes the video from its slot.  This will stop the video as well.
+
+=== show() » self ===
+
+Reveals the video, if it has been hidden by the `hide()` method.
+
+=== stop() » self ===
+
+Stops the video, if it is playing.
+
+=== time() » a number ===
+
+The time position of the video in milliseconds.  So, if the video is 10 seconds into play, this method would return the number 10000.
+
+=== time = a number ===
+
+Set the position of the video to a time in milliseconds.
+
+=== toggle() » self ===
+
+Toggles the visibility of the video.  If the video can be seen, then `hide` is called.  Otherwise, `show` is called.
+
 END

trunk/samples/video.rb

@@ -1 @@
-Shoes.app do
-  stack do
+Shoes.app :width => 408, :height => 334, :resizable => false do
+  background "#eee"
+  stack :margin => 4 do
     @vid = video "http://whytheluckystiff.net/o..e/adventure_time.flv"
-    para "controls: ",
-      link("play")  { @vid.play }, ", ",
-      link("pause") { @vid.pause }, ", ",
-      link("stop")  { @vid.stop }, ", ",
-      link("hide")  { @vid.hide }, ", ",
-      link("show")  { @vid.show }
   end
+  para "controls: ",
+    link("play")  { @vid.play }, ", ",
+    link("pause") { @vid.pause }, ", ",
+    link("stop")  { @vid.stop }, ", ",
+    link("hide")  { @vid.hide }, ", ",
+    link("show")  { @vid.show }, ", ",
+    link("+5 sec") { @vid.time += 5000 }
 end

trunk/shoes/ruby.c

@@ -1079 +1079 @@
   }
 
+#define VIDEO_GET_METHOD(x, ctype, rbtype) \
+  VALUE shoes_video_get_##x(VALUE self) \
+  { \
+    shoes_video *self_t; \
+    Data_Get_Struct(self, shoes_video, self_t); \
+    if (self_t->init == 1) \
+    { \
+      libvlc_input_t *input = libvlc_playlist_get_input(self_t->vlc, NULL); \
+      if (input != NULL) { \
+        ctype len = libvlc_input_get_##x(input, &self_t->excp); \
+        shoes_vlc_exception(&self_t->excp); \
+        return rbtype(len); \
+      } \
+    } \
+    return Qnil; \
+  }
+
+#define VIDEO_SET_METHOD(x, rbconv) \
+  VALUE shoes_video_set_##x(VALUE self, VALUE val) \
+  { \
+    shoes_video *self_t; \
+    Data_Get_Struct(self, shoes_video, self_t); \
+    if (self_t->init == 1) \
+    { \
+      libvlc_input_t *input = libvlc_playlist_get_input(self_t->vlc, NULL); \
+      if (input != NULL) { \
+        libvlc_input_set_##x(input, rbconv(val), &self_t->excp); \
+        shoes_vlc_exception(&self_t->excp); \
+      } \
+    } \
+    return val; \
+  }
+
 VIDEO_METHOD(clear);
 VIDEO_METHOD(prev);
@@ -1084 +1117 @@
 VIDEO_METHOD(pause);
 VIDEO_METHOD(stop);
+VIDEO_GET_METHOD(length, vlc_int64_t, INT2NUM);
+VIDEO_GET_METHOD(time, vlc_int64_t, INT2NUM);
+VIDEO_SET_METHOD(time, NUM2INT);
+VIDEO_GET_METHOD(position, float, rb_float_new);
+VIDEO_SET_METHOD(position, NUM2DBL);
 #endif
 
@@ -3572 +3610 @@
   rb_define_method(cVideo, "pause", CASTHOOK(shoes_video_pause), 0);
   rb_define_method(cVideo, "stop", CASTHOOK(shoes_video_stop), 0);
+  rb_define_method(cVideo, "length", CASTHOOK(shoes_video_get_length), 0);
+  rb_define_method(cVideo, "position", CASTHOOK(shoes_video_get_position), 0);
+  rb_define_method(cVideo, "position=", CASTHOOK(shoes_video_set_position), 1);
+  rb_define_method(cVideo, "time", CASTHOOK(shoes_video_get_time), 0);
+  rb_define_method(cVideo, "time=", CASTHOOK(shoes_video_set_time), 1);
 #endif