CAS Tools 1.1

		     Copyright 2001,2002 Vincent van Dam
			   (vincentd@kip.sateh.com)


This is a set of tools which can read sampled MSX tapes and convert them to
the standard .cas format and back to .wav samples. This package consist of
three tools: wav2cas, cas2wav and casdir.

The most important tool is wav2cas, this tool does the actual conversion of
audio samples to the .cas format. The cas2wav is the reverse process and
converts .cas files back to audio samples, which can be read on a real MSX.
The casdir tool gives a detailed list of the contents of the .cas file. The
last two tools are pretty straight forward and will not be described any
further in this document.

The wav2cas tool requires a .wav file as input. It will analyse the signal and
create a .cas file. It will work on 'copy-protected' tapes which use their own
custom loader using the bios routines for the actual retrieval of data.
Unfortunately tapes exist which don't use the bios routines (e.g. a lot of 
Gremlin games used a entirely different format). These will not work. 
Fortunately, a lot of publishers did use the bios calls, and they should work
fine. 

However, keep in mind that the tape medium was not the most reliable medium to
store data on; remember cleaning your heads, tuning your heads and playing with
the phase and volume settings on your datarecorder? This tool can have good
results, but if the signal is too much deteriorated it will probably fail.

You get the best results by sampling the tapes at the highest sample frequency
as possible. It does not matter if the sample is 16 or 8 bits; if it is 16 bits
it will be converted to 8 bits. Sample the signal as loud as possible, but make
sure the signal does not clip!. 

The wav2cas tool has 4 arguments to play with, but the default settings should
work fine if it is a clean clear signal.  The -t argument requires an integer
which defines a threshold; if the signal is noisy you could try a higher value
to get better results. The -e argument also requires an integer and defines the
amount of 'envelope' correction, you could try increasing and decreasing this
to get better results. The -n argument will maximize the signal and the final
-p argument will phase shift the signal.

This should be enough info to get you started in converting your old cassette
tapes to .cas files. Good luck!


                               Version History
                               ---------------

[2002/06/09] 1.1
----------------
* cas2wav: increased gap between data and headers
* wav2cas: fixed bug in wav reading
* wav2cas: changed default phase 

[2001/12/03] 1.0
----------------
* first public release

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 4531   10820  41.9% -lh5- b23d Apr 23 19:12 cas_tools-mos/cas2wav
[generic]                 2894    7272  39.8% -lh5- ab5b Apr 23 19:13 cas_tools-mos/casdir
[generic]                 1352    2899  46.6% -lh5- 020a Apr 23 19:16 cas_tools-mos/cas_tools-mos.readme
[generic]                 1239    2672  46.4% -lh5- 7cc6 Jun  9  2002 cas_tools-mos/README
[generic]                 2508    7895  31.8% -lh5- 4aaf Jun  9  2002 cas_tools-mos/sources/cas2wav.c
[generic]                 1112    3320  33.5% -lh5- a7dc Jun  9  2002 cas_tools-mos/sources/casdir.c
[generic]                 7015   18009  39.0% -lh5- e98e Nov 15  2001 cas_tools-mos/sources/COPYING
[generic]                  103     212  48.6% -lh5- a340 Jun  2  2002 cas_tools-mos/sources/Makefile
[generic]                 3625   11125  32.6% -lh5- d228 Jun  9  2002 cas_tools-mos/sources/wav2cas.c
[generic]                 5534   14916  37.1% -lh5- b71a Apr 23 19:13 cas_tools-mos/wav2cas
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        10 files   29913   79140  37.8%            Apr 24 14:54