
	      **************************************
	      *		   VIEWER V1.0		   *
	      *		   ~~~~~~~~~~~		   *
	      *	by Treebeard of the Dragon Masters *
	      **************************************

Like the original name?

To run it from the CLI, simply type:

Viewer <filename>

where <filename> is the filename of the main document structure.  This 
structure is:

1. PICTURES
	List all the filenames of the pictures and follow each by a null
	byte, eg.

file	dc.b	'df0:gfx/Picture1',0
	dc.b	'df0:gfx/Picture2',0
	dc.b	'df0:gfx/Picture3',0

	Follow the last filename with an extra null byte, and then do an
	even command to bring it onto a word barrier

	dc.b	0
	even

2. PAGE OFFSETS
	Give the offsets from the start of the file of each page (long
	word each), following the last by a null long, eg.

	dc.l	page1-file
	dc.l	page2-file
	dc.l	page3-file
	dc.l	0

3. PAGES
	For each page,
	(a)	List the pictures and their positons with the following 
		structure or just use a null byte to indicate no pictures:

		(byte)	Picture no. (1-?)
		(byte)	X pos of pic (0-79 or 0-52, whichever you're using)
		(byte)	Y pos of pic (0-31 or less if logo is used)
		(byte)	width (in bytes)
		(byte)	height (in pixels)
		(byte)	no. of bitplanes - 1 (included so, for example, a
			4-colour pic doesn't need 2 blank planes to make
			up the 4-bitplane screen

		Follow the last picture by a null byte

	(b)	The text, null byte terminated, and with the following
		condition codes:

		9	Tab
		10	Carriage return
		17 c	Change colour to colour c
		30 x	Change x position to x
		31 x y	Change text position to (x,y)

		c is in the range (0-3)
		x is in the range (0-79 or 0-52)
		y is in the range (0-31)

Simple really.  Until the editing util is written, Neil's Textmaster will
come in handy.  If the program exits without displaying a picture it means
it cannot find one of the files (either the document file or the individual
picture files).  All pictures must, of course, be in raw format and must be
an even number of bytes wide.

Use the left and right arrow keys to view the pages, with the space-bar also
going onto the next page.

SUGGESTIONS FOR EXPANSION:

1 - Realised there is no way of changing the colours for each page to allow
    the pictures to have any colour you like.  A suggestion would be that
    for each page before the picture list all sixteen colours to be used for
    the page are listed.  --  I'll do that miself soon and incorporate it 
    into the util.

2 - Allow a variation on the font used.

3 - Anything really

THE CODE
~~~~~~~~
Test is a variable which when 0 indicates assembling to disk (so it will
accept the a0,d0 info passed from CLI, and when 1 indicates assembling to
memory with the filename to load being given after the label Struct.

Logoh is the height of the text part of the screen in characters (default
is full screen, ie. 32).  If a logo is added, the copper list will obviously
need to be changed and logoh given its correct value.

THE DISK
~~~~~~~~
FILE_CREATOR
	Creates a file (filename given by variable filename - wow!) and
	saves into it all the data between data and dataend.  Until util
	is written this is needed to create the document file.

TEXT_VIEWER1
	Hi-res 8x8 font version.

TEXT_VIEWER2
	Low-res 6x8 font version (I know you say you'll use the Hi-res
	one but seeing as its written now I might as well include it
	anyway).  The example doesn't work properly for this one since
	it was designed for a hi-res screen

VIEWER_EG
	The example document file

GFX/MY_LOGO and
GFX/AMIGA_LOGO
	2 superb quality logos (honest!)

GFX/FONT6.FONT
	The 6x8 font which can be loaded and edited by FontMaster (on
	one of the ACC disks) at will.

GFX/TOPAZ.FONT
	SE

			Enjoy (and reject)...

				Treebeard 10.10.91
