MPEG-FAQ 4.0:

MPEG Video Software Analyzer

                  MPEG Video Software Analyzer
                  (Version 1.0; May 81995)

 Lawrence A. Rowe, Doug Banks, Steve Smoot, and Sam Tze-San Fung 
 Computer Science Division-EECS, Univ. of Calif. at Berkeley

This directory contains a public domain tool to monitor and modify 
MPEG video streams.  mpeg_bits takes as input an mpeg stream and
presents graphical feedback on the distribution of bits in the
stream, on a macroblock-by-macroblock level.  mpeg_bits also provides
a simple user interface to generate specifics files that can be
used by mpeg_encode to re-encode a stream, modifying the encoding 
on a macroblock-by-macroblock level.  [The present version of mpeg_encode
does not support this..]

This tool does not support system layer streams.

mpeg_bits supports the standard described in the Committee 
Draft ISO/IEC CD 11172 dated December 6, 1991 which is
sometimes refered to as "Paris Format." The code has been
compiled and tested at least once on the following platforms:
	
 HP PA-RISC (HP/UX 9.X, X11R5) (i.e., HP 9000/7XX and 9000/3XX)
 Sun Sparc (SunOS 4.X, X11R5)

If you decide to port the code to a new architecture, please let
us know about important changes, so that we can incorporate the changes
into our sources. 

This directory contains everything required to build and use
mpeg_bits.  We have included source code, a makefile, installation
instructions, and a man page.  

See the INSTALL file for instructions on how to
compile and run the analyzer.

Our future plans consist of more fully supporting an interactive
editor paradigm; specifying changes directly on the display, 
seeing the results of edits on the video stream immediately
as they occur, etc.  We would also like to port the code to
run on more platforms, and add support for system layer streams.
Vendors or other organizations interested in supporting 
this research or discussing other aspects of this project should 
contact Larry Rowe at Rowe@CS.Berkeley.EDU.


Reporting bugs:
    If you find any bugs in this software, please send them to
    mpeg-bugs@plateau.cs.berkeley.edu.  Since this software

    is unsupported, we make no guarantees about how long it will
    take to fix the bug, or if it will be fixed at all.  Bug fixes
    will be cheerfully accepted.  Please include as much detailed
    information as possible, including:

	1) the version number of the program you are using (cf. VERSION)
	2) the data file that caused the bug (if possible)
	3) the OS version and machine type you ran the program on
	4) the compiler used to compile the program

ACKNOWLEDGEMENTS:
	We gratefully thank Hewlett-Packard, Fujitsu, the Semiconductor
	Research Corporation for financial support.

	We also want to thank the following people for their help:

	Tom Lane of the Independent JPEG Group provided us with
		the basic inverse DCT code used by our player.
		(tom_lane@g.gp.cs.cmu.edu)


	Reid Judd of Sun Microsystems provided advice and assistance.

	Todd Brunhoff of NVR provided advice and assistance.

	Toshihiko Kawai of Sony provided advice and assistance.

-- 
Eugene Hung                             eyhung@garnet.berkeley.edu