@database BCDPlay.guide
@width 72
@node Main "BCDPlay documentation"
@help overview.iff/main
@{b}------------------------------------------------------------@{ub}
		      BCDPlay 0.34 (5.8.96)
			by Elmar Plischke
		      The better (beta) CDPlayer
@{b}------------------------------------------------------------@{ub}
@{i} Noch in Arbeit ... @{ui}
		    @{"Introduction" link intro}
		    @{"Installation" link install}
		    @{"   Usage    " link details}
		    @{"  Copyright " link cright}
@endnode
@node intro ""
Welcome to BCDPlay, an easy-to-use cd player which supports SCSI
and CD
 compatible cd-drives and comes with a stylish GUI that
does not depend on MUI, external fonts or graphics data.
BCDPlay has a minimal @{"ARexx" link arexx} interface to allow
external control.
@endnode
@node install ""
 @{b}Installation@{ub}
Just copy the program somewhere in your path.
BCDPlay requires no external fonts or data,
but uses ARexx and screennotify.library where available.
 @{b}How to Suit Your Needs @{ub}
BCDPlay comes with a lot of tooltypes to configure it:
		@{"  SCSINAME  " link scsiname}
		@{"  SCSIUNIT  " link scsiunit}
		@{"  USECD32   " link usecd32}
		@{"   MONO     " link mono}
		@{"   HIRES    " link hires}
		@{" PUBSCREEN  " link pubscreen }
		@{"  ICONIFY   " link iconify }
		@{"  AUTOSTART " link autostart}
		@{"    XPOS    " link pos}
		@{"    YPOS    " link pos}
		@{"  ICONXPOS  " link pos}
		@{"  ICONYPOS  " link pos}
		@{"OVERCDPATCH " link hacks}
		@{" QCODEHACK  " link hacks}
		@{" SEEK&PLAY  " link hacks}
Please note: Shell arguments are just the same ( plus some shortcuts).
@endnode
@node scsiname ""
 @{b}SCSINAME@{ub} ( Shell shortcut: d)
 SCSINAME specifies the name of the SCSI device attached to the cd drive.
 If this is missing the program tries to use the device specified in the
 FileSystemStartupMessage of the 'cd0:' filesystem - this may fail and
 leads to an error message.
 Users of a CD
-emulation with a cd.device should use @{"USECD32" link usecd32}.
@endnode
@node scsiunit ""
 @{b}SCSIUNIT@{ub} ( Shell shortcut: u)
 SCSIUNIT expects a numerical value and specifies the unit nuber of
 the SCSI cd-driver. For more details see @{"SCSINAME" link scsiname}
@endnode
@node usecd32 ""
 @{b}USECD32@{ub}
 This enables the use of a cd.device which is shipped with any useful
 emulation. Most of the ATAPI-software drivers have it included.
@endnode
@node mono ""
 @{b}MONO@{ub}
 Normally BCDPlay starts up using 8 MagicWB colors. If your Workbench
 has other or only 4 colors then you can use MONO to force a 4 color
 GUI.
@endnode
@node hires ""
 @{b}HIRES@{ub}
 The GUI is designed for screens with a pixel aspect of 1:1.
 To enjoy the GUI with e.g. a PAL:Hires screen, which has
 'tall' dots, you can double the width of the player
 window by specifying HIRES.
@endnode
@node pubscreen ""
 @{b}PUBSCREEN@{ub}
 Select a Pubscreen to open the window on.
 !!!! The screen notify works only with the WB-Screen
@endnode
@node iconify ""
 @{b}ICONIFY@{ub}
 Start up with a small window with no time display.
@endnode
@node autostart ""
 @{b}AUTOSTART@{ub}
 Begin to play as soon as an audio CD is inserted.
 !!!! This flag can only be specified at startup
@endnode
@node pos ""
 @{b}XPOS@{ub}	  (Shell shortcut: x)
 @{b}YPOS@{ub}	  (Shell shortcut: y)
 @{b}ICONXPOS@{ub} (Shell shortcut: ix)
 @{b}ICONYPOS@{ub} (Shell shortcut: iy)
 Specify window position at startup.
@endnode
@node hacks ""
Try it out  ... and if it works, fine.
@endnode
@node details ""
 Click @{"here" alink overview.iff/main} for an overview picture.
 This picture can be accessed anywhere in the guide by clicking
 the "Help" button (V39+ AmigaGuide/MultiView).
 @{"Time Display" link details}
  This LCD emulation display shows you
  @{"*" link ctrack} current track and play time
  @{"*" link modes} active modes
  @{"*" link status} the CD status
 @{"   Gadgets  " link gadinfo}
   @{"Stop " link stop} @{"Previous Track" link prev} @{"Play " link play} @{"Next Track" link next} @{"Eject" link eject}
    @{"          Direct Track Selection          " link dtracks}
   @{"Timer Mode" link tmode} @{"Intro" link mode} @{"Repeat" link mode} @{"Program Mode" link memmode} @{"  +10  " link dtracks}
 @{"Volume Control" link ctrack}
@endnode
@node ctrack ""
 @{b}Track and Playtime Display@{ub}
 This display shows you the current track and playtime.
 There are several time modes you can choose from:
 - time from start of track
 - time to end of track
 - time to end of program / disc
 If you press the right mousebutton in the gadgetsfield,
 the whole number of tracks and the disclength will be
 displayed.
 If you press the mouse buttons over the display field,
 the current volume will be displayed ( left - down / right - up).
 A blinking double-dot will be displayed if the add-track memory mode.
 is selected and the cd-player is stopped.
 The timer has a precision of one second. This may lead to
 'drunken timer effects', e.g. skips if the system is heavily loaded.
@endnode
@node modes ""
 @{b} Modes @{ub}
 This display maps directly to the last gadget row, where you can
 select
  - REP repeat mode
  - INT intro mode ( 10sec of each track )
  - MEM program mode
@endnode
@node status ""
 @{b}CD Status@{ub}
 This shows you the CD-Status ( stopped / playing / paused ).
 The information shown here may be incorrect, if the CD drive was
 already playing before BCDPlay was started or you used some hardware buttons
 on the drive.
@endnode
@node gadinfo ""
If you iconify the window, you have only access
to the @{"Stop" beep 0}  to @{"Eject" beep 0}  row.
The Time Display will vanish.
@endnode
@node stop ""
 @{b}Stop / Reset@{ub}
 This button stops playing.
 Pressed twice the Player will be resetted.
@endnode
@node prev ""
 @{b}Previous Track / Rewind@{ub}
 This button selects the previous track and plays it.
 If pressed for a longer while the time will be decreased
 and playing starts at this specified position if released again.
@endnode
@node play ""
 @{b}Play / Pause@{ub}
 This button plays the current track. If already playing,
 the track will be paused and with another click resumed.
 Differences between pause and stop:
  After a stop the track will be played from the start.
@endnode
@node next ""
 @{b}Next Track / Fast Forward@{ub}
 This button selects the next track and plays it.
 If pressed for a longer while the time will be increased
 and playing starts at this specified position if released again.
@endnode
@node eject ""
 @{b}Eject@{ub}
 This opens/closes the disc tray. This may not always work,
 some drives will not eject an empty tray.
@endnode
@node dtracks ""
 @{b}Track Selection@{ub}
 Here you can select a track directly. To select tracks >10
 use the '+10' button, eg. track 24 -> +10 +10 4 .
 Playing starts immediatly if not in MEM mode.
@endnode
@node tmode ""
 @{b}Timer Mode@{ub}
 This gadget cycles through the available timer-modes:
 - time from start of track
 - time to end of track
 - time to end of program / disc
 The last two modes are denoted by a negative sign in
 the time display.
@endnode
@node memmode ""
 @{b}The Program Mode@{ub}
 The mem-mode gadget enables/disables the
 add/insert-track-editor.
 To use it :
 1.) Select first track in the program
 2.) Press STOP and select MEM - you will
	see a blinking double dot.
 3.) Select another track.
 4.) Repeat 3 until your program is ready.
 5.) Press PLAY.
 Other usage:
 - Play track over and over:
    Select track
    Select MEM
    Select REPEAT
   ( this creates a program which contains
     the current track twice )
 - Create random program with all tracks:
    Select MEM
    Select MEM
   ( Do nothing inbetween !)
Notes:
 - PREV/NEXT work during editing, so you
   can insert tracks.
 - After a PLAY command, editing is disabled. To
   re-enable select MEM.
 - Editing the program while playing may lead
   to unwanted effects.
 - Program buffer has room for 39 tracks.
 - To stop a program use @{"RESET" link stop}
   or select a track ( while not in edit-mode).
@endnode
@node mode ""
 @{b}Intro Mode@{ub}
 Intro mode plays the first ten seconds of each track
 in the program or on the disc, it 'wraps around' if
 REPEAT is active.
 @{b}Repeat Mode@{ub}
 Repeat mode plays the disc or program over and
 over. For specific use look at {"MEM mode" link memmode}.
@endnode
@node cright ""
 @{b}Copyright@{ub}
 Code		   
 Elmar Plischke
 Icon and Graphics 
rn  Plischke
 Permission is hereby granted to use and distribute
 this program for non-commercial purposes as long as the
 program and its accompanied files are not modified in any way.
 Please contact me for commercial redistribution, e.g. on coverdisks.
 This program comes with absolutly no warrenty.
 @{b}Tested configurations@{ub}
 A4000/040 with Mitsumi FX001D/ internal AT/ VOBKit
 A4000/040 with Mitsumi Quadspeed/ internal AT/ idefix and a4k atapi drivers
 A1200/030 with Mitsumi Quadspeed/ PCMCIA / Overdrive
 A1200/020 with Goldstar 6
speed/ internal AT/ a4k atapi
 Only minor problems were encountered due to the different implementations
 of a CD
-emulation cd.device.
 Please note the SCSI-Code has never seen any 'real' SCSI CD drive.
 @{b}Contact Address@{ub}
 Send any questions, bugreports, gifts or postcards to
 Elmar Plischke
 Schollstr. 68		     email:
 27755 Delmenhorst	    <elmar@zfn.uni-bremen.de>
 Germany
@endnode
@node arexx ""
@{b}ARexx@{ub}
BCDPlay has an ARexx-port named 'BCDPLAY' with
the following command set :
 @{" RESET  " link ARexx}
 @{"  STOP  " link ARexx}
 @{"  PLAY  " link ARexx}
 @{" PAUSE  " link ARexx}
 @{"  NEXT  " link ARexx}
 @{"  PREV  " link ARexx}
 @{" TRACK  " link ARexx} number
 @{"PROGRAM " link ARexx} numberlist
 @{" RANDOM " link ARexx}
 @{" REPEAT " link ARexx}
 @{" INTRO  " link ARexx}
 @{" EJECT  " link Arexx}
 @{"   LCD  " link Arexx} string (8 characters)
 @{"  QUIT  " link ARexx}
 @{"ICONIFY " link ARexx}
@endnode
@node x
\__/  \__/  \__/  \__/	\__/  \__/  \__/  \__/	\__/  \__/  \__/  \
/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/
\__/  \__/  \__/  \__/	\__/  \__/  \__/  \__/	\__/  \__/  \__/  \
/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/  \__/
@endnode