home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / software / unix / mpeg / readme.txt < prev   
Text File  |  1994-06-03  |  9KB  |  229 lines
  1.               mpeg2encode / mpeg2decode
  2.               =========================
  3.           MPEG-2 Encoder / Decoder, Version 1.0, May 1994
  4.  
  5.             MPEG Software Simulation Group
  6.                   (MPEG-L@netcom.com)
  7.  
  8. Contents:
  9. 1. Overview
  10. 2. Introduction
  11. 3. Contacting the MPEG Software Simulation Group
  12. 4. Availability 
  13. 5. Installation
  14. 6. Acknowledgements
  15. 7. History of the technical report
  16.  
  17.  
  18. 1. Overview
  19. ===========
  20.  
  21. This directory contains our implementation of an ISO/IEC DIS 13818-2 codec. 
  22. It converts uncompressed video frames into MPEG-1 and MPEG-2 video 
  23. coded bitstream sequences, and vice versa.
  24.  
  25. The files mpeg2enc.doc and mpeg2dec.doc in the doc/ directory contain
  26. further information about the codec. The doc directory also contains an
  27. FAQ file answering frequently asked questions about MPEG. A precompiled
  28. version of the programs for MSDOS (requires at least a '386) and a set
  29. of verification files are available separately.
  30.  
  31. Subdirectories src/mpeg2enc and src/mpeg2dec contain the source code
  32. for the encoder and decoder, subdirectory par/ contains a couple of
  33. example encoder parameter files for 25 and 30 frames/sec MPEG-2 and
  34. MPEG-1 video.
  35.  
  36.  
  37. 2. Introduction
  38. ===============
  39.  
  40. MPEG-2 Video is a generic method for compressed representation of video
  41. sequences using a common coding syntax defined in the document ISO/IEC
  42. 13818 Part 2 (CD: Nov. 1993, DIS: March 1994) by the International
  43. Organization for Standardization (ISO) and the International
  44. Electrotechnical Commission (IEC), in collaboration with the
  45. International Telecommunications Union (ITU) as Recommendation H.262.
  46. The MPEG-2 concept is similar to MPEG-1, but includes extensions to
  47. cover a wider range of applications. The primary application targeted
  48. during the MPEG-2 definition process was the all-digital transmission
  49. of broadcast TV quality video at coded bitrates between 4 and 9
  50. Mbit/sec.  However, the MPEG-2 syntax has been found to be efficient
  51. for other applications such as those at higher bit rates and sample
  52. rates (e.g. HDTV). The most significant enhancement over MPEG-1 is the
  53. addition of syntax for efficient coding of interlaced video (e.g. 16x8
  54. block size motion compensation, Dual Prime, et al).  Several other more
  55. subtle enhancements (e.g. 10-bit DCT DC precision, non-linear
  56. quantization, VLC tables, improved mismatch control) are included 
  57. which have a noticeable improvement on coding efficiency, even for
  58. progressive video. Other key features of MPEG-2 are the scalable
  59. extensions which permit the division of a continuous video signal into
  60. two or more coded bit streams representing the video at different
  61. resolutions, picture quality (i.e. SNR), or picture rates.
  62.  
  63. The MPEG Software Simulation Group is currently developing MPEG
  64. software with the purpose of providing aid in understanding the various
  65. algorithms which comprise an encoder and decoder, and giving a sample
  66. implementation based on advanced encoding models. The MPEG-2 software
  67. project is on on-going development. Since the current version of the
  68. encoder already employs a reasonable (and the most popular) subset of
  69. the MPEG-2 signal coding toolkit, and there appears to be sufficient
  70. public interest, we have decided to make a first public release of the
  71. code.
  72.  
  73. This encoder can also be used for generating good quality constant
  74. bitrate MPEG-1 sequences and is (to our knowledge) the first public
  75. release of an encoder based on the relatively sophisticated TM5 coding
  76. model.
  77.  
  78.  
  79. 3. Contacting the MPEG Software Simulation Group
  80. ================================================
  81.  
  82. We welcome any project-specific questions, comments, suggestions, bug
  83. reports etc. They should be sent to the Internet address: 
  84.  
  85.       MPEG-L@netcom.com 
  86.  
  87. which automatically forwards them to the authors.
  88.  
  89.  
  90. 4. Availability
  91. ===============
  92.  
  93. The current version of the codec source code is available by anonymous
  94. ftp from:
  95.  
  96.   ftp.netcom.com:/pub/cfogg/mpeg2
  97.  
  98. This directory contains the following files:
  99.  
  100.   README                         this file
  101.   mpeg2codec_v1.0.tar.gz         codec source code and documentation
  102.   mpeg2codec_verify_v1.0.tar.gz  verification archive       
  103.   mpeg2v10.zip                   MS-DOS executable archive  
  104.   tennis.m2v                     sample MPEG-2 video sequence (8 frames 704x576)
  105.   tennis.par, tennis.stat.gz     parameter file and statistics output
  106.                                  for tennis.m2v
  107.  
  108. You need gunzip (GNU zip/unzip) to uncompress the .gz archives.
  109.  
  110. Alternatively, the files may be retrieved by sending E-mail to:  
  111.  
  112.   ftp-request@netcom.com
  113.  
  114. ... with the following line in the body of the message:
  115.  
  116.   SEND cfogg/mpeg2/mpeg2codec_v1.0.tar.gz
  117.  
  118. You can retrieve the directory listings by sending the following command to ftp-request@netcom.com:
  119.  
  120.   DIR cfogg/mpeg2
  121.  
  122. General information can be retrieved with the command:   HELP
  123.  
  124.  
  125. 5. Installation
  126. ===============
  127.  
  128. mpeg2decode and mpeg2encode have been compiled successfully on the following
  129. platforms:
  130.  
  131. - SUN SPARCstation 10, SunOS 4.1.3, cc / gcc / acc
  132. - '386-PC, MSDOS 5.0, djgpp v1.11, gcc v2.5.7
  133.  
  134. The source code should compile without major modifications on other 32 bit
  135. systems using both K&R and ANSI C compilers. Systems with 16 bit 'int'
  136. variables or segmented memory models are not supported.
  137.  
  138. Please report any modifications you had to apply in order to install the
  139. programs on your system to the address MPEG-L@netcom.com.
  140.  
  141. The encoder and decoder are kept in separate sub-directories,
  142. src/mpeg2dec contains the decoder, while src/mpeg2enc contains the
  143. encoder sources.  The following installation procedure applies to both
  144. the encoder and the decoder:
  145.  
  146.  
  147. Step 1: edit Makefile
  148. ---------------------
  149.  
  150. You may have to set CC to your C compiler and CFLAGS to the flags required
  151. by the compiler. It is sufficient to set these variables in the top directory
  152. Makefile. They are propagated to the individual Makefiles of the encoder
  153. and decoder. Any other changes have to be applied to the individual Makefiles,
  154. however.
  155.  
  156. If you use a C compiler which doesn't understand ANSI-C function prototypes
  157. add -DNON_ANSI_COMPILER to CFLAGS.
  158.  
  159.  
  160. Step 2: edit src/mpeg2dec/config.h
  161. ----------------------------------
  162.  
  163. In most cases, no modification should be required. If your C library
  164. doesn't accept "rb" / "wb" parameters in fopen() (required to disable
  165. LF <-> CR/LF conversion on MSDOS systems), change the #defines RB and WB
  166. to "r" and "w".
  167.  
  168.  
  169. Step 3: make
  170. ------------
  171.  
  172. Type 'make' from the top directory (mpeg2). On a PC with DJGPP installed you
  173. have to enter 'make pc' in the individual source directories to produce
  174. .exe files.
  175.  
  176.  
  177. Step 4: verification
  178. --------------------
  179.  
  180. If you have downloaded and unarchived the mpeg/verify directory, you can
  181. verify correct compilation of the codec by typing 'make test'. No differences
  182. should be reported. The only comparison which is allowed to fail is between
  183. test.mpg and new.mpg, caused by floating point accuracy dependencies in the
  184. encoder rate control.
  185.  
  186.  
  187. 6. Acknowledgements
  188. ===================
  189.  
  190. Authors of the current release are:
  191.  
  192. Stefan Eckart    (stefan@lis.e-technik.tu-muenchen.de)
  193. Chad Fogg        (cfogg@netcom.com)
  194. Cheung Auyeung   (auyeung@mot.com)
  195.  
  196.  
  197. 7. History of Technical Report Project
  198. ======================================
  199.  
  200. The Technical Report, a document which primarily consists of
  201. a C source code program, was initiated by the MPEG committee to: 
  202.  
  203.  - Provide an example of MPEG video syntax being intelligently employed 
  204.    to generate good quality video.
  205.  - A reference tool for implementors
  206.  - Aid in understanding the MPEG specification 
  207.  
  208. MPEG would like to especially thank Dr. Stefan Eckart for his
  209. contributions have greatly helped the MPEG-2 Technical Report project
  210. start onto a successful path towards the final 13818-5 document.
  211.  
  212. MPEG lends a kind acknowledgement to Arian Koster (PTT) for initiating
  213. the MPEG-1 technical report project in Autumn 1992, and Leonardo
  214. Chiariglione (Chairman of MPEG) and Didier Le Gall (Chairman of MPEG
  215. Video) for support throughout both projects.  Also many thanks to MPEG-1
  216. project contributors Peter Au (Hughes Aircraft), Ron Burns (Hughes
  217. Aircraft), Stefan Eckart (Technical University of Munich), Chad Fogg,
  218. Tsuyoshi Hanamura (Waseda University), Kinya Oosa (Nippon Steel), Brian
  219. Quandt (Heuris Logic) and Hiroshi Watanabe (NTT).
  220.  
  221. Regards,
  222.  
  223. Chad Fogg
  224. MPEG Chair for Software Simulation, Jan 1993 - 
  225. +1 415 254 5818
  226. cfogg@netcom.com
  227. ----
  228. End of Readme file
  229.