Avi2Movie 1.00


				 18.12.2000

			   (c) by R.Rawer '99-'01




===============================================================================
 (1) Contents
===============================================================================

 (1) Contents
 (2) About Avi2Movie
 (3) Syntax of Avi2Movie
 (4) Possible Code Modifications
 (5) History of Changes
 (6) Contact the Autor




===============================================================================
 (2) About Avi2Movie
===============================================================================


Avi2Movie is a simple m-file to read the images of uncompressed AVIs into 
MatLab and store them as a MatLab Movie-Dataset. 

Avi2Movie is based on AviRead.

(*1*) 	the section where the bytestream read from the AVI-file is transformed
	into a matrix
(*2*) 	the section where you can add you own code to do caculations based on
	the picture data

Both sections are marked in the source code.




===============================================================================
 (3) Syntax of Avi2Movie
===============================================================================

Syntax:

 Result = Avi2Movie(filename, 
                     number of frames to process, 
                     first frame to display, 
                     last frame to display)

 Result : selected frames stored as one MatLab Movie-Dataset

 Example: Avi2Movie('sample.avi',30,10,12)
            reads and processes the first 30 frames of the file 
            'sample.avi', and saves frame 10, 11 and 12 as one
            MatLab Movie-Dataset.       




===============================================================================
 (4) Possible Code Modifications
===============================================================================

AviRead justs reads the image data of AVI-files. In order to process this
image data you probably need to modify the the code in section (*2*).
If anothe arrangement of the pixelinformation is needed also modify 
section (*1*) ind AviRead.m.

Use the folowing variables within your image processing routines:
  
   no_of_frames:   number of frames to be read
   time_per_frame: time to display each frame [ms] (reverse of frames 
  		   per 0.001 second)
   frames:	   number of this frame
   columns:	   number of pixels per line
   lines:	   number of lines per image
   bytes:	   number of bytes per pixel
   im:		   image data: 
  	 	     8bit/pixel:  uint8-Matrix[columns,lines]
  		     16bit/pixel: uint16-Matrix[columns,lines]
  		     24bit/pixel: uint8-Matrix[columns,lines,3] 
  			          (3 Color Planes R,G,B)
  		     32bit/pixel: uint32-Matrix[columns,lines]
   xx:		   raw image data:
  		     8bit/pixel:  uint8-Matrix[columns*lines] 
  				  (1-dimentional)
  		     16bit/pixel: uint16-Matrix[columns*lines]
  				  (1-dimentional)
  		     24bit/pixel: uint8-Matrix[3,columns*lines] 
  				  (1-dimentional, 3 Color Planes R,G,B)
  		     32bit/pixel: uint32-Matrix[columns*lines]					  
  				  (1-dimentional)  
  



===============================================================================
 (5) History of Changes
===============================================================================

V1.00 (22/12/2000):
-------------------
 
Generated Avi2Movie from AviRead V1.13




===============================================================================
 (6) Contact the Author
===============================================================================

rrawer@gmx.de

http://www.rawer.de/rainer/software/



===============================================================================