xine MCD rc2

About xine
----------

xine is and video player.  It was originally written for Linux and supports
many formats, from MP3 audio to DVDs.  It is considered one of the two
best video players for Linux.  In time, I hope all formats supported by
Linux will be supported by xine.

xine usually comes as a stand alone player.  xine MCD is a special version
that installs as part of the OS/2 Multimedia system so that most
applications that played video files through MMOS/2 before can be used to
play videos through xine.

Installation for new users
--------------------------

0. The emx run type library is required.  It is available here:
http://ftp-os2.nmsu.edu/pub/os2/dev/emx/v0.9d/emxrt.zip

1. Unzip the archive into a directory.

2. Run Multimedia Application Install.  In OS/2 Warp 4 this is in the
Install/Remove folder of the System Setup.  You can also execute it by
typing "minstall" from the command line.

3. Select the directory you uncompressed the archive into.

4. Click the Install button.  If it crushes with a SYS3175 try again, but
move the window part way off the screen before pressing the Install
button.  The xine files will be stored in the \MMOS2\DLL and \MMOS2\XINE
directories.

5. DO NOT open Multimedia Setup before rebooting.

6. Reboot.

7. Open Multimedia Setup. In OS/2 Warp 4 this is in the System Setup.

8. If installation was successful you should now have a tab labeled xine.
If you have another video player you may have to remove the file
associations from it before you can add them to xine.  To do this click on
the tab for the other video player and click the plus or press Page Down
to see what associations it has and remove them.  Sometime the Remove
button will be greyed out even if you've got one selected to remove.  What
you can do is add a random type or extension and the Remove button will
activate.  You can then remove the one you just added and any others you
want.  Once you got all the type and extensions associations removed from
your old video player you can go to xine tab, go to the next page and add
associations for the MPEG type and add the extensions MPG and any other
extension that you have for movie files.

9. Reboot.

xine MCD will now be used play any MPG files on your system.
From the Workplace shell you and use Open as|Play (the default). 

The only formats that I expect will work are MPEG-1 and MPEG-2 videos.
MPEG-4 video and MP3 audio might work.

Problems
--------

While video files will work with Open as|Play it will not work with Open
as|Player.  If you run the Player without first running Play the WPS will
crash because of an problem initializing the EMX library when using the
Player.  If you did get Player to run it will play the video, but will get
into an infinite loop when the video ends.  Not to toot my own horn, but I
recommend using Normal Player.

If you're having a problem with xine MCD please email me at the address at
the end of this file.  Please give me the steps you took that caused the
problem.

You should be aware the the time I have to work on xine is very limited
and sporadic.  If you find a problem it could be a very long time before I
get around to fixing it.  Luckily xine is open source software, so other
people can work on it, even if I can't.

Links
-----

xine MCD for OS/2 Homepage (the source code will be here):
http://doconnor.reamined.on.ca/xine/

xine Homepage:
http://xinehq.de/

Normal Player:
http://doconnor.reamined.on.ca/nplay/

Darwin O'Connor
doconnor@reamined.on.ca
