home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Sound / Player / MCDPL121.LHA / MCDPlayer / MCDPlayer_GB.Doc < prev    next >
Encoding:
Text File  |  1996-05-21  |  10.0 KB  |  281 lines
  1.  
  2.  
  3.                              MultiCDPlayer
  4.                                  V1.21
  5.                               21.5.1996
  6.                            - Public Domain -
  7.  
  8.                       The Development Foundation
  9.  
  10.                                MANUAL
  11.  
  12. This update to MCDPlay is based entirely on the work of Boris Jakubaschk,
  13. who thoughtfully released the source code.
  14.  
  15. Do you find that MCDPlay has problems like:
  16.    Time display seeming random;
  17.    Stop button doesn't work;
  18.    FFWD/RWND buttons don't work;
  19.    Programming not working properly ?
  20.  
  21. This update is for you.
  22.  
  23. I found that MCDPlay was still the easiest program to use despite these
  24. problems, but it would be nice if they were fixed... This update provides:
  25.  
  26. V1.21 - 21/5/96
  27.    - Enforcer hit on entry removed (Thanks, Stefan!)
  28.    - 20 byte memory loss fixed
  29.    - Archive smaller (Thanks again, Stefan!)
  30.    - Program mode fixed: sometimes the last few seconds of a track were skipped.
  31.  
  32. V1.2 - 15/5/96
  33.    - Startup code altered slightly to work with GCC
  34.    - Stop button works (Used SCSI_CD_REZERO_UNIT instead)
  35.    - The timing details are correct
  36.    - The fast forward/reverse buttons work (sort of)
  37.    - An entire program will play instead of a single track
  38.    - Fully translated to English (sorry, Europe!)
  39.    - The list and programming windows are asynchronous. This means that the
  40.         display gets updated continually and programs run correctly with these windows
  41.         open. If the application is closed with them open, they will autosave.
  42.         If you alter the tracks in the list window while the program window is
  43.         open, you will have to close and re-open the program window for the changes to
  44.         show.
  45.    - Three new tooltypes are added: XPOS and YPOS, for the window's position.
  46.         These, if set, will override the existing 'WND_POS' tooltype.
  47.         NEWTIMER: Uses the new timing method. If the old one worked for you, set
  48.         this to 0 ie 'NEWTIMER=0'
  49.    - The CD name is added to the disk file as a comment. This is easier to
  50.         remember than eg. 'ID020A301E043737' !
  51.  
  52. These last three points are the only new functions; the rest all hinged on the
  53. timing information which was being read incorrectly for my setup at least.
  54.  
  55. The reason I said 'sort of' for the FFWD/RWND buttons is that I'd like them to
  56. continually work. At the moment they skip about 8 seconds for each click.
  57.  
  58. This new version is most definitely a 'works for me' release; I have:
  59.  
  60.    A1200, MC68030 & M68881 @ 50 MHz, 18 MB RAM
  61.    Squirrel SCSI-II interface (nice one, HiSoft!)
  62.    Aiwa ACD-300 damn sexy CD-ROM drive.
  63.  
  64. MCDPlay V1.2 hasn't been tested on anything else. As far as I know, it should
  65. work in 1MB under KS 2.04, but I can't test this. It was compiled using
  66. GCC 2.7.1
  67.  
  68. I hope you find this of some use.
  69.  
  70. Jamie Keir
  71.  
  72. //////////////////////////////////////////////////////////////////////////
  73. #include <Old_Docs>
  74. //////////////////////////////////////////////////////////////////////////
  75.  
  76.  
  77.                              MultiCDPlayer
  78.                                  V1.0
  79.                               22.12.1994
  80.                            - Public Domain -
  81.  
  82.                                 MANUAL
  83.  
  84.  
  85. 1. Preface
  86.  
  87. MCDPlayer is public domain, meaning that you can use and spread the
  88. program as you want.
  89.  
  90. You are using MCDPlayer on your own risk. I cannot be held responsible
  91. for any damage caused by MCDPlayer. This includes system crashes, bugs
  92. in the program or this documentation.
  93.  
  94. This will be the only distribution of MCDP done by me. It works fine
  95. with some SCSI2-CDROMs (i.e. Toshiba 4101, 3401, SONY CDU-554) but
  96. refuses to run on others (NEC). I don't have the time to search for
  97. bugs that occurs in combination with hardware that I do not own.
  98. I hope there's anyone who will continue development of MCDP.
  99.  
  100.                                                Boris Jakubaschk
  101.                                                Im Öschle 28
  102.                                                78727 Oberndorf
  103.                                                Germany
  104.  
  105.                                                FIDO 2:246/1115.2
  106.                                  EMail Boris@alice.tynet.sub.org
  107.  
  108. Thanks to:
  109.   - Gary Duncan and Heiko Rath for SCSIUtil
  110.   - Matt Dillon for DICE
  111.   - Jan van den Baard for GadToolsBox
  112.  
  113.  
  114. 2. The purpose of this program...
  115.  
  116. ...is to play audio CDs (CDDAs) on your CD-ROM drive. Therefore it must
  117. be connected to a SCSI-host.
  118.  
  119. MCDP has some special features:
  120.  
  121. - Very compact GUI on your Workbench screen
  122. - GUI is designed like a CD player
  123. - direct access of first 20 titles of every CD
  124. - automatically detects CDs and displays the interpreter, the CDs title
  125.   and the name of the title currently played.
  126. - automatically detects the change of the CD.
  127. - Editor to add new CDs to your database.
  128. - Editor for programming
  129. - Configuration using tooltypes: SCSI-device and -unit, window position
  130.   and path of CD database
  131. - Commodoty with hotkeys for start/stop/title selection
  132.  
  133.  
  134. 3. Installation:
  135.  
  136. Before you start it for the first time, you should adapt the tooltypes
  137. of MCDPs icon to your hardware configuration:
  138.  
  139. FONTNAME=<name>.font
  140.    Replace <name> with the name of the font you want to use in the
  141.    display. There are 4 Fonts in the MCDP archive:
  142.    - MCDP_DOT.font : Looks like a dot matrix LCD display
  143.    - MCDP_LCD.font : Looks like a segmented LCD display
  144.    - MDCP_LC2.font : LCD display font including lower case characters
  145.    - MCDP_STD.font : Best readable but somehow boring
  146.    You must copy at least one of these fonts to your FONTS: drawer and
  147.    set its name in the tooltypes.
  148.  
  149. SCSI_DEV=<name>.device
  150.    Insert the device name of your SCSI host as <name>. Commodore uses
  151.    scsi.device as device name for their hosts. This is the default value.
  152.  
  153. SCSI_ID=<nr>
  154.    SCSI-ID of your CD-ROM drive. As this number must be in the range of
  155.    0 to 6, you can detect it by "try and error" if you don't know it.
  156.    Default value is 1.
  157.  
  158. SONGPATH=<path>
  159.    Use this tooltype to determine the path where MCDP will save its CD
  160.    database. Default is the actual drawer at startup.
  161.  
  162. WND_POS=<path>
  163.    MCDP opens its window on the default publicscreen. You can determine
  164.    the position:
  165.    0: Centered to the visual part of your screen (if your screen doesn't
  166.       auto scroll: centered to the screen)
  167.    1: right upper corner of the screen
  168.    2: left upper corner of the screen
  169.    3: left lower corner of the screen
  170.    4: right lower corner of the screen
  171.    The editor windows always open in the screen center.
  172.  
  173. Wrong settings lead to the following results:
  174.  
  175. - MCDP refuses to start: Wrong device name or unoccupied SCSI-ID.
  176. - MCDP starts, but only shows the "breadless arts" logo: The ID doesn't
  177.   belong to a CD-ROM drive or it is not operable.
  178. - MCDP opens its window and closes it instantly: The font can't be
  179.   found.
  180.  
  181. Now you can start MCDP from Workbench. It is also possible to start it
  182. from Shell by using the tooltypes as parameters:
  183.  
  184. MCDP "SCSI_DEV=gvpscsi.device" "SCSI_ID=1" "SONGPATH=Music:CDs/"
  185.  
  186.  
  187. 4 Bedienung:
  188.  
  189. The "Look & Feel" of MCDP is almost identical to a CD player. So there
  190. should be no problems.
  191.  
  192. I'll describe the gadgets below the display first, beginning at the
  193. left edge:
  194.  
  195. Play ( > ):
  196.   Play CD, beginning with the first title. In program mode, playing
  197.   starts with the first title of the program. In both cases the CD-ROM
  198.   must have been in idle state before, the play symbol ( ">", right
  199.   lower corner of display ) mustn't have been visible.
  200.  
  201. Pause ( || ):
  202.   Pauses playing until this Gadget is klicked again.
  203.  
  204. Stop ( [] ):
  205.   Stops playing and quits program mode.
  206.  
  207. Skip backwards ( |< ):
  208.   Skips to the title that has been played before the actual one.
  209.  
  210. Skip forward ( >| ):
  211.   Skips to the next title.
  212.  
  213. Search backward ( << ):
  214.   Jumps 20 seconds backwards in the actual title.
  215.  
  216. Search forward ( >> ):
  217.   Jumps 20 seconds forward in the actual title.
  218.  
  219. Eject ( ^ ):
  220.   Eject CD.
  221.  
  222.  
  223. At the right side of the display you find some more gadgets:
  224.  
  225. Number gadgets ( 1-19 ):
  226.   In standard mode you can select the first 19 titles of the CD
  227.   directly. In program mode the keys 1-8 select the actual pro-
  228.   gram, the others are unused.
  229.  
  230. Direct input ( + ):
  231.   Now you can type in the title number using the number gadgets
  232.   1 to 10 (= 0).
  233.  
  234. Edit title list ( LIST ):
  235.   You see a window with some gadgets to put in the interpreters
  236.   and the CDs name and the names of all titles. To leave this
  237.   window you find the same gadgets as in the preferences pro-
  238.   grams of your workbench.
  239.   After you saved the title list of a CD, this CD will be iden-
  240.   tified whenever you insert it. The titles are displayed.
  241.  
  242. Edit programs ( PGM ):
  243.   In the program window, you see two big lists: On the left side,
  244.   all titles of the actual CD are displayed. The list on the
  245.   right side is empty. It will hold the programmed titles. The
  246.   gadgets between the two lists are used to clear the actual
  247.   program (New), to select the selection mode of the program
  248.   list and to select the actually edited program.
  249.  
  250.   The programming system is very simple: Whenever you select a
  251.   title of the left list, it is appended to the program list. If
  252.   you select a title in the right list, the action depends on
  253.   the selection mode: It can be deleted or moved up, down, to
  254.   the top or to the bottom of the program list.
  255.  
  256. Start program mode ( PG# ):
  257.   This gadget activates the program mode of MCDP. The display shows
  258.   "PGM" then. If you klick on "Play" now, the first title of the
  259.   start program will be played. Alternatively, you can select the
  260.   number of a program using the number gadgets before.
  261.  
  262.  
  263. 5. Keyboard control:
  264.  
  265. MCDP uses the numeric keypad in conjunction with Ctrl and the left
  266. Alt key as hotkeys for all basic functions. Therefore, the window
  267. doesn't necessarily have to be selected.
  268.  
  269. The keys are assigned as follows:
  270.    __ __ __ __
  271.   |  |  |^ |+ |
  272.   |__|__|__|__|  Enter  Start
  273.   |7 |8 |9 ||<|  .      Stop and quit program mode
  274.   |__|__|__|__|  1-9    Play title 1-9
  275.   |4 |5 |6 |>||  0      Play title 10
  276.   |__|__|__|__|  +      Play next title
  277.   |1 |2 |3 |> |  -      Play previous title
  278.   |__|__|__|  |  /      Eject CD
  279.   |10   |[]|  |  *      Direct input
  280.   |_____|__|__|
  281.