home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / CD32 / CJ-2CD32.DMS / in.adf / Docs / PlayCD.doc < prev   
Encoding:
Text File  |  1994-04-30  |  11.7 KB  |  372 lines
  1.  
  2. Welcome to PlayCD!!!
  3.  
  4. -----------------------------------------------------------------------------
  5.  
  6. LEGAL STUFF
  7.  
  8. PlayCD © Elaborate Bytes, Oliver Kastl
  9.  
  10. This software has been licensed to bsc büroautomation AG for use with
  11. their hardware.
  12.  
  13. All other rights reserved.
  14.  
  15.  
  16. -----------------------------------------------------------------------------
  17.  
  18.  
  19. GENERAL
  20.  
  21. PlayCD is a small but versatile player program for audio CDs.
  22. It will only work with the tandem package and with Mitsumi CD-ROM drives.
  23. This program will refuse to work with Kickstart or Workbench versions
  24. below 2.04.
  25.  
  26.  
  27.  
  28. INSTALLATION
  29.  
  30. Use the supplied installation program to install PlayCD.
  31. PlayCD uses an own font for its display. However, if you don't want to copy
  32. the PlayCD font files to your fonts: directory, you may instruct the
  33. installation program to do so.
  34. PlayCD will look for the font specified in its tooltypes, where FONT=default
  35. will use the system's default font.
  36. If it can't find a specified font or you didn't specify one, it will use the
  37. screen font.
  38.  
  39.  
  40.  
  41. STARTING PLAYCD
  42.  
  43. Double-click on the program's icon to start.
  44. The program will get the proper device and unit number out of its ToolTypes.
  45. The installation program has entered the correct values here.
  46. Further it will read the "SKIP" value (The value how many seconds are
  47. "skipped" when you hit the SKIP FORWARD [>>] or BACK [<<] gadgets, see below)
  48. and PEEKTIME value (see the ToolType value PEEKTIME for details).
  49. When starting from the CLI, you must specify the proper device name und unit
  50. number. You may also specify the skip value.
  51. If you don't enter anything, PlayCD will default to DEVICE=tandemcd.device,
  52. UNIT=0, SKIP=1, screenfont, PEEKTIME=20.
  53.  
  54.  
  55.  
  56. ERRORS WHILE STARTING:
  57.  
  58. If the program refuses to start, there might be something wrong.
  59. For the most common errors during startup, an error message will be displayed:
  60.  
  61. "NO BOARD FOUND":
  62. The tandemcd.device refused to open, because it couldn't find the bsc tandem
  63. card. Please check the hardware installation! Check also the UNIT tooltype!
  64.  
  65. "CDROM NOT FOUND":
  66. The tandemcd.device refused to open, because it couldn't find the cdrom drive
  67. connected to a bsc tandem card. Probably it is not powered up. Please check
  68. the hardware installation and cabling! Check also the UNIT tooltype!
  69.  
  70. "OPEN DEVICE ERROR":
  71. The tandemcd.device couldn't be opened for some unknown reason.
  72. Please check the proper software installation! Use the installation program!
  73. Check also the DEVICE and UNIT tooltypes!
  74.  
  75.  
  76.  
  77.  
  78. QUITTING PLAYCD
  79.  
  80. To get rid of PlayCD you can:
  81.  
  82. 1. Hit the close gadget
  83. 2. Select "QUIT" from the menu Items
  84. 3. Use right-Amiga-key + Q from the keyboard
  85.  
  86. However, if the drive is already playing, it will continue playing linear
  87. from the current position until the end of the CD and then stop.
  88. If you restart PlayCD while audio is playing, PlayCD will not disturb the
  89. audio play. Nice, isn't it?
  90.  
  91.  
  92. DISPLAY
  93.  
  94. The Display shows you program status information.
  95. If a CD is inserted, the display shows:
  96.  
  97. No ss of tt
  98. xx:xx yy:yy
  99.  
  100. This means, the laser is currently at track number ss. On this CD are tt
  101. tracks available.
  102.  
  103. xx:xx is the time position from the beginning of the current track.
  104.  
  105. yy:yy is the time position from the beginning of the CD.
  106.  
  107. If no disc is inserted, the message "NO DISC" will be displayed.
  108.  
  109. Other possible messages are:
  110.  
  111.  
  112. HYBRID DISC:
  113. A hybrid disc (a disk capable to hold multiple sessions) is inserted.
  114. As there are no audio tracks on these discs, PlayCD will completely
  115. ignore them.
  116.  
  117.  
  118. TIME OUT:
  119. The CD-ROM didn't response to a command in the given amount of time.
  120. Very unlikely.
  121.  
  122. BAD STATUS:
  123. The drive returned bad status to a command. This should never happen.
  124.  
  125.  
  126. DATA TRACK:
  127. You tried to play or program a data track. This is not possible.
  128.  
  129.  
  130. READ ERROR:
  131. Error reading disc information or table of contents.
  132.  
  133.  
  134. PLEASE WAIT:
  135. Drive is busy, wait a moment.
  136.  
  137.  
  138. CLEAR SHUFFLE:
  139. Current shuffle play is cleared. This happens usually, if all tracks on a
  140. disc are played.
  141.  
  142.  
  143. CLEAR PROGRAM:
  144. Current program is cleared. This happens usually, if all programmed
  145. tracks on a disc are played.
  146.  
  147.  
  148. TABLE FULL:
  149. You cannot program more tracks, because the allocated memory is exhausted.
  150.  
  151.  
  152. NO TRACK:
  153. You tried to play or program a track, which does not exist.
  154.  
  155.  
  156. TRACK nn PROGRAMMED:
  157. An acknoledgement for you, that you have successfully programmed a track in
  158. PROGRAM mode.
  159.  
  160.  
  161.  
  162.  
  163. THE MENUES
  164.  
  165. MODE:
  166.  
  167. The menu item "MODE" configures PlayCD, which kind of play mode you wish to
  168. perform. The possible options are "CONTINUE", "PROGRAM", "SHUFFLE" and "TRACK".
  169.  
  170. The default mode is CONTINUE, when the program is started.
  171.  
  172. To change the play mode, simply activate one of the four subitems of MODE.
  173. You may also use the keyboard shortcuts right-Amiga-key and C,P,S or T.
  174. A checkmark left to the menu subitem shows the current mode.
  175. These modes are mutually exclusive.
  176.  
  177. Subitem CONTINUE:
  178. An Audio CD is played "linear". If the play operation is started, it will play
  179. all following tracks until the end of the CD.
  180.  
  181. Subitem PROGRAM:
  182. You can program different tracks. If you start the play operation by hitting
  183. the Play gadget, the PlayCD will play the tracks in the order you have entered
  184. them. You can either use the number gadgets to program the tracks, or the number
  185. keys on your keyboard. If you program via the keyboard please note that you have
  186. to enter 2 digits for each track (e.g. 02 for track 2), or 2 followed by enter.
  187. (See also "Keyboard shortcuts" later in this document).
  188.  
  189. Subitem SHUFFLE:
  190. In this mode, a random generator will choose the tracks that will be played.
  191.  
  192. Subitem TRACK:
  193. In this mode, only a single track will be played - playing will stop, after the
  194. track is finished.
  195.  
  196.  
  197. REPEAT:
  198. Enabling REPEAT will repeat play. This affects all modes described above:
  199. In "CONTINUE" mode, the whole CD will be played again and again.
  200. In "PROGRAM" mode, your programmed tracks will be repated.
  201. In "SHUFFLE" mode, the CD will be played randomly again and again.
  202. In "TRACK" mode, the single track you chose will be endlessly repeated.
  203. You may also use the keyboard shortcut right-Amiga-key and R to toggle Repeat.
  204. A checkmark left to the REPEAT item shows, if reapeat is active or not.
  205.  
  206.  
  207. INQUIRE:
  208. This menu item will give you verbose information about the exec device driver
  209. in use, the Unit number and the version of your CD-Rom drive
  210. You may also use the keyboard shortcut right-Amiga-key and I to pop up the
  211. information requester.
  212.  
  213. ABOUT:
  214. This menu item gives you information about the PlayCD program.
  215. You may also use the keyboard shortcut right-Amiga-key and A to pop up the
  216. information requester.
  217.  
  218.  
  219. QUIT:
  220. This will quit the program. It has the same function as hitting the close
  221. gadget. You may also use the keyboard shortcut right-Amiga-key and Q to quit.
  222.  
  223.  
  224.  
  225. THE GADGETS:
  226.  
  227. [|>]
  228. This is the PLAY gadget. It will start audio play from the beginning of
  229. the current track.
  230. In PROGRAM mode, it will start the play of your programmed tracks or,
  231. if already playing, seek to the next program step.
  232. In SHUFFLE mode, it will start the random play or, if already playing,
  233. play the next track in the "shuffle sequence". You can use "CURSOR DOWN"
  234. as a shortcut on your keyboard.
  235.  
  236. [|-|]
  237. This is the STOP gadget. It will stop the play and position the drive to track
  238. one. In PROGRAM mode, it will clear the running program. You can use "CURSOR
  239. UP" as a shortcut on your keyboard.
  240.  
  241. [||]
  242. This is the PAUSE gadget. It will pause audio play. Hitting it again will resume
  243. play at the position, where you paused. You may use the space bar on your
  244. keyboard as a shortcut.
  245.  
  246. [<<]
  247. This is the SKIP BACK gadget. You can use "CURSOR LEFT" as a shortcut on your
  248. keyboard. The value, how many seconds will be skipped can be specified via
  249. tooltypes or from the cli.
  250.  
  251. [>>]
  252. This is the SKIP FORWARD gadget. You can use "CURSOR LEFT" as a shortcut on
  253. your keyboard. The value, how many seconds will be skipped can be specified via
  254. tooltypes or from the cli.
  255.  
  256. [|<<]
  257. This is the SEEK BACK gadget. It will seek to the track before the one currently
  258. playing and play this track immediately. In PROGRAM mode, it will SEEK BACK
  259. on program step. You can use "B" as a shortcut on your keyboard.
  260.  
  261. [>>|]
  262. This is the SEEK NEXT gadget. It will seek to the next track following the one
  263. currently playing and play this track immediately. In PROGRAM mode, it will
  264. go to the next program step. You can use "N" as a shortcut on your keyboard.
  265.  
  266. [^]
  267. This is the EJECT gadget. It will open/close the cd tray on Mitsumi FX001
  268. drives. With LU005 drives it is ghosted and inoperational.
  269. You can use "E" as a shortcut on your keyboard.
  270.  
  271. VOLUME SLIDER
  272. It will adjust the audio volume on Mitsumi FX001 drives. With LU005 drives it
  273. is ghosted and inoperational. It hast no keyboard shortcut.
  274.  
  275. [NUMBER]
  276. These gadgets are for direct playing/programming of tracks. Tracks greater as
  277. 20 must be entered via the keyboard.
  278. (See also "Keyboard shortcuts" later in this document).
  279.  
  280.  
  281.  
  282. KEYBOARD SHORTCUTS:
  283.  
  284. Most operations can be controlled with the keyboard.
  285. For these shortcuts to work, the PlayCD window must be active.
  286.  
  287.  
  288. GADGET SHORTCUTS:
  289.  
  290. CURSOR LEFT     = [<<]     (SKIP BACK)
  291. CURSOR RIGHT     = [>>]    (SKIP FORWARD)
  292. CURSOR DOWN     = [|>]    (PLAY)
  293. CURSOR UP         = [|-|]    (STOP)
  294. SPACE BAR         = [||]    (PAUSE/RESUME)
  295. B                    = [|<<]    (SEEK BACK)
  296. N                    = [>>|]    (SEEK NEXT)
  297. E              = [^]    (EJECT)
  298.  
  299. MENU SHORTCUTS:
  300.  
  301. Right Amiga key + C = Continue
  302. Right Amiga key + P = Program
  303. Right Amiga key + S = Shuffle
  304. Right Amiga key + T = Track
  305. Right Amiga key + R = Repeat
  306. Right Amiga key + I = Inquire
  307. Right Amiga key + A = About
  308. Right Amiga key + Q = Quit (same as hitting the close gadget)
  309.  
  310.  
  311. OTHER KEYBOARD OPERATIONS:
  312.  
  313. DEL                = Zip window (make it big or small)
  314. HELP                = run "sys:Utilities/AmigaGuide playcd.guide"
  315.  
  316. Instead of clicking on one of the number gadgets to play or progam a track,
  317. you may use the keyboard instead. This is very important to know, if you want
  318. to program track numbers greater than 20.
  319. To do this, simply enter the number on your keyboard, e.g. [2] and [1] for
  320. track 21. If you want to enter a track number below ten, you have to either
  321. enter a leading 0 (e.g. [0] and [5] for track 5), or enter [5] followed by
  322. the carriage return or the enter key.
  323. If you have entered a wrong first digit (e.g. you want to program track 21,
  324. but accidently typed 1 first), you can press backspace [<-] on our keyboard
  325. to erase the wrong entry (In our example this would be [1] oops! [<-]
  326. [2] [1]).
  327.  
  328.  
  329. TOOLTYPES
  330. Here are the tooltypes of the PlayCD.info file listed:
  331.  
  332. DEVICE=name.device
  333. Name of the exec.device driver. The Installation program should have filled
  334. in the correct name. Device names could be "tandemcd.device",
  335. "tandemcd_come.device" or "tandemcd_pcmcia.device". If no device name
  336. is given, the program defaults to "tandemcd.device".
  337.  
  338. UNIT=number
  339. Unit number of your driver. The Installation program should have filled
  340. in the correct unit number (usually 0).
  341. If no unit number is specified, the program defaults to unit 0.
  342.  
  343. SKIP=number
  344. Amount of seconds to skip when hitting SKIP FORWARD [>>] or SKIP BACK [<<] or
  345. their keyboard equivalents.
  346. If no value is specified, the program defaults to 1.
  347.  
  348. FONT=name
  349. Uses this font, if possible. Enter "default" for the system default font.
  350. If the specified font can't be loaded or if this tooltype is mising, PlayCD
  351. will use the current screen font.
  352.  
  353. FONTSIZE=number
  354. Size of your preferred font. If you want to use the system's default font size,
  355. enter 0 for the size.
  356.  
  357. PEEKTIME=number
  358. Interval (in 1/100 of a second), the drive will be asked for the current
  359. position during playback. Default is 20 (0,2 secs).
  360. Should never be higher than 100 (1 second) for proper operation.
  361. Lowering the value will make the "non-linear" playback modes (Track, Shuffle,
  362. Program) more accurate, but will use more CPU time.
  363.  
  364. PUBSCREEN=name
  365. The name of the public screen, you wish PlayCD to open its window.
  366. If this screen cannot be found or no screen is specified, the default public
  367. screen will be used.
  368.  
  369.  
  370. END OF DOCUMENT
  371.  
  372.