home *** CD-ROM | disk | FTP | other *** search
/ Da Capo / da_capo_vol1.bin / programs / amiga / cdrom / dcplayer / read_me < prev    next >
Text File  |  1995-02-28  |  6KB  |  162 lines
  1. DCPlayer - another pulsating Blender Software (BS) production
  2. -------------------------------------------------------------
  3.  
  4. It's yet another music CD player. This one sits quietly in the background and
  5. watches the buttons on the control pad (or joystick) plugged into controller
  6. port 1.
  7.  
  8. So now it's possible to play CDs whilst doing something else using Workbench.
  9. When it's time to swap CDs or skip tracks you just press a button on the pad
  10. and carry on with what you were doing before, instead of shuffling through
  11. windows or screens, clicking on something, then finding your way back.
  12.  
  13. I really wrote it to help me sample CDs - I find that the CD32 control pad is
  14. faster to use than my stereo and I don't want wires trailing across the room
  15. - instead I have a sampler that's connected from the SX-1's parallel port to
  16. the CD32's audio output, some sample software, and this to skip to the right
  17. place on the CD before starting sampling. Easy, eh?
  18.  
  19. And another good reason - at the moment nobody's found out a way of ripping
  20. audio data from CD to memory with cd.device. So this is the next best thing.
  21.  
  22.  
  23. So, what does it work on?
  24. -------------------------
  25.  
  26. The CD32. You'll need to access the Workbench or a shell. This can be done
  27. with one of the many serial links that connect to the aux port or the SX-1 or
  28. CD32x which connect to the expansion port.
  29.  
  30. It should also work on Amigas with CD drives, provided that you are running
  31. some kind of CD32 emulation software and you have lowlevel.library in the
  32. LIBS: directory. Some examples...
  33.  
  34.     - An A1200 with the Archos Overdrive CD drive.
  35.     - An A1200 with the Hi-Soft Squirrel or Power CD-ROM drive
  36.       (both these drives are really the same).
  37.     - Any Amiga with Cache-CDFS and an IDE or SCSI CD drive.
  38.     - Any Amiga with Kickstart 3.1 and a SCSI-2 CD drive.
  39.  
  40. It doesn't work with the CDTV or A570 because those machines use cdtv.device
  41. and I don't have any info on that...
  42.  
  43.  
  44. Installing
  45. ----------
  46.  
  47. Drag the icon to your C: drawer or some other drawer that you've got set
  48. aside for programs. That's it. Have a slice of chocolate roll.
  49.  
  50.  
  51. Options
  52. -------
  53.  
  54. All of the options can be used in the tooltype list if you run it from
  55. Workbench or placed after the program name if you run it from the shell...
  56.  
  57. - DISPLAY
  58.   You get a little read out on the screen of what's happening. It's really a
  59.   sprite, so it doesn't matter if you flip screens or have an autoscrolling
  60.   Workbench screen, it always stays there.
  61.  
  62.   There appear to be problems with the sprites in weird screen modes like
  63.   DBLPAL, DBLNTSC, or Super72 for example (probably more). Unfortunately
  64.   there's no way I can easily change and test the program because I use PAL
  65.   High Res and a telly which tends to go a bit spastic if you chuck a weird
  66.   screen mode at it.
  67.  
  68. - CHANGE
  69.   If you give this option, the display will only appear if something changes,
  70.   then it'll disappear soon after.
  71.  
  72. - LEFT=<number>
  73.   The distance from the left edge of the screen to the display. 0 is the far
  74.   left and 319 is the far right (but it could be a bit more if you've got an
  75.   overscanned screen).
  76.  
  77. - TOP=<number>
  78.   The distance from the top edge of the screen to the display. 0 is the top
  79.   and 255 (or 199 for NTSC) is the bottom edge (or a bit more for overscan).
  80.  
  81. - COLOUR1=<R><G><B>
  82.   COLOUR2=<R><G><B>
  83.   COLOUR3=<R><G><B>
  84.   The highlight, shadowed, and bright colours of the display. Each R, G, and
  85.   B number ranges from 0 to 9 or A to F (for 10 to 15). You can't leave a
  86.   space between the numbers. If you want, you can use COLOR.
  87.  
  88. The defaults are no display, no change, the left edge just a little bit away
  89. from the right edge of the screen, the top edge just a little bit away from
  90. the bottom of the screen, and some very tasteful colours.
  91.  
  92. With the left and top edge defaults, it has a guess at where the far end of
  93. the screen is, but it goes a bit mad when you have two screens displayed at
  94. once (say when the Workbench screen is dragged down a bit). Once you've told
  95. it exactly where on the screen you'd like the display to appear, it doesn't
  96. matter anyway.
  97.  
  98.  
  99. Running
  100. -------
  101.  
  102. From the Workbench, click on the icon once to start it and again to stop it.
  103. To run it all the time, drag it to your WBStartup drawer.
  104.  
  105. From the shell, type "DCPlayer" to start it and either run it again from
  106. another shell or press CTRL and C to stop it. Or you can use something like
  107. "Run <>NIL: DCPlayer" to start it and again to stop it. To run it all the
  108. time, put "Run <>NIL: DCPlayer" at the end of your User-Startup.
  109.  
  110. You can start it through Workbench and stop it through the shell, or the
  111. other way round, if you see what I mean.
  112.  
  113.  
  114. Controls
  115. --------
  116.  
  117. The CD32 pad is used in almost the same way as it is in the CD32's music CD
  118. player. There are a few differences though. Skipping tracks is different - it
  119. makes things easier for sampling (er, and it's easier to code...). If your CD
  120. drive can eject CDs, you can use the shuffle button.
  121.  
  122. If you don't have a CD32 pad you can use a Megadrive joypad, a Master System
  123. joypad, or a two button joystick instead. You just can't eject CDs or repeat,
  124. a shocking loss as I'm sure you'll agree.
  125.  
  126. Finally if you've got an old crappy single fire button joystick you don't get
  127. eject or repeat and you're not able to stop the CD (but you can still pause
  128. it though).
  129.  
  130.     Function        CD32 pad        Others
  131.     --------        --------        ------
  132.  
  133.     Play/Pause        Select/Play        Fire
  134.     Stop/Really stop    Stop            (2nd fire)
  135.     Search <        Reverse            Up
  136.     Search >        Forward            Down
  137.     Track  <        Left            Left
  138.     Track  >        Right            Right
  139.     Eject/Close        Shuffle
  140.     None/Repeat/Repeat 1    Loop
  141.  
  142.  
  143. Boring wibble
  144. -------------
  145.  
  146. This is copyrighted by me but freely distributible. It shouldn't be altered
  147. in any way and you should only charge for disks, postage, or packing if you
  148. charge anything.
  149.  
  150. If something goes wrong (it crashes, an android appears from a trapdoor in
  151. the floor and blows up your CD32, etc...) then I can't be held responsible
  152. for the mess - you use this program at your own risk. After all, it's free -
  153. what more do you want?
  154.  
  155. And it can't be used as part of anything that's sold for profit without my
  156. say so, although the chances of that are fairly remote, I think. Oh, that
  157. means cover CDs and disks on those glossy magazines as well.
  158.  
  159. My Email address is dan@blender.demon.co.uk, if you spot a bug or something.
  160.  
  161. Dan.
  162.