home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / disk / yacdp-1.1.lha / YACDP / YACDP.doc < prev    next >
Encoding:
Text File  |  1994-04-28  |  17.0 KB  |  450 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 SCSI-2 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 (95 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) or RAW              (*)
  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 should edit the tooltypes:
  61.  
  62. TOOLPRI [0]
  63.     The taskpriority of YACDP (must be a number from -128 to 127).
  64.     If you often want to use the "via SCSI" mode, I recommend a
  65.     taskpriority of 1
  66.  
  67. CX_PRIORITY [0]
  68.     The priority for the commodity (must be a number from -128 to 127)
  69.  
  70. CX_POPUP [YES]
  71.     YES = show GUI when started
  72.     NO  = don't show GUI
  73.  
  74. CX_POPKEY [CTRL SHIFT ALT C]
  75.     Hotkey to bring up the GUI
  76.  
  77. DEVICE [scsi.device]
  78.     Your SCSI device (caution: the devicename is casesensitive)
  79.  
  80. BOARD [0]
  81.     Controller board number (0 to 7), normally 0
  82.  
  83. UNIT [1]
  84.     SCSI target ID (0 to 7)
  85.  
  86. LUN [0]
  87.     SCSI logical unit (0 to 7), normally 0
  88.  
  89. SONGDIR [PROGDIR:Songs/]
  90.     Valid directory where to store the songfiles
  91.  
  92. EDITOR [C:Ed %s]
  93.     Your favorite texteditor which will be used if you edit the songnames.
  94.     Use "%S" if your editor expects AmigaDOS wildcards
  95.  
  96. IFFDIR [RAM:]
  97.     Default directory where the IFF files are saved
  98.  
  99. WINDOWX [0]
  100.     Windows x position
  101.  
  102. WINDOWY [11]
  103.     Windows y position
  104.  
  105. ZIPWINDOWX [0]
  106.     x position of the zipped window
  107.  
  108. ZIPWINDOWY [11]
  109.     y position of the zipped window
  110.  
  111. VIASCSI [NO]
  112.     Content of "via SCSI" at startup:
  113.     YES = checked
  114.     NO  = not checked
  115.  
  116. AUDIOCHANNELS [----]
  117.     If the "via SCSI" mode is used the playback is done by the Amiga which
  118.     has four audio channels (two for the left and two for the right).
  119.     The default is to allocate any left-right pair. Normally there should be
  120.     no reason to change this, but you can. The four chars mean:
  121.  
  122.                                  XXXX
  123.                Amiga's left _____||||_____ Amiga's left
  124.                channel 0          ||       channel 1
  125.                                  /  \
  126.                    Amiga's right<    >Amiga's right
  127.                    channel 0          channel 1
  128.  
  129.     Where X may be:  - = don't use
  130.                      L = use for left audio data
  131.                      R = use for right audio data
  132.  
  133.     Note: YACDP currently does no stereo playback, i.e. there is no difference
  134.           between L and R. But this may change in future versions.
  135.     For example to use all channels you would write "AUDIOCHANNELS=LRRL".
  136.  
  137. AMIGAVOL [64]
  138.     Start volume for Amiga
  139.  
  140. CDROMVOL [255]
  141.     Start volume for CD-ROM
  142.  
  143. AUTOSTART []
  144.     Start playback on track 1 whenever a new CD is inserted
  145.  
  146. AUTOEJECT []
  147.     Only works in conjunction with AUTOSTART. The CD is ejected when
  148.     the end of the CD is reached
  149.  
  150. ALTERNATETIME []
  151.     Show the time rather in "00:00:00" format than in "0h 0m 0s" format
  152.  
  153. NOVIASCSI []
  154.     Hide menu and button that can only be used by CD-ROM's which can
  155.     send audio data over the SCSI bus
  156.  
  157. CHIPMEM | FASTMEM | 24BITDMAMEM [any]
  158.     If any of the keywords is given the buffer for audio playback will
  159.     be either chipmemory, fastmemory or 24Bit-DMA-memory
  160.  
  161.  
  162. THE GUI
  163. ¯¯¯¯¯¯¯
  164.  ICON
  165.  ¯¯¯¯
  166.  a SCSI cable with a           the program couldn't connect to your CD-ROM.
  167.  flashing question-mark        You should have seen a requester with more
  168.                                detailed information. Play around with the
  169.                                parameters in the menu "SCSI"
  170.  
  171.  a CD with a flashing          the program found a CD-ROM, but you didn't
  172.  question-mark                 insert a CD yet
  173.  
  174.  a CD with 0's and 1's         you inserted a CD, but it's a data CD
  175.  on it
  176.  
  177.  a CD with notes on it         you inserted an audio CD
  178.  
  179.  BUTTONS
  180.  ¯¯¯¯¯¯¯
  181.  For most funktions you will obviously have to put a audio CD into your
  182.  CD-ROM or the gadgets will stay ghosted.
  183.  
  184.  1-39 Clicking on one of them will start the audio replay at this
  185.       track (song). If your CD has more than 39 tracks you can
  186.       use the "+ " button on lower right of the window, which will
  187.       bring up a requester where you can enter your desired track.
  188.  >    If no playback is in progress it will start at track 1.
  189.       If the playback is paused it will start again.
  190.       If the CD is currently playing, it will restart the playback
  191.       at the begin of the current track.
  192.  ||   (Un)pause playback
  193. [  ]  stop playback
  194.  |<   Start playback of previous track, not possible for 1st track :-)
  195.  >|   Start playback of next track, not possible if you are already at
  196.       the last track
  197.  >>   Skip n seconds back     \  qualifier | n
  198.  <<   Skip n seconds forward  /  -------------------
  199.                                  SHIFT     | 10 secs
  200.                                  none      | 20 secs
  201.                                  ALT       | 40 secs
  202.                                  CTRL      | 60 secs
  203.  ««   Skip to previous index
  204.  »»   Skip to next index («« and »» only work if not in "via SCSI" mode)
  205.  ^    Eject the CD
  206.  
  207.  If the "via SCSI" is checked the audio data will be send over the SCSI bus,
  208.  converted and played by the audio device. This will result in a heavy CPU
  209.  load (at least for 68000er's), so you might not be able to "multitask" much
  210.  or the playback is not continous anymore.
  211.  If not checked the playback is done by the CD-ROM. Only the GUI is updated
  212.  every second.
  213.  
  214.  The slider titled with "Vol" let's you control the volume for the CD-ROM
  215.  and the Amiga depending on the state of the "via SCSI"-checkbox.
  216.  
  217.  MENU
  218.  ¯¯¯¯
  219.  "About Program"   Display a requester about the program (what surprise).
  220.  "About CD-ROM"    Display a requester about the CD-ROM including
  221.                    vendor, the productname and the revision.
  222.  "About CD"        Display a requester with the songnames (if present)
  223.                    and the playing time of each song.
  224.  "Edit Songs"      Start the texteditor so you can enter the songnames.
  225.                    The filname is either the Universal-Product-Code (bar code)
  226.                    of the CD or if not available an identifier built with
  227.                    the number of tracks, the total playing time and the
  228.                    playing time of the first track.
  229.  "Update"          You may need this if you change something in the
  230.                    corresponding songfile of the CD or the data displayed 
  231.                    about the CD isn't correct.
  232.  "Hide"            Hide the GUI.
  233.  "Quit"            Quit the program.
  234.  "SCSI"            All menuitems change the value of the corresponding
  235.                    tooltype.
  236.  "Filter"          The condition of the lowpass filter (defaults to off).
  237.  "Release Device"  If you first play back audio data, some additional buffers
  238.                    and soundchannels of the sound device are allocated.
  239.                    Use this if you want the program to give them back.
  240.  "Save Audio"      Show a window where you can enter the parameters which
  241.                    part of the CD you want to save as IFF. (see below)
  242.  
  243.  KEYBOARD SHORTCUTS
  244.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  245.  0..9     : Start playback at entered track. If the track consists of two
  246.             digits the second digit must be entered within a second. If
  247.             you enter more than two digits the last is shifted out, e.g.
  248.             if you type 5 - 1 - 6 the track 16 will be played.
  249.  G        : Same as "> " button
  250.  P        : Same as "||" button
  251.  S or
  252.  <RETURN> : Same as "  " button
  253.  <Cursor
  254.   Down  > : Same as "|<" button
  255.  <Cursor
  256.   Up    > : Same as ">|" button
  257.  <Cursor
  258.   Left  > : Same as "<<" button (also same qualifier)
  259.  <Cursor
  260.   Right > : Same as ">>" button (also same qualifier)
  261.  <        : Same as "««" button
  262.  >        : Same as "»»" button
  263.  ^        : Same as "^ " button
  264.  <HELP>   : Same as if you pick the menu item "About CD"
  265.  
  266.  
  267. SAVE AUDIO AS IFF/RAW
  268. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  269.  COPYRIGHT
  270.  ¯¯¯¯¯¯¯¯¯
  271.  Though you own the CD you do not own the rights for the CD. Especially the
  272.  RAW option enables you to copy CD's without loss of data. YOU are
  273.  responsible that no existing rights are violated.
  274.  
  275.  BACKGROUND
  276.  ¯¯¯¯¯¯¯¯¯¯
  277.  CD-DA discs have their audio data stored in blocks of 2352 bytes plus
  278.  additional information each containing 588 signed 16-bit numbers for
  279.  the left and the right channel. The samplingrate of an audio CD is 44100,
  280.  which means 44100 signed 16-bit numbers for each channel reconstruct the
  281.  original waveform for one second. So 75 (=44100/588) blocks on a CD-DA discs
  282.  make one second. For example 1 minute in CD quality has a total size of
  283.  75*2352*60 = 10584000 (about 10MB).
  284.  The Amiga hardware (currently ???) can play back signed 8-bit numbers in
  285.  a maximum samplingrate of 28867.
  286.  
  287.  CONVERTING AUDIO
  288.  ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  289.  So the audio data send by the CD-ROM has to be reduced, but how?
  290.  The program let's you controll the conversion by the
  291.  o Samplingrate: 22050 ==> 1/2 original samplingrate
  292.                  14700 ==> 1/3    "          "
  293.                  11025 ==> 1/4    "          "
  294.                   8820 ==> 1/5    "          "
  295.                   ...
  296.    Reducing the samplingrate beyond 11025 will result in very pure quality.
  297.  o Channels:     Left & Right ==> the data for the left and the right
  298.                                   channel is combined.
  299.                  Right        ==> only the audio data for the right channel
  300.                                   is taken into account
  301.                  Left         ==> only the audio data for the left channel
  302.                                   is taken into account
  303.  o Scale samples:  Sometimes the audio data will sound rather low, so you
  304.                    can scale them by any amount, especialy by a power of 2.
  305.                    Try 2, 4, 8, 16.
  306.  o RAW: Do absolute no conversion (the file created is simply a dump of the
  307.         data present on the CD, i.e. the file is not in IFF format)
  308.  
  309.  Example: Let's say you have choosen a samplingrate of 14700 and
  310.           "Left & Right" and scale the samples by 2, how would
  311.           this input be reduced:
  312.              L    R      L     R      L      R
  313.           -9785, 456, -23764, 135, -32768, -343
  314.  
  315.           o First all samples will be summed up: -66069
  316.           o The divisor is (256*2*3) / 2 = 768
  317.                              ^  ^ ^    ^
  318.                16-bit to 8-bit  | |    scale samples with 2
  319.              left & right channel |
  320.                                   14700, i.e. 1/3
  321.           o The final output would be -66069 / 768 = -86
  322.             Note: If you had choosen to scale with 4 the result
  323.                   would have been -172, which doesn't fit in 8-bit
  324.                   and therefore would have been reduced to -128
  325.                   (As well as numbers greater than 127 will be reduced
  326.                   to 127).
  327.                   If this case happens too often your audio data
  328.                   will sound pretty ugly.
  329.  o The scrollers on the left side represent the start track the relative
  330.    time in this track and finally the absolute blocks (remember 1 second
  331.    makes 75 blocks?). The scrollers on the right side represent the same
  332.    for the end position.
  333.  o "PLAY START" plays 10 seconds from your current start position
  334.    "PLAY END"   plays 10 seconds before your current end position
  335.    "PLAY ALL"   plays all of your selected audio data
  336.    "STOP"       stop any audio playback
  337.  Hit "OK" to proceed and a filerequster let's you select the filename.
  338.  "CANCEL" brings you back to the main window.
  339.  If all goes fine you should see a little window showing the success
  340.  of the conversion. Press ESC or CTRL-C in the window if you want to
  341.  abort the conversion.
  342.  
  343.  
  344. COMPATIBLITY
  345. ¯¯¯¯¯¯¯¯¯¯¯¯
  346. Following drives are known to work with YACDP:
  347.  
  348.   Vendor                    |   Product            |  Supports "via SCSI"
  349.   --------------------------+----------------------+---------------------
  350.   Pioneer Electronic Corp.  |   CD-ROM DRM-604X    |         no
  351.   Sony Corporation Japan    |   CD-ROM CDU-561     |         yes
  352.                             |   CD-ROM CDU-8003A   |         yes
  353.   Texel                     |   CD-ROM DM-XX24 K   |         no
  354.   Toshiba Japan             |   CD-ROM XM-3401TA   |         yes
  355.                             |   CD-ROM XM-4101TA   |         yes
  356.  
  357.  
  358. TO DO
  359. ¯¯¯¯¯
  360.   o other playback modes (random and program), A-B range play, repeat button,
  361.     cuing
  362.   o Ability to save CD specific settings such as volume, favourite tracks,
  363.     "via SCSI", ...
  364.   o Stero playback in "via SCSI" mode
  365.   o AREXX-port
  366.   o add an option to replace buttons by listview
  367.   o find optimum "Scale Sample" value
  368.   o jog-shuttle-wheel
  369.   o fontsensitive GUI
  370.  
  371.  
  372. HOW TO SUPPORT YACDP
  373. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  374. o It would be nice if you could write me about your success/problems
  375.   with the program, especially if your CD-ROM isn't yet in the
  376.   COMPATIBLITY list. Please include information about your Amiga model
  377.   and the output of the program TestCDROM (the program only works in
  378.   the CLI and accepts the parameters DEVICE, BOARD, UNIT, LUN which
  379.   are the same as the tooltypes of YACDP), i.e. type something like
  380.   "TestCDROM >T:CDROM.log DEVICE=scsi.device BOARD=0 UNIT=1 LUN=0"
  381. o If you know your CD-ROM to be capable of sending audio data over
  382.   the SCSI bus, but YACDP doesn't yet support your CD-ROM you might ask
  383.   the vendor about how to access audio data and send the information to me.
  384.   I will try to suport your CD-ROM at the next release.
  385. o If you entered the songnames of some CD's you should send the files to me
  386.   (best would be compressed with lha and uuencoded to my email address) so
  387.    I can include them with the next release.
  388. o Tell me what features you would like to see in YACDP, aside those
  389.   already present in the "TO DO" list.
  390.  
  391.  
  392. Send mail to
  393.  
  394.                 Frank Würkner
  395.                 Georgenschwaigstr. 22
  396.                 D-80807 München
  397.                 Germany
  398.  
  399.                 or
  400.  
  401.                 E-Mail: wuerkner@informatik.tu-muenchen.de
  402.  
  403.  
  404. THANKS
  405. ¯¯¯¯¯¯
  406.    Many thanks to following persons which helped to improve YACDP
  407.  
  408.           DarkStar
  409.           Eric Bachfischer
  410.           James Cooper
  411.           Lance Kibblewhite
  412.           Mario Kemper
  413.           Marquart Franz
  414.           Stefan Kaintoch
  415.           Urs Utzinger-Brunner
  416.  
  417.  
  418. HISTORY
  419. ¯¯¯¯¯¯¯
  420.   1.0
  421.   ¯¯¯
  422.        first release
  423.   1.1
  424.   ¯¯¯
  425.        o removed a bug that caused some CD-ROM's to report
  426.          "INVALID FIELD IN CDB" when starting audio playback
  427.        o "via SCSI" now works for Toshiba drives (of course only those
  428.          who support to send audio as digital data over the SCSI bus)
  429.        o most buttons now have keyboard shortcuts
  430.        o volume now adjustable
  431.        o new tooltype AMIGAVOL and CDROMVOL to set the start volume
  432.        o IFF format now more correct
  433.        o removed SCSI error text that didn't belong to CD-ROM's
  434.        o updated vendor identification list
  435.        o device, board, unit, LUN now changeable within the program
  436.          and therefore invalid start parameter don't quit the program
  437.          anymore
  438.        o tooltype EDITOR now also accepts %S for editors that expect
  439.          AmigaDOS wildcards
  440.        o new tooltype VIASCSI to allow "via SCSI" to be checked at startup
  441.        o new tooltype AUDIOCHANNELS to specify which of the four audio
  442.          channels are used
  443.        o new tooltype AUTOSTART to start playback whenever a CD is inserted
  444.        o new tooltype AUTOEJECT to eject CD at end of playback
  445.        o new tooltype ALTERNATETIME (time in 00:00:00 format)
  446.        o new tooltype NOVIASCSI to hide menu and button that can only be
  447.          used by CD-ROM's which are able to send audio data over the SCSI bus
  448.        o windows now open activated
  449.        o Now included the command TestCDROM to simplify (bug) reports
  450.