AGA Utilities DocFile
	=====================


  The utils covered in this docfile are:

	Iff-binary
	Spriteconverter
	ColourConverter

 Iff-Binary
 ~~~~~~~~~~
	This program will convert any IFF picture into a binary format
 that you can use  in your programs. This is a very simple  utility to
 use and doesn't really need much explaining. After loading Iff-binary
 the different options available are listed, these let you select what
 data to save with your file and how to save it.
	The options are as follows :-

  (A) T - 12 bit colours values. This when saving the colours stores
	  them in the old 12 bit word value format, by not selecting
	  this they are saved as two  banks of 12 bit values for AGA
	  machines. ie. Changing a 128 colour screen to binary would
	  add a 128 words of the upper 4 bits of each RGB first then
	  a second set of 128 words of the lower 4 bits.

		Colour value $f4e28c would be $fe8 and $42c.

  (B) C - Cancel saving colours. Speaks for itself.

  (C) S - Sequential data. This lets you choose from an interleaved
	  binary file or sequential.

  (D) H - If the picture is HAM8 then this must be selected so the
	  right colours are saved.

	To convert your file just follow the prompts to enter your
  filename, options and then the new filename.



 SpriteConverter
 ~~~~~~~~~~~~~~~
  This utility will convert a 16 colour binary data file into two
 64 pixel wide format files to be included in the example file on
 this disc.
   The process is simple :-

  1. Draw your 16 colour image in say Dpaint.
  2. Save it as a brush with a width of 64 pixels.
  3. Run it through Iff-Binary and select C in the options to cancel
     colour saving.
  4. Now run this program and two files will be produced to load into
     the program included.


   Example - Spriteconvert df0:Mypicture.binary ram:Spritedata

   The program will add an extension of .SP1 and .SP2 to the output
   file.


 ColourConverter
 ~~~~~~~~~~~~~~~

  This program will change the header file on an image saved with
 Iff-binary from two banks of word data into byte values for each
 RGB component for use with the AGA fade routine.

   The process is simple :-

  1. Iff-binary your 128 colour image with no options ( just press
     return ).

  2. Now run this program and it will give you the required file.

   Example - Colourconvert df0:Mypicture.binary ram:Mycolours 128

   The value 128 must be added so that the utility knows how many
  colours to convert.