GPoke - CD+G Player for GP32 test release                        June 1st, 2003
===============================================================================
                                     by Pawel Szymczykowski (pawel@makenai.net)

Description
-----------
This is a simple little test program I made to display CD+G data on the GP32.
It's nothing special, basically, it just displays the graphics as it reads them
out of the .CDG file on the fly. At this moment in time, it is lacking a couple
features included in the CD+G standard, notably, Scroll Copy and Scroll Preset
- this shouldn't really cause any big inconvenience, so far I have never come
across a CD+G that made use of them - hence the reason for their omission.

Also, and more importantly, music is not supported. I would love to get this
to work with MP3 files, but am not myself quite up to the task of porting over
an MP3 library to the GP32. If one should make its self available however, I 
will be sure to jump right on it!

This program was created using information provided by Jim Bumgardner in his
document 'CD+G Revealed' (http://www.jbum.com/jbum/sware/cdg_revealed.txt)

The complete sources should have been included in this archive - they are being
released under the GNU General Public License (see gpl.txt, also included). In 
addition to my code, the sources include a file requester module written by 
Christian Nowak, which was also released under the GPL.

Usage
-----
Basically, in order to get any usage out of this program, you will need a .CDG
file.  A CDG file is essentially a dump of the subcode data for a single CD+G
compatible CD track. There is a great deal of information on how to extract
this CDG information at Karaoke Playground (http://www.karaokeplayground.co.uk/)

Additionally, you can get sample CDG data files from Power Karaoke, makers of
some nice CD+G Authoring software on their website at: 
http://www.powerkaraoke.com/src/download.php

Your .CDG files go into gp:\GPMM\CDG\ and gpoke.fxe goes into gp:\GPMM\ - from
the file requester, 'A' selects and plays a .CDG, and 'B' exits. There are no
keys during playback.

Todo
----
* Accurate timing. At 75 sectors per second on audio CD, and 4 subcode packets 
  per sector, 300 packets (and thus 300 CD+G instructions) should be read 
  every second. Right now it is pretty much just winging it.. it would become
  a moot issue once some sort of MP3 support was implemented though, so no
  attempt at accuracy is being made at the moment.

* The two missing functions, if someone has a CD+G where the entire screen
  seems to scroll around, please let me know!

* Sound of course.. it might be a while though.