SDL_YUVplayer Files

/*
 *  Copyright 2010 University of Nantes, IRCCyN lab.
 *
 *  All Rights Reserved.
 *
 *  Florent Autrusseau.
 *  start : 08/10/2010.
 *  end   : ...
 *
 *  Questions and comments to:
 *       <mailto:florent.autrusseau@univ-nantes.fr>
 *       <http://www.irccyn.ec-nantes.fr/~autrusse/>
 */

This cource code (in C) uses the SDL library to display a YUV video.
So far, the player only displays 4:4:4, 4:2:2 and 4:2:0 planar YUV formats.

More details are given here:
http://www.irccyn.ec-nantes.fr/~autrusse/Code/ReadmeYUVplayer.html

Compilation: 
************

You may need to install:
 - SDL (http://www.libsdl.org/)
 - SDL_Image (http://www.libsdl.org/projects/SDL_image/)
 - Python (http://www.python.org/download/)
 - wxPython (http://www.wxpython.org/download.php#stable)

On Unix-like systems, a "make" should work.

On MS Windows OS, please refer to the explanations here: 
http://www.irccyn.ec-nantes.fr/~autrusse/Code/ReadmeYUVplayer.html


Running the player:
*******************

Here's how to launch the program:

Graphical User Interface:
.........................

Run the PySdlYUVplayer.py file with Python.


Command line :
..............

Unix:
./SDL_YUVplayer_bns foreman_qcif.yuv 144 176 4:2:0

MS Windows:
SDL_YUVplayer_bns.exe foreman_qcif.yuv 144 176 4:2:0

1st argument is the yuv file name.
2nd argument is the frames height.
3rd argument is the frames width.
4th argument is the sampling format

This opens a black window, then, press the "PLAY" icon to start playing (or Hit RETURN for the version without buttons : "SDL_YUVplayer.exe").

You can either use the icons, or the keyboard input:

Keyboard options:
-----------------
Once the video is playing, you can:
- Play "Rewind" by pressing the "left" arrow.
- Play "Forward" by pressing the "right" arrow.
- Enter in loop mode by pressing the "l" key.
- "Fast forward" by pressing the "up" arrow ->	Decreases by 10ms the time between 2 consecutive frames.
- "Slow motion" by pressing the "down" arrow -> Increases by 10ms the time between 2 consecutive frames.
- Use "up" and "down" as many times as needed to speed up / slow down the video.
- press "o" anytime to go back to a normal speed (40 ms between frames).
- Pause by pressing the "space bar" (press "Return" to start again playing or "space bar" again to play frame-by-frame)
- Save any Y,U&V frame (each as a PGM image) by pressing "s" while in pause mode (space bar), the saved images will go in the "Images" folder.
- Press "2" to see a zoomed-in video (X2 with & length)
- Press "1" to see the original resolution
- Quit by pressing "escape".

The program can store each frame (Y, U and V components) in the Images folder, you'll have to set "SaveImges" to 1 in SDL_YUVplayer.c
Beware, this may use a lot of space or your hard drive.


NOTE: 
-----

This program only works for 4:4:4, 4:2:2, and 4:2:0 planar YUV files.

It has been tested (and works) on various test sequences from the following links :

4:2:0 :
http://trace.eas.asu.edu/yuv/
ftp://ftp.tnt.uni-hannover.de/pub/svc/testsequences/
ftp://ftp.ldv.e-technik.tu-muenchen.de/pub/test_sequences/

4:4:4 & 4:2:2 :
http://samples.mplayerhq.hu/raw-video/