GEMP3 1.3 - An MP3 player for GEM
Copyright (c) Owen Rudge 2000-2001

GEMP3 uses DJGPP, a 32-bit programming system for DOS. It uses the Allegro
libraries, which manage sound and graphics and LibAmp, an MP3 playing system.

You can download Allegro source from www.talula.demon.co.uk. There is a link
to the LibAmp source on this site. You can download DJGPP from
www.delorie.com/djgpp/.

This software is licensed under the terms of the GNU General Public License.
See LICENSE.TXT for details.

You can download the source to GEMP3 from www.owenrudge.co.uk/GEM/.

OVERVIEW
========

This is my MP3 player for GEM. It requires a 486 or better processor, as it
uses DJGPP. The interface has been partly rewritten from version 1.1. It may
look similar but internally it is quite different. I have thrown the text
window routines out of the window (pun not intended) and Heinz Rath has
written some new, movable, redrawing window code, complete with buttons. IT IS
NOT COMPLETE AT THE MOMENT, but I decided to release it as this version of
GEMP3 includes a few enhancements.

This release contains a new graphical representation of the current MP3, but
it's too slow when the mouse is on screen. To enable it, edit GEMP3.CFG
and change the Active= option to 1. Change back to 0 to disable.

This release also contains a German translation of GEMP3 by Heinz Rath
(www.geocities.com/heinz_rath/). Thanks! See below for more details on
the multi-language support.

There are also a few bug fixes and other minor features in this release. When
you click on the window, it activates it. Previously, this didn't work. Also,
I've fixed a major bug where if you double-click an MP3 in a directory
different to the one GEMP3 is in, it crashes horribly. Lastly, in the
source code there is an optional #define of CHANGE_PALETTE. If you add
#define CHANGE_PALETTE to the top of the file and recompile, you will
find the button looks nicer, as two colours in the palette have been
changed to make a light yellow and lighter medium blue.

Sometimes when you move the window, the desktop turns blue. This is probably
a bug with changing colours and not putting them back or something. Also,
sometimes the window seems to invert some of it's colour, and you end up
with a dark red background. In the final release of the new window code,
the buttons should look like standard FreeGEM buttons (3D, with
user-definable colour). I decided to set the window's background colour to
cyan.

The other newish feature is a Convert to WAV function that lets you convert
MP3s to WAV format. There is also a small GEMP3 logo in the corner of the
GEMP3 window. Please note that you should no longer get 'unable to find
GEMP3.DAT' messages.

I've also added multi-language support. This release contains a small
program, SETLANG.EXE, that starts GEMP3.APP with the /SELLANG parameter.
This starts a small DOS program that displays a list of languages and
lets you choose one.

To use the MP3 player, run GEMP3.APP from GEM. It is recommended you put this,
GEMP3.DAT, LANG.DAT, GEMP3.CFG and GEMP3???.RSC in your GEMSYS folder or
another folder on the path. You may want to associate MP2 and MP3 files with
GEMP3. GEMP3 will also play WAV files encoded with the MPEG Layer 3 codec,
but not any other type at present. Replace the ??? in GEMP3???.RSC with the
language ID you want (see LANG.DAT and the @0 entry for the language you
want).

INCLUDED FILES
==============

*.H          GEM headers, text window header (TW.H), GEMP3 header (GEMP3.H),
             LibAmp header (LIBAMP.H) and language header (LANG.H)

LIBAMP.A     The LibAmp library.

LANG.DAT     Language data file

GEMP3.CC     GEMP3 main module

GEMP3.DAT    GEMP3 logo

GEMP3.CFG    Configuration file

MP3PLAY.CC   MP3 player object (from SETEdit, and modified for GEMP3)

GEMP3RSC.*   GEMP3 resources

GEMP3GER.RSC German resources

TEST.MP3     A sample MP3

SETLANG.EXE  Small DOS program that starts GEMP3.APP /SELLANG

SETLANG.C    Source for SETLANG.EXE

GERMAN\*.*   German resources (*.DFN, *.H, *.RSC etc)

BUILDING THE SOURCES
====================

To create GEMP3, make sure you have DJGPP, the GEM library and Allegro
installed. If you are sure these are present, run MAKEIT.BAT.

OTHER INFORMATION
=================

Please send any comments or bug reports to me at orudge@freeuk.com.

Enjoy!

Owen Rudge
13th January 2001

http://www.osplus.co.uk/
http://www.owenrudge.com/
http://www.owenrudge.co.uk/
http://www.transporttycoon.uk.tt/
