home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 9 / CD_ASCQ_09_1193.iso / news / 4441 / mpegcode / readme < prev    next >
Text File  |  1993-01-01  |  5KB  |  99 lines
  1.  
  2.                  MPEG-1 Video Software Encoder
  3.                  (Version 1.1; August 9, 1993)
  4.  
  5.      Lawrence A. Rowe, Kevin Gong, Ketan Patel, and Dan Wallach
  6.     Computer Science Division-EECS, Univ. of Calif. at Berkeley
  7.  
  8. This directory contains the freely distributed Berkeley MPEG-1 Video 
  9. Encoder.  The encoder implements the standard described in the ISO/IEC
  10. International Standard 11172-2.  The code has been compiled and tested 
  11. on the following platforms:
  12.  
  13.  HP PA-RISC (HP/UX 8.X, X11R4) (i.e., HP 9000/7XX and 9000/3XX)
  14.  Sun Sparc (SunOS 4.X, X11R5)
  15.  DECstation 5000 and Alpha
  16.  
  17. If you decide to port the code to a new architecture, please let
  18. us know so that we can incorporate the changes into our sources.
  19.  
  20. This directory contains everything required to build the encoder
  21. and run it.  We have included source code, makefiles, binaries
  22. for selected platforms, documentation, and test data.  Installation 
  23. instructions are given in the file named src/INSTALL.  A man 
  24. page is given in the file doc/mpeg_encode.1. 
  25.  
  26. The encoder will accept any input file format as long as you provide 
  27. a script to convert the images to PPM or YUV format.  Input file
  28. processing is described in the file doc/INPUT.FORMAT.  Options to control 
  29. input file processing and compression parameters are specified in 
  30. a parameter file.  Very little error processing is done when reading 
  31. this file.  We suggest you start with the sample parameter file 
  32. examples/template.param and modify it.  See also examples/default.param.
  33.  
  34. We have also provided a Tcl/Tk script, named encode.tcl, that can 
  35. be used to set parameters interactively (see the misc/ directory).
  36. The misc/ directory contains utility you might find useful including:
  37. programs to do PPM/YUV conversion and programs to convert Parallax
  38. XVideo JPEG files into PPM or YUV frames.
  39.  
  40. The motion vector search window can be specified, including half-pixel
  41. block matching, in the parameter file.  We have implemented several 
  42. search algorithms for P-frames including: 1) exhaustive search, 
  43. 2) subsampled search, and 3) logarithmic search.  We have also implemented
  44. several alternatives for B-frame block matching including: 1) interpolate
  45. best forward and best backward block, 2) find backward block for best
  46. forward or vice-versa (called CROSS2), and 3) exhaustive cross product
  47. (i.e., go out for coffee and a donut!). The search algorithms are controlled
  48. by options in the parameters file.  For tips on choosing the right search
  49. technique, see doc/TIPS.
  50.  
  51. We have done some tuning to produce a reasonable encoder, but there are
  52. many more optimizations that we would like to incorporate.  These 
  53. extensions are listed in the file EXTENSIONS.  If you succeed in 
  54. implementing any of them, please let us know! We have established 
  55. several mailing lists for messages about the Berkeley MPEG work:
  56.  
  57. mpeg-list-dist@CS.Berkeley.EDU
  58.    General information on the MPEG-1 decoder and encoder for 
  59.    everyone interested should be sent to this list.
  60.  
  61. mpeg-list-request@CS.Berkeley.EDU
  62.    Requests to join or leave the list should be sent to this
  63.    address. The subject line should contain the single word
  64.    ADD or DELETE.
  65.  
  66. mpeg-bugs@CS.Berkeley.EDU
  67.    Problems, questions, or patches should be sent to this address.
  68.  
  69. Our future plans include porting the encoder to run on other
  70. platforms and completing a portable parallel version of the code
  71. that will run on a network of workstations.  Vendors or other 
  72. organizations interested in supporting this research or discussing 
  73. other aspects of this project should contact Larry Rowe at 
  74. Rowe@CS.Berkeley.EDU (+1 510-642-5117).
  75.  
  76. ACKNOWLEDGEMENTS:
  77.  
  78. We gratefully thank Hewlett-Packard and Fujitsu who provided financial
  79. support for this work.  We also want to thank the following people for 
  80. their help:
  81.  
  82.     Jef Poskanzer who developed the pbmplus package.
  83.     ---------
  84.     Copyright (C) 1989, 1991 by Jef Poskanzer.
  85.  
  86.     Permission to use, copy, modify, and distribute this software and its
  87.     documentation for any purpose and without fee is hereby granted, provided
  88.     that the above copyright notice appear in all copies and that both that
  89.     copyright notice and this permission notice appear in supporting
  90.     documentation.  This software is provided "as is" without express or
  91.     implied warranty.
  92.     ---------
  93.  
  94.     Eiichi Kowashi of Intel and Avideh Zakhor of U.C. Berkeley who
  95.     provided valuable suggestions on motion vector searching.
  96.  
  97.     Chad Fogg of the University of Washington who has helped us 
  98.     understand many issues in MPEG coding and decoding.
  99.