TZPlay V2.00 (21.01.1996) - Copyright 1995-96 by Mario Kppen
A sample player for MS Windows Sound System soundcards

Legal
-----
This program must not be sold in any form without the permission of the author.
Only the whole original archive may be distributed.

This software is provided as-is. Author makes no warranties on this program.
You use this software at your own risk.


Requirements
------------
 - i386 (only required for ADPCM decompression)
 - about 250KB free RAM
 - DOS 3.3
 - any WSS compatible soundcard
   (e.g. Turtle Beach Tropez)

Supported formats
-----------------
 - Microsoft Wave:
   * MS PCM 8/16 bit, mono/stereo
   * A-Law/-Law 8 bit, mono/stereo (uses h/w expanding)
   * IMA/DVI (Intel) ADPCM 4 bit, mono/stereo (uses s/w decompression)
   * MS ADPCM 4 bit, mono/stereo (uses s/w decompression)
 - Creative Labs Voice:
   * PCM 8/16 bit, mono/stereo
   * A-Law 8 bit, mono/stereo (uses h/w expanding)
   * -Law 8 bit, mono/stereo (uses h/w expanding)
 - Sun/NeXT Audio:
   * PCM 8/16 bit, mono/stereo
   * -Law 8 bit, mono/stereo (uses h/w expanding)
 - Apple IFF:
   * PCM 8/16 bit, mono/stereo
 - Amiga IFF 8SVX:
   * PCM 8 bit, mono


Usage
-----
TZPLAY [options] <filename> [filename filename ...]

Options:
  -p <port>  codec base address
  -d <dma>   dma channel
  -r <rate>  set defined replay rate
  -l         loop each sample infinitely
  -n         no check for WSS id (req. -p & -d)
  -q         quiet mode


Author
------
If you have any comments, hints, bug reports or wishes for future features
contact me at mk2@irz.inf.tu-dresden.de . To get the latest version check
out the webpage http://www.inf.tu-dresden.de/~mk2/TZPlay .


Background Info
---------------
 - development started february 1995
 - CODEC functions based on the CS4231 manual form Crystal Semiconductors
 - about 4000 lines of pascal and smalls portions assembly code (for low-level
   CODEC functions and ADPCM decompression)


History (changes)
-----------------
V 2.00 (21.01.1996)
 - supported formats:
   - Microsoft Wave:
     * MS ADPCM 4 bit, mono/stereo (uses s/w decompression)
   - Apple IFF:
     * PCM 8/16 bit, mono/stereo
   - Amiga IFF 8SVX:
     * PCM 8 bit, mono
 - minor enhancements in IMA/DVI ADPCM decompression routine
 - small bug removed in Sun Audio module (caused clicks at the end of samples)
 - command line options added

V 1.02 (30.11.1995)
 - check for 386 when needed
 - some more formats are recognized (but not yet implemented)
 - CODEC mode 2 features (big endian 16 bit samples) not needed anymore
 - TZPlay is now AD1848 compatible (plain WSS compatible cards)
 - slightly enhanced error handling
 - supported formats:
   - Creative Labs Voice:
     * PCM 8/16 bit, mono/stereo
     * A-Law 8 bit, mono/stereo (uses h/w expanding)
     * -Law 8 bit, mono/stereo (uses h/w expanding)
     * supported block types:
       - Terminatior (0)
       - Voice Data (1)
       - Voice Continuation (2)
       - Silence (3)
       - Marker (4) (not used)
       - Extended Block (8)
       - New Block ?? (9)

V 1.01 (16.11.1995)
 - bug in a low level CODEC function removed (the program sometimes hung at
   startup)
 - bug in ADPCM decoding removed (it was caused by using an old version of
   a TPU)

V 1.00 (16.11.1995)
 - 1st public release

V 0.13 (15.11.1995)
 - dma detection bug removed (hopefully)

V 0.12 (14.11.1995)
 - multiple sample playing (with wildcards)
 - bug discovered in dma detection (not removed yet)
 - keyboard functions:
   [ESC]   - abort sample playing
   [SPACE] - skip to the next sample

V 0.11 (13.11.1995)
 - supported formats:
   - Sun/NeXT Audio:
     * PCM 8/16 bit, mono/stereo
     * -Law 8 bit, mono/stereo (uses h/w expanding)
 - automatically detects the used dma channel

V 0.10 (12.11.1995)
 - supported formats:
   - Microsoft Wave:
     * MS PCM 8/16 bit, mono/stereo
     * A-Law/-Law 8 bit, mono/stereo (uses h/w expanding)
     * IMA/DVI (Intel) ADPCM 4 bit, mono/stereo (uses s/w decompression)
 - automatically detects the used WSS port
 - uses all possibly replay rates supported by the codec (CS 4231)

V 0.10b and before
 - early betas


Future
------
 - support for AU (PCM 24/32 bit), IFF 8SVX Stereo, GUS Patches,
   ScreamTracker & FastTracker instruments
 - command line options (dma, port, quiet, verbose ...)
 - Windows 95 long filename support
 - support for other 16 bit soundcards (SB16, PAS16, ESS, GUSMAX, AWE32)

