home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / cdrom / bcdplay / bcdplay.guide (.txt) < prev    next >
Amigaguide Document  |  1996-11-13  |  10KB  |  296 lines

  1. @database BCDPlay.guide
  2. @width 72
  3. @node Main "BCDPlay documentation"
  4. @help overview.iff/main
  5. @{b}------------------------------------------------------------@{ub}
  6.               BCDPlay 0.34 (5.8.96)
  7.             by Elmar Plischke
  8.               The better (beta) CDPlayer
  9. @{b}------------------------------------------------------------@{ub}
  10. @{i} Noch in Arbeit ... @{ui}
  11.             @{"Introduction" link intro}
  12.             @{"Installation" link install}
  13.             @{"   Usage    " link details}
  14.             @{"  Copyright " link cright}
  15. @endnode
  16. @node intro ""
  17. Welcome to BCDPlay, an easy-to-use cd player which supports SCSI
  18. and CD
  19.  compatible cd-drives and comes with a stylish GUI that
  20. does not depend on MUI, external fonts or graphics data.
  21. BCDPlay has a minimal @{"ARexx" link arexx} interface to allow
  22. external control.
  23. @endnode
  24. @node install ""
  25.  @{b}Installation@{ub}
  26. Just copy the program somewhere in your path.
  27. BCDPlay requires no external fonts or data,
  28. but uses ARexx and screennotify.library where available.
  29.  @{b}How to Suit Your Needs @{ub}
  30. BCDPlay comes with a lot of tooltypes to configure it:
  31.         @{"  SCSINAME  " link scsiname}
  32.         @{"  SCSIUNIT  " link scsiunit}
  33.         @{"  USECD32   " link usecd32}
  34.         @{"   MONO     " link mono}
  35.         @{"   HIRES    " link hires}
  36.         @{" PUBSCREEN  " link pubscreen }
  37.         @{"  ICONIFY   " link iconify }
  38.         @{"  AUTOSTART " link autostart}
  39.         @{"    XPOS    " link pos}
  40.         @{"    YPOS    " link pos}
  41.         @{"  ICONXPOS  " link pos}
  42.         @{"  ICONYPOS  " link pos}
  43.         @{"OVERCDPATCH " link hacks}
  44.         @{" QCODEHACK  " link hacks}
  45.         @{" SEEK&PLAY  " link hacks}
  46. Please note: Shell arguments are just the same ( plus some shortcuts).
  47. @endnode
  48. @node scsiname ""
  49.  @{b}SCSINAME@{ub} ( Shell shortcut: d)
  50.  SCSINAME specifies the name of the SCSI device attached to the cd drive.
  51.  If this is missing the program tries to use the device specified in the
  52.  FileSystemStartupMessage of the 'cd0:' filesystem - this may fail and
  53.  leads to an error message.
  54.  Users of a CD
  55. -emulation with a cd.device should use @{"USECD32" link usecd32}.
  56. @endnode
  57. @node scsiunit ""
  58.  @{b}SCSIUNIT@{ub} ( Shell shortcut: u)
  59.  SCSIUNIT expects a numerical value and specifies the unit nuber of
  60.  the SCSI cd-driver. For more details see @{"SCSINAME" link scsiname}
  61. @endnode
  62. @node usecd32 ""
  63.  @{b}USECD32@{ub}
  64.  This enables the use of a cd.device which is shipped with any useful
  65.  emulation. Most of the ATAPI-software drivers have it included.
  66. @endnode
  67. @node mono ""
  68.  @{b}MONO@{ub}
  69.  Normally BCDPlay starts up using 8 MagicWB colors. If your Workbench
  70.  has other or only 4 colors then you can use MONO to force a 4 color
  71.  GUI.
  72. @endnode
  73. @node hires ""
  74.  @{b}HIRES@{ub}
  75.  The GUI is designed for screens with a pixel aspect of 1:1.
  76.  To enjoy the GUI with e.g. a PAL:Hires screen, which has
  77.  'tall' dots, you can double the width of the player
  78.  window by specifying HIRES.
  79. @endnode
  80. @node pubscreen ""
  81.  @{b}PUBSCREEN@{ub}
  82.  Select a Pubscreen to open the window on.
  83.  !!!! The screen notify works only with the WB-Screen
  84. @endnode
  85. @node iconify ""
  86.  @{b}ICONIFY@{ub}
  87.  Start up with a small window with no time display.
  88. @endnode
  89. @node autostart ""
  90.  @{b}AUTOSTART@{ub}
  91.  Begin to play as soon as an audio CD is inserted.
  92.  !!!! This flag can only be specified at startup
  93. @endnode
  94. @node pos ""
  95.  @{b}XPOS@{ub}      (Shell shortcut: x)
  96.  @{b}YPOS@{ub}      (Shell shortcut: y)
  97.  @{b}ICONXPOS@{ub} (Shell shortcut: ix)
  98.  @{b}ICONYPOS@{ub} (Shell shortcut: iy)
  99.  Specify window position at startup.
  100. @endnode
  101. @node hacks ""
  102. Try it out  ... and if it works, fine.
  103. @endnode
  104. @node details ""
  105.  Click @{"here" alink overview.iff/main} for an overview picture.
  106.  This picture can be accessed anywhere in the guide by clicking
  107.  the "Help" button (V39+ AmigaGuide/MultiView).
  108.  @{"Time Display" link details}
  109.   This LCD emulation display shows you
  110.   @{"*" link ctrack} current track and play time
  111.   @{"*" link modes} active modes
  112.   @{"*" link status} the CD status
  113.  @{"   Gadgets  " link gadinfo}
  114.    @{"Stop " link stop} @{"Previous Track" link prev} @{"Play " link play} @{"Next Track" link next} @{"Eject" link eject}
  115.     @{"          Direct Track Selection          " link dtracks}
  116.    @{"Timer Mode" link tmode} @{"Intro" link mode} @{"Repeat" link mode} @{"Program Mode" link memmode} @{"  +10  " link dtracks}
  117.  @{"Volume Control" link ctrack}
  118. @endnode
  119. @node ctrack ""
  120.  @{b}Track and Playtime Display@{ub}
  121.  This display shows you the current track and playtime.
  122.  There are several time modes you can choose from:
  123.  - time from start of track
  124.  - time to end of track
  125.  - time to end of program / disc
  126.  If you press the right mousebutton in the gadgetsfield,
  127.  the whole number of tracks and the disclength will be
  128.  displayed.
  129.  If you press the mouse buttons over the display field,
  130.  the current volume will be displayed ( left - down / right - up).
  131.  A blinking double-dot will be displayed if the add-track memory mode.
  132.  is selected and the cd-player is stopped.
  133.  The timer has a precision of one second. This may lead to
  134.  'drunken timer effects', e.g. skips if the system is heavily loaded.
  135. @endnode
  136. @node modes ""
  137.  @{b} Modes @{ub}
  138.  This display maps directly to the last gadget row, where you can
  139.  select
  140.   - REP repeat mode
  141.   - INT intro mode ( 10sec of each track )
  142.   - MEM program mode
  143. @endnode
  144. @node status ""
  145.  @{b}CD Status@{ub}
  146.  This shows you the CD-Status ( stopped / playing / paused ).
  147.  The information shown here may be incorrect, if the CD drive was
  148.  already playing before BCDPlay was started or you used some hardware buttons
  149.  on the drive.
  150. @endnode
  151. @node gadinfo ""
  152. If you iconify the window, you have only access
  153. to the @{"Stop" beep 0}  to @{"Eject" beep 0}  row.
  154. The Time Display will vanish.
  155. @endnode
  156. @node stop ""
  157.  @{b}Stop / Reset@{ub}
  158.  This button stops playing.
  159.  Pressed twice the Player will be resetted.
  160. @endnode
  161. @node prev ""
  162.  @{b}Previous Track / Rewind@{ub}
  163.  This button selects the previous track and plays it.
  164.  If pressed for a longer while the time will be decreased
  165.  and playing starts at this specified position if released again.
  166. @endnode
  167. @node play ""
  168.  @{b}Play / Pause@{ub}
  169.  This button plays the current track. If already playing,
  170.  the track will be paused and with another click resumed.
  171.  Differences between pause and stop:
  172.   After a stop the track will be played from the start.
  173. @endnode
  174. @node next ""
  175.  @{b}Next Track / Fast Forward@{ub}
  176.  This button selects the next track and plays it.
  177.  If pressed for a longer while the time will be increased
  178.  and playing starts at this specified position if released again.
  179. @endnode
  180. @node eject ""
  181.  @{b}Eject@{ub}
  182.  This opens/closes the disc tray. This may not always work,
  183.  some drives will not eject an empty tray.
  184. @endnode
  185. @node dtracks ""
  186.  @{b}Track Selection@{ub}
  187.  Here you can select a track directly. To select tracks >10
  188.  use the '+10' button, eg. track 24 -> +10 +10 4 .
  189.  Playing starts immediatly if not in MEM mode.
  190. @endnode
  191. @node tmode ""
  192.  @{b}Timer Mode@{ub}
  193.  This gadget cycles through the available timer-modes:
  194.  - time from start of track
  195.  - time to end of track
  196.  - time to end of program / disc
  197.  The last two modes are denoted by a negative sign in
  198.  the time display.
  199. @endnode
  200. @node memmode ""
  201.  @{b}The Program Mode@{ub}
  202.  The mem-mode gadget enables/disables the
  203.  add/insert-track-editor.
  204.  To use it :
  205.  1.) Select first track in the program
  206.  2.) Press STOP and select MEM - you will
  207.     see a blinking double dot.
  208.  3.) Select another track.
  209.  4.) Repeat 3 until your program is ready.
  210.  5.) Press PLAY.
  211.  Other usage:
  212.  - Play track over and over:
  213.     Select track
  214.     Select MEM
  215.     Select REPEAT
  216.    ( this creates a program which contains
  217.      the current track twice )
  218.  - Create random program with all tracks:
  219.     Select MEM
  220.     Select MEM
  221.    ( Do nothing inbetween !)
  222. Notes:
  223.  - PREV/NEXT work during editing, so you
  224.    can insert tracks.
  225.  - After a PLAY command, editing is disabled. To
  226.    re-enable select MEM.
  227.  - Editing the program while playing may lead
  228.    to unwanted effects.
  229.  - Program buffer has room for 39 tracks.
  230.  - To stop a program use @{"RESET" link stop}
  231.    or select a track ( while not in edit-mode).
  232. @endnode
  233. @node mode ""
  234.  @{b}Intro Mode@{ub}
  235.  Intro mode plays the first ten seconds of each track
  236.  in the program or on the disc, it 'wraps around' if
  237.  REPEAT is active.
  238.  @{b}Repeat Mode@{ub}
  239.  Repeat mode plays the disc or program over and
  240.  over. For specific use look at {"MEM mode" link memmode}.
  241. @endnode
  242. @node cright ""
  243.  @{b}Copyright@{ub}
  244.  Code           
  245.  Elmar Plischke
  246.  Icon and Graphics 
  247. rn  Plischke
  248.  Permission is hereby granted to use and distribute
  249.  this program for non-commercial purposes as long as the
  250.  program and its accompanied files are not modified in any way.
  251.  Please contact me for commercial redistribution, e.g. on coverdisks.
  252.  This program comes with absolutly no warrenty.
  253.  @{b}Tested configurations@{ub}
  254.  A4000/040 with Mitsumi FX001D/ internal AT/ VOBKit
  255.  A4000/040 with Mitsumi Quadspeed/ internal AT/ idefix and a4k atapi drivers
  256.  A1200/030 with Mitsumi Quadspeed/ PCMCIA / Overdrive
  257.  A1200/020 with Goldstar 6
  258. speed/ internal AT/ a4k atapi
  259.  Only minor problems were encountered due to the different implementations
  260.  of a CD
  261. -emulation cd.device.
  262.  Please note the SCSI-Code has never seen any 'real' SCSI CD drive.
  263.  @{b}Contact Address@{ub}
  264.  Send any questions, bugreports, gifts or postcards to
  265.  Elmar Plischke
  266.  Schollstr. 68             email:
  267.  27755 Delmenhorst        <elmar@zfn.uni-bremen.de>
  268.  Germany
  269. @endnode
  270. @node arexx ""
  271. @{b}ARexx@{ub}
  272. BCDPlay has an ARexx-port named 'BCDPLAY' with
  273. the following command set :
  274.  @{" RESET  " link ARexx}
  275.  @{"  STOP  " link ARexx}
  276.  @{"  PLAY  " link ARexx}
  277.  @{" PAUSE  " link ARexx}
  278.  @{"  NEXT  " link ARexx}
  279.  @{"  PREV  " link ARexx}
  280.  @{" TRACK  " link ARexx} number
  281.  @{"PROGRAM " link ARexx} numberlist
  282.  @{" RANDOM " link ARexx}
  283.  @{" REPEAT " link ARexx}
  284.  @{" INTRO  " link ARexx}
  285.  @{" EJECT  " link Arexx}
  286.  @{"   LCD  " link Arexx} string (8 characters)
  287.  @{"  QUIT  " link ARexx}
  288.  @{"ICONIFY " link ARexx}
  289. @endnode
  290. @node x
  291. \__/  \__/  \__/  \__/    \__/  \__/  \__/  \__/    \__/  \__/  \__/  \
  292. /  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/
  293. \__/  \__/  \__/  \__/    \__/  \__/  \__/  \__/    \__/  \__/  \__/  \
  294. /  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/
  295. @endnode
  296.