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).

popp@iis.fhg.de (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

phade@powerweb.de

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

~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: stefan@lis.e-technik.tu-muenchen.de (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/
URL=ftp://ftp.microsoft.com:/developr/drg/WinG/

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:

  stefan@lis.e-technik.tu-muenchen.de

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/

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/

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

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

mpegwin        Port of mpeg_play for MS-Windows
               by: Michael Simmons, msimmons@ecel.uwa.edu.au
               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, u7711501@bicmos.ee.nctu.edu.tw

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
  ftp://havefun.stanford.edu/pub/

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

  tennis.mpg
  flowg.mpg
  bike.mpg


--
Stefan Eckart, stefan@lis.e-technik.tu-muenchen.de
Kagerstr. 4, D-81669 Munich, Germany.

Stefan Eckart, stefan@lis.e.technik.tu-muenchen.de

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

~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 (phade@powerweb.de)
 
---------------------------------------------------------------------------

~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 (phade@powerweb.de)

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

~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: glogan@taynet.co.uk
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
glogan@taynet.co.uk

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

~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
ctsay@pasteur.eecs.berkeley.edu.

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

~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:layer3@iis.fhg.de>

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

~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