CAS Tools 1.1

       Copyright 2001,2002 Vincent van Dam
      (vincentdkip.sateh.com)

AmigaOS 4.0 compile by Spot / Up Rough with HNL_DK as my mentor, thanx a lot!


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]                33555   76224  44.0% -lh5- 4d3e Apr 25 15:23 cas_tools/cas2wav
[generic]                21759   51764  42.0% -lh5- e29e Apr 25 15:23 cas_tools/casdir
[generic]                 1387    2977  46.6% -lh5- f710 Apr 25 15:29 cas_tools/cas_tools-aos4.readme
[generic]                 1239    2672  46.4% -lh5- 7cc6 Jun  9  2002 cas_tools/README
[generic]                 2522    7925  31.8% -lh5- b54c Apr 25 15:20 cas_tools/sources/cas2wav.c
[generic]                 1133    3349  33.8% -lh5- b232 Apr 25 15:20 cas_tools/sources/casdir.c
[generic]                 7015   18009  39.0% -lh5- e98e Nov 15  2001 cas_tools/sources/COPYING
[generic]                  118     274  43.1% -lh5- 6b24 Apr 25 15:31 cas_tools/sources/Makefile
[generic]                 3639   11156  32.6% -lh5- 3444 Apr 25 15:20 cas_tools/sources/wav2cas.c
[generic]                33864   80892  41.9% -lh5- 7f75 Apr 25 15:23 cas_tools/wav2cas
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        10 files  106231  255242  41.6%            Apr 26 00:43