Short:        ZX Snapshot to TIFF Converter
Author:       Conor McMenamin, Morphos port by Fabrizio "Lanch" Bartoloni
Uploader:     lanch tiscali it (Fabrizio Bartoloni)
Type:         misc/emu
Version:      0.5
Architecture: ppc-morphos

                        SNAP TO TIFF CONVERTER
            by Conor McMenamin (C.S.McMenamin@sussex.ac.uk)



PROGRAM: sna2tiff is a simple C program which extracts the screen image
from a ZX Spectrum memory snapshot and converts it into a TIFF (Tagged
Image File Format) file. TIFF files can be read by most image viewing
programs (eg xv on Unix, GifConverter on Macintosh, Cshow on PC etc.),
and can also be used in some word processing/DTP packages. The images
produced conform to Baseline TIFF 6.0, and are uncompressed palette
colour (16 colours) images. Without a border, each output TIFF file
should be 25088 bytes in size.



USE: The program expects the name of a single snapshot file on the
command line, as the first non-option (i.e. not preceeded with a '-')
argument, and will use the second argument of this type (if one is
supplied) as the name of the output file, if one is supplied. If only
the name of the snapshot is passed to the program, a output filename
will be created by knocking the suffix(if any) off the snapshot
filename (eg .sna, .z80), and appending '.tif'.



WARNING:  If you wish to get TIFFs from multiple snapshots, do each one
seperately or use a batch language file. Specifying multiple snapshots
on the command line will cause the second named file to be trashed and
replaced with a TIFF from the first!



OPTIONS: The program defaults to a conversion from the .sna format used
by JPP, but other formats may be specified by a command line option:



-z for Z80 format snapshots

-s for straight screen memory dump (I have never seen one of these, but
	someone asked about converting them on comp.sys.sinclair once).



There is also support for including the border in the TIFF; the colour
can be read from .z80 and .sna files. To specify a border, use the
-b<n> option, where <n> is an optional single digit integer giving the
border width in characters (8 pixels). If no <n> is supplied, the
border will be two characters (16 pixels) wide.



Examples:

	sna2tiff jetpac.sna                     (produces jetpac.tif,
                                                 with no border)

	sna2tiff -z -b6 elite128.z80            (produces elite128.tif,
                                                 with a 48 pixel border)

	sna2tiff elite128.z80 image.out -b -z   (produces TIFF in
                                                 image.out with a 16
                                                 pixel border)



N.B. Options should be grouped together either before or after the
filename arguments.



CREDITS: Many thanks to Fredrik Ekman, Filip Kujawski, Colin Meeks and
especially Russell Marks for helping with the devlopment, testing and
(in Russell's case) coding style of this program.



Thanks again to Russell for supplying the DOS executable.