$VER: JoinAIFF 1.2 (07.09.98)

Copyright (C) 1997, 1998 by Digital Surface/Kenneth "Kenny" Nilsen.
All rights reserved.


DESCRIPTION
-----------

This tool merge two mono AIFF files to one stereo file. The program buffers
the merge so you can have as long files you want. Samples may be 8 bit or 16
bit.


USAGE
-----

    JoinAIFF <file1> <file2> <newfile>

file1 and file2 is the name and path on the two mono AIFF files,
newfile is the name and path on the new file merged from file 1 and 2


FEATURES
--------

 - Can merge both 8-bit and 16-bit sounds in all frequencies.
   (If you need other bit aspects (eg. 12-bit/20-bit) let me know).
 - Buffered copy. Uses two buffers on 200 kb each for fast handling and
   interleaving the new sample.
 - Written in assembler for fast interleaving and for small size.
 - From version 1.2 JoinAIFF will only warn about differences in size
   and frequencies. It will still join the files, but it will chop the
   longest file and use the frequency from file 1.

NOTES
-----

AIFF is open for several channels. This version only supports two (stereo)
made from mono files only (in theory you should be able to for example merge
two stereo files into a quad file.. if you (really) need this let me know).

This version strips all other chunks than COMM and SSND. It replaces the ANNO
chunk with its own. Be warned if you need other chunks. If uses the COMM
chunk from file1 with modified channel number.

AIFC is not supported and will not be unless I get an algorithm on the pack
format (please drop me a note if you have such).

TODO/IDEAS
----------

- resample to best resolution if unequal size
- scaling to best bit resolution if unequal bit resolution with interpolation
- handle 12 and 20 bits samples
- ask user if he wants to pad or chop files of unequal length
- options:
   - option to tell wanted size (to-from) on outfile
   - info dump only on files
   - force mode to handle mangled AIFF
   - verbose mode
   - copy chunks that is not used by this program
   - handle the loop point in SSND chunk perhaps (not required though)
     (maybe use the loop point to copy the loop to own file)
   - split files with more channels than one
   - set custom frequency
   - pad, chop or resample if unequal length on files
- merge more channels together

AUTHOR:
-------

  mailto:kenny@bgnett.no (Kenneth "Kenny" Nilsen)

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 2061    4868  42.3% -lh5- 5eb1 Sep  7  1998 JoinAIFF
[generic]                 1233    2585  47.7% -lh5- 36a3 Sep  7  1998 JoinAIFF.readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         2 files    3294    7453  44.2%            Sep  8  1998