
                           \||/
                      ___ (o><o) ___
             _________UUU\oo/UUU______________
             / \/ \    \    \    \    \    \ \/ \
             \_   /  \_/_ \_/ /__/  \_/  \_/ /\ /
             / \  \  / \ \  \ \  \    \  / \  / \
             \Y___/e___/s___/C___/R___/E___/W___/
             ======================================
                   ****  GemPLAY Player  ****
   
  
 GemPLAY is GEM player for various modules formats:

*.ACE (Ace tracker modules - 16ch, depends on CPU power)
*.MOD (Noise tracker modules - 4,6,8)
*.GT2 (Groumf tracker v2 modules - 32ch, depends on CPU power)
*.AON (ArtOfNoise tracker modules - 4,6,8 ch)
*.SND (SNDH songs.. Currently only Timer C songs are supported, non
       Timer C song load with a warrning and dont play automaticaly
       u have to  risk that by yourself :))  Timer C is always used
*.XMS (XLR8 songs. This was added more as curiosity as real feature
       and its a little unstable if u load many tunes. Original XLR
       replay routines also do not play SID sounds!??)  Also,  XLR8
       replay routines uses VBL syncing, so replay speed depends on
       vertical refresh rate.

 GemPLAY is full GEM application with GUI dialogs in windows. Works
in  MiNT/Magic/TOS (not tested in Geneva) and use AVSERVER protocol
extensively...



 Buttons in GemPLAY from left to right:


 - Quit   : This button actualy quits the application, while window
           closer only close main dialog.

 - Target : This is multi-option button and its function depends on
            player currently active.

 - Load   : Load new song

 - Rwd    : Rewind in GTK mode, multi-function button in other mode

 - Play   : Play

 - Fwd    : Forward wind in GTK mode, multi-function button in other
            mode

 - Pause  : Pause

 - Stop   : Stop


 Description of multi-function buttons:


  Fast Forward/Rewind  buttons. Apart from GRAOUMF mode, where they
actualy FWD/RWD module, FWD/RWD buttons are used for diferent tasks
in other GemPLAY modes:

 - SNDH: In SNDH mode FWD/RWD buttons are used to scrol up and down
   thru subtunes if song is multipart.  At bottom of the display 32
   icons represent subtunes in song.  By clicking  on those you can
   jump to desired subtune.  If you click on currently playing tune
   Intro mode is toggled on/off (I) appears in status display

 - MOD: in this mode FWD/RWD  buttons are used to scroll instrument
   list (info block) up and down.

 Target button (second from left) act as some kind of multifunction
switch. Shortcut is CTRL/O. With this button u can switch:

 - SNDH: In this mode Target button switch Intro modeON/OFF. That's
   mainly usefull on CT60,  as o6o caches makes some tunes to sound
   odd. Caches are switched off automaticaly if u stop or switch or
   load new tune. Thats because caches off affect system a lot! (*)
   apears in status display if caches are OFF.  Caches stays off if
   tunes switch in Intro mode. You can toggle caches by clicking on
   status display Cache icon as well. (C) means caches are ON.

 - ACE: Delay uses a LOT CPU time, so ACE Delay can be switched OFF
   with Target buton. (D) apears in status display to indicate that
   Ace Delay is ON . Same effect you also get  if u click on status
   display Delay icon.

 - MOD:  Target button toggle between SURROUND  nd INTERPOLATION in
   DSPMOD mode. (S, I and S+I) apears to inidicate current mode. Or
   you click on status display (S) or (I) icons.

 As not all buttons work in all modes, there is indicator of active
buttons in each mode.  If button is active, small mark appear above
button.


 GemPLAY modes:


  GemPLAY has two play modes, normal mode and Intro mode, which atm
is only enabled in SNDH mode.  In Intro mode, multipart songs plays
each song for  about 15 seconds and then skip to another.  Any user
action switch Intro mode off.


 Other options:


 Info menu option (CTRL/I) is used to display song infos.  Espcialy
Art Of Noise tunes  can have big info blocks,  so this option calls
AVSERVER, which opens your prefered text editor and display info in
editors window. If editor is not set or Info is called in TOS, file
is saved in CLIBOARD.

 Spech menu option (CTRL/T) is fancy talk mode ON/OFF.  When active
it uses STSPEECH to communicate with user.  This mode is completely
useless, but it is quite funny! In status display, speech status is
shown and toggled with last icon, it can be (S) or ( ) respectively


 GP2ACC:


 GPACC is very minimalistic ACC player, using  GemPLAY  engine. Use
with caution,  we won't  be held resonsible for any potential crash
or dataloss as, locking of DSP & Sound system is a bit quirky. Also
you  **must** create  GEMPLAY folder on your boot partiton and copy
PLUGINS folder in it. Without that, GPACC will not work.



  Known problems:


 - Button highlightning, when loading file via AVSERVER, don't work
   so either wrong buttons are highlighted or none.. Need some more
   insight in GEM :)

 - FWD/RWD is  enabled for GRAOUMF modules,  but in MiNT that works
   shaky....

 - Seems there is a problem with GT2 replay on  CT60+Phantom  board
   This is probably due to DSP clock problem... One of solutions is
   to add 50MHz oscillator for DSP.

 - ACE Delay ON/OFF work, however when delay is switched off, music
   stop as well.  It probably is feature of ReplACE replay routines
   WARNING Switching caches OFF (SNDH) will drasticaly decrease 060
   performance! Because of that whenever "STOP" button is presed or
   SNDH tune is reloaded, caches switch back ON.  Same happens when
   you quit GemPLAY. Also a "(*)"  will occur next to "USE: player"
   to indicate caches are OFF.

  ToDo list:

 - Playlist?

							                      
  Credits:
  
  GemPLAY Shell.........................................SWE/YesCREW
  ACE.replay routines................................Thomas/NewBeat
  MOD.replay routines........................Bitmaster/TCE+Evil/DHS
  GT2.replay routines..............................Laurent de Soras
  AON.replay routines.....................................TaT/Avena
  SND.replay routines....BDC/Aura+Ozk/Assemsoft+Evil/DHS+Grazey/PHP
  XMS.replay routines....................................Iso/Sentry
  GUI.Design........................................C-REM/MJJ Proud

 BIG THANX to Grazey/PHP,  for finding problem with SNDH v2 archive
and Evil/D.H.S. for help, especialy with GFA wrappers!!

  Included tunes:

  ACE:400.Beats......................................Thomas/NewBeat
  MOD:Glutamin.Extended........................Toodeloo/DHS/YesCREW
  GT2:YesCREW.Theme............................Toodeloo/DHS/YesCREW
  AON:DNA.Warrior........................................Lego/Twice
  SND:Spunge........................................Per Almered/XiA
  XMS:Enchanted.Lands....................................Iso/Sentry

  NOTE:
  
 GemPLAY  needs  Falcon030 computer and atleast 4MB of RAM. We also
don't take any  responsibility  for your hardware  or ears damage!!
Use GemPLAY at your own risk. U HAVE BEEN WARNED! ;))

							
                             *********


http://yescrew.atari.org...............................YesCREW.Page
swe@atari.org / jvalant@atari.org..............SWE's.email.address