             ____________________________________________________            
              ___     ___     ___     ___             ___     ___
             (  __ . (   ' . (___) . (   ) . (   ) . ( | ) . (___
             (___)   (       (   )   (___)   (___)   ( | )   (
              ____    ___     ___     ___     _  _    ___     ___
                )  . (   ' . (___) . (     . (__/  . (___  . (   
                )    (       (   )   (___    (_ \_   (___    (
                        ___  ___        ___  ___   ___
                     / (___ (___) (    (    (   ) (   ) \ 
                     \ (    (   ) (___ (___ (___) (   ) / v0.8777
             ____________________________________________________
       
              A 32-voice DSP soundtracker for the Atari Falcon 


                 Further development by the Graoumf Devteam:-
                  
               sjx of Vectronix      sjx.vectronix@hushmail.com
               Lonny L. Pursell
               SWE		     swe@atari.org

               http://privatewww.essex.ac.uk/~smooreg/graoumf/

  Based on the sources of Graoumf Tracker v0.8771 by Laurent de SORAS ~ 1997


                               Release Notes 
0.8801 - Catched a bug which caused that GTK saved broken files. ATM only
	 GT2 format is saved, plan is to catch all bugs.. In GEM mode u can
	 now double click module and it will load and start to play, auto-
	 play also work for "LOAD MOD" GEM menu, was a bit annoying to start
	 that manualy. Just set GTK as player for gt2,gtk,mtm,dtm,ult,xm,s3m
	 mod files in Thing or JInee and that is. 
	 
	 Also i changed colour scheme, there was a lot of demands for that :))
	 
	 THX Lonny Pursell for va_start routines and help!
                              
0.8779 - Managed to use MXALLOC on machines with FAST-Ram. MALLOC is used
         on ST-Ram only machines. FAST-Mode request is now activated with
         both mouse buttons simultaneously. Quit dialog now offer backdoor
         to GEM, very handy in mtaskinng OS-es! Also GTK can now be started
         from UnixFS (minixFS/ext2FS) partitions and behave ok in MiNT as
         well. Maybe FAST-Mode and GEM backdoor should get own buttons on
         GTK main screen? Ah almost forgot, Laurent checked mouse key and
         coordintates for EACH button separately... i moved all coordinate
         checks in one general mouse button check, so in main loop now
         only button status is checked once.. if that meet, coordinates 
         are checked..
         
         GTK has now some kind of "Remote Controller". When u are in GEM
         mode(temporary in GEM), there is menu with Play/Stop, Load/Save, 
         Return to GTK/Quit GTK and Switch Replay Frequency options. So u
         may use it easily as some kind of player, with tracker interface 
         waiting.. Its wise to setup MAXMEM in MinT or Magic, otherwise
         GTK is greedy and take all RAM. Thats not so important in SingleTOS
         ;)) Or u may set how much memory will be left to system in
         /SYS/GTKPREFS.INF. (u need to save it 1st! Sample file is included)
         
         2 annoying bugs remained.. One cause mouse leaving a trail if GTK
         was started in 256c mode. Other one ocasionaly cause Taskbar
         gets a bit confused.. Restarting Taskbar fixes it...

0.8778 - Changed some IF loops with CASE to gain a bit CPU time. Fixed
	 ugly looking LOAD/SAVE screen (overwritting of status line).
	 Added semi FAST-Mode and also support for later "FASTEST-Mode"
	 with enabling "turbo blanker" Fast mode selection is atm binded
	 to ESC key.

0.8777 - Slightly improved memory allocation. It still needs attention.
         It doesn't use RESERVE - or undocumented system call GEMDOS 21 -
         anymore!
         
         It still cannot use TT RAM. Sorry. My Falcon doesn't have any
         and I can't test it, but more to the point, when I tried using
         Mxalloc, GFA threw a major wobbly. I will investigate - next
         version ought to be TT RAM ok, but this one isn't.

         Now changes back to GEM's resolution to use the fileselector.
         Minor disadvantage: No caption. I'll fix this in the next release
         but I have no time now, if you want a version before May. :)
         Major advantage: Now locks the screen with the AES (kinda badly,
         but it'll do for now). This means Graoumf can finally run under
         MiNT/N.aes 2.0.0 (tested). Although, you'd better have a really
         fast Falcon, because when I tried it, it was a little... shall
         we say, unresponsive. (N.aes's keyboard routines?) :)

         Volume slide can now optionally have a keyboard shortcut (see
         the prefs file).

         number_of_lines in the prefs file can be set, this indicates
         the default number of lines given to a pattern when right-
         clicking on the lines box or when right-clicking on the
         insert pos buttons (which makes a new pattern for you).
         
         se_revbuffer defaults to FALSE, TRUE is old behaviour. With
         it set to FALSE, the sample editor comes up and exits MUCH
         quicker than previously, although it's not heavily tested
         (there may be some side-effects). Haven't seen any in the
         ten minutes' testing that feature's had though. ;)

         I've included my preferences file (properly, this time) as
         GTKPREFS.SJX if you want to see what I use, or tweak it. :)

         Released 15th April 2000. -- /sjx.

0.8776 - Lots and lots of bugfixes, mainly typos but also other, serious 
         bugs. Most notably -- Graoumf now actually saves envelopes, making 
         them usable, at last! :)

         Additionally, two new preferences were added to the GTKPREFS.INF 
         file:

         grmode_preserve - default no - If set to yes, causes Graoumf not to 
         change the resolution. This does mean Graoumf should be started in a 
         suitable resolution (at least 640x200, 16 colours).

         grmode_skipxbra - default no - If set to yes, Graoumf does not 
         attempt to remove NVDI and some screen expanders from the vector 
         chain.
         
         Changing these both to yes and running Graoumf from the correct 
         resolution seems to make it more stable, although it's worth 
         pointing out that Graoumf absolutely hates NVDI. I'm looking in to 
         this problem, but I think it's the memory allocation.
         
         Incidentally, I had a little more success with this under N.aes,
         in fact it actually runs now, although the mouse clicks "fall 
         through" the graoumf screen. I shall look into adding code to lock 
         the screen with form_dial; if that improves the situation, Graoumf 
         may start to become more stable under MiNT, although it still does 
         not seem to like memory protection much. Your Mileage May Vary.
         I'd be interested to hear how you get on. -- /sjx.

0.8775 - Looks like 0.8770 sometimes messed up saving modules. I've observed 
         gt2 modules with one too many byteswaps, swapping the first and 
         second letter of the chunk header. The net effect of this was to 
         cause 'ASMP' chunks to be written instead of 'SAMP' chunks. 
         Curiously, 0.8770 would load these without problem, but 0.8771 would 
         not. I've added a workaround - once a damaged module is loaded, it 
         will be corrected, so just save it back again. -- /sjx.

0.8774 - Added full support for loading modules from Octalyser - 4, 6 and 8 
         channels, and at 16KHz, 20KHz, 25KHz basespeeds (which would 
         previously crash). Unfortunately I don't have the exact basespeeds 
         used by Octalyser, and in any case they varied by a small amount (if 
         you were using a UCDM, the frequencies were slightly lower). 
         Octalyser modules may thus need a little manual correction, but they 
         will at least load OK. -- /sjx.

0.8773 - Crash (4 bombs) on loading unknown module type corrected. It turns 
         out that a GOTO to an undefined label isn't flagged by the compiler,
         it just compiles into a 'jmp 0' instruction. This is a Bad Thing,
         and definitely something to look out for in the future. -- /sjx.

0.8772 - Registration legacy code removed, is now fully functional without a
         key file. -- /sjx.

0.8771 - The year is 2000; Laurent de SORAS finally releases the full source
         code to Graoumf Tracker. [ In other news, hell freezes over. ;) ]
         Changes between 0.8770 and 0.8771 are not known. Freeware.

0.8770 - Last known binary release by Laurent de SORAS. Changes from this to 
         previous versions are covered in the original documentation 
         WHATSNEW.TXT and will not be duplicated here.


                                Known Bugs 

- Song2disk nonrealtime (monitor off) freezes. Am trying to
  find the cause of this.
- The delay settings are sometimes strange on startup. These
  strange settings may cause the delay routine to emit 2 bombs.
  This is being fixed, but for now, just select one of the presets
  before you use delay.
- Graoumf's memory allocation doesn't suck as much, but still
  needs attention sometimes.
- When changing resolution, parts of the destination screen
  are sometimes cleared. This seems to be the XBIOS 5 call
  itself, unfortunately. Investigations continue.
- Graoumf doesn't like MiNT too much, especially with memory 
  protection, but this isn't as bad as it used to be.
- Graoumf dislikes long filenames sometimes. In any case, it doesn't
  run in the MiNT domain.
- Graoumf hates NVDI. Causes mouse dropping and short sharp buzzes
  in long samples (which turn out to be corrupted). I'd love to
  find out why...
- Lots of problems with 16-bit samples, particularly with extra fine
  sample offset, and "clipping" - the latter caused by malloc. Again.
- Two sources included: SOURCES.OFF (official - doesn't make any sound)
  and SOURCES.NEW (unofficial, patched, but slightly earlier version).
  I will give the replay sources attention in time for the next version!
  
  To do: Rewrite the rest of the memory handling functions.


                             Planned Features 

- Corrections for all the above bugs! :)
- Faster replay routines.
- Save as XM? Would be useful...
- (Partial?) support for mods saved by Graoumf Tracker 2 (pc version)?
- Filters (esp. resonance + low-pass) and synths in the sample editor?
- Loading (+saving?) Impulse Tracker? (.IT)
- Loading and saving Impulse Tracker instruments?
- Realtime filters  la Graoumf Tracker 2/Impulse Tracker? (Punish the dsp?)
- Loading and saving patterns/songs.
- Some extra editing features (wait and see, but they are very useful)


Share and enjoy... contributions welcome, source code included!

See you on IRCnet #atariscne. -- /sjx.

[eof]