home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / disk / playcdda-1.1.lha / PlayCDDA / PlayCDDA.doc < prev    next >
Text File  |  1994-01-04  |  4KB  |  137 lines
  1. PlayCDDA - Play audio CDs on your Amiga's audio.device
  2. ------------------------------------------------------
  3.  
  4. Version 1.1    04-Jan-94    (C) 1993 by Frank Munkert
  5.                             (ln_fmu@pki-nbg.philips.de)
  6.  
  7. INTRODUCTION
  8.  
  9.   PlayCDDA is a program for owners of Toshiba 3401 and Apple CD-300
  10.   CDROM drives. These drives are capable of transferring CD-DA
  11.   (digital audio) data over the SCSI bus. PlayCDDA reads this data and
  12.   reproduces the corresponding sounds on the Amiga's audio.device.
  13.  
  14. DISCLAIMER
  15.  
  16.   This software is provided as-is, without warranty of any kind,
  17.   either expressed or implied. In no event will the author be liable
  18.   for direct, indirect, incidental or consequential damages or data
  19.   loss resulting from the use or application of this software. The
  20.   entire risk as to the results and performance of this software is
  21.   assumed by the user.
  22.  
  23. REQUIREMENTS
  24.  
  25.   AmiCDROM should work with any Amiga model which has a "SCSI-direct"
  26.   compatible SCSI bus adapter. A Toshiba 3401 or Apple CD-300 CDROM
  27.   drive must be connected to the SCSI bus.
  28.   
  29.   Your SCSI bus setup must have a bandwidth of at least 173 KB/sec in
  30.   order to transfer 44100 4-bit-samples per second. The higher the
  31.   bandwidth, the better. Also, while running PlayCDDA there shouldn't
  32.   be much other activity on the SCSI bus (e.g. hard disk accesses).
  33.  
  34. INSTALLATION
  35.  
  36.   Copy the file 'PlayCDDA' to your favourite location for executable
  37.   programs.
  38.  
  39. USING PLAYCDDA
  40.  
  41.   Invocation from CLI
  42.     You have to supply the name of your SCSI device and the
  43.     SCSI unit number of your CDROM drive as arguments to PlayCDDA,
  44.     e.g.
  45.     
  46.         PlayCDDA scsi.device 1
  47.  
  48.     invokes PlayCDDA with SCSI device name "scsi.device" and
  49.     unit number 1.
  50.     
  51.     The complete command line template for PlayCDDA is
  52.     
  53.        DEVICE/A,UNIT/A/N,CHIP/S,FAST/S,DMA/S,ANY/S,LOW/S,MEDIUM/S,HIGH/S
  54.     
  55.     DEVICE:  scsi device name
  56.     UNIT:    scsi unit number
  57.     CHIP:    use chip memory for CDROM buffers (this is the default)
  58.     FAST:    use fast memory for CDROM buffers
  59.     DMA:     use 24 bit DMA memory for CDROM buffers
  60.     ANY:     use any available memory for CDROM buffers
  61.     The options CHIP, FAST, DMA and ANY are mutually exclusive.
  62.     LOW:     low volume
  63.     MEDIUM:  medium volume
  64.     HIGH:    high volume
  65.     The options LOW, MEDIUM and HIGH are mutually exclusive.
  66.  
  67.   Invocation from WorkBench
  68.     Edit the tooltype entries "DEVICE" and "UNIT" of the PlayCDDA icon
  69.     such that they reflect your system setup.
  70.     Double-click on the PlayCDDA icon.
  71.     The optional tooltype "MEMORY" may have the values "CHIP", "FAST",
  72.     "DMA" or "ANY" (see above).
  73.     The optional tooltype "VOLUME" may have the values "LOW", "MEDIUM"
  74.     or "HIGH" (see above).
  75.  
  76.   PlayCDDA communicates with the user over a simple graphical
  77.   interface. Basically, you have to click at the button for the
  78.   track you want to hear, and PlayCDDA starts playing this track
  79.   on your Amiga's loudspeaker.
  80.  
  81.   The rest of the section explains the individual buttons of the
  82.   user interface.
  83.   
  84.   "Start"
  85.     Click at this button to play the first track. 
  86.   
  87.   "Stop"
  88.     Stop playing.
  89.   
  90.   "1" ... "20"
  91.     Click at on of these buttons to play the corresponding track.
  92.  
  93.   "Next"
  94.     Plays the next track.
  95.   
  96.   "Prev"
  97.     Plays the previous track.
  98.  
  99.   "Volume"
  100.     Adjust the volume of the sound reproduction.
  101.  
  102.   "Sampling rate"
  103.     The number of bytes per second that are sent to the audio.device.
  104.     The higher the sampling rate the better the sound quality.
  105.  
  106.   "Buffers"
  107.     Number of buffers. The higher the number of buffers, the lesser is
  108.     the chance that the sound may be interrupted by other tasks with
  109.     higher priority.
  110.  
  111.   You should adjust "Buffers" and "Sampling rate" to fit your system's
  112.   need. On an Amiga 3000T with built-in SCSI device, the default settings
  113.   should work. With an Apple CD-300 it might be necessary to set the
  114.   number of buffers to 64 for increased performance.
  115.  
  116. HISTORY
  117.  
  118.   V1.1: 04-Jan-94
  119.  
  120.     Added support for the Apple CD-300, implemented by Heiko Rath
  121.     (hr@brewhr.swb.de)
  122.  
  123.         New options: CHIP, FAST, DMA, ANY, LOW, MEDIUM, HIGH.
  124.     Minor changes. (ln_fmu)
  125.  
  126.   V1.0: 21-Nov-93
  127.  
  128.     Original release with support for Toshiba 3401 CDROM drives.
  129.  
  130.  
  131. CONTACTING THE AUTHOR
  132.  
  133.   Please send bug reports and suggestions to ln_fmu@pki-nbg.philips.de.
  134.  
  135.   If you want to report an error, please describe your system
  136.   configuration (Amiga model, SCSI device, PlayCDDA version number).
  137.