Index: video.h
===================================================================
--- video.h	(revision 538)
+++ video.h	(revision 539)
@@ -10,23 +10,29 @@
 
 // Introduction
 /**
-Raydium supports simple video playback, thru a special video codec (JPGS),
-useful for menus enhancements, "speaking" thumbnails, ...
-This codec only supports video, use sound API if needed.
+Raydium supports simple video playback, using a simple dedicated video 
+codec (JPGS), useful for menus enhancements, "speaking" thumbnails, ...
+This codec now supports audio syncing with OGG files.
 You will find an small utility, ##mk_jpgs## in Raydium source tree, didacted to
 movie creation.
+The Raydium official source tree also provides a small JPGS player,
+named ##jpgs_play.c##. You can compile it like any other Raydium application.
 **/
 
-// How to create a movie ?
+// How to create a JPGS movie ?
 /**
 First, compile ##mk_jpgs##: example: ##gcc mk_jpgs.c -o mk_jpgs## or any other
 standard build command.
-Then, generate JPEG pictures (using a temporary directory, if possible):
+Then, generate JPEG pictures (using a temporary directory, if possible), with
+something like mplayer, for example:
 ##mplayer movie.avi -vo jpeg:quality=50 -vf scale=256:256##, where you may
 change quality factor and output size. Use "hardware friendly" sizes (64,
 128,256,...) !
 You can now build JPGS file:
 ##./mk_jpgs 25 256 256 video.jpgs## (fps, size x, size y, output file)
+If you wan to extract the audio, use this:
+##mplayer -vc nul -vo null -ao pcm:file=audio.dump movie.avi##
+##oggenc audio.dump##
 **/
 
 __rayapi void raydium_video_init(void);
@@ -61,13 +67,27 @@
 /**
 This function will open and prepare video ##filename##, and will attach
 this video to a "live texture" (see Live API chapter, if needed).
+The playback starts automatically.
+You can then display the video with OSD functions like, for
+example, ##raydium_live_texture_mask_name()## or using it within meshes.
 **/
 
+__rayapi int raydium_video_open_with_sound(char *filename, char *as, char *ogg);
+/**
+Same as above, but it will also play the ##ogg## file, synced with the
+video stream.
+**/
+
 __rayapi void raydium_video_callback_video(int id);
 /**
 Internal use.
 **/
 
+__rayapi float raydium_video_sound_callback(void);
+/**
+Internal use. Callback for sound.c BufferData function.
+**/
+
 __rayapi void raydium_video_callback(void);
 /**
 Internal use. Frame callback.
@@ -107,5 +127,4 @@
 Same as above, using video name.
 **/
 
-
 #endif