readme_3dyuv.txt

3d_spiht

// = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =

//      THREEE DIMENSIONAL SPIHT COMPRESSION FOR COLOR IMAGE SEQUENCES
//            
// = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
//
// Copyright (c) 1995, 1996, 1997 by  Beong-Jo Kim, William A. Pearlman,
// and Amir Said.

// These programs are protected by Copyright (c) and patents.
// They may not be redistributed without the consent of the copyright
// holders. In no circumstances may the copyright notice be removed.
// The programs may not be sold for profit nor may they be incorporated
// in commercial programs without the written permission of the copyright
// and patent holders. These programs are provided as is, without any express or
// implied warranty, without even the warranty of fitness for a
// particular purpose.

// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Note: 	The routines (algorithms) may have bugs, despite our best efforts 
	to remove as many as possible. Also, the programs have 
	never been optimized to minimize computational time.
//-----------------------------------------------------------------------------------
	

The programs included in this package run at the DOS command line. 
These programs encode/decode raw format YCbCr or YUV video sequences in 16 
frame units using 3D SPIHT.  The input and output are single files of concatenated 
raw YUV frames

Use *420 for CIF or QCIF and *422 for CCIR601.  

Running the command without arguments gives the syntax.   
Some parameters require explanation.

height - no. of lines in Y (288 for CIF)
width - no. pixels/line in Y (352 for CIF)
GOP - number of full 16-frame units in sequence
bitrate = (no. of compressed file bits for 16 frames)/(height*width*16) (bits per pixel).

Examples: 

Encode CIF sequence, akiyo.cif, of 198 frames, at rate of 0.5 bpp.

> encode420 akiyo.cif akiyo.cmp 288 352 12 0.5

192 out of the 198 frames will be encoded, with each 16-frame unit compressed
to a file size of 101376 bytes.  The bit rate in bits per second 
is 101376*8*30/16 = 1,520,640. (Original bit rate is 352*288*1.5*8*30 = 36,495,360 bps.)

The compressed file can be decoded to any rate <= 0.5 bpp.  
To decompress akiyo.cmp to 0.1 bpp or 304128 bps:

> decode420 akiyo.cmp akiyo_010.cif 0.1

The output file akiyo_010.cif contains the reconstructed sequence of 192 frames.