This archive contains my port (alpha version) to Windows NT(tm) and Win32s
of the berkeley Public Domain MPEG player.

WARNING this is code is very buggy so use it at your own risk.
Read all of this file before running the player.

I suggest that you close any running applications before running this player.

To run this program under Windows 3.1 you will need a copy the the Win32s
runtime this can be found in the Spice4?.zip files in the /pub/pc/win3/nt
directory on ftp.cica.indiana.edu.
It is also include on the October 92 Win32 SDK CD-ROM.

For Win32s+Window3.1 users I also suggest you restart windows and/or reboot
your machine after running the player.

This player can Play both Xing(tm) 160x120 MPEG movies and standard
320x240 encoded movies.

Note at present only the 24bit full color ditherer is implemented. This means
that dithering the image down to 256 or 16 colors is done via the Windows
DIB's driver. For best results you need either a 24bit or 15bit (hicolor)
graphics card. Using Hicolor mode gives much better images than the Xing(tm)
Player.
At present I am working on getting the other ditherers working.

This player has been run on the following two machines:

(1) OPTI 486DX33 with 8Mb,Trident 1MB Video card in 640x480x16 Mode,120MB 
    Hard disk and running Windows NT(tm).

(2) SMI 486DX33 with 8Mb,ATI 2MB ULTRA + in 800x600x65K Mode, 200MB Hard disk 
    and runing Win32s and Windows 3.1. 

It may not run on a machine with only 4Mb.

To install the player copy the files to your hard disk then create a new
program item by selecting the Program Manager File/New menu item.

There are two versions of the player included mpegplay.exe and mpegply2.exe.
mpegply2 is the same as mpegplay.exe but attempt to completly hog the cpu.
The machine will not respond to any input while it is playing movies.

To Play a movie perform the following:
(1) Start the player either from the NT command prompt or via the 
    Program Manager.
(2) Select the Open Menu item from the File Menu.
(3) type "*.mpg" into the file name dialog box.
(4) select the file you wish to play.
(5) Select Play from the Movie Menu
(6) The movie will now play.
(7) if you are running the mpegplay.exe player you may select Stop
    from the Movie Menu and then Open another movie for playing.
    Note - The player will Exit when/if it gets to the end of the Movie.


The "Actual Size" and "Stretch to Window" options in the Display Menu
determine whether the movie images are displayed as actual size (centered
in the middle of the windows client area) or scaled to fill the windows
entire client area.
The Player will also play as an Icon if Iconified.

This player is very easy to cash.

Some known Bugs are
(1) image is horizontally flipped.(Hey at least its not upside down!).
(2) Player will cash if another movie is opened while the current movie
    is playing.
(3) Stretch to window and Iconic play back modes are not functioning
    under win32s.
(4) The common dialog box file selection filters are not working.
(5) Fails to free memory after exit.


The file txtfiles.zip contains the original berkeley text files.
The original Unix Xwindows C source can be obtained by anon ftp from
toe.cs.berkeley.edu in the /pub/multimedia/mpeg directory

The following copyright message is from the original Mpeg players source code.

/*
 * Copyright (c) 1992 The Regents of the University of California.
 * All rights reserved.
 * 
 * Permission to use, copy, modify, and distribute this software and its
 * documentation for any purpose, without fee, and without written agreement is
 * hereby granted, provided that the above copyright notice and the following
 * two paragraphs appear in all copies of this software.
 * 
 * IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR
 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
 * OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF
 * CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 * 
 * THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
 * AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
 * ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATION TO
 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
 */

also
 
IN NO EVENT SHALL I MICHAEL SIMMONS BE LIABLE TO ANY PARTY FOR
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT
OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF I MICHAEL SIMMONS
HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
I MICHAEL SIMMONS SPECIFICALLY DISCLAIMS ANY WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
ON AN "AS IS" BASIS, AND I MICHAEL SIMMONS HAS NO OBLIGATION TO
PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.


The next release of this player should be much more stable.

Please send suggestions and comments to msimmons@ecel.uwa.edu.au

Windows NT(tm) is a trademark of Microsoft Corporation.
Xing(tm) is a trademark of Xing.