home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Multimed / Multimed.zip / mpegplay.zip / INSTALL < prev    next >
Text File  |  1993-02-02  |  4KB  |  106 lines
  1. These are the instructions for compiling mpeg_play, the software MPEG
  2. decoder and player.
  3.  
  4. 1) Untar the file mpeg_play.tar.Z. This is best done by creating a new
  5. directory for the files involved, moving the tar file into this directory
  6. and invoking the command:
  7.  
  8.     zcat mpeg_play-2.0.tar.Z | tar xvf -
  9.  
  10. 2) Create and customize the Makefile. Do this by copying the file
  11. Makefile.proto to Makefile. Then edit Makefile for your particular needs.
  12.  
  13. In the makefile the CFLAGS definition is multiply defined for a couple of
  14. different machines, uncomment the one you want to use, or define your own
  15. if necessary. 
  16.  
  17. The INCLUDEDIR variable should be set to include the paths leading to the
  18. standard header files such as stdio.h as well as to X11/Xlib.h  (on most
  19. systems, this is /usr/include).  To do this set the INCLUDEDIR variable to
  20. -I followed by the pathname. For example, if the path is /usr/local/include,
  21. edit the Makefile to look like this:
  22.  
  23.     INCLUDEDIR       = -I/usr/local/include
  24.  
  25. If more than one pathname is necessary, simply prepend -I to each path.
  26. For example if you needed to include /usr/local/include and /usr/X11/include,
  27. the variable definition would look like:
  28.  
  29.     INCLUDEDIR       = -I/usr/local/include -I/usr/X11/include
  30.  
  31. Finally, make sure the LIBS variable is set to the path and name of your X11
  32. library. For example:
  33.  
  34.     LIBS             = /usr/lib/X11/libX11.a
  35.  
  36. 3) Type make all.
  37.  
  38. 4) To remove .o files, type make clean
  39.  
  40. 5) Add yourself to the mailing list by sending mail to
  41.    mpeg-list-request@roger-rabbit.cs.berkeley.edu with the subject line
  42.    "ADD" (you can delete yourself by sending the subject line "DEL").
  43.    If you are a uunet user, you can use the mail path
  44.    'uunet!ucbvax!roger-rabbit.cs!mpeg-list-request'
  45.  
  46.     mail mpeg-list-request@roger-rabbit.cs.berkeley.edu
  47.     Subject: ADD
  48.     ^D
  49.  
  50. 6) Try it out! You can ftp some sample data files from the same site
  51.    you got this player from. Data files usually end in .mpg or .mpeg
  52.    The command line for the player is described in the man page, but
  53.    is basically:
  54.  
  55.    mpeg_play [options] [file_name] 
  56.  
  57. 7) If you want the player to collect statistics on size of frames, 
  58.    macroblocks, time to decode, etc., add the following to the 
  59.    definition of CFLAGS in the Makefile:
  60.     -DANALYSIS
  61.    Remove all .o files with "make clean" and remake with "make all"
  62.    The player will now print summarized statistics at the end of the
  63.    video clip and can be made to print frame by frame statistics with
  64.    the use of the -eachstat flag. Read man page for more info.
  65. ------------------------------------------------------------------------
  66.  
  67. Using Imake
  68.  
  69. We have included an Imakefile for use with Imake. Since we do not use
  70. Imake ourselves and the file was provided by someone else, we can not
  71. give any specific instructions on how to use it. Please, consult
  72. someone more experienced with Imake. 
  73. Thanks.
  74.  
  75. ------------------------------------------------------------------------
  76. NOTES
  77.  
  78. It seems that much of the time is spent converting the 24 bit MPEG image
  79. to an 8 bit color space. This process is called "dithering".  We've included
  80. several dithering algorithms.  Read the man pages for more instructions.
  81.  
  82. The data files available are produced by XING. These images are
  83. usually small (~160X120). XING data does not take advantage
  84. of P or B frames (ie, frames with motion compensation). The data is simply
  85. a series of I frames.  Performance of the player on XING data is
  86. significantly lower (half or less) of the performance when motion compensated
  87. MPEG data is decoded. 
  88.  
  89. Reporting bugs:
  90.     If you find any bugs in this software, please send them to
  91.     mpeg-bugs@roger-rabbit.cs.berkeley.edu.  Since this software
  92.     is unsupported, we make no guarantees about how long it will
  93.     take to fix the bug, or if it will be fixed at all.  Bug fixes
  94.     will be cheerfully accepted.  Please include as much detailed
  95.     information as possible, including:
  96.  
  97.     1) the version number of the program you are using (cf. VERSION)
  98.     2) the data file that caused the bug (if possible)
  99.     3) the OS version and machine type you ran the program on
  100.     4) the compiler used to compile the program
  101.  
  102.  
  103.  
  104.  
  105.  
  106.