home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / mpeg-faq / part6 < prev    next >
Encoding:
Internet Message Format  |  1996-11-10  |  52.3 KB
  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!news.mathworks.com!fu-berlin.de!cs.tu-berlin.de!phade
  2. From: phade@cs.tu-berlin.de (Frank Gadegast)
  3. Newsgroups: alt.answers,comp.answers,news.answers
  4. Subject: MPEG-FAQ: multimedia compression [6/9]
  5. Followup-To: alt.binaries.multimedia
  6. Date: 9 Nov 1996 09:34:05 GMT
  7. Organization: Technical University of Berlin, Germany
  8. Lines: 1305
  9. Approved: news-answers-request@MIT.EDU
  10. Expires: 31 Dec 1996 12:00:00 GMT
  11. Message-ID: <561j6d$ou1$1@news.cs.tu-berlin.de>
  12. Reply-To: mpegfaq@powerweb.de
  13. NNTP-Posting-Host: 130.149.22.20
  14. Mime-Version: 1.0
  15. Content-Type: text/plain; charset=iso-8859-1
  16. Content-Transfer-Encoding: 8bit
  17. Summary: This is the summary about the ISO video and audioformats MPEG 1, 2 and 4
  18. Keywords: MPEG, FAQ, Compression
  19. Xref: senator-bedfellow.mit.edu alt.answers:21699 comp.answers:22309 news.answers:86424
  20.  
  21. Archive-name: mpeg-faq/part6
  22. Last-modified: 1996/06/02
  23. Version: v 4.1 96/06/02
  24. Posting-Frequency: bimonthly
  25.  
  26. MPEGVIEW.EXE and type "MPEG MPEGFILENAME.MPG".
  27.  
  28. ---------------------------------------------------------------------------
  29.  
  30. ~Subject: mpgaudio
  31.  
  32. Now there is the MPEG AUdio Player for Win3.1 !
  33.  
  34. This program is Shareware. To encode your own MPEG Audio files, you need
  35. to buy the MPEG Audio Software Encoder program for Win3.1 .
  36.  
  37. [ Look above. Get some freeware encoder in software, much better !]
  38.  
  39. ---------------------------------------------------------------------------
  40.  
  41. ~Subject: SUBSECTION - WINDOWS-NT
  42.  
  43. ---------------------------------------------------------------------------
  44.  
  45. ~Subject: mpeg2ply
  46.  
  47. [The June 30 edition of mpeg2w11 does not contain encoder port]
  48.  
  49.                     MPEG Software Simulation Group codecs
  50.                              for Windows 32s 
  51.                            (MPEG-L@netcom.com)
  52.  
  53. MPEG2DEC.EXE and MPEG2ENC.EXE are Windows 32s ports with integrated
  54. display functions of the MPEG Software Simulation Group's programs. 
  55.  
  56. MPEG2PLY.EXE is the port of mpeg2play---Stefan Eckart's variation of
  57. mpeg2decode which optimizes speed through fast decoding methods such as
  58. approximation techniques, loop unravelling, et al.
  59.  
  60. All Win32s programs were ported with Microsoft Visual C++.  Only the
  61. main() program and display files (mpeg2dec.c, mpeg2enc.c, or mpeg2ply.c) 
  62. differ from the standard "Unix distribution."
  63.  
  64. If you do not have a 32-bit Windows environment (e.g. Win 4.0 Chicago,
  65. Windows NT), but plain old Windows 16 (e.g. Windows 3.1), yet you do
  66. possess either a 386, 486, or Pentium-based PC, you can download the
  67. Microsoft 32-bit extension program, "Win32s" from the Microsoft FTP
  68. site:
  69.  
  70. URL=ftp://ftp.microsoft.com/developers/DEVTOOLS/Win32SDK/Win32s115a.zip
  71.     [198.105.231.1]
  72.  
  73. (this is the latest edition--June 23, 1994)
  74.  
  75. Win32s archive (mpeg2w11.zip):      
  76.  
  77.  mpeg2dec:   
  78.    mpeg2dec.c             Main() routine.  Initiates application and display.
  79.    mpeg2dec.r             MS Visual C++ resource file.
  80.    makefile               MS Visual C++ project file.
  81.    gui.h                  #include constants for MS GUI values.
  82.    mpeg2dec.exe           Speed-optimized executable
  83.    grayleo.ico            mpeg2dec.exe 32x32 4-bit System Palette icon
  84.  
  85.  
  86. About the windows icon:
  87. The 32x32 4-bit icon for MPEG2DEC.EXE and MPEG2ENC.EXE is a silhouette
  88. of Dr. Leonardo Chiariglione (CSELT, Italy), none other than our
  89. co-founder and exhaulted lifetime Convenor of MPEG.
  90.  
  91. Acknowledgement:
  92. Many thanks to Sorin Papuc (sop@compcore.com) for porting these programs
  93. to Windows 32s.
  94.  
  95. ---------------------------------------------------------------------------
  96.  
  97. ~Subject: mpegplay
  98.  
  99. [ This new version of it, is running now extremly nice, the subsystem ]
  100. [ is no harm at all. The file should be known as MPEGW32W.ZIP.        ]
  101.  
  102. From: michael@ecel.uwa.edu.au (Michael Simmons  - division)
  103.  
  104. MPEGPLAY V1.61 (c) 1993,1994 Michael Simmons
  105.  
  106. Please READ ALL of this file!
  107.  
  108. This is Release Version 1.61 of my port of the Berkeley mpeg player.
  109.  
  110. Note this version requires the WIN32s V1.15a Windows(tm) Extender.
  111. Also this version will only work under (beta 612) of Windows NT(tm) V3.5 or later.
  112.  
  113. Features added in this version include
  114. (1) Support for MPEG1 System Layer files (you don't have to split them now).
  115. (2) Support for the Microsoft(tm) WinG(tm) Windows(tm) gaming library.
  116. (3) Improved colours for the Ordered and 2x2 Order dithers.
  117. (4) "Save As" For all the Mosaic Users.
  118. (5) Improved Error handling for corrupt/non standard mpeg files.
  119. (6) Support for CDI(tm) and VideoCD Streams. Either as an extracted MPEG
  120.     sequence or as a RAW CDROM grab.
  121. (7) Recompiled using the Microsoft Daytona(tm?) (beta 612) SDK Compiler.
  122.  
  123. Please Email me with any suggestions you may have on improving the player!
  124. (See the section CONTACTING ME).
  125.  
  126. This player can play standard mpeg files that include P and B frame
  127. encoding, and large 354x288 movie files. 
  128. It has several display options including mono, gray scale, color dither and
  129. Full colour (for Hicolor graphic cards).
  130. 8MB of Ram or greater is recommended if large Image size MPEG files 
  131. are played.
  132.  
  133. This program is SHAREWARE Please read the REGISTER.TXT file for 
  134. information on registering your copy. 
  135.  
  136. To install the player.  
  137. If you don't have Win32s V1.15a installed, install it first.
  138. Unzip the file disk1.zip to a floppy disk. 
  139. Then run the setup.exe file via the Progman File-Run Menu
  140. Item. 
  141. Note: This will also install the Microsoft WinG(tm) extensions to Windows(tm)
  142. Should you wish to remove these extensions at a later date
  143. please refer to the section near the end of this Readme.txt file.
  144.  
  145. Read the Disclaimer in the online Help before loading any mpeg movie files.
  146.  
  147. The latest version of this software can be found first on
  148.  
  149. URL=ftp://ftp.ecel.uwa.edu.au/users/michael/
  150.  
  151. UNREGISTERED VERSION LIMITATIONS:
  152. The unregistered version will display the About box at startup. 
  153. IT WILL ALSO NOT HANDLE FILES BIGGER THAN 1MB!
  154.  
  155. DISTRIBUTION:
  156.  
  157. The Unregistered Version of the Player may be freely Re-Distributed so long as
  158. (1) None of the files are modified.
  159. (2) All files in this archive are re-distributed together.
  160. (3) None of the files are removed from this archive.
  161. (4) It is clearly stated that this program is Shareware, extended use of
  162.     which requires payment to myself Michael Simmons as described in the
  163.     players about box and the REGISTER.TXT file.
  164. (5) If any additional files are added it must be clearly stated 
  165.     which files have been added, who added these files and why!. 
  166.     It must be stated that I "Michael Simmons" am in no way responsible 
  167.     for these additional files.
  168. (6) None of the added files can instruct the user or modify the player 
  169.     in any way possible to enable the Unregistered Version Limitations 
  170.     to be overcome.
  171.  
  172. The Registered Version may only be Re-Distributed with my written
  173. approval.
  174.  
  175. KNOWN BUGS:
  176. The player does not like certain PD/Shareware desktop addons (Clocks etc).
  177. A small number of people are getting a GPF in POINTER.DLL. If you have
  178. this problem and solve it please contact me. So far I can not reproduce
  179. the fault.
  180. The player does not multitask while scanning a file to determine whether
  181. or not it is a system layer or straight video file. This is only a problem
  182. on large misaligned RAW CDI or VideoCD grabs.
  183. RAW CDI or VideoCD grabs have only be tested on 4 CDI Disks. Given the
  184. variation found between these disks I would not be surprised if there
  185. are problems with some disks.
  186. If you are having a problem with a certain CDI/VideoCD disk please send a
  187. copy (both original CD's) of it to me. If I don't already have it I will treat
  188. it as a registration fee.
  189. If you have a problem and are really stuck 
  190. try and find a machine on which it works and compare the two configurations.
  191. If you really really get stuck then see the section CONTACTING ME.
  192.  
  193. CHANGE LOG: (there is more to read after this section)
  194.  
  195. Changes V1.0 -> V1.2
  196. (1) Re complied using the latest (March) WIN32 Beta.
  197. (2) Includes the latest (March) Win32s windows 3.1 extension.
  198. (3) Fix bug in finding help file. The working directory can now be different
  199.     to the Command Line directory.
  200. (4) Increase number of clicks at startup to 4 
  201.  
  202. Changes V1.2 -> 1.25
  203. (1) Major rewrite of source code to clean up bugs
  204. (2) Now saves options in a .ini file
  205. (3) Can split a multi stream MPEG into separate files.
  206. (4) Loop is now a separate option
  207. (5) Can be set to skip over B and P frames ( best to stop and rewind player 1st)
  208. (6) Decrease the number of About Box clicks to one
  209. (7) Can started via the file manager (associate .mpg with the player)
  210. (7b) Also startable from other applications i.e. NCSA Mosaic.
  211. (8) Recompiled with the release version of the Visual C++ for NT compiler
  212. (9) includes the Win32s version 1.1 files
  213. (10) Can change InputBufferSize in .ini file (i.e. InputBufferSize=80000)
  214. (11) Don't have to Close MPEG before OPEN ing
  215. (12) MPEG images are properly clipped when they are displayed
  216. (13) Hopefully no one will have any display problems now (try Use Small DIBS)
  217.  
  218. Changes V1.25 -> V1.30
  219. (1) Increased speed 10-20% (mainly P B frames and gray, Full/Hi Color dither).
  220. (2) Fixed bug, old mpegs causing exceptions (bus.mpg,flower.mpg,flowb.mpg etc).
  221. (3) Decreased the memory usage.
  222. (4) Added HiColor Dither (Uses 16 Bit DIBS,These are not supported by many
  223.     drivers yet, NT emulates support in the GDI).
  224. (5) Dropped Fs2 and Fs4 dither (use Fs2Fast)
  225.  
  226. Changes V1.30 -> V1.50
  227. (1) Added Push button, VCR like controls.
  228. (2) Now has a Separate Video Window.
  229. (3) Automatically Displays the 1st frame of the MPEG.
  230. (4) Redraws the current frame when needed.
  231. (5) Displays MPEG File Name, Image Dimensions and File Size in Video Caption
  232. (6) Saves all window positions correctly when exiting.
  233. (7) Detects when saved windows position is off the screen.
  234. (8) Added Experimental Set+Blt Mode for transferring images to the screen.
  235.  
  236. Changes V1.50 -> V1.60
  237. (1) Support for MPEG1 System Layer files (you don't have to split them now).
  238. (2) Support for the Microsoft(tm) WinG(tm) Windows(tm) gaming library.
  239. (3) Improve colors for the Ordered and 2x2 Order dithers.
  240. (4) "Save As" For all the Mosaic Users.
  241. (5) Improve Error handling for corrupt/non standard mpeg files.
  242. (6) Support for CDI(tm) and VideoCD Streams. Either as an extracted MPEG
  243.     sequence or as a RAW CDROM grab.
  244. (7) Recompiled using the Daytona (beta 612) SDK Compiler.
  245.  
  246. ACKNOWLEDGMENTS:
  247.  
  248. This code was derived from the U.C. Berkeley MPEG Player (version 2.0)
  249. developed by L.A. Rowe, K. Patel, and B. Smith (Rowe@CS.Berkeley.EDU).
  250. Permission to use their code in this Sharware product was obtained.
  251. THAT code included the following copyright:
  252.  
  253. /*
  254.  * Copyright (c) 1992 The Regents of the University of California.
  255.  * All rights reserved.
  256.  * 
  257.  * Permission to use, copy, modify, and distribute this software and its
  258.  * documentation for any purpose, without fee, and without written agreement is
  259.  * hereby granted, provided that the above copyright notice and the following
  260.  * two paragraphs appear in all copies of this software.
  261.  * 
  262.  * IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
  263.  * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
  264.  * OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF
  265.  * CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  266.  * 
  267.  * THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
  268.  * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANT ABILITY
  269.  * AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
  270.  * ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATION TO
  271.  * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
  272.  */
  273. /*
  274.  
  275. OTHER ACKNOWLEDGMENTS:
  276. Frank Gadegast (the MPEG FAQ Maintainer) for his helpful suggestions.
  277. Many others for their suggestions and support.
  278.  
  279. PATENTS:
  280. Should this player infringe on a patent held by someone somewhere.
  281. Please contact me as soon as possible. See the section CONTACTING ME
  282.  
  283. CONTACTING ME:
  284. In any correspondence please clearly state your email and snail mail addresses!
  285.  
  286. I have been receiving a large number of emails. 
  287. In-order to handle these efficiently I would ask that you note the following:
  288. (1) If possible look on
  289.  
  290. URL=ftp://ftp.ecel.uwa.edu.au/users/michael/faq.txt
  291.  
  292. (2) Mark all emails that do not require a reply "No Reply Expected". I will READ THESE!
  293. (3) Bounced replies due to incorrect email addresses (unless obvious) will not 
  294.     be chased up!
  295.  
  296. Email to michael@ecel.uwa.edu.au
  297. Talk to michael@div-pc-michael.ecel.uwa.edu.au  (8:30am to 5:00pm WA time).
  298. Phone to (Int)+ 61 9 344 1998 (Home number with answering machine)
  299. Don't automatically expect me to ring outside of Western Australia.
  300. I can be contacted via snail mail to PO Box 506,NEDLANDS WA 6009,AUSTRALIA
  301.  
  302. NOTE None of the source code to this player is on any of the machines
  303.      connected to the net via the University of Western Australia.
  304. IF   someone on network news is flaming me or my port of the player. Please
  305.      Email me about it.
  306.  
  307. OTHER INFO:
  308. There is another mpeg player for windows available for free from
  309.  
  310. URL=ftp://ftp.netcom.com/pub/cfogg/mpeg2/mpeg2w11.zip
  311.  
  312. I have nothing to do with this player. None of the source for that player
  313. is related to mine.
  314.  
  315. All of the money from registration is being spent on tools and 
  316. hardware to improve the player and further my knowledge of MPEG and 
  317. programming.
  318. This player is written and maintained in my free time. It is in no-way
  319. related to the University of Western Australia.
  320. They have indicated they have no interest in the player or its copyright.
  321.  
  322. The Source to this player is NOT Available!
  323.  
  324. HOW TO REMOVE THE WIN32s EXTENSIONS to WINDOWS(tm)
  325.  
  326. (1) exit to DOS.
  327. (2) backup your hard disk.
  328. (3) delete the Win32s directory and all its files.
  329. (4) edit the system.ini file in the window directory.
  330.     and remove the line device=C:\WINDOWS\SYSTEM\WIN32S\W32S.386
  331. (5) return to windows
  332. (6) remove the Win32 Applications Progman group
  333.  
  334. HOW TO REMOVE THE WING EXTENSIONS TO WINDOWS(tm)
  335.  
  336. (1) exit to DOS.
  337. (2) backup your hard disk.
  338. (3) delete the following files from you c:\windows\system directory
  339.     dva.386
  340.     wing.dll
  341.     wing32.dll
  342.     wingde.dll
  343.     wingdib.drv
  344.     wingpal.wnd
  345. (4) edit the system.ini file in the window directory.
  346.     and remove the line device=C:\WINDOWS\SYSTEM\dva.386
  347. (5) return to windows
  348.  
  349. Windows NT, Win32s, Windows 3.1, WinG are trademarks of the Microsoft Corporation.
  350. CDI is a trademark of Phillips.
  351.  
  352. ---------------------------------------------------------------------------
  353.  
  354. ~Subject: SUBSECTION - OS/2
  355.  
  356. ---------------------------------------------------------------------------
  357.  
  358. ~Subject: mp
  359.  
  360. mp.lha               gfx/show    45K  83 MPEG player for EHB display.
  361.  
  362. ---------------------------------------------------------------------------
  363.  
  364. ~Subject: SUBSECTION - X-WINDOWS and UNIX
  365.  
  366. ---------------------------------------------------------------------------
  367.  
  368. ~Subject: FHG Layer 3
  369.  
  370. ISO-MPEG Audio Layer 3 software only Encoder and Decoder for Unix
  371. Version 2.00.
  372.  
  373. copyright Fraunhofer - IIS 1994, 1995
  374.  
  375. - evaluate highest quality perceptual audio compression technique
  376.   available today
  377. - software only encoder and decoder implementations
  378. - implements ISO/MPEG Audio standard ISO/IEC IS 11172-3, Layer 3
  379. - wide range of compression ratios including
  380.       6:1   fully transparent quality 
  381.      11:1   64 kbps per channel, very high quality
  382.      16:1   still better than your average 16 bit 44.1 kHz sound card 
  383. - music data is input in raw format (16 bit signed integer), in
  384.   RIFF/WAVE format as used by Microsoft Windows .WAV files, in 
  385.   AIFF/AIFC format as used by SGI and Mac or in .snd/.au format used
  386.   by NeXT and Sun.
  387. - 44.1kHz sampling frequency (32 kHz and 48 kHz also for registered users)
  388. - packed bit stream conforming to ISO/MPEG Layer III
  389. - output of decoder is in raw format (16 bit signed integer), 
  390.   in .snd/.au format, in AIFF/AIFC format or in RIFF/WAVE format
  391. - .WAV music files can be played with Windows Media Player
  392. - Under rare circumstances the .WAV output is broken. Please use raw format
  393.   in that cases.
  394. - optional decoder output as 24 bit hex ascii data
  395. - written by the very same people at Fraunhofer-IIS who did the 
  396.   Layer III codecs for the ISO and ITU-R (former CCIR) tests 
  397.   (best sound quality at low bit rates at all listening tests)
  398. - commercial real time products for encoding and/or decoding of 
  399.   Layer III are available. Contact one of the companies listed 
  400.   in the file info.txt
  401.  
  402. The package consists of the following files
  403.    
  404. l3v200.UNIX_NAME.tar.gz:
  405.    l3enc          encoder program V2.00
  406.    l3dec          decoder program V2.10
  407.    manual.txt     instructions for encoder and decoder programs
  408.    register.txt   information on registration. PLEASE READ THIS!
  409.    info.txt       infos on ISO MPEG Layer III and Layer III products
  410.    readme.txt     this file
  411.    history.txt    infos on the history of this shareware product
  412.    go32.exe       DOS extender
  413.    winplay3/      in this directory is a demo version of the realtime
  414.                   Windows player WinPlay3 
  415.  
  416.  
  417. mp3-bitstreams.tar.gz:
  418.    contents.txt    short discription of the following Layer 3 bitstreams
  419.                    (CR/LF format)
  420.    contents        short discription of the following Layer 3 bitstreams
  421.                    (LF format)
  422.    funky.mp3       demo layer 3 bitstream (96 kbit/s, stereo, 44.1 kHz)
  423.    spot1.mp3       demo layer 3 bitstream (96 kbit/s, stereo, 44.1 kHz)
  424.    spot2.mp3       demo layer 3 bitstream (96 kbit/s, stereo, 44.1 kHz)
  425.    spot3.mp3       demo layer 3 bitstream (96 kbit/s, stereo, 44.1 kHz)
  426.    classic1.mp3    demo layer 3 bitstream (56 kbit/s, stereo, 22.05 kHz)
  427.    classic2.mp3    demo layer 3 bitstream (48 kbit/s, stereo, 22.05 kHz)
  428.  
  429. The song used for funky.mp3 is named "Funky" and was composed and 
  430. arranged by Juergen Herre. "Funky" is copyright Juergen Herre 1994.
  431. You may use "Funky" for all evaluation purposes of this shareware product.
  432. You may not use "Funky" for commercial purposes (e.g. radio broadcasting).
  433. The other bitstreams were provided by OMNI-Mediasound.
  434.  
  435. This package is distributed as shareware. You may work with the package for
  436. 30 days for evaluation purposes. If you want to use this package after the
  437. evaluation period, you are required to register the package (see information
  438. in the file register.txt). You may give copies of this package to other 
  439. people as long as no file is changed and no file is omitted.
  440.  
  441. If you need further information on Layer 3 products or if you have
  442. any questions concerning this shareware product, please send email to
  443. layer3@iis.fhg.de or try http://www.iis.fhg.de/. 
  444.  
  445. You can also fax or mail your questions to
  446.  
  447.    Layer 3 support
  448.    Fraunhofer - IIS
  449.    Am Weichselgarten 3
  450.    D-91058 Erlangen
  451.    Germany
  452.  
  453. Fax: + 49 9131 / 776 399
  454.  
  455. Disclaimer:
  456.  
  457. Don't forget that there are no warranties associated with this software.
  458. While we believe that our software is reasonably bug free and well behaved,
  459. we are in no way responsible if our software does not work the way you
  460. would expect it to work. No matter if it locks up your computer, garbles
  461. your floppy disks or does any other harmful things to your computer - it
  462. is entirely your problem. 
  463. Fraunhofer - IIS is not liable for any infringments or damages of 
  464. third parties' rights in consequencs of your use of this shareware 
  465. product. Fraunhofer - IIS is in no event liable for, respectively does 
  466. not warrant the trustworthiness, quality, industrial exploitability, 
  467. serviceability of this shareware product for the supposed purpose 
  468. or any other purposes.
  469.  
  470.  
  471. All brand names are registered trade marks of their respective owners.
  472.  
  473. ---------------------------------------------------------------------------
  474.  
  475. ~Subject: Berkeley's MPEG Tools
  476.  
  477. [ These tools were still in Beta-Version when the FAQ was compiled ]
  478. [ Try ftp to
  479.  
  480. URL=ftp://mm-ftp.cs.berkeley.edu/pub/multimedia/mpeg/
  481.  
  482. [ find the next 4 tools.                                           ]
  483.  
  484. This version of the Berkeley MPEG Tools packages together the decoder 
  485. (mpeg_play), the encoder (mpeg_encode), and three analysis tools (mpeg_stat,
  486. mpeg_blocks, and mpeg_bits).  Our last estimate was that over 60,000 copies 
  487. of the decoder have been FTP'd since the first release in November 1991,
  488. and over 15,000 copies of the encoder have been FTP'd since it was released 
  489. in July 1993.
  490.  
  491. For other information on multimedia research at U.C. Berkeley, see the home
  492. page for the Plateau Multimedia Research Group.
  493.     http://www-plateau.cs.berkeley.edu/plateau.html
  494.  
  495. Further about the FTP site is included in INDEX.  See ANNOUNCE for our
  496. posted announcement of the tools.
  497.  
  498. (Last updated: May 5, 1995)
  499.  
  500. -- 
  501. Eugene Hung                             eyhung@garnet.berkeley.edu
  502. Peter's Theorem:
  503.   Incompetence plus incompetence equals incompetence.
  504.  
  505. ---------------------------------------------------------------------------
  506.  
  507. ~Subject: MPEG-1 Video Software Encoder
  508.  
  509.                  MPEG-1 Video Software Encoder
  510.                 (Version 1.5; May 8, 1995)
  511.  
  512.      Lawrence A. Rowe, Kevin Gong, Eugene Hung, Ketan Patel, Steve Smoot
  513.        and Dan Wallach
  514.     Computer Science Division-EECS, Univ. of Calif. at Berkeley
  515.  
  516. This directory contains the freely distributed Berkeley MPEG-1 Video 
  517. Encoder.  The encoder implements the standard described in the ISO/IEC
  518. International Standard 11172-2.  The code has been compiled and tested 
  519. on the following platforms:
  520.  
  521.  DECstation 5000 and Alpha
  522.  HP PA-RISC (HP/UX 9.X) (i.e., HP 9000/7XX and 9000/3XX)
  523.  SGI Indigo running IRIX 5.0.1
  524.  Sun Sparc (SunOS 4.X)
  525.  
  526. In addition, Rainer Menes from the Technical University of Munich has
  527. ported the encoder and decoder to the Macintosh.  You can get that code
  528. directly from him (menes@statistik.tu-muenchen.de), or from the 
  529. Berkeley FTP archive (mm-ftp.CS.Berkeley.EDU).  If you decide to port 
  530. the code to a new architecture, please let us know so that we can 
  531. incorporate the changes into our sources.
  532.  
  533. This directory contains everything required to build the encoder
  534. and run it.  We have included source code, makefiles, binaries
  535. for selected platforms, documentation, and test data.  Installation 
  536. instructions are given in the file named src/mpeg_encode/INSTALL.  A man 
  537. page is given in the file doc/mpeg_encode.1.  A detailed user 
  538. manual is provided in postscript format in the file doc/user-manual.ps.
  539.  
  540. The encoder will accept any input file format as long as you provide 
  541. a script to convert the images to PPM, YUV, JPEG, or JMOVIE format.  Input 
  542. file processing is described in the file doc/INPUT.FORMAT.  Options to 
  543. control input file processing and compression parameters are specified in 
  544. a parameter file.  Very little error processing is done when reading 
  545. this file.  We suggest you start with the sample parameter file 
  546. examples/template.param and modify it.  See also examples/default.param.
  547.  
  548. The convert directory of Mpeg-Tools contains utilities you might find 
  549. useful including: 
  550.  
  551. programs to do PPM/YUV conversion and programs to convert Parallax
  552. XVideo JPEG files into PPM, YUV, or JPEG frames.
  553.  
  554. The motion vector search window can be specified, including half-pixel
  555. block matching, in the parameter file.  We have implemented several 
  556. search algorithms for P-frames including: 1) exhaustive search, 
  557. 2) subsampled search, and 3) logarithmic search.  We have also implemented
  558. several alternatives for B-frame block matching including: 1) interpolate
  559. best forward and best backward block, 2) find backward block for best
  560. forward or vice-versa (called CROSS2), and 3) exhaustive cross product
  561. (i.e., go out for coffee and a donut!). The search algorithms are controlled
  562. by options in the parameters file.  For tips on choosing the right search
  563. technique, see the user manual.
  564.  
  565. The encoder can be run on one computer (i.e., sequential) or on several
  566. computers (i.e., parallel).  Our goal is to produce a portable, easy-to-use
  567. encoder that we can use to encode large volumes of video material for
  568. the Berkeley VOD system (see paper VodsProp93.ps.Z on the FTP archive).
  569. The parallelism is done on a sequence of pictures.  In other words, you 
  570. can spawn one or more children to encode continuous runs pictures. The 
  571. uncompressed data can be accessed either through NFS or TCP sockets.  
  572. The goal is to allow you to encode using multiple processors, think 
  573. spare cycles on workstations, to speed up the encoding time.  Although
  574. performance depends on the speed of individual processors, the file system
  575. and network, and the P/B frame search methods, we have encoded 3.75
  576. frames/second on 8 HP Snakes running in parallel as compared with 0.6
  577. frames/second on 1 Snake.  These are preliminary results. We are continuing 
  578. to experiment with and tune the code.  Instructions to run the parallel system 
  579. are given in the man page and the parallel.param example parameter file.
  580.  
  581. We have done some tuning to produce a reasonable encoder, but there are
  582. many more optimizations that we would like to incorporate.  These 
  583. extensions are listed in the file doc/EXTENSIONS.  If you succeed in 
  584. implementing any of them, please let us know! 
  585.  
  586. Send bug reports to:
  587.  
  588. mpeg-bugs@CS.Berkeley.EDU
  589.    Problems, questions, or patches should be sent to this address.
  590.  
  591. Anyone interested in providing financial support for this research or 
  592. discussing other aspects of this project should contact Larry Rowe at 
  593. Rowe@CS.Berkeley.EDU (+1 510-642-5117).
  594.  
  595. This software is freely distributed.  That means, you may use it for 
  596. any non-commercial purpose.  However, patents are held by several companies 
  597. on various aspects of the MPEG video standard.  Companies or individuals
  598. who want to develop commercial products that include this code must
  599. acquire licenses from these companies.  For information on licensing, see
  600. Appendix F in the standard.
  601.  
  602. ACKNOWLEDGEMENTS:
  603.  
  604. We gratefully thank Hewlett-Packard and Fujitsu who provided financial
  605. support for this work.  We also want to thank the following people and
  606. organizations for their help:
  607.  
  608.     Jef Poskanzer who developed the pbmplus package.
  609.     ---------
  610.     Copyright (C) 1989, 1991 by Jef Poskanzer.
  611.  
  612.     Permission to use, copy, modify, and distribute this software and its
  613.     documentation for any purpose and without fee is hereby granted, provided
  614.     that the above copyright notice appear in all copies and that both that
  615.     copyright notice and this permission notice appear in supporting
  616.     documentation.  This software is provided "as is" without express or
  617.     implied warranty.
  618.     ---------
  619.  
  620.     Eiichi Kowashi of Intel and Avideh Zakhor of U.C. Berkeley who
  621.     provided valuable suggestions on motion vector searching.
  622.  
  623.     Chad Fogg of the University of Washington who has helped us 
  624.     understand many issues in MPEG coding and decoding.
  625.  
  626.     Rainer Menes of the Technical University of Munich who has ported the
  627.     the Berkeley MPEG encoder and decoder to the Macintosh, and he has 
  628.     provided us with many suggestions to improve the code.
  629.  
  630.     Robert Safranek of ATT for comments, suggestions, and most of the
  631.     code for custom quantization tables.
  632.  
  633.     Jim Boucher of Boston University for jmovie2jpeg.
  634.  
  635.     The San Diego SuperComputing Center for providing facilities to 
  636.     develop some of the code contained within.
  637.  
  638. -- 
  639. Eugene Hung                             eyhung@garnet.berkeley.edu
  640.  
  641. ---------------------------------------------------------------------------
  642.  
  643. ~Subject: MPEG Video Software Decoder
  644.  
  645.                   MPEG Video Software Decoder
  646.                   (Version 2.1; May 1 1995)
  647.  
  648.  Lawrence A. Rowe, Ketan Patel, Brian Smith, Steve Smoot, and Eugene Hung
  649.       Computer Science Division-EECS, Univ. of Calif. at Berkeley
  650.  
  651. This directory contains a public domain MPEG video software
  652. decoder. The decoder is implemented as a library that will
  653. take a video stream and display it in an X window on an 8, 24
  654. or 32 bit deep display.  The main routine is supplied to
  655. demonstrate the use of the decoder library. Several dithering
  656. algorithms are supplied based on the Floyd-Steinberg, ordered
  657. dither, and half-toning algorithms that tradeoff quality and
  658. performance. Neither the library nor the main routine handle
  659. real-time synchronization or audio streams.
  660.  
  661. The decoder implements the standard described in the Committee 
  662. Draft ISO/IEC CD 11172 dated December 6, 1991 which is
  663. sometimes refered to as "Paris Format." The code has been
  664. compiled and tested on the following platforms:
  665.  
  666.  HP PA-RISC (HP/UX 9.X, X11R5) (i.e., HP 9000/7XX and 9000/3XX)
  667.  Sun Sparc (SunOS 4.X, X11R5)
  668.  DECstation 5000 and Alpha
  669.  Silicon Graphics Indigo
  670.  MIPS RISC/os 4.51
  671.  
  672. If you decide to port the code to a new architecture, please let
  673. us know if there are any significant changes, so that we can incorporate
  674. them into our sources. 
  675.  
  676. This directory contains everything required to build and
  677. display video. We have included source code, a makefile, an Imakefile,
  678. installation instructions, and a man page. Data files can
  679. be obtained from the same ftp site this was located in.
  680. See the INSTALL file for instructions on how to
  681. compile and run the decoder. 
  682.  
  683. The data files were produced by XING. XING data does not take
  684. advantage of P or B frames (ie, frames with motion compensation). 
  685. Performance of the player on XING data is significantly slower 
  686. (half or less) than the performance when motion compensated MPEG 
  687. data is decoded. We are very interested in running the software 
  688. on other MPEG streams.  Please contact us if you have a stream 
  689. that does not decode correctly. Also, please send us new streams
  690. produced by others that do utilize P and B frames.
  691.  
  692. Our future plans include porting the decoder to run on other
  693. platforms, integrating it into a video playback system that
  694. supports real-time synchronization and audio streams, and
  695. further experiments to improve the performance of the
  696. decoder. Vendors or other organizations interested in supporting 
  697. this research or discussing other aspects of this project should 
  698. contact Larry Rowe at Rowe@CS.Berkeley.EDU.
  699.  
  700. Other Versions:
  701. There are three variations of the old mpeg_play:
  702.   One added a very nice Motif interface (variously named 
  703.     mpeg_play-2.0.1 and xmpegplay).
  704.   One was mpegvga.patch and let linux play straight to a VC.
  705.   One was an X interface (mpegplayer.tar.gz on linux sites)
  706. We have notified the authors of those programs, and will
  707. have new versions of them here as soon as they can find the time
  708. to update them.
  709.  
  710.  
  711. Reporting bugs:
  712.     If you find any bugs in this software, please send them to
  713.     mpeg-bugs@plateau.cs.berkeley.edu.  Since this software
  714.     is unsupported, we make no guarantees about how long it will
  715.     take to fix the bug, or if it will be fixed at all.  Bug fixes
  716.     will be cheerfully accepted.  Please include as much detailed
  717.     information as possible, including:
  718.  
  719.     1) the version number of the program you are using (cf. VERSION)
  720.     2) the data file that caused the bug (if possible)
  721.     3) the OS version and machine type you ran the program on
  722.     4) the compiler used to compile the program
  723.  
  724. ACKNOWLEDGEMENTS:
  725.     We gratefully thank Hewlett-Packard, Fujitsu, the Semiconductor
  726.     Research Corporation for financial support.
  727.  
  728.     We also want to thank the following people for their help:
  729.  
  730.     Tom Lane of the Independent JPEG Group provided us with
  731.         the basic inverse DCT code used by our player.
  732.         (tom_lane@g.gp.cs.cmu.edu)
  733.  
  734.     Reid Judd of Sun Microsystems provided advice and assistance.
  735.  
  736.     Todd Brunhoff of NVR provided advice and assistance.
  737.  
  738.     Toshihiko Kawai of Sony provided advice and assistance.
  739.  
  740. -- 
  741. Eugene Hung                             eyhung@garnet.berkeley.edu
  742.  
  743. ---------------------------------------------------------------------------
  744.  
  745. ~Subject: MPEG Video Software Analyzer
  746.  
  747.                   MPEG Video Software Analyzer
  748.                   (Version 1.0; May 81995)
  749.  
  750.  Lawrence A. Rowe, Doug Banks, Steve Smoot, and Sam Tze-San Fung 
  751.  Computer Science Division-EECS, Univ. of Calif. at Berkeley
  752.  
  753. This directory contains a public domain tool to monitor and modify 
  754. MPEG video streams.  mpeg_bits takes as input an mpeg stream and
  755. presents graphical feedback on the distribution of bits in the
  756. stream, on a macroblock-by-macroblock level.  mpeg_bits also provides
  757. a simple user interface to generate specifics files that can be
  758. used by mpeg_encode to re-encode a stream, modifying the encoding 
  759. on a macroblock-by-macroblock level.  [The present version of mpeg_encode
  760. does not support this..]
  761.  
  762. This tool does not support system layer streams.
  763.  
  764. mpeg_bits supports the standard described in the Committee 
  765. Draft ISO/IEC CD 11172 dated December 6, 1991 which is
  766. sometimes refered to as "Paris Format." The code has been
  767. compiled and tested at least once on the following platforms:
  768.     
  769.  HP PA-RISC (HP/UX 9.X, X11R5) (i.e., HP 9000/7XX and 9000/3XX)
  770.  Sun Sparc (SunOS 4.X, X11R5)
  771.  
  772. If you decide to port the code to a new architecture, please let
  773. us know about important changes, so that we can incorporate the changes
  774. into our sources. 
  775.  
  776. This directory contains everything required to build and use
  777. mpeg_bits.  We have included source code, a makefile, installation
  778. instructions, and a man page.  
  779.  
  780. See the INSTALL file for instructions on how to
  781. compile and run the analyzer.
  782.  
  783. Our future plans consist of more fully supporting an interactive
  784. editor paradigm; specifying changes directly on the display, 
  785. seeing the results of edits on the video stream immediately
  786. as they occur, etc.  We would also like to port the code to
  787. run on more platforms, and add support for system layer streams.
  788. Vendors or other organizations interested in supporting 
  789. this research or discussing other aspects of this project should 
  790. contact Larry Rowe at Rowe@CS.Berkeley.EDU.
  791.  
  792. Reporting bugs:
  793.     If you find any bugs in this software, please send them to
  794.     mpeg-bugs@plateau.cs.berkeley.edu.  Since this software
  795.     is unsupported, we make no guarantees about how long it will
  796.     take to fix the bug, or if it will be fixed at all.  Bug fixes
  797.     will be cheerfully accepted.  Please include as much detailed
  798.     information as possible, including:
  799.  
  800.     1) the version number of the program you are using (cf. VERSION)
  801.     2) the data file that caused the bug (if possible)
  802.     3) the OS version and machine type you ran the program on
  803.     4) the compiler used to compile the program
  804.  
  805. ACKNOWLEDGEMENTS:
  806.     We gratefully thank Hewlett-Packard, Fujitsu, the Semiconductor
  807.     Research Corporation for financial support.
  808.  
  809.     We also want to thank the following people for their help:
  810.  
  811.     Tom Lane of the Independent JPEG Group provided us with
  812.         the basic inverse DCT code used by our player.
  813.         (tom_lane@g.gp.cs.cmu.edu)
  814.  
  815.     Reid Judd of Sun Microsystems provided advice and assistance.
  816.  
  817.     Todd Brunhoff of NVR provided advice and assistance.
  818.  
  819.     Toshihiko Kawai of Sony provided advice and assistance.
  820.  
  821. -- 
  822. Eugene Hung                             eyhung@garnet.berkeley.edu
  823.  
  824. ---------------------------------------------------------------------------
  825.  
  826. ~Subject: MPEG Blocks Analyzer
  827.  
  828.                     MPEG Blocks Analyzer
  829.                   (Version 1.0; Feb 1 1995)
  830.  
  831.                        Ketan Patel
  832.                        Steve Smoot 
  833.                        Brian Smith
  834.                      Sam Tze-San Fung
  835.  
  836.  Computer Science Division-EECS, Univ. of Calif. at Berkeley
  837.  
  838. This directory contains a public domain MPEG video software
  839. analyzer.  It operates by playing a video stream in one window, while
  840. another window displays the block type and motion vectors for each block in
  841. the current frame.
  842.  
  843. The decoder implements the standard described in the Committee 
  844. Draft ISO/IEC CD 11172 dated December 6, 1991 which is
  845. sometimes refered to as "Paris Format." The code has been
  846. compiled and tested on the following platforms:
  847.  
  848.  
  849.  HP PA-RISC (HP/UX 8.X, X11R4) (i.e., HP 9000/7XX and 9000/3XX)
  850.  Sun Sparc (SunOS 4.X, X11R5)
  851.  
  852. This directory contains everything required to build and
  853. display video. We have included source code, a makefile, 
  854. installation instructions, and a man page. Data files can
  855. be obtained from the same ftp site this was located in.
  856. See the INSTALL file for instructions on how to
  857. compile and run mpeg_blocks.
  858.  
  859. Problems, questions, or patches should be sent to:
  860.     mpeg-bugs@Plateau.CS.Berkeley.EDU
  861.  
  862. ACKNOWLEDGEMENTS:
  863.     We gratefully thank Hewlett-Packard, Fujitsu, the Semiconductor
  864.     Research Corporation for financial support.
  865.  
  866.     We also want to thank the following people for their help:
  867.  
  868.     Tom Lane of the Independent JPEG Group provided us with
  869.         the basic inverse DCT code used by our player.
  870.         (tom_lane@g.gp.cs.cmu.edu)
  871.  
  872.     Reid Judd of Sun Microsystems provided advice and assistance.
  873.  
  874.     Todd Brunhoff of NVR provided advice and assistance.
  875.  
  876.     Toshihiko Kawai of Sony provided advice and assistance.
  877.  
  878. -- 
  879. Eugene Hung                             eyhung@garnet.berkeley.edu
  880.  
  881. ---------------------------------------------------------------------------
  882.  
  883. ~Subject: MPEG Video Software Statistics Gatherer
  884.  
  885.               MPEG Video Software Statistics Gatherer
  886.                   (Version 2.2; May 8, 1995)
  887.  
  888.  Lawrence A. Rowe, Steve Smoot, Ketan Patel, and Brian Smith
  889.  Computer Science Division-EECS, Univ. of Calif. at Berkeley
  890.  
  891. This directory contains a public domain MPEG video statistics gatherer.
  892. The decoder implements the standard described in the Committee 
  893. Draft ISO/IEC CD 11172 dated December 6, 1991 which is
  894. sometimes referred to as "Paris Format." The code has been
  895. compiled and tested on the following platforms:
  896.  
  897.  HP PA-RISC (HP/UX 9.X) (i.e., HP 9000/7XX and 9000/3XX)
  898.  Sun Sparc (SunOS 4.X)
  899.  DECstation 5000 and Alpha
  900.  Sequent
  901.  Irix 4.0.5
  902.  Linux
  903.  
  904. See the CHANGES file for information on all the improvements over 2.0
  905.  
  906. See the manual page for information on how to use mpeg_stat.
  907.  
  908. Send bug reports to mpeg-bugs@plateau.cs.berkeley.edu,
  909. job offers (PhD in '96) to smoot@cs.berkeley.edu ;-)
  910.  
  911. Vendors or other organizations interested in supporting 
  912. this research or discussing other aspects of this project should 
  913. contact Professor Larry Rowe at rowe@CS.Berkeley.EDU.
  914.  
  915. FUTURE PLANS:
  916. In the next version I'd like to beef up the verification code and do
  917. something with system layer audio (when present).  In addition (major
  918. though) MPEG-2 would be cool.  If you send me code to do any of this, it
  919. will be much appreciated.  (In general, though, I'll only be improving it
  920. to meet my thesis needs. -srs)
  921.  
  922. INSTALL:
  923.   If you have gcc, type "make"
  924.   See the file INSTALL for slightly more help.
  925.  
  926. AUDIO (we don't do audio, but Chad Fogg points out):
  927.   CCETT has been distributing executables only of their Audio bitstream
  928.   syntax verifier.  The site address is: 161.105.2.22
  929.   Audio conformance bitstreams are also at ftp.tnt.uni-hannover.de 
  930.  
  931. ACKNOWLEDGEMENTS:
  932.     We gratefully thank Hewlett-Packard, Fujitsu, the Semiconductor
  933.     Research Corporation for financial support.
  934.  
  935.     We also want to thank the following people for their help:
  936.  
  937.     Tom Lane of the Independent JPEG Group provided us with
  938.         the basic inverse DCT code used by our player.
  939.         (tom_lane@g.gp.cs.cmu.edu)
  940.  
  941.     Reid Judd of Sun Microsystems provided advice and assistance.
  942.  
  943.     Todd Brunhoff of NVR provided advice and assistance.
  944.  
  945.     Toshihiko Kawai of Sony provided advice and assistance.
  946.  
  947. -- 
  948. Eugene Hung                             eyhung@garnet.berkeley.edu
  949.  
  950. ---------------------------------------------------------------------------
  951.  
  952. ~Subject: xmg
  953.  
  954. XMG v1.0 - The X MPEG Grabber  
  955. *******************************
  956.  
  957. DESCRIPTION
  958. +++++++++++
  959.  
  960. XMG is a utility for the X Window System which allows you to create MPEG-1 video streams by repeatedly
  961. grabbing a window on the screen and then joining the frames into an MPEG sequence. XMG has several
  962. options that modify its behaviour, but it also provides sensible defaults for most of them. The two switches that
  963. you'll use most of the time are -fps (or -fpm) and -frames. These specify the number of frames per second (or
  964. per minute) and the total number of frames to grab. Here's an example invocation : 
  965.  
  966.         xmg -fps 1 -frames 20
  967.  
  968. This specifies that we want to grab 20 frames, one per second, and also that we want to see what's going on
  969. during the grabbing process. At this point the XMG window will appear : 
  970.  
  971.                          
  972.  
  973. Click on the "Grab" button and then click with the left mouse button inside the window that you want to grab.
  974. Once you've done this, the grabbing process will begin immediately, displaying some progress information as
  975. it does it. It is possible to change a few parameters directly from inside the window, instead of specifying them
  976. on the command line. When all the frames have been grabbed, the MPEG encoding process begins: go off and
  977. make yourself a nice cup of tea and come back later. By default the program creates a file called xmgout.mpg
  978. in the current directory. This file can then be viewed with any MPEG player which supports I,P and B frames
  979. of any size (Xing for example, doesn't support them). You can specify a different name for the output file with
  980. the -output switch. For example, the command : 
  981.  
  982.         xmg -fps 1 -frames 20 -output mympeg.mpg
  983.  
  984. will create a file called mympeg.mpg. When XMG is grabbing the frames, it stores them in a temporary RLE
  985. compressed and archived format called XLA. This file can become quite large very quickly, especially if you're
  986. grabbing several frames of a certain size. This file will be created by default in the /tmp directory with the
  987. name xmgtmp.$$$. This can be changed with the -tmp option : 
  988.  
  989.         xmg -fps 1 -frames 20 -tmp /empty/xmpeggrab.tmp
  990.  
  991. which will create it in the /empty directory with the name xmpeggrab.tmp. Make sure you've got plenty of
  992. space on the device ! To actually perform the encoding, XMG requires a parameter file. By default this file is
  993. called xmg.param and has to be in the current directory. Don't worry if you haven't got one : XMG will create
  994. a default one for you and use that. A different parameter file can be specified with the -param switch : 
  995.  
  996.         xmg -fps 1 -frames 20 -param flower.param
  997.  
  998. This will use the file flower.param. A description of the possible contents of the paramter file is provided later
  999. on. 
  1000.  
  1001. SYNOPSIS
  1002. ++++++++
  1003.  
  1004.     xmg
  1005.         -help
  1006.         -display host:dpy
  1007.         -frames nframes
  1008.         -fps nfps
  1009.         -fpm nfpm
  1010.         -terse 
  1011.         -output filename
  1012.         -tmp filename
  1013.         -param filename
  1014.  
  1015. OPTIONS
  1016. +++++++
  1017.  
  1018. -fps nfps : specifies the number of frames per second to grab. Even if the machine you're using is slow, XMG
  1019. will grab the server during the grab, so that no other application can write to the screen at the same time. As
  1020. soon as the frame has been grabbed, the server is released so that the other applications can redraw their client
  1021. area. 
  1022.  
  1023. -fpm nfpm : specifies the number of frames per minute to grab. 
  1024.  
  1025. -frames nframes : specifies the number of frames to grab in total. 
  1026.  
  1027. -output filename : specifies a name and location for the generated MPEG stream. By default XMG creates a
  1028. file in the current directory called xmgout.mpg. 
  1029.  
  1030. -tmp filename : specifies a name and location for the temporary storage of the grabbed frames. This file is
  1031. deleted when XMG has completed the encoding process. The default is /tmp/xmgtmp.$$$ 
  1032.  
  1033. -terse : does not display the XMG status window during the grabbing/encoding process. The default is to
  1034. display the XMG window. 
  1035.  
  1036. -param : specifies a name and location for the parameter file. By default the file is called xmg.param and has to
  1037. be in the current directory. If one doesn't exist, a default one will be created for you. 
  1038.  
  1039. PARAMETER FILE
  1040. ++++++++++++++
  1041.  
  1042. The parameter file MUST contain the following lines : 
  1043.  
  1044. PATTERN pattern
  1045. ---------------
  1046.  
  1047. pattern is a sequence of I's, P's and B's, that specifies the order of the frames in the MPEG stream. 
  1048.  
  1049. GOP_SIZE n
  1050. ----------
  1051.  
  1052. n is roughly the number of frames in a Group of Pictures (roughly because a GOP must begin with an I-frame) 
  1053.  
  1054. SLICES_PER_FRAME n
  1055. ------------------
  1056.  
  1057. n is roughly the number of slices per frame. Note, at least one MPEG player may complain if slices do not start
  1058. at the left side of an image. To ensure this does not happen, make sure the number of rows is divisible by
  1059. SLICES_PER_FRAME. 
  1060.  
  1061. PIXEL (FULL or HALF)
  1062. --------------------
  1063.  
  1064. use half-pixel motion vectors, or only full-pixel ones 
  1065.  
  1066. RANGE 
  1067. ------
  1068.  
  1069. use a search range of +/- n pixels 
  1070.  
  1071. PSEARCH_ALG algorithm
  1072. ---------------------
  1073.  
  1074. algorithm must be one of {EXHAUSTIVE, TWOLEVEL, SUBSAMPLE, LOGARITHMIC}. Tells what kind
  1075. of search procedure should be used for P-frames. Exhaustive gives the best compression, but logarithmic is the
  1076. fastest. You select the desired combination of speed and compression. TWOLEVEL is an exhaustive full-pixel
  1077. search, followed by a local half- pixel search around the best full-pixel vector (the PIXEL option is ignored
  1078. for this search algorithm). BSEARCH_ALG algorithm must be one of {SIMPLE, CROSS2, EXHAUSTIVE}.
  1079. Tells what kind of search procedure should be used for B-frames. Simple means find best forward and
  1080. backward vectors, then interpolate. Cross2 means find those two vectors, then see what backward vector best
  1081. matches the best forward vector, and vice versa. Exhaustive does an n-squared search and is EXTREMELY
  1082. slow in relation to the others (Cross2 is about twice as slow as Simple). 
  1083.  
  1084. IQSCALE
  1085. -------
  1086.  
  1087. use n as the qscale for I-frames 
  1088.  
  1089. PQSCALE
  1090. -------
  1091.  
  1092. use n as the qscale for P-frames 
  1093.  
  1094. BQSCALE
  1095. -------
  1096.  
  1097. use n as the qscale for B-frames 
  1098.  
  1099. REFERENCE_FRAME (ORIGINAL or DECODED)
  1100. -------------------------------------
  1101.  
  1102. If ORIGINAL is specified, then the original images are used when computing motion vectors. To be more
  1103. accurate, use DECODED, in which the decoded images are used. This should increase the quality of the image,
  1104. but will take a bit longer to encode. 
  1105.  
  1106. The lines may appear in any order, except the following exceptions. 
  1107.  
  1108. NOTES
  1109. +++++
  1110.  
  1111. If XMG was compiled with the -DMITSHM switch enabled, then shared memory will be used if available and
  1112. will increase performance noticeably. 
  1113.  
  1114. AUTHOR
  1115. ++++++
  1116.  
  1117. Tristan Tarrant - University of Sussex, UK, tristant@cogs.susx.ac.uk 
  1118.  
  1119. CREDITS
  1120. +++++++
  1121.  
  1122. MPEG encoding based on mpeg_encode by : 
  1123.  
  1124. Kevin Gong - University of California, Berkeley, keving@cs.berkeley.edu 
  1125.  
  1126. Ketan Patel - University of California, Berkeley, kpatel@cs.berkeley.edu 
  1127.  
  1128. Dan Wallach - University of California, Berkeley, dwallach@cs.berkeley.edu 
  1129.  
  1130. BUGS AND LIMITATIONS
  1131. ++++++++++++++++++++
  1132.  
  1133. XMG works only on Pseudo-Color displays. No known bugs. 
  1134.  
  1135. Tristan Tarrant, tristant@cogs.susx.ac.uk
  1136.  
  1137. ---------------------------------------------------------------------------
  1138.  
  1139. ~Subject: mpegstat
  1140.  
  1141. Tom Pfeifer (pfeifer@fokus.gmd.de) announces:
  1142.  
  1143. [ mpegstat.tar.Z was uploaded to mm-ftp.cs.berkeley.edu, the DOS-port ]
  1144. [ is available on http://www.powerweb.de/mpeg                         ]
  1145. [ It will probably included in the next version of Berkeley's encoder ]
  1146.  
  1147. This is mpegstat v1.0 - an analyzing took for MPEG-I video streams for Unix. 
  1148. It is based on the Berkeley MPEG player v2.0, utilizing the Berkeley parsing 
  1149. and decoding routines for the MPEG data stream.
  1150.  
  1151.  
  1152. MPEGSTAT is  a  useful utility for analyzing MPEG-I video
  1153. streams. It is based on the Berkeley  MPEG  movie  player.
  1154. MPEGSTAT reads  a  video  stream from a file or stdin and
  1155. shows the frame type pattern as it is found while parsing.
  1156. After  the  stream  is  completely  parsed it displays the
  1157. frame pattern as it would be displayed by a  MPEG  viewer.
  1158. It then generates a summary of various mpeg format related
  1159. statistics.  MPEGSTAT works for MPEG movies that are Paris
  1160. format compatible.
  1161.  
  1162.  
  1163. Authors
  1164.  
  1165. Multimedia  systems  project - Technical University of Berlin, Germany
  1166. Tom   Pfeifer,   Dept.   of    Computer    Science, pfeifer@fokus.gmd.de
  1167. Jens  Brettin - Alexander Schulze - Harald Masche - Dirk Schubert
  1168.  
  1169. ---------------------------------------------------------------------------
  1170.  
  1171. ~Subject: mplex
  1172.  
  1173. *********************************************************************
  1174. *                                                                   *
  1175. *         ANNOUNCING OF A FREE MPEG 1/SYSTEMS MULTIPLEXER           *
  1176. *                                                                   *
  1177. *   thanks to                                                       *
  1178. *   ^^^^^^^^^                                                       *
  1179. *    SIEMENS LTD, CORPORATE RESEARCH AND DEVELOPMENT ZFE ST SN 11   *
  1180. *         TECHNICAL UNIVERSITY OF MUNICH, PROF. SCHLICHTER          *
  1181. *                                                                   *
  1182. *********************************************************************
  1183.  
  1184.  
  1185. Hello all.
  1186.  
  1187. This is an announcing for all of those that have already been waiting
  1188. on the release of my code for multiplexing one  MPEG 1 Audio  and one
  1189. MPEG 1 Video Stream   into a  MPEG 1/SYSTEMS  multiplexed data stream
  1190. according to the ISO/IEC 11172-1 specs.  Sorry for all of those  that
  1191. needed the code really bad and kept mailing me on it. I couldn't hold
  1192. my promises because of copyright release on part of the University.
  1193.  
  1194. But here it is: I uploaded the source code on
  1195.  
  1196. URL=ftp://hpsystem2.informatik.tu-muenchen.de//pub/comp/graphics/mpeg/mplex/mplex-1.0beta.tar.gz
  1197.     [131.159.0.198]
  1198.     ftp.informatik.tu-muenchen.de
  1199.  
  1200. .gz means it is compressed with GNU zip. Should somebody not have it,
  1201. you can find it on our FTP server under
  1202.  
  1203.    /pub/comp/gnu/gzip/
  1204.  
  1205. else, just try
  1206.  
  1207.    get mplex-1.0beta.tar.Z
  1208.  
  1209. Our FTP server will do an on-the-fly-compressing with the 'compress'
  1210. (.Z) format.
  1211.  
  1212.  
  1213. Now to the code itself:
  1214.  
  1215. I have been kept really busy with my papers on multiplexing (they will
  1216. shortly be available on the FTP server also, I will post on that),  so
  1217. sorry if I couldn'g tighten the code up a bit.  There is no real docu-
  1218. mentation yet, please try out the code.  Feel free to email me for any
  1219. further questions.
  1220.  
  1221. As of now, this code will only run under standard UN*X-Style platforms
  1222. providing a (K&R-Style) C compiler (GNU CC is fine). It tested fine on
  1223. SUN's, HEWLETT PACKARD's series 700, SILICON GRAPHICS machine's.
  1224. There is * NO DOS PORT AVAILABLE (YET) *.
  1225.  
  1226. Contact me if you are planning such a thing.
  1227.  
  1228. There will be better releases, and I promise to clean up the code soon.
  1229.  
  1230. :)
  1231.  
  1232. This Software is released under the terms of the GNU public license,
  1233. see the tar archive for further details. Feel free to archive the code
  1234. on other FTP servers or post it to newsgroups, if there is such
  1235. interest.
  1236.  
  1237.  
  1238. Research done at 
  1239.  
  1240.     SIEMENS LTD, CORPORATE RESEARCH AND DEVELOPMENT ZFE ST SN 11
  1241.     TECHNICAL UNIVERSITY OF MUNICH, PROF. SCHLICHTER
  1242.  
  1243. Christoph Moar             moar@Informatik.TU-Muenchen.DE (Christoph Moar)
  1244.  
  1245. ---------------------------------------------------------------------------
  1246.  
  1247. ~Subject: xmplay
  1248.  
  1249. [ Here it is !! The first, fully-featured MPEG-player with X11-interface. ]
  1250. [ XMPLAY exists currently in Version 1.0, patches are available. The next ]
  1251. [ Version 1.1 is currently in development. Thats the announcement !       ]
  1252.  
  1253.             XMPLAY [Version 1.1] - Sun Apr 10 14:51:22 MDT 1994
  1254.  
  1255.       This distribution is the result of a project worked out at the
  1256.       Technical University (TU) Berlin, held in Winter 93/94 by
  1257.       Tom Pfeifer. The basic idea is created by Frank Gadegast,
  1258.       the programing work was then done by Juergen Meyer, Metin
  1259.       Cetinkaya and Frank Gadegast.
  1260.  
  1261. This software is ftp-able from:
  1262.  
  1263. http://www.powerweb.de/mpeg
  1264.  
  1265. [ Just to remember .gz means, its compressed using GNU's zip, called ]
  1266. [ gzip. Use gunzip to uncompress.                                    ]
  1267.  
  1268.  
  1269. XMPLAY [Version 1.1]
  1270.  
  1271. <IMG SRC="xmplay1.gif"> <IMG SRC="xmplay2.gif">
  1272.  
  1273. XMPLAY is a very nice directory-browser under X11 to use XMPEG,
  1274. the interactive X11-MPEG-player.
  1275.  
  1276. MPEG is a video-format described by the ISO-standard ISO CD11172.
  1277. This implementation here can handle MPEG-stream written down
  1278. at the MPEG-group-meeting in Paris '92. It can handle IPB-frames
  1279. but no system- nor audio-information.
  1280.  
  1281. <IMG SRC="xmplay3.gif"> <IMG SRC="xmplay4.gif">
  1282.  
  1283. Additional you get a little utility called MPEGINFO, showing you, if called
  1284. with the filename of a MPEG-file the most important parameter it can read
  1285. dirrectly from its header, like size, picture rate or frame-style.
  1286.  
  1287. It should work under nearly every system, 'cause it's programed without
  1288. MOTIF, the X11-Toolit or other stupid things, that are always causing
  1289. problems. It only needs the X11-library, no matter if you're using
  1290. Release 3, 4 or Release 5.
  1291.  
  1292. In addition it has lots of defines to let it run under BSD, SYSV, ISC,
  1293. Solaris, SunOS, A/UX, SCO or XENIX and you don't have to hack a difficult
  1294. Imake- or Makefile and you will not have trouble with build-in pathnames !!!
  1295.  
  1296. It's specially made for those systems, that don't have super hardware
  1297. or that have problems with the Toolkit or MOTIF.
  1298.  
  1299.  
  1300. XMPEG [Version 1.1]
  1301.  
  1302. <IMG SRC="xmpeg1.gif"> <IMG SRC="xmpeg3.gif">
  1303.  
  1304. XMPEG is a MPEG-video-player based on the MPEG-widget-implementation
  1305. from Jim Frost and the MPEG-movie-player "mpeg_play" from the Portable
  1306. Video Research Group at Berkeley.
  1307.  
  1308. It just adds a few buttons and is normally getting called
  1309. from XMPLAY, but can be used as stand-alone to include into other
  1310. programs. Its programmed with the same methods than XMPLAY.
  1311.  
  1312. <IMG SRC="xmpeg2.gif"> <IMG SRC="xmpeg4.gif">
  1313.  
  1314.  
  1315. You can download XMPLAY from http://www.powerweb.de/mpeg.
  1316.  
  1317. If you get problems (not really possible) to compile it or if you have
  1318. comments send them to the authors, reachable at:
  1319.  
  1320.         phade@powerweb.de (responsible for compiling and X11)
  1321.         jm@cs.tu-berlin.de (responsible for the mpeg-code) or
  1322.         brain@cs.tu-berlin.de
  1323.  
  1324. ---------------------------------------------------------------------------
  1325.  
  1326.