 !ScrDumper
 purpose : save the screen off to the disk.
 author  :  Stanislas Renan, 1997
 version 0.06, 19/02/1997

What is ScreenDumper ?
--------------------
ScreenDumper is a little module that enables you to <<shoot>> an image
of the screen onto the disk. This image is the _real_ image displayed,
even in non-multitasking games or demos (well, I hope so).
This image is in RISC OS sprite format.

Use :
---
Load The module by double-clicking on its icon, dragging it to the iconbar,
starting it from the command line or an obey file, launching it with a
module you've written especially for this, or whatever you want.
Press simultaneously the [shift], [control] and [print screen] keys.
The screen will be saved in a file of which prefix name is by default
	"ADFS::4.$.ScreenD".
If you want to change this name, define the variable ScreenDump$File to
the desired value, by typing for example :
	"set ScreenDump$File RAM::0.$.BreizhIzel".

This name will evolve each time you dump the screen. Actually, it is
	"<ScreenDump$File>n"
where n is a number. All but file name are concatened with this number.
So we'll get, BreizhIzel0, BreizhIzel1, BreizhIzel2, ...

Every time you restart the module, the default name is restored and the
number set to zero.

Short history :
-------------

 version 0.06, 19/02/1997 :
 -default name changed to ADFS::4.$.ScreenD.
 -multiple file option : ScreenD0, ScreenD1, ScreenD2...

 version 0.04, 17/02/1997 :
 -reinitialision of the dump method on screen mode changing.
 -finalisation of the OS_Word22 dump method (case vdu<>hard).

 version 0.03, 16/02/1997 :
 -removed 'VDU graphic window not being the entire screen' bug that caused
  sometimes only a portion (say a window) of the screen to be dumped.

 version 0.02, 15/02/1997 :
 -it snaps all types of game/demo screens! (thanks to F. Elisei).

 version 0.01, 02/02/1997 :
 -the file saved is contained in the variable <ScreenDump$File>
 -the file by default is ADFS::4.$.tmp.ScreenFile
 -it works even in non multitasking environment (so it can shoot demo scr.).

To do :
-----
 -JPEG support with CompressJPEG.
 -tidy the vdu handling code (align the buffer if possible).

Legal things :
------------
ScreenDumper is copyright (c) Stanislas Renan.
ScreenDumper is freeware, this means that you can copy and give it freely
provided you charge nothing (say, money) for this, and this file and the
module remain unaltered and not separated.

ScreenDumper is billGate$FuckWare. You have to promote RISC OS, Galileo,
ARM processors and Acorn machines to use it more that 7 days. If you fail
in doing so, you must erase ScreenDumper from its medium.

ScreenDumper is PostCardWare. Please write me at the address below.

ScreenDumper is provided "as is", I make no warranty, whether express or
implied, to its fitness for any particular purpose. In no circumstances will I
be liable for any damage, loss of profits, goodwill or for any indirect or
consequential loss arising out of your use of ScreenDumper, even if I have been
advised of the possibility of such loss.
This is a hidden line.

Contacting me :
-------------
By E-mail : renan@aime.insa-tlse.fr (until the next week, so...)
By S-mail : Stanislas Renan
	    "Le Colombier"
	    22700 Perros-Guirec
	    France

Please feel free to contact me for suggestions or bug reports. Indicate the
machine type you're using, its configuration, the environment of the dump that
eventually failed (WIMP, game, demo...), the storage medium, etc.
Please be precise, redundant, verbose, etc.

Greetings :
---------
Thanks to Frederic Elisei whose help has built this module more than me.

Apologies :
---------
For my lame english.
