ftp.pasteur.org/FAQ//ftp-pasteur-org-FAQ.zip/FAQ/mpeg-faq/part5

Internet Message Format | 1996-11-10 | 48.6 KB

Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!news.mathworks.com!fu-berlin.de!cs.tu-berlin.de!phade
From: [e-mail] (Frank Gadegast)
Newsgroups: alt.answers,comp.answers,news.answers
Subject: MPEG-FAQ: multimedia compression [5/9]
Followup-To: alt.binaries.multimedia
Date: 9 Nov 1996 09:33:50 GMT
Organization: Technical University of Berlin, Germany
Lines: 1306
Approved: [e-mail]
Expires: 31 Dec 1996 12:00:00 GMT
Message-ID: <561j5u$ou0$[e-mail]>
Reply-To: [e-mail]
NNTP-Posting-Host: 130.149.22.20
Mime-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit
Summary: This is the summary about the ISO video and audioformats MPEG 1, 2 and 4
Keywords: MPEG, FAQ, Compression
Xref: senator-bedfellow.mit.edu alt.answers:21698 comp.answers:22308 news.answers:86423

Archive-name: mpeg-faq/part5
Last-modified: 1996/06/02
Version: v 4.1 96/06/02
Posting-Frequency: bimonthly

          email support
          limited phone support
    Price:        15% of purchased product price (Free intro!)

                     Further Information
                     -------------------
You can reach us at:
     North Valley Research, Inc.
     15262 NW Greenbrier Parkway
     Beaverton, OR 97006
     Tel: [phone]
     Fax: [phone]
     email (sales and marketing): [e-mail]
     email (technical questions): [e-mail]

This and other text-only versions of our product sheets are available via
anonymous ftp to nvr.com (192.82.231.50).  Look in /pub/NVR.  We are happy
to mail paper versions of our product sheets on request.

If you require a demo version, please call or send mail to [e-mail].

---------------
Todd Brunhoff
Vice President, R&D
North Valley Research

---------------------------------------------------------------------------

~Subject: Demo of NVR Digital Media Development Kit

    $Revision: 1.2 $
    $Date: 1994/08/06 19:49:42 $

We are pleased to make available another release of NVR's digital media
development kit, version 2.0.3.  You should already have a license key.
If you don't, please contact us at [e-mail].

This version has several fixes for bugs and some important improvements
over version 2.0.2.  In particular:
   - Support added for Alias PIX files
   - Support added for playing XING sequences that have illegal syntax
     (extra picture info and non-increasing temporal references)
   - 400% speed improvement for RGB --> Y/Cr/Cb conversion in the compressor
     and imageop (you'll want this if you are compressing any rgb files,
     such as SGI rgb files).
   - the deinterlace operator (in imageop and the compressor) was broken
     in version 2.0.2.  You would only notice this if you are compressing
     abekas or other interlaced files.

The 2.0.x version is a significant improvement over our last major release,
1.0.4.  Briefly, this software offers:
   - MPEG video compression
   - image processing and compatibility with many image file formats,
     including JPEG, TIFF, SGI RGB and others.
   - MPEG audio compression
   - compatibility with a variety of audio files, including AIFF, AIFC
     Sun Audio and Parallax movie files.
   - MPEG system multiplexing
   - real-time, synchronized playback of any combination of video and audio
     files.   This means you can play back MPEG video files with AIFF, or
     you can play back MPEG system streams containing MPEG video and
     MPEG audio.  And everything in between
   - a variety of tools for converting image file formats and audio file
     formats.
   - a real-time video/audio recording program (Sun and Parallax hardware
     required)

The software package is available in several pieces via anonymous ftp to

URL=ftp://nvr.com/pub/NVR-software/
    [192.82.231.50]

Look in /pub/NVR-software for the license
agreement and README file.  It also contains about 25 megabytes of data and
software, so first fetch the README file and read it to decide what you
need.  If you only need the software, you should get one of

    SGI-Product-2.0.3.tar.Z
    Sun-Product-2.0.3.tar.Z

depending on the kind of hardware you have.

Turning on the software
-----------------------
If you already have a demo key from us, simply install the software
described above and copy the file $NVRHOME/adm/keys/demokeys from the
previous version into the same place in the new version.  Then type:

    % installkeys

This will give enable the software as before.  If you don't have a demo
key and would like one, please contact us at [e-mail].
---------------
internet: [e-mail]                                             c--Q Q
US:       Todd Brunhoff; North Valley Research;                         `
          15262 NW Greenbriar Pkwy; Beaverton, OR  97006                -
Phone:    [phone]
Fax:      [phone]


---------------------------------------------------------------------------

~Subject: How will I get the NVR-Software ?

From: Todd Brunhoff <[e-mail]>
Date: Tue, 18 May 93 09:23:26 -0700

The price list and text-only versions of our product sheets are available via
anonymous ftp to

URL=ftp://nvr.com/pub/NVR-data-sheets/
    [192.82.231.50].

Look in /pub/NVR-data-sheets.
If you need glitzy paper versions to convey credibility, we are
happy to mail our product sheets on request.

The demonstration software package comes in several pieces via anonymous ftp to

URL=ftp://nvr.com/pub/NVR-software/
    [192.82.231.50)

Look in /pub/NVR-software for the license agreement
and README file.  Briefly you will need:
    /pub/NVR-software/Manual.evenpages-1.0.2.ps.Z
    /pub/NVR-software/Manual.oddpages-1.0.2.ps.Z
    /pub/NVR-software/Product-1.0.4.tar.Z
    /pub/NVR-software/README
and some selection from
    /pub/contrib/mpeg and /pub/contrib/jpeg
depending on the kind of hardware you have.

If you get our software via ftp, send us an email note and we will give you
a demo license key so you can run it.
---------------
internet: [e-mail]                                             c--Q Q
US:       Todd Brunhoff; North Valley Research;                         `
          15262 NW Greenbriar Pkwy; Beaverton, OR  97006                -
Phone:    [phone]
Fax:      [phone]

---------------------------------------------------------------------------

~Subject: SUBSECTION - MacIntosh

---------------------------------------------------------------------------

~Subject: Cdi Tools v2.0

Cdi Tools v2.0 is a complete Cdi/Video CD Authoring solution targeted for
Mac C-programmer.
Contents of Cdi Tools are:
CDL - a real time scripting language
BD - disc image builder (630 MB cdi image with 25'000 assets was bildt in 7
min 40 sec.)
XLINK - MAC to OS9 cross linker
RTRView - utility for analyzing real time files
CDIView - utility for analyzing disc image files
Reference productions with Cdi Tools: Burn Cycle, Escape from Cyber City,
Video Speedway, Compton Encyclopedia, PGA Golf Tour

Pricing information:
MediaPlayback for PC/Mac                US$1,200.00
MediaPreview for Mac            US$3,995.00
MediaAuthor for PC/Mac          US$5,999.00

ALPHA MEDIA, Inc.
Media Integration & Consulting
Neubrunn, 8488 Turbenthal, Switzerland
Phone: [phone] Fax: [phone]
E-mail: [e-mail]

===========================================================================

~Subject: SECTION 3. - FREE AVAILABLE SOFTWARE

SUBSECTION - DOS
SUBSECTION - Windows
SUBSECTION - WINDOWS-NT
SUBSECTION - OS/2
SUBSECTION - X-WINDOWS and UNIX
SUBSECTION - VMS
SUBSECTION - MacIntosh
SUBSECTION - Atari
SUBSECTION - Amiga
SUBSECTION - NeXT
SUBSECTION - SGI

---------------------------------------------------------------------------

~Subject: SUBSECTION - DOS

---------------------------------------------------------------------------

~Subject: AMpeg

AMpeg  v4.3-- A simple Audio Mpeg Layer 1& 2 encoder and a Layer 1,2, & 3 decoder suite.

Source by ISO, compiled for MS-DOS by John Fulmer ([e-mail])

---


**Audio Mpeg Compression**

Audio Mpeg Compression is a proposed standardized sound compression technique put out by the International Standards Organization (ISO). So far there has been three flavors, Layer 1 Layer 2, and Layer 3.  It also features the following:

* 8:1 to 10:1 compression for general music audio with no audible sound degredation.

* 16:1 compression for general voice audio with no audible sound degredation.

* On the fly decompression and playback (the Xing Layer 2 player comes to mind).

* Xing also sells a Mpeg Layer 2 MCI driver for windows, and it's own encoder/decoder/editor package for windows.

*Will hopefully become a standard for audio communications.


**AMPEG**

Ampeg is a straight compile of ISO's freely available and distributed code for a Audio Mpeg Layer 1 and Layer 2 encoder and a Layer 1, 2, and 3 decoder. It was compiled using DJGPP C (the MS-DOS port of  GNU's C compiler) and falls under both IS0's and the FSF's copyrights (see ISOREL.txt and COPYING.TXT). ISO's orgional source code was only slightly changed to accomidate the DJGPP compiler's unique mindframe (a MS-DOS compiler that thinks it's a UNIX compiler, or vice versa). The orgional source code is a

vailable from ISO, or a affiliated ftp site, or the code for this version is available at the SIMTEL archive, or from me upon request. I've put minimal time into this, so don't expect perfection. It's just that no one else seems to have done the simple task of compiling this and releasing it in a usable form to the public.

AMPEG runs under MS-DOS and Windows (and probably OS/2), with minimal memory requirements. Also compatable with Xing's audio MPEG Layer 2 player for Windows.

The program is released as freeware and may be distributed freely, as long as this file, COPYING.TXT,  the Readme files, and all other documentation accompany it. If you don't like it, compile it yourself!

Note: This program had not been optimized in any way, and runs very slowly. For encoding, a 2MB file will take 5 minutes to process and a 20MB file will take at least an hour. Decoding is much faster but still fairly slow. However, I believe in the theory that a slow, free, useful program is better than no program at all.

**Directions**

AMPEG is made up of three components:

1) the aencode.exe program, which takes a PCM file (.WAV or .SND) and compresses it using Audio MPEG Layer 1 or Layer 2.

2) the adecode.exe program, which decodes Audio MPEG files into headerless PCM files (.SND). You can use a .SND to .WAV converter to reconvert the file to a .wav format.

3) the TABLE files, which both programs use to perform the MPEG compressions.

There are two ways of running aencode and adecode.

1) (RECOMMENED) just type AENCODE (or ADECODE) and the program will prompt you for whatever information it needs. This method is very solid and works nicely.

The possible options are:

Sampling Frequency  --> 44100(default), 48000, 32000
BitRate --> 64, 128, 256, 384(default)
Compression Layer --> 1 or 2


2) (NOT RECOMMENDED) type AMPEGIN (or AMPEGOUT) [options] <inputfile> <outputfile>. This takes the input file and applys the program defaults and produces the output file. THIS METHOD IS NOT RECOMMENDED AND MAY CAUSE YOU TO LOSE YOUR ORIGIONAL FILE! Only specifying the input file without the output file, will cause the input file to be erased! This is a bug due to the fact that this program was written for a UNIX environment and it's not worth it to me to hunt it down.


**Installation**

AMPEG needs to know where the TABLE files are. This is a pretty clunkly installation procedure, but it works....

1) put all non-text and non-executable files that were included in this .ZIP file into a directory by themselves called TABLESES.  Not good english, but necessary to get around a bug

2) AMPEG MUST BE RUN FROM the directory ABOVE TABLESES (ie, if TABLESES is located in C:/util/tables; AMPEG must be run from the C:/util directory).

3) Alternatively you can create a environment variable to point to TABLES. Add the following line to your autoexec.bat file:

SET MPEGTABLES = C:\<path>\TABLES

where <path> is the path to the TABLESES directory. It seems that AMPEG looks for a directory whose name get corrupted somewhere in the AMPEG code. So if you name the directory "TABLESES" AMPEG will find it if 'TABLES'  is in the SET statement, if you name it "CHAIRSRS" Ampeg needs to be told "Chairs" in the Set statement. Anyway AMPEG should now run.

**Changes since 1.0 (first and last version)**

*Changed version name to match ISO's version.
*Found decoder source with layer 3 decompression.
*decompression runs MUCH faster.

**Disclaimer**

I hold no responsibility for any damage, loss, or problems encountered in the use of this program. It is provided as-is, and there will be no future versions or bug fixes (unless ISO releases another).


John Fulmer ([e-mail])

---------------------------------------------------------------------------

~Subject: MAPLAYPC

MAPLAYPC v1.2
=============

DOS port of the realtime full quality mpeg audio player for 11/22/44 khz
playback on 486dx2 / p60 / p90 / higher + soundblaster 8/pro/16/awe.
Original sources included.

Get it now!. MAPLAYPC, the msdos (blech!) port of the famous MAPLAY program.
It's a realtime full-quality MPEG audio player for dx2-66 / p60 / p90 and
Soundblaster 8 / Pro / 16 / Awe .

On ftp.cdrom.com : /pub/demos/incoming/music/programs/maplaypc.zip

   teeri.oulu.fi : /pub/msdos/programming/incoming/maplaypc.zip

Done by MikMak / HaRDCoDE '95

---------------------------------------------------------------------------

~Subject: More MPEG-Audio for MSDOS
From: [e-mail] (Richie B)
Date: Mon, 26 Feb 96 22:38:59 MET

Hi there,

MPEG layer II is really great, but for poor MS-Windows users, all
it offers is the Xing shareware decoder. This decoder only plays MONO
sound at low (really bad) quality. Since I started using MPEG encoding
for my own site recently, I ported 2 freeware MPEG 2 decoder to MSDOS
(namely "maplay" and "mpegaudio"). They are at:

http://morra.et.tudelft.nl/~richie/ftp/sound/utils/
ftp://morra.et.tudelft.nl/pub/prince/sound/utils/

Perhaps they are of some use to you guys.

Richie

---------------------------------------------------------------------------

~Subject: layr_200

From: "Matthias Hanft" <[e-mail]>
Date:          Thu, 23 Jun 1994 18:10:28 +0200
Subject:       SUN and PC Version of MPEG Audio Codec Shareware

SOFTWARE: MPEG Audio Layer 3 Shareware Codec and Windows Realtime Player

----------------------------------------------------------------
MPEG Audio Codec and Windows REALTIME Player from Fraunhofer IIS
----------------------------------------------------------------

Fraunhofer IIS announces l3enc/l3dec V2.00 and WinPlay3 V1.00.

For high quality audio compression, the shareware l3enc/l3dec V2.00
package is available for Linux, SUN, NeXT and DOS on
<URL:ftp://ftp.fhg.de/pub/layer3>
Versions for SGI and HP will follow soon.

The shareware package for DOS
<URL:ftp://ftp.fhg.de/pub/layer3/l3v200d1.zip>
includes a demo version of WinPlay3, a Windows MPEG Audio Layer 3
realtime-player.

With MPEG Audio Layer 3 you can get a 12:1 compression with a CD like
quality.
Instead of 12 MByte / minute (stereo 44.1 kHz) you only need about
1 Mbyte / minute!

More information can be found on
<URL:ftp://ftp.fhg.de/pub/layer3/MPEG_Audio_L3_FAQ.html>
or contact <URL:mailto:[e-mail]>

---------------------------------------------------------------------------

Subject: MPEG1-IIS

Public C source code for MPEG1 audio decoder available now

The source code for the MPEG1 audio decoder layer 1, 2 and 3 is
now available on ftp.fhg.de (153.96.1.4).

There are two files:
   mpeg1_iis.tar.Z     (Unix: lines seperated by line feed only)
   mpeg1iis.zip        (PC: lines seperated by carriage return and line feed)

They are in the directory /incoming now but will be moved to the directory
/pub/layer3/public_c.

Please note that the public C code for the decoder is *not* identical to
the shareware provided by Fraunhofer IIS.

However we at Fraunhofer IIS did check that the layer 3 part of the public
C source decoder works correctly. (As usual this does not imply any
warranties).

[e-mail] (Harald Popp)

---------------------------------------------------------------------------

~Subject: mpeg2ppm

This is the MPEG to PPM converter running under DOS. Its based
on the MPEG-decoder called "mpeg_play" by the Berkeley Research
Group. The basic idea was coming from the PPM-patch by Jef
Poskanzer. Many thanks to both.

SHAREWARE
---------

MPEG2PPM is inexpensive shareware. If you are continuing using
it after a 30 day trial-period, please send a letter containing
the filled and signed registration-form and the little donation
of 10 $ or 15 DM in cash to the adress below.

ATTENTION: The dots the shareware version of MPEG2PPM produces
are just delay, to force you to register.

ATTENTION: A registration is recommended for commercial use.

ATTENTION: The full-licenced version is restricted to a local
           area netword (company) or a privat single host.

MPEG2PPM will  decode  a  (video-only)  MPEG-I-stream and
extract the rebuild frames as PPM-files (Portable Pixmap).
The  extracted  frames will be numbered starting from zero
(0), the first part of the filename is  derived  from  the
original MPEG-stream, the files extension will be .PPM.

The final PPM-files will be in 24-bit-format.

MPEG2PPM  expects  MPEG-1  video  streams only. It can not
handle multiplexed MPEG streams  or  video+audio  streams.
The  converter  uses  the  paris  entropy coding table set
(which I believe to be the MPEG-1 standard).

MPEG2PPM was developed by

PHADE Software
Inh. Frank Gadegast
Leibnizstr. 30
10625 Berlin GERMANY

[e-mail]

---------------------------------------------------------------------------

~Subject: vmpeg

VMPEG is now out in Version 1.5, Stefan sold the full version,
but the "Lite" version is still available to the public, he included
a nice button player interface, audio (!!), systemstream and CD support.
It's just the best MPEG-utility for the end-user ever seen, yo !

From: [e-mail] (Stefan Eckart)


                              VMPEG V1.2
                       DOS / Windows MPEG player
                           by Stefan Eckart

                            September 1994

1. Features
===========

 - full MPEG-1 video standard (ISO 11172-2): I,P,B frames of arbitrary size

 - plays system layer (ISO 11172-1) files (audio is discarded)

 - high speed: e.g. 21 frames/s on a 386DX/33 for a 160x120 I frame
               sequence (mjackson.mpg)

 - supports VGA and a variety of SVGAs

 - display options: 4x4 ordered dither normal size (8 bit)
                    4x4 ordered dither double size (8 bit)
                    grayscale (8 bit)
                    true color (24 bit)

  - requires:

    - '386,'486 or '586 processor (no '286)
    - 4 MB RAM
    - VGA or Super VGA
    - Windows version: Windows 3.1, Win32s and optionally WinG


2. Overview
===========

VMPEG is a fast decoder / viewer for MPEG encoded video sequences (.mpg
files). MPEG (Moving Pictures Expert Group) is a video compression algorithm
standardized by the International Organization for Standardization (ISO) and
the International Electrotechnical Commision (IEC) as ISO/IEC IS 11172. Main
application of MPEG is the storage and retrieval of video on/from Compact
Disk at a rate of about 1.5 Mbit/sec.

VMPEG can play MPEG system layer streams containing both video and audio.
Most streams from CD-ROM (Video-CD) are of this type. The audio stream is
discarded by the decoder. VMPEG automatically detects whether the file is a
video compression layer or a system layer file. I have also included a small
utility (MPGSPLIT) which extracts the video and audio streams from a system
layer stream into separate files (cf. MPGSPLIT.DOC).

The DOS version of VMPEG is compiled with the GNU C compiler (gcc) into '386
code and runs under the DOS extender GO32 by DJ Delorie which is included in
the archive file. The DOS version of VMPEG cannot be run from Windows.

The Windows version of VMPEG is the first release for Windows. It is not as
thoroughly tested as the DOS version but already seems to be reasonably
stable. Please feel free to report any bugs you encounter to my email
address. The Windows version requires Windows 3.1 and the free Windows
extensions MS Win32s (32 bit support) and optionally WinG (screen output
acceleration). These packages are available by anonymous ftp from (currently)

URL=ftp://ftp.microsoft.com:/developr/win32dk/sdk-public/Win32s115a.Zip
URL=ftp://ftp.microsoft.com:/developr/drg/WinG/WINGBT.ZIP

and perhaps somewhere on CompuServe.


3. Installation
===============

3.1 DOS version
---------------

- You need at least a '386 with a VGA and 512 KB of RAM. 4 MB are strongly
  recommended. XT, AT, EGA and CGA are not supported. A '387 is not required
  nor does it increase speed. VMPEG doesn't use floating point.

- You should leave about 2 MB of RAM (XMS) unused: if you have, say,
  a 4 MB system you shouldn't reserve more than 2 MB for a RAM drive.
  Otherwise the DOS extender would start swapping memory pages from and to
  disk. This would slow down the program, even if swapping to a RAM drive.

- If you have installed EMM386 make sure you don't have specified the
  'noems' option in your config.sys file.

- Create a subdirectory for installation:

  md \vmpeg
  cd \vmpeg

- Unzip the archive into this subdirectory:

  pkunzip -d vmpeg12.zip

- Edit VMPEG.BAT and VMPEG24.BAT; you probably have to change drive
  and/or path specifications and to select a suitable graphics driver
  (see paragraph 4).


3.2 Windows version
-------------------

- Install Win32s and (optionally) WinG. These packages come with their own
  installation instructions. Basically you have to run the setup program
  supplied with them.

  Installation of Win32s copies a couple of files (w32sys.dll, win32s.ini,
  win32s16.dll, winmm16.dll) to the Windows system directory and creates a
  WIN32S subdirectory with additional files. It also adds two entries
  (for winmm16.dll and w32s.386) to the system.ini file in the Windows
  directory. You can deinstall Win32s by removing these files and restoring
  your original system.ini file (saved in system.old by the setup program).

  Installation of WinG is optional. I have included two versions of VMPEG,
  one with WinG calls (VMPEGWIN.EXE) and one without (VMPEGNWG.EXE).
  The WinG version is faster, but the difference is only notable for
  large (CIF/SIF) MPEGs (may depend on your SVGA).

  WinG adds several files (wing.dll, wing32.dll, wingde.dll, wingdib.drv,
  wingpal.wnd, dva.386) to the system directory and adds an entry for DVA.386
  to your system.ini file. To deinstall WinG simply remove this entry from
  system.ini.

  If you start VMPEG (or any other program using WinG) for the first time,
  a performance test window appears which adapts and optimizes WinG for the
  VGA in your PC. This takes a while (about 3 minutes on my computer), don't
  despair...

- Create a subdirectory for installation:

  md \vmpeg
  cd \vmpeg

- Unzip the archive into this subdirectory:

  pkunzip -d vmpeg12.zip

  if you don't need the DOS version, you can delete vmpeg, go32.exe, the
  drivers subdirectory and the vmpeg*.bat batch files

- You can start the program (vmpegwin.exe / vmpegnwg.exe) either from the
  file manager or from the program manager (File->Run menu item) or you can
  define a program entry in the program manager (File->New menu item).

- both VMPEG and the Win32s libraries need a lot of memory (about 3-5 MB in
  total), and you may therefore have to increase the size of the swap file.
  4 MB of RAM are sufficient, however, to run the program without swapping
  (except during program startup).


4. Graphics Drivers (DOS version)
=================================

The DRIVERS subdirectory contains a set of graphics drivers for different
Super VGAs. Select the one that matches your graphics card by editing the
file VMPEG.BAT (for 8 bit display). If none of the drivers work, you may try
to use the (go32 internal) VESA driver and a TSR VESA BIOS extension. A
collection of such drivers is available at

URL=ftp://oak.oakland.edu/pub/msdos/graphics/vesadrv2.zip

and on all other SimTel mirrors.

True color support requires VESA BIOS. It works for my configuration (a
Cirrus Logic GD5422 based card with VESA BIOS) and should work for most other
'well behaved' boards as well. You may have to adjust the -y option in the
last line of VMPEG24.BAT. The number indicates the length of each scanline.
This is usually either 1920 or 2048. If the frames appear scattered over the
screen, the setting is probably wrong... If you get incorrect colors (red
sky, blue faces) you have a card with reversed RGB order. Simply replace the
-y... by a -Y... to fix this.


5. Troubleshooting
==================

DOS version:

If you get a message about the CPU not being in Real Mode, you have to remove
the noems option from the EMM386.EXE (or any other EMS emulator) line in your
CONFIG.SYS.

Windows version:

If you get the message 'Can't find WING32.DLL' you don't have WinG properly
installed. Either install WinG or use VMPEGNWG.EXE instead.

If starting VMPEGWIN briefly switches to text mode and displays the message
'This program cannot be run in DOS mode', Win32s is not installed properly.

If you get 'Out of Memory' errors, you have to increase the size of your
swap file (from the control panel).


6. Command Line Options
=======================

The following command line options are valid for both DOS and Windows
versions. To specify options to the Windows version, you have to run it
from the program manager (File->Run menu). Of course you can set all
these options interactively after starting vmpegwin (without command
line options).

  vmpeg [options] input.mpg
  vmpeg24 [options] input.mpg
  vmpegwin [options] input.mpg
  vmpegwng [options] input.mpg

options:

  -l  loop the sequence (infinitely until you press a key)

  -x1 skip B frames
  -x2 skip B and P frames, i.e. only I frames are displayed; you should
      use this option for I-frame-only sequences (including Xing compatible
      streams) to make the program run faster (as it doesn't have to manage
      reference frames)

  -d0 (default) ordered 4x4 dither
  -d1 grayscale
  -d2 similar to -d0 but display magnified by a factor of 2

      True color mode is selected by using vmpeg24 instead of vmpeg. In this
      case the -d switch isn't effective.

DOS version only:

  -in displace output by n pixel in horizontal direction
  -jn displace output by n pixel in vertical direction

      VMPEG centers the MPEG on the screen. If the frame is larger than
      the screen you can use the -i and -j options to pan the visible
      area. positive n shifts to the right or bottom, negative n to the
      left or upwards.

  -zn reduce display speed. This is done by a counting loop, so you
      have to experiment until you get the speed you want.


The program can be terminated by pressing an arbitrary key (DOS version).


7. Remarks
==========

Please report bugs (don't forget to mention which version of VMPEG you are
using!) to my email address:

  [e-mail]

or by mail to:

  Stefan Eckart
  Kagerstr. 4
  D-81669 Muenchen, Germany


8. Acknowledgements, Copyrights
===============================

This program comes without any warranty. Your are using it at your own
risk. VMPEG is copyrighted software (C) Stefan Eckart, 1994. You may
use, copy and distribute this program without restrictions but only in
unmodified form and without charging money for it.

GO32.EXE, DRIVERS\*.GRD:

   Copyright (C) DJ Delorie
                 24 Kirsten Ave
                 Rochester NH  03867-2954

These files are part of DJGPP which is available from

    host:      oak.oakland.edu (or another SimTel mirror)
    login:     ftp
    password:  send your e-mail address
    directory: /pub/msdos/djgpp

other DRIVERS:

 Copyright (C) 1991 DJ Delorie, 24 Kirsten Ave, Rochester NH 03867-2954
 Copyright (C) 1992 Csaba Biegl, 820 Stirrup Dr, Nashville, TN 37221

VMPEG:

The library VMPEG is linked with is

 Copyright (c) Regents of the University of California.

 acknowledgement:  ``This product includes software developed by the
 University of California, Berkeley and its contributors''

 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

The program is compiled with GNU GCC, the C compiler of the Free
Software Foundation (FSF), Inc. 675 Mass Ave, Cambridge, MA 02139, USA.
VMPEG does not contain code covered by the FSF General Public License.


9. Known Bugs
=============

Interframe coded macroblocks theoretically can experience wrap-around
(255<->0). This happens rarely enough to live with it (fixing would
reduce speed for all sequences).

Accuracy of the IDCT does not meet the requirements of IEEE 1180-1990. It is,
however, a reasonable trade-off between speed and image quality.

Display should be synchronized to the frame rate signalled in the sequence
header.

The program should use VESA BIOS supplied information instead of the -y
option.


10. References
==============

1. Coding of moving pictures and associated audio for digital storage
   media up to about 1,5 Mbit/s, International Standard ISO/IEC
   IS 11172, 1993.

2. Frequently Asked Questions (FAQ) of the alt.binaries.pictures
   and comp.compression newsgroup: contains an introduction to MPEG.

3. Documentation of the PVRG MPEG software: a thorough overview
   covering many aspects of MPEG.

4. Documentation of the MSSG MPEG-2 codec (mpeg2codec, see below).


Appendix A: Related Software
============================

This list is probably incomplete, but it's all I'm aware of. Of course
there are programs for other systems as well (Mac, Amiga etc.).

mpeg2codec     MPEG-1 and MPEG-2 codec from the MPEG Software Simulation Group
               Authors: Stefan Eckart, C. Fogg, C. Aeyung, S. Papuc
               Includes source code for Unix X11 and Windows (Win32s / NT)
               and compiled versions for PC.

URL=ftp://ftp.netcom.com/pub/cfogg/mpeg2/ or
URL=ftp://ftp.netcom.com/pub/cf/cfogg/mpeg2/

mpeg2play      a speed optimized version of the decoder from mpeg2codec

URL=ftp://ftp.netcom.com/pub/cfogg/mpeg2/mpeg2play/

mpeg_play      MPEG Video Software Decoder (Version 2.0; Jan 27, 1993)
               Authors: Lawrence A. Rowe, Ketan Patel, and Brian Smith
               Computer Science Division-EECS, Univ. of Calif. at
               Berkeley

URL=ftp://toe.cs.berkeley.edu/pub/multimedia/mpeg/mpeg-2.0.tar.Z

cmpeg          an MPEG encoder for the PC (DOS, 640K, no '386 req.)
               for Targa, PBMPLUS and Alchemy RAW images
               Author: Stefan Eckart

URL=ftp://garbo.uwasa.fi:/pc/graphics/cmpeg10.zip

dmpeg          MPEG decoder and player for the PC (DOS, 640K, VGA)
               Author: Stefan Eckart

URL=ftp://garbo.uwasa.fi/pc/graphics/dmpeg11.zip

mpegwin        Port of mpeg_play for MS-Windows
               by: Michael Simmons, [e-mail]
               toe.cs.berkeley.edu:/pub/multimedia/mpeg/Ports/mpegw*
               (HiColor & TrueColor support, Shareware)

mpeg.exe       DOS MPEG player from Xing Technologies (XingIt V2.1)
               (high speed, but decodes only a small subset of the
                MPEG standard, audio (.WAV,.MP2) support, Windows)
               mpegview.zip (available from many ftp sites)

MPEGv1.1/1.2alpha
               MPEG Software Encoder/Decoder
               Authors: Portable Video Research Group (PVRG)

URL=ftp://havefun.stanford.edu:/pub/mpeg/
    MPEGv*.tar.Z

disp
               a display program for pictures and animations
               including MPEG (based on mpeg_play)
               contains additional drivers that can also be used
               with VMPEG.
               Author: Jih-Shin Ho, [e-mail]

URL=ftp://NCTUCCCA.edu.tw/PC/graphics/disp/



APPENDIX B: MPEG files
======================

Two good sources for MPEG files:

  s2k-ftp.cs.berkeley.edu:/pub/multimedia/mpeg/movies
  havefun.stanford.edu:/pub/mpeg

High quality MPEGs you simply can't afford to miss:

  tennis.mpg
  flowg.mpg
  bike.mpg


--
Stefan Eckart, [e-mail]
Kagerstr. 4, D-81669 Munich, Germany.

Stefan Eckart, [e-mail]

---------------------------------------------------------------------------

~Subject: cmpeg

Stefan Eckart's CMPEG, another Freeware MPEG maker!

Here is another MPEG creator!   This one supports 8086+, so if you
thought you couldn't make MPEGs, boy were YOU wrong. :-)   Can make
Xing (I-frame) or normal MPEGs (which contain I, P & B frames, and
offer better compression).   Be full aware of the fact that the
slower your machine, the longer it will take to compress your files
into an MPEG animation (does this need to be said?).  (Don't expect
eyeball-charring performance from your 286, please..)

Due to its small size, I am offering CMPEG here at a2i.  Access info:

---------------------------------------------------------------------------

~Subject: dmpeg

Public Domain MPEG decoder by Stefan Eckart  June 1993

1. Features

DMPEG is another MPEG decoder/player for the PC:

 - decodes (nearly) the full MPEG video standard
   (I,P,B frames, frame size up to at least 352x288)
 - can save decoded sequence in 8 or 24bit raw file for
   fast off-line display (two pass mode)
 - optional on-screen display during decoding
 - several dithering options for 8 bit displays:
     ordered dither, Floyd-Steinberg, grayscale
 - selectable color-space
 - runs under DOS, 640KB RAM, no MS-Windows or '386 required
 - compact (small code / small data models, 16 bit arithmetic)
 - supports VGA, many Super-VGAs (including VESA) and
   some TrueColor SVGAs

DMPEG is both an MPEG viewer AND converter.  When viewing, it is important
to note that it is markedly slower than the Xing player.  That is, unless
you CONVERT the MPEG to DMPEG's proprietary RAW format.  You then use a
special player, included, which will show the RAW format animation on VGA,
SVGA, or VESA screens!  And, hey 286 users, this one actually works on
80286 machines (albeit a little slowly).

The converter does a remarkable job, and I use it for the "essential" MPEGs
that I would like to view at the highest speed possible.  If you have the
anim loaded in RAMdisc then you have a really nice framerate even on a
lowly 386!  :)   In the newly released 1.1 version, the converter and
viewer are now included in one executable.

It is important to note that this viewer will allow users to see MPEGs that
the Xing player will not.  This is because DMPEG is programmed to view all
3 frametypes, while Xing's player isn't.  If the MPEG won't view using
Xing, try this player, DMPEG.

---------------------------------------------------------------------------

~Subject: secmpeg

[ This is the README.DOS file out of the SECMPEG-archive. Read below in ]
[ the UNIX-section for more information about SECMPEG.                  ]

       SECMPEG is a program based on a rather  complex  algorythm
       to  ensure  a  confidentiality and a integrity service for
       the video-stream MPEG-I.


SECMPEG.ZIP (c) 1994 by Frank Gadegast and Juergen Meyer

This is my DOS-port of the MPEG-filter called "secmpeg".
Read the provided file README and the man-page first.

It was compiled with the DOS-port of the GNU GCC-compiler,
called DJGCC Version 2.4.1 and NDMAKE Version 4.5. So please
read the GNU-Licence-file 'LICENCE.GNU'.

You find the DOS executable in this distribution under
'secmpeg.exe'.


NEEDS and INSTALL

Cause of DJGCC, the final executable is not running under
DPMI (so not in a Windows-DOS-Box) nor on a 286-machine.

The executable 'GO32.EXE' has to be somewhere in the PATH.
If running on a 386, the emulationfile 'EMU387' has to be,
where the environment variable GO32 is pointing to, so if
the emu-file is in D:\LIB enter:

set GO32=emu d:/lib/emu387

       Permission to use, copy, modify, and distribute this soft-
       ware and its documentation for any purpose and without fee
       is hereby granted, provided that the archive remains  com-
       plete,  that  this author notice will appear in all copies
       and as long as you don't try to make money off it, or pre-
       tend that you wrote it.

---------------------------------------------------------------------------

~Subject: mpegstat

[ The first tool to test a MPEG-I-stream ! Including statistics, frame- ]
[ order, decoding times !! Now you can test, if archives are ok or if a ]
[ file uudecoded ok without playing it ! This code is surely based on   ]
[ the berkeley-decoder.                                                 ]


MPEGSTAT.ZIP (c) 1994 by PHADE Software

This is my DOS-port of the MPEG-filter called "mpegstat".

It was compiled with the DOS-port of the GNU GCC-compiler,
called DJGCC Version 2.4.1 and NDMAKE Version 4.5. So please
read the GNU-Licence-file 'LICENCE.GNU'.


NEEDS and INSTALL

The executable 'GO32.EXE' has to be somewhere in the PATH.
If running on a 386, the 387-emulationfile 'EMU387' has to be,
where the environment variable GO32 is pointing to, so if the
emu-file is in D:\LIB enter:

set GO32=emu d:/lib/emu387

That should do, KeyJ Phade ([e-mail])

---------------------------------------------------------------------------

~Subject: enc11dos

[ Well, and soon as it was out, I ported Berkeley's new MPEG-ecndoder ]
[ to DOS as well, here the README.DOS file. For more information see  ]
[ below in the UNIX-section.                                          ]

ENC11DOS.ZIP (c) 1993 by PHADE Software

This is my DOS-port of the MPEG-encoder called "mpeg_encode"
by the Berkeley Research Group.

It was compiled with the DOS-port of the GNU GCC-compiler,
called DJGCC Version 2.4.1 and NDMAKE Version 4.5. So please
read the GNU-Licence-file 'LICENCE.GNU'.


NEEDS and INSTALL

The executable 'GO32.EXE' has to be somewhere in the PATH.
If running on a 386, the 387-emulationfile 'EMU387' has to be,
where the environment variable GO32 is pointing to, so if the
emu-file is in D:\LIB enter:

set GO32=emu d:/lib/emu387

That should do, KeyJ Phade ([e-mail])

---------------------------------------------------------------------------

~Subject: pvrg MPEG

[ Well, this is just class. The Stanford-Codec is now available for ]
[ DOS-users. The file is usually called PVRGMPEG.ZIP, it supports   ]
[ IPB-Frames and Xing-Format ! Sometimes called MPGCODEC too.       ]

From: [e-mail]
Subject: PVRG MPEG CODEC
Date: 15 Jun 93 20:09:52 +0100

This archive contains the following files:

    README.1ST      This file
    PVRGMPEG.EXE    My port of the PVRG MPEG CODEC
    PPM2CYUV.EXE    My port of the PVRG YUV file splitter
    CYUV2PPM.EXE    My port of the PVRG YUV file combiner
    MAKEMPEG.TXT    Details of how I did the port
    USEMPEG.TXT     Details on using PVRGMPEG
    SHORT.MPG       A XING compatible version of short.mpg supplied
            by PVRG with the source code.
    SHORT*.GIF      The 10 frames in GIF format to make SHORT.MPG

I hope I have not offended anybody by putting this archive together. I offer
no warranty of any description with respect to my porting.

All of the EXE files were compiled by me from Publicly available source code
from the FTP sites listed in MAKEMPEG.TXT.

I would like to thank the PVRG group for writing such an excellent encoder
and for their help in getting at the Alpha release of v1.2 so quickly (I can't
name this person as the PVRG copyright notice forbids it). Also I would like
to thank Jelle van Zeijl for sending me the XING patch originally written by
Mats Loftvist which has subsequently been included the Alpha release of v1.2.

Have fun and please mail me to let me know how you get on. A copy of any
interesting movies would be appreciated.

This is the MAKEMPEG.TXT file from pvrgmpeg.zip it may help you port the PVRG
MPEG CODEC to your platform.

Hi All you Eager MPEG Makers, here is how to port the PVRG MPEG
encoder/decoder to DOS/PC (386).

Tools required:
    Well the ones that I used.

        GNU C version 2.2.2
        An uncompress util for UNIX .Z files
        An untar util for UNIX tar files
        Text Editor (sorry some code needs tweaked)
        Note: Diff from the GNU File utilities, could be used instead
Source required:
        1)
        /pub/mpeg/MPEGv1.2.alpha.tar.Z
            from havefun.stanford.edu

        /pub/mpeg/MPEGDOCv1.1.tar.Z
            from havefun.stanford.edu
            documentation still to be updated.

    2)      The DOS port of PPM2CYUV called ppm2cyuv.exe
    3)      Image Alchemy from a number of ftp sites.
            eg /mirrors4/garbo.uwasa.fi/graphics/alch16.zip
                at wuarchive.wustl.edu

Image Alchemy may be replaced with giftoppm.exe from the pbmplus set of
graphics tools.

Graham Logan
June 15th 1993
[e-mail]

---------------------------------------------------------------------------

~Subject: SUBSECTION - Windows

---------------------------------------------------------------------------

~Subject: CoolEdit 1.5.3

[ This is really cool ! MPEG encoding and decoding in a windows-tools. ]
[ Surely not it realtime, but it works ;o), check their site under     ]
[ http://www.syntrillium.com/#Cool                                     ]

----------------------------------
MPEG Layers I and II for Cool Edit
----------------------------------

The complete MPEG file filters for Cool Edit consists of the following:

   MPE.FLT      MPEG encoder
   MPG.FLT      MPEG decoder
   MPEG.DAT     MPEG related data (psychoacoustic models, etc.)
   COPYING.TXT  GNU General Public License document
   README.TXT   This file.

This MPEG implementation is covered under the GNU General Public License, so
the source code for Cool Edit's MPEG implementation is available upon request.
No special optimization was performed (which means it will be about 1998
before Cool Edit will be able to read MPEG II files in real time with this
current module on common PCs).

MPEG audio data is saved without any headers, and in Intel byte ordering format.
Some ShareWare (and retail) players are available that will play files saved
by Cool Edit.  The Xing audio player is one of them.

Happy compressing!!!

-David Johnston
 Syntrillium Software Corporation

---------------------------------------------------------------------------

~Subject: Maplay 1.2 for Win32

Maplay 1.2 for Win32 Last modified: Februrary 3, 1995

What is maplay 1.2?

Maplay 1.2 is a program written for UNIX systems by Tobias Bading. What it
does is decodes MPEG Audio Layer 1 and 2 files, which are factor of 6-12
times smaller than uncompressed audio (like Windows PCM WAVE, Sun AU, or
Mac AIFF files). Despite the huge compression, there is no audible signal
loss! You can retain CD-quality sound at compression ratios around 1:6 (128
kbit/s). Unfortunately, decoding MPEG audio streams is a very CPU intensive
process. And until now, there have been no fully-featured decoders
available for Windows.

What is maplay 1.2 for Win32?

Thanks to Bading's hard work in maintaining portability in maplay, I was
able to retarget maplay to run on the Windows 95 and Windows NT operating
systems. I also added a few features such as WAV playing, pausing,
stopping, and repeating MPEG audio playback. It took about 4 weeks, since I
had no prior Windows programming experience.

Doesn't XingSound do the same thing?

No. Compare the features in the following table:

 Program         L1  L2 WAV Bits/sample Sample    Stereo Win3.1 Win95WinNT
                                        freq.
 XingSound1      ?   YesYes 162         22.0 kHz  No     Yes    Yes3 Yes3

 maplay for
 Win32           Yes YesYes 16          44.1 kHz  Yes    No     Yes  Yes
1Freeware version of XingSound. There is a full-featured version, but it is
not free.
2Low precision
3Not a native 32-bit program

Should I even consider XingSound at all?

Yes. Maplay 1.2 for Win32 is recommended for 486DX2-66 or higher x86
machines (for stereo playback), running Windows 95 or Windows NT. It will
not run on Windows 3.1 or lower operating systems, even if you have Win32s.
It is also pretty CPU intensive due to its high precision and playing
frequency. Also, it does not work on 8-bit sound cards yet. Finally, unlike
XingSound, maplay 1.2 for Win32 cannot fast forward, rewind, or search for
tracks. If you need these features or don't have what it takes to run
maplay 1.2 for Win32, get XingSound (115k) instead. But if quality is a
priority and you have a 16-bit sound card and decent computer and
multimedia equipment, maplay is the way to go!

Cool. Where can I get maplay for Win32?

Maplay for Win32 is available here in following six flavors:
               With Source Code Without Source Code
 386 compatiblempw32-3s.zip     mpw32-3n.zip
 Intel 486     mpw32-4s.zip     mpw32-4n.zip
 Pentium       mpw32-5s.zip     mpw32-5n.zip
... Or from an FTP site to be announced later. E-mail me if you have
problems obtaining it. If you have a non-Intel CPU, choose the 386 version.
For my testers, these versions should be much smoother.

How do I use maplay for Win32?

Maplay for Win32 supports command-line playback, so you can associate MP2
or MPG files with maplay in the File Manager of Windows Explorer. You can
also use it as a viewer in Netscape. The MIME type is "audio", and the
subtype is "x-mpeg". Finally, you can use as a stand-alone program, as
there is a menu item to open files. Feel free to E-mail me if you need
further instructions.

How much does maplay for Win32 cost?

Nothing. Well, almost nothing. Of course you still have to pay for the
access time and the long distance charges to download it! I do request that
you e-mail me and tell me if it worked on your system. Also, your generous
donations are welcomed but not required.

Are there any bugs in maplay for Win32?

Well, as I said before, I'm new at Windows programming, so I'm sure there
are. But the following are the only bugs I know about:

   * Sometimes the shortcut keys don't work. You just have to use the
     mouse.

I'll work on getting rid of these bugs, and if you find any others, please
e-mail me.

Where can I get MPEG audio files?

Good news if you're into Japanese animation music because I've recorded a
number of MPEG audio files from my favorite anime. The Underground Music
Archive also has MPEG audio streams of unsigned artists. I'll list some
more sources shortly.

Credits

Well, I hope I'm not being to presumptuous by listing credits, but here
goes:

Original Source Code by Tobias Bading.
Copyright (C) 1993, 1994 Berlin University of Technology.
Win32 port and interface by Jeff Tsay.
License rights granted by the Free Software Foundation, Inc.
Academic (reduced price for students) C++ compiler sold by Borland
International.

Thanks to my computer science teachers and professors at Eastern High
School and UC Berkeley!

Need more information? Broken links? Comments? Please contact me at
[e-mail].

---------------------------------------------------------------------------

~Subject: WinPlay

----------------------------------------------------------------
MPEG Audio Codec and Windows REALTIME Player from Fraunhofer IIS
----------------------------------------------------------------

Fraunhofer IIS announces l3enc/l3dec V2.00 and WinPlay3 V1.00.

For high quality audio compression, the shareware l3enc/l3dec V2.00
package is available for Linux, SUN, NeXT and DOS on
<URL:<ftp://ftp.fhg.de/pub/layer3>
Versions for SGI and HP will follow soon.

The shareware package for DOS
<URL:<ftp://ftp.fhg.de/pub/layer3/l3v200d1.zip>
includes a demo version of WinPlay3, a Windows MPEG Audio Layer 3
realtime-player.

With MPEG Audio Layer 3 you can get a 12:1 compression with a CD like
quality.
Instead of 12 MByte / minute (stereo 44.1 kHz) you only need about
1 Mbyte / minute!

More information can be found on
<URL:<ftp://ftp.fhg.de/pub/layer3/MPEG_Audio_L3_FAQ.html>
or contact <URL:<mailto:[e-mail]>

---------------------------------------------------------------------------

~Subject: XingIt

[ This is Xing's new Public-Domain-Player. It is enhanced, but still   ]
[ has of bugs. You have to deinstall the old .DLL's and the MCI-driver ]
[ to have it running proper. The DOS-MPEG-Player included in this file ]
[ (named MPEGVIEW.EXE) doesn NOT run with all Soundblaster-compatible  ]
[ cards and kills the machine quit often.                              ]

         XingIt! MPEG Player Software Demo
               (August 27,1993)

The file MPEGVIEW.EXE installs Xing Technology, Inc.'s XingIt! MPEG
Player Software Demo for IBM PC compatibles. Xing's "XingIt!" real-time
video MPEG capture board, including encoding software, video and sound editor,
and the full-featured player is available direct from Xing Technology,
Inc. in Arroyo Grande, CA (See below for order info).

The file MPEGVIEW.EXE is a self extracting archive. To install the player,
create a new directory on your hard drive and copy MPEGVIEW.EXE into it.
Change to that directory and type MPEGVIEW to extract the player files.

MPEGVIEW.EXE also contains a DOS version of the player, MPEG.EXE.
To run the DOS version, change to the directory where you extracted