This  is a tiny documentation for `CDDA', a program to replay digitial
audio  data  read  from an Apple CD-300 CD-ROM drive. You will get the
same  information  if  you invoke the program by entering "CDDA ?" and
then entering "?" again.

The  source code was written in `C', compiled with SAS/C 6.51. Execute
the source code to compile.

If you wish to get into contact with me, write to:

   Olaf Barthel
   Brabeckstraße 35
   D-30559 Hannover

   Federal Republic of Germany

   eMail: olsen@sourcery.han.de

                                  *

This  program  replays  digital audio data directly off a compact disc
using  the Amiga audio hardware (in stereo where available). A special
type  of  CD-ROM  drive  is required since this program makes use of a
vendor  unique command supported by Sony drives, such as the CDU-8003A
or the Apple CD-300 drive.

Please  note  that due to the work involved reading and converting the
audio  data  music may not always play smoothly. The program will also
consume  large  amounts  of  chip memory in order to supply the player
task  with  a  contiguous  stream of data (the maximum number of sound
queue  packets  can  be adjusted using a command line parameter). Your
system  may also experience heavy task loading since the incoming data
(more  than  88K  bytes  per  second)  must  be  handled  quickly  and
efficiently in order to avoid `pops' and delays.

The command line template looks like this:

DEVICE/K,UNIT/K/N,TRACK/N,FROM/K/N,TO/K/N,NUM/K/N,MAX/K/N,VERBOSE/S

DEVICE  This parameter requires a keyword. By default the program will
        address `scsi.device' as the device driver which controls your
        CD-ROM  drive.  You  can  override this by using the following
        command line option:

                        DEVICE <device name>

        Example:        DEVICE gvpscsi.device

UNIT    This parameter requires a keyword. By default the program will
        expect  your  CD-ROM drive to respond to device unit number 2.
        You  can  override  this  by  using the following command line
        options:

                        UNIT <unit number>

        Example:        UNIT 3

TRACK   This  parameter  requires  a keyword. Each data/music track on
        the CD has a unique number assigned which ranges from 1 to 99.
        This is how you choose which track to replay.

        Example:        TRACK 1

FROM    This  parameter requires a keyword. The CD consists of several
        sectors, each of which can be addressed independently. Several
        sectors form a track, 75 sectors of data make up one second of
        audio  data.  This  is how you choose which sectors to replay,
        note  that  this  parameter  requires  the  "TO"  or the "NUM"
        parameter.

        Example:        FROM 1 TO 600

TO      This  parameter  requires  a  keyword.  It works both with the
        "TRACK" and "FROM" parameters.

        Example:        TRACK 1 TO 5    Plays tracks to 1 to 5
                        FROM 1 TO 600   Plays sectors 1 to 600

NUM     This  parameter  requires  a  keyword.  It works both with the
        "TRACK" and "FROM" parameters.

        Example:        TRACK 3 NUM 7   Plays tracks to 3 to 10
                        FROM 2 NUM 4    Plays sectors 2 to 6

MAX     This  parameter  requires  a  keyword.  In  order  to  feed  a
        contiguous  stream  of  data to the player task incoming audio
        data  is  queued. The maximum number of data packets queued is
        set  using this parameter. By default the number of packets is
        set to 3. Each packet requires about 176K bytes, so take care.

        Example:        MAX 5

VERBOSE This command line option will enable some more or less helpful
        progress messages, may not be of any use at all.

        Example:        VERBOSE

That's  all  folks!  This program and the accompanying source code are
freeware. Respect copyright, encourage creativity.