home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / CD32 / CJ-2CD32.DMS / in.adf / YACDP.lha / YACDP / YACDP.doc < prev    next >
Encoding:
Text File  |  1994-04-05  |  10.3 KB  |  267 lines
  1.                   __   _____   ____ ____  ____    _   ___  
  2.                   \ \ / / _ \ / ___|  _ \|  _ \  / | / _ \ 
  3.                    \ V / |_| | |   | | | | |_) | | || | | |
  4.                     | ||  _  | |___| |_| |  __/  | || |_| |
  5.                     |_||_| |_|\____|____/|_|     |_(_)___/ 
  6.  
  7.                              Yet Another CD Player
  8.  
  9.                             © 1994 by Frank Würkner
  10.                               All Rights Reserved
  11.  
  12.  
  13. COPYRIGHT NOTE
  14. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  15. The program YACDP is copyrighted © 1994 by Frank Würkner.
  16. All rights reserved.
  17.  
  18. YACDP is FREEWARE.  This program may be freely distributed as long as
  19.   - the executable and documentation remain unchanged and
  20.     are included in the distribution
  21.   - No other charge is made than to cover time and copying costs
  22.  
  23.  
  24. DISCLAIMER
  25. ¯¯¯¯¯¯¯¯¯¯
  26. No warranties of any kind are made as to the functionality of this
  27. program. You are using it ENTIRE at your own risk.
  28.  
  29.  
  30. SYSTEM REQUIREMENTS
  31. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  32. o OS2.0 or higher
  33. o reqtools.library © 1991-1994 by Nico François (thanks Nico!)
  34. o a SCSI bus adapter capable of sending SCSI direct commands
  35. o a CD-ROM which can read CD-DA ("Red Book") encoded discs
  36.   (i.e. you should see a headphone jack on the front panel)
  37. o optionally your CD-ROM should be capable of sending the audio as
  38.   16-bit digital data over the SCSI bus
  39.  
  40.  
  41. FEATURES
  42. ¯¯¯¯¯¯¯¯
  43. o GUI that let's you access all basic functions of a normal CD-Player
  44. o is a Commodity
  45. o can display songnames and CD title (of course you once have to enter
  46.   the names)
  47. o doesn't wastes memory
  48. o SCSI errors are displayed as text (190 known)
  49. o realtime playback of audio on your Amiga, even on 68000 machines   (*)
  50.   (achieved by highly optimised assembler routines)
  51. o ability to save (parts of) songs as IFF (8SVX)                     (*)
  52.  
  53. (*) CD-ROM must be able to send audio over SCSI bus (see SYSTEM REQUIREMENTS)
  54.  
  55.  
  56. GETTING STARTED
  57. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  58. If you often use audio CD's you might like to put the program into the
  59. WBStartup drawer. But any other place is fine too. But before the first
  60. use you MUST edit the tooltypes:
  61.  
  62. CX_PRIORITY [0]
  63.     The priority for the commodity (must be a number from -128 to 127)
  64.  
  65. CX_POPUP [YES]
  66.     YES = show GUI when started
  67.     NO  = don't show GUI
  68.  
  69. CX_POPKEY [CTRL SHIFT ALT C]
  70.     Hotkey to bring up the GUI
  71.  
  72. DEVICE [scsi.device]
  73.     Your SCSI device (caution: the devicename is casesensitive)
  74.  
  75. BOARD [0]
  76.     Controller board number (0 to 7), normally 0
  77.  
  78. UNIT [1]
  79.     SCSI target ID (0 to 7)
  80.  
  81. LUN [0]
  82.     SCSI logical unit (0 to 7), normally 0
  83.  
  84. SONGDIR [PROGDIR:Songs/]
  85.     Valid directory where to store the songfiles
  86.  
  87. EDITOR [C:Ed %s]
  88.     Your favorite texteditor which will be used if you edit the songnames
  89.  
  90. IFFDIR [RAM:]
  91.     Default directory where the IFF files are saved
  92.  
  93. WINDOWX [0]
  94.     Windows x position
  95.  
  96. WINDOWY [11]
  97.     Windows y position
  98.  
  99. ZIPWINDOWX [0]
  100.     x position of the zipped window
  101.  
  102. ZIPWINDOWY [11]
  103.     y position of the zipped window
  104.  
  105. CHIPMEM | FASTMEM | 24BITDMAMEM [any]
  106.     If any of the keywords is given the buffer for audio playback will
  107.     be either chipmemory, fastmemory or 24Bit-DMA-memory
  108.  
  109.  
  110. THE GUI
  111. ¯¯¯¯¯¯¯
  112. For most funktions you will obviously have to put a audio CD into your
  113. CD-ROM or the gadgets will stay ghosted.
  114.  
  115.  BUTTONS
  116.  ¯¯¯¯¯¯¯
  117.  1-39 Clicking on one of them will start the audio replay at this
  118.       track (song). If your CD has more than 39 tracks you can
  119.       use the "> " button on lower right of the window, which will
  120.       bring up a requester where you can enter your desired track.
  121.  >    If no playback is in progress it will start at track 1.
  122.       If the playback is paused it will start again.
  123.       If the CD is currently playing, it will restart the playback
  124.       at the begin of the current track.
  125.  ||   (Un)pause playback
  126. [  ]  stop playback
  127.  |<   Start playback of previous track, not possible for 1st track :-)
  128.  >|   Start playback of next track, not possible if you are already at
  129.       the last track
  130.  >>   Skip n seconds back     \  qualifier | n
  131.  <<   Skip n seconds forward  /  -------------------
  132.                                  SHIFT     | 10 secs
  133.                                  none      | 20 secs
  134.                                  ALT       | 40 secs
  135.                                  CTRL      | 60 secs
  136.  ««   Skip to previous index
  137.  »»   Skip to next index («« and »» only work if not in "via SCSI" mode)
  138.  ^    Ejact the CD
  139.  
  140.  If the "via SCSI" is checked the audio data will be send over the SCSI bus,
  141.  converted and played by the audio device. This will result in a heavy CPU
  142.  load, so you might not be able to "multitask" much or the playback is
  143.  not continous anymore.
  144.  If not checked the playback is done by the CD-ROM. Only the GUI is updated
  145.  every second.
  146.  
  147.  MENU
  148.  ¯¯¯¯
  149.  "About Program"   Display a requester about the program (what surprise)
  150.  "About CD-ROM"    Display a requester about the CD-ROM including
  151.                    vendor, the productname and the revision
  152.  "About CD"        Display a requester with the songnames (if present)
  153.                    and the playing time of each song
  154.  "Edit Songs"      Start the texteditor so you can enter the songnames.
  155.                    The filname is either the Universal-Product-Code (bar code)
  156.                    of the CD or if not available an identifier built with
  157.                    the number of tracks, the total playing time and the
  158.                    playing time of the first track.
  159.  "Update"          You may need this if you change something in the
  160.                    corresponding songfile of the CD or the data displayed 
  161.                    about the CD isn't correct.
  162.  "Hide"            Hide the GUI
  163.  "Quit"            Quit the program
  164.  "Release Device"  If you first play back audio data, some additional buffers
  165.                    and soundchannels of the sound device are allocated.
  166.                    Use this if you want the program to give them back.
  167.  "Save Audio"      Show a window where you can enter the parameters which
  168.                    part of the CD you want to save as IFF. (see below)
  169.  
  170.  
  171. SAVE AUDIO AS IFF
  172. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  173.  BACKGROUND
  174.  ¯¯¯¯¯¯¯¯¯¯
  175.  CD-DA discs have their audio data stored in blocks of 2352 bytes plus
  176.  additional information each containing 588 signed 16-bit numbers for
  177.  the left and the right channel. The samplingrate of an audio CD is 44100,
  178.  which means 44100 signed 16-bit numbers for each channel reconstruct the
  179.  original waveform for one second. So 75 (=44100/588) blocks on a CD-DA discs
  180.  make one second. For example 1 minute in CD quality has a total size of
  181.  75*2352*60 = 10584000 (about 10MB).
  182.  The Amiga hardware (currently ???) can play back signed 8-bit numbers in
  183.  a maximum samplingrate of 28867.
  184.  
  185.  CONVERTING AUDIO
  186.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  187.  So the audio data send by the CD-ROM has to be reduced, but how?
  188.  The program let's you controll the conversion by the
  189.  o Samplingrate: 22050 ==> 1/2 original samplingrate
  190.                  14700 ==> 1/3    "          "
  191.                  11025 ==> 1/4    "          "
  192.                   8820 ==> 1/5    "          "
  193.                   ...
  194.    Reducing the samplingrate beyond 11025 will result in very pure quality.
  195.  o Channels:     Left & Right ==> the data for the left and the right
  196.                                   channel is combined.
  197.                  Right        ==> only the audio data for the right channel
  198.                                   is taken into account
  199.                  Left         ==> only the audio data for the left channel
  200.                                   is taken into account
  201.  o Scale samples:  Sometimes the audio data will sound rather low, so you
  202.                    can scale them by any amount, especialy by a power of 2.
  203.                    Try 2, 4, 8, 16.
  204.  
  205.  Example: Let's say you have choosen a samplingrate of 14700 and
  206.           "Left & Right" and scale the samples by 2, how would
  207.           this input be reduced:
  208.              L    R      L     R      L      R
  209.           -9785, 456, -23764, 135, -32768, -343
  210.  
  211.           o First all samples will be summed up: -66069
  212.           o The divisor is (256*2*3) / 2 = 768
  213.                              ^  ^ ^    ^
  214.                16-bit to 8-bit  | |    scale samples with 2
  215.              left & right channel |
  216.                                   14700, i.e. 1/3
  217.           o The final output would be -66069 / 768 = -86
  218.             Note: If you had choosen to scale with 4 the result
  219.                   would have been -172, which doesn't fit in 8-bit
  220.                   and therefore would have been reduced to -128
  221.                   (As well as numbers greater than 127 will be reduced
  222.                   to 127).
  223.                   If this case happens too often your audio data
  224.                   will sound pretty ugly.
  225.  o The scrollers on the left side represent the start track the relative
  226.    time in this track and finally the absolute blocks (remember 1 second
  227.    makes 75 blocks?). The scrollers on the right side represent the same
  228.    for the end position.
  229.  o "PLAY START" plays 10 seconds from your current start position
  230.    "PLAY END"   plays 10 seconds before your current end position
  231.    "PLAY ALL"   plays all of your selected audio data
  232.    "STOP"       stop any audio playback
  233.  Hit "OK" to proceed and a filerequster let's you select the filename.
  234.  "CANCEL" brings you back to the main window.
  235.  If all goes fine you should see a little window showing the success
  236.  of the conversion. Press ESC or CTRL-C in the window if you want to
  237.  abort the conversion.
  238.  
  239.  
  240. HOW TO SUPPORT YACDP
  241. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  242. o It would be nice if you could write me about your success/problems
  243.   with the program. Please include information about your Amiga model,
  244.   SCSI device, which CD-ROM you are using and version of YACDP.
  245. o If you know your CD-ROM to be capable of sending audio data over
  246.   the SCSI bus, but YACDP doesn't yet support your CD-ROM you might ask
  247.   the vendor about how to access audio data and send the information to me.
  248.   I will try to suport your CD-ROM at the next release.
  249. o If you entered the songnames of some CD's you should send the files to me
  250.   (best would be compressed with lha and uuencoded to my email address) so
  251.    I can include them with the next release.
  252. o Tell me what features you would like to see in YACDP. I thought of adding
  253.   an AREXX-port, other playback modes (such as random or program), ...
  254.  
  255.  
  256.  
  257. Send mail to
  258.  
  259.                 Frank Würkner
  260.                 Georgenschwaigstr. 22
  261.                 D-80807 München
  262.                 Germany
  263.  
  264.                 or
  265.  
  266.                 E-Mail: wuerkner@informatik.tu-muenchen.de
  267.