Tools for analysing and converting software for the Colour Emulator    1.12.96
********************************************************************************
by Burkhard Lehner (b_lehner@informatik.uni-kl.de)
and Stephan Scholz (stscholz@informatik.uni-kl.de)
Colour Emulator Homepage http://www.student.uni-kl.de/~sscholz/ColourGenie.html

This is a software package for reading and analysing Colour Genie tapes.
It consists of the three following tools:
CASSLOAD.EXE converts a VOC-File to a CAS-File (virtual tape) for the Colour
             Genie Emulator.
CASSSAVE.EXE converts a CAS-File to a VOC-File for using with the original 
             machine.
ANALYSE.EXE  analyses a CAS-File and checks for errors.

Since we want to improve the emulator more and more, we need a lot of software
for testing it. Please send us your CAS-files via email, it will help a lot !

CASSLOAD 1.0
************
Syntax:  CASSLOAD vocfile[.VOC] [cassfile[.CAS]]
Example: CASSLOAD chopper
         CASSLOAD meteor.voc meteor.cas
CASSLOAD converts a VOC-File to a CAS-File. The VOC file should include exactly
one Colour Genie program. It needs to be sampled at 10989 Hz, 8-bit mono 
(uncompressed). You can use any sampling tool for it, for example Cool95 or
Goldwave (both are shareware programs). You should use the .CAS-extension in
order not to get too much confused with your files. This is also the default
extension. You can load the analysed program directly into the emulator, or
you can check it first using the ANALYSE tool.

CASSSAVE 1.0
************
Syntax:  CASSSAVE cassfile[.CAS] [vocfile[.VOC]]
Example: CASSSAVE africa.cas
         CASSSAVE kong.cas kong.voc
CASSSAVE converts a CAS-File to a VOC-File. You can use the VOC file to load
the program into the original Colour Genie. This tool is meant for
verifying programs on the emulator with the original machine.

ANALYSE 1.0
***********
Syntax:  ANALYSE [-d] cassfile[.CAS]
Example: ANALYSE chopper
         ANALYSE *
         ANALYSE -d meteor.cas
You may use wild cards !
With this tool, you can analyse a virtual tape. It is checked whether the 
CAS-File contains a COLOUR BASIC or a machine code (SYSTEM) program. For BASIC
programs, the line pointers are checked, and a warning is printed if there is a
possible error. For the machine code programs, the checksums are checked and a 
warning is printed if there is an error.
If you use the -d option, more (detailed) information is given, for example the
code of the analysed program.
