_______________________________________________________________________.
                        MODPlay v0.30b for GamePark32                  |
         Copyright (c)2002, 2003 by Christian Nowak <chnowak@web.de>   |
-----------------------------------------------------------------------'

      MODPlay is a media player for the music format commonly known as
      Protracker or Soundtracker MOD from the good old Amiga. The player
      runs at a clock speed of 66MHz, features a playlist, pattern view,
      ZIP archive (with mutliple files and directories) support as well 
      as direct loading from the SMC, scopes and an overall enhanced
      user interface. It has been written completely from scratch by me,
      except the code for unzipping the modules which was taken from the
      excellent zlib. Have a look at http://www.gzip.org/zlib/ for more
      information.
      The homepage of this player is http://chn.roarvgm.com/#gp32.
      
      
      You can load your modules directly from the SMC as well as from a
      ZIP archive on the SMC. The SMC browser starts at gp:\gpmm\mod\ 
      but there are no restrictions as to where and how many modules you
      can store on the SMC (or in the ZIP archive).
      
      !! Please note !!
      The player currently only supports MOD files in the original Pro-
      or Soundtracker format from the Amiga. Trying to load modules in
      a different format is very likely to crash the GP32.

_______________________.
      Loading from ZIP |
-----------------------'
      
      To prepare a ZIP archive for use with modplay, do the following:
      
       + Create a ZIP file which contains your modules. It can contain
         as many modules in as many directories as you want. The ZIP 
         must not contain absolute directories, only relative ones are
         allowed. The ZIP file's name must be modplay.zip.
       + Create a lst file from your ZIP file. The lst file acts as a 
         directory cache for the file requester. You can create this 
         file with the program "ziplist" from the command line as 
         follows:
         
           ziplist --infile modplay.zip --outfile modplay.lst
         
         The lst file's name must be modplay.lst.
       
       + Store modplay.zip and modplay.lst in "gp:\gpmm\" on your SMC.
       + You're done :)
       
      You need to update the lst file whenever you change the ZIP or 
      create a new one.
      
____________________.
      MODPlay Usage |
--------------------'
      
      To install the player on your SMC, copy modplay.fxe to the 
      directory "gp:\gpmm\". The free launcher is used to start it.
      
      When starting up, the player displays the playlist. From there,
      you can load MODs and edit, play and save the playlist. The button
      configuration is as follows:

       + B: Show the pattern view
       + DPad Up/Down: Select a MOD from the playlist
       + DPad Left/Right: Select an option from the menu above the list
       + Start: Pause/Continue playback
       + Select: Go to the currently playing MOD in the list
       + Left shoulder: Play previous MOD in the playlist
       + Right shoulder: Play next MOD in the playlist
       
      Above the playlist there's a little menu with the following 
      options:
      
       + Play: Load & play the currently selected MOD
       + Add: Add the currently loaded MOD to the bottom of the playlist
       + Del: Delete the currently selected MOD from the playlist
       + Move: Hold the A button and press up/down to move the currently
         selected entry in the playlist.
       + Loop: Hold the A button and press up/down to select how many
         times the MOD plays until the player skips to the next one.
       + Save: Store the current playlist on the SMC.
       + SMC: Load a MOD from the SMC.
       + ZIP: Load a MOD from the ZIP.
       + Blnk: Go to sleep mode. The playlist will continue to play.
         Press L and R to quit the sleep mode.
      
      When the pattern view is active, only the current MOD is played,
      the playlist isn't taken into account. The button configuration is
      as follows:
      
       + A: Show the playlist
       + B: Sleep mode. Press L and R to quit the sleep mode.
       + Start: Pause/Continue playback
       + Select: Load a MOD from the SMC
       + DPad Down+Select: Load a MOD from the ZIP archive (except when
         there is no lst and ZIP file)
       + DPad Up: Restart MOD
       + DPad Left: Jump to the previous pattern
       + DPad Right: Jump to the next pattern
       + Left shoulder: Mono
       + Right shoulder: Stereo
       + Left & Right shoulder: Reset GP32
      

___________________________.
      File Requester Usage |
---------------------------'

      The file requester for the ZIP archive as well as the SMC is the
      same. Its button configuration is:
      
       + DPad up / DPad down: Should be clear ;)
       + DPad left: Parent directory
       + A / DPad right: Select file or dir
       + B: Cancel
       + Left shoulder: Go to first directory entry
       + Right shoulder: Go to last directory entry
       
      When the file requester is active, only the current song is played
      without the playlist taken into account.
      
      
      That's all. Have a lot of fun!
      
      Greets go to Kojote (who finally got a GP32 :), Mr. Spiv, krb, Don 
      Miguel, Guyfawkes, hando, Inopia, Daemon, aj0, Peit(schi), _flow, 
      Mithris and Costis in no particular order.

      Special thanks go to Kojote for the GP32 icon and to Guyfawkes for
      checking this doc.
      
      If you need a collection of GP32 freeware, visit www.pdroms.de :)
      
      /chris

      chnowak@web.de
      http://chn.roarvgm.com/

      April 26, 2003 01:59:20 PM
