home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / cdrom / cdtoolbox10 / readme < prev    next >
Text File  |  1981-06-29  |  9KB  |  209 lines
  1. CDToolbox - another oscillating Blender Software (BS) production
  2. ----------------------------------------------------------------
  3.  
  4. Here are a load of freely distributable commands for CD drives controlled by
  5. cd.device. Anything that can run AmigaDOS commands (eg. Scala, ARexx program,
  6. or a script) can fully control the CD drive (although not through a serial or
  7. parallel link, unless you use something like DNet which allows you to execute
  8. commands on another computer).
  9.  
  10. All the programs work on the CD32. They should also work on CD drives with
  11. some kind of CD32 emulator, if the emulator's programmed properly.
  12.  
  13.  
  14. Installing
  15. ----------
  16.  
  17. Just copy or drag all the commands from the C drawer in this archive to your
  18. C: drawer, or some other drawer you've got set aside for programs.
  19.  
  20.  
  21. Options
  22. -------
  23.  
  24. Each command needs options given in the normal way (like the commands you
  25. find in the C: drawer such as Copy or Rename). All the options for each
  26. command are listed with each command a bit further down. If you're not sure
  27. about all this /FISH business then...
  28.  
  29.     - /A    Means you've got to use this option.
  30.     - /N    Means the option expects a number.
  31.     - /S    Means the option is a switch. Type the option's name on its
  32.         own to get it working or miss out the name to disable it.
  33.  
  34. If there's no /N and there's no /S, it's a string.
  35.  
  36. If you don't give any options (ie. you just type the command's name on its
  37. own) then the command does whatever the default says on the right hand side.
  38.  
  39. Most of the commands have a CHECK option. If you give this, you'll get a one
  40. word description of what's happening at the moment. Also for script or ARexx
  41. freaks it returns WARN (return code 5) for DOUBLE, ON, OPEN, etc...
  42.  
  43.  
  44. Drive commands
  45. --------------
  46.  
  47. - CDDoor CHECK/S,CLOSE/S,OPEN/S                Default: OPEN
  48.   Open or close the drive door. If you haven't got a motorised drive door, it
  49.   doesn't do a lot.
  50.  
  51. - CDInfo CHECK/S,STATUS/S,TOC/S                Default: STATUS & TOC
  52.   Spews out more info than anyone could possibly need. STATUS shows the drive
  53.   status and TOC lists the contents of the CD. If you give CHECK instead, it
  54.   tests if a CD is in the drive.
  55.  
  56. - CDMotor CHECK/S,OFF/S,ON/S                Default: OFF
  57.   Change the drive motor. Normally you won't need to turn it on because as
  58.   soon as a CD needs to be read it's turned on anyway. But it's quite good if
  59.   the CD in the drive has a spinny pattern on it though. Er.
  60.  
  61. - CDReset CHECK/S,OFF/S,ON/S                Default: OFF
  62.   Change the reset on eject option - that irritating thing where you take out
  63.   a CD and the computer decides that you'd really like it to reset for you.
  64.  
  65.  
  66. Audio commands
  67. --------------
  68.  
  69. - CDAudio CHECK/S,SINGLE/S,DOUBLE/S            Default: SINGLE
  70.   Change speed for playing music. Double speed is completely useless in every
  71.   way (unless you're into Autechre or LFO or something).
  72.  
  73. - CDPause OFF/S,ON/S,TOGGLE/S                Default: TOGGLE
  74.   Pause or unpause any music playing with CDPlay. If CDPlay isn't running it
  75.   doesn't do much. The TOGGLE option will make it switch to the other pause
  76.   state.
  77.  
  78. - CDPlay CHECK/S,TRACK/N,OFFSET,LENGTH,PAUSED/S        Default: All CD
  79.   Play all or part of a track or CD.
  80.  
  81.   If you don't give a track to play, it goes for the start of the CD. If the
  82.   track number you give or the start of the CD happens to be a CD-ROM track
  83.   then it'll stop with an error.
  84.  
  85.   If you give an offset then it'll start playing from that offset into the
  86.   track (or the start of the CD if you didn't give a track number). It's in
  87.   the form minutes:seconds:frames. A frame is 1/75th of a second, it ranges
  88.   from 0 to 74.
  89.  
  90.   If you don't give a length, the whole track is played (or the whole CD if
  91.   you didn't give a track number). The length is given in the same way as the
  92.   offset. The length can go over track boundaries with no problems (unless it
  93.   runs into a CD-ROM track).
  94.  
  95.   CDInfo will probably help a lot when it comes to working out lengths and
  96.   offsets.
  97.  
  98.   If you give the PAUSED switch, CDPlay will go to the start of the section
  99.   to play but then it'll go straight into pause and wait for the CDPause
  100.   command. This can be useful in presentations where you want any audio to
  101.   immediately happen on some action or in time with a visual effect. You can
  102.   set it up a couple of seconds before then unpause when the action happens,
  103.   so there's no annoying seek times. You could even copy CDPause to RAM: for
  104.   the most speed possible. If the action never gets round to happening, just
  105.   use CDStop. You don't even need to do that if your program doesn't need to
  106.   load files off CD (playing music, even when paused, stops files from being
  107.   read in until the music finishes), look down a couple of paragraphs about
  108.   running CDPlay twice.
  109.  
  110.   The Archos Overdrive CD with V9 of the software or below can't use this
  111.   option because of buggy CD32 emulation. Versions 10 and up may be able to,
  112.   but I haven't been able to check. If it can't and you need it, please yell
  113.   at Archos.
  114.  
  115.   CDPlay will only return when the play has finished. If you're calling this
  116.   from another program (eg. Scala), or even a shell, you'll probably want to
  117.   run it in the background. You can do this by sticking a 'Run <>NIL:' before
  118.   'CDPlay <whatever>'.
  119.  
  120.   If you manage to run CDPlay twice in the background to play two tracks at
  121.   once, the first one will stop and give way to the second.
  122.  
  123.   A few examples are probably in order...
  124.  
  125.   - CDPlay
  126.     Play the entire CD.
  127.  
  128.   - CDPlay 4
  129.     Play track 4.
  130.  
  131.   - CDPlay 3 2:50:37
  132.     Play track 3, starting from 2 minutes 50 and half a seconds into the
  133.     track.
  134.  
  135.   - CDPlay 5 LENGTH 1:12:0
  136.     Play the first 1 minute 12 seconds of track 5.
  137.  
  138.   - CDPlay LENGTH 1:12:0
  139.     Play the first 1 minutes 12 seconds of the CD.
  140.  
  141.   - CDPlay 8 3:12:0 0:4:0 PAUSED
  142.     Play track 8, starting 3 minutes 12 into the track and lasting for 4
  143.     seconds, but wait for CDPause before starting.
  144.  
  145.   If you give the CHECK switch, it'll check if another CDPlay is playing a CD
  146.   at the moment. This won't check if any other players, for example DCPlayer
  147.   (plug), is playing a CD.
  148.  
  149. - CDStop
  150.   Stop any music playing with CDPlay. If CDPlay isn't running it doesn't do
  151.   much.
  152.  
  153. - CDVolume CHECK/S,OFF/S,ON/S,VOLUME/N,FRAMES/N        Default: ON
  154.   Change the volume level for playing music. The volume ranges from 0 to
  155.   32767. OFF can be used instead of 0, and ON can be used instead of 32767.
  156.  
  157.   If you give the FRAMES option, the volume will fade up or down gradually to
  158.   the new volume in the time you give. A frame is 1/75th of a second, so 75
  159.   will alter the volume gradually over 1 second.
  160.  
  161.   Some CD drives don't support volume changing. Others may only have OFF and
  162.   ON (like the CD32). Others may be limited to say 4 volumes. In that case,
  163.   the 4 volumes are stretched out to 32768 volumes, so 0 to 8191 is volume
  164.   level 1, 8192 to 16383 is volume level 2, and so on...
  165.  
  166.  
  167. CD-ROM commands
  168. ---------------
  169.  
  170. - CDRead FILE/A,OFFSET/A/N,LENGTH/A/N
  171.   Read sectors off the CD into a file. The offset is in sectors (you can use
  172.   the CDInfo command here) and the length is in bytes (but it will always be
  173.   rounded up to an even number).
  174.  
  175.   This won't read music tracks because either cd.device doesn't allow music
  176.   to be read or the drive itself won't transfer music across to memory, not
  177.   sure which.
  178.  
  179. - CDSize CHECK/S,SIZE/N                    Default: 2048
  180.   Change the sector size for reading CD-ROMs. There's 2048 (the default) or
  181.   2328 (which isn't). If you set it to one option, the other size CDs can't
  182.   be read. Probably only useful for reading weird CDs from other computers.
  183.  
  184. - CDSpeed CHECK/S,SINGLE/S,DOUBLE/S            Default: DOUBLE
  185.   Change the speed mode - with this you can read in data at 300K/s instead of
  186.   the usual 150K/s. It can be a bit unreliable though.
  187.  
  188.  
  189. Boring wibble
  190. -------------
  191.  
  192. All the programs are copyrighted by me, but they're all freely distributible.
  193. They shouldn't be altered in any way and you should only charge for disks,
  194. postage, or packing if you charge anything for copying. Copy the complete
  195. archive if you pass this onto a BBS or PD library or something.
  196.  
  197. All the programs work fine for me, but if your CD drive blows up or something
  198. then then I can't be held responsible for the mess - use at your own risk and
  199. all that. It's free, after all.
  200.  
  201. And finally none of the programs or can be used as part of anything that's
  202. sold for profit without my say so, unless it's a presentation, feel free to
  203. use it for them. That includes those nasty capitalistic glossy magazines
  204. with disks and CDs on the front filled full of everyone else's work.
  205.  
  206. My Email address is dan@blender.demon.co.uk, if you find a bug or something.
  207.  
  208. Dan.
  209.