home *** CD-ROM | disk | FTP | other *** search
/ Sound Sensations! / sound_sensations.iso / voc / vocboot / vocboot.doc < prev    next >
Text File  |  1992-07-05  |  5KB  |  113 lines
  1.                   WELCOME TO VOCBOOT V1.0
  2.  
  3. ***HISTORY***
  4.  
  5. Actually, there's very little history to VOCBOOT.  I saw a nifty little
  6. utility one day called SBBOOT, which did nothing more than play a random
  7. .VOC file on the sound blaster.  A couple of limitations to this
  8. program, though, first, it used the program VPLAY, packed with the
  9. SoundBlaster.  Second, it only held 5 .VOC files.
  10.  
  11. This posed two problems.  One, I had a ThunderBoard (A SB Compatible).
  12. This meant that the VPLAY program didn't come with my board.  I renamed
  13. my file (PLAYFILE.EXE), only to find that the other program was also
  14. passing parameters that weren't supported.  <SIGH>
  15.  
  16. I didn't mind using an external player, since I'm not a hard-core
  17. machine language programmer, and besides, why re-invent the wheel?  But
  18. I did want more .VOC files supported.
  19.  
  20. ***DEVELOPMENT***
  21.  
  22. Well, don't laugh.  It took me about 15 minutes of pounding code into
  23. QuickBasic to develop this.  It has a nice little random number seeder,
  24. so it SHOULD be different each time you boot.  It also checks to make
  25. sure that you have at least ONE .VOC file in the configuration.  It will
  26. NOT, however, check to make sure the path and such is right.  You have
  27. up to 30 characters to specify.  Personally, I have a directory that I
  28. keep my player and .VOC files in, so it's easy to run.
  29.  
  30. The code was tested and compiled on 7/5/1992.
  31.  
  32. ***USE***
  33.  
  34. Ok, OK, enough of WHY I wrote it, let's talk about HOW to use it.  It
  35. was actually my first experiment with parameter passing to a QB program
  36. that made this a nifty program.  There are only three parameters that
  37. are used with VOCBOOT.  -C , -L , and -R.
  38.  
  39. -C   --- Configure
  40.  
  41. To configure the program, just enter VOCBOOT -C    This will take you to
  42. a configuration screen.  Just type in the name (and optionally the path)
  43. of your .VOC file player, and press [ENTER].
  44.  
  45. Next, you are asked for up to 20 .VOC files, that you wish to be
  46. randomly played when you boot (or call the program).  Just enter the
  47. name, and press [ENTER].  Keep in mind that if your player requires the
  48. .VOC extension, it should also be entered at this time.  (PLAYFILE sent
  49. with the ThunderBoard supports both .VOC and .WAV formats.  Use the
  50. extension.  For that matter, you can even use .WAV files as well!  Isn't
  51. that nifty?  <Grin>)
  52.  
  53. Press [ENTER] on a .VOC input if you don't wish to enter any more.  You
  54. can enter up to 20 .VOC files, and as few as 1 (although that would be a
  55. bit tiring....)
  56.  
  57. -R   --- Random Play
  58.  
  59. This is the command that should be in your AUTOEXEC.BAT.  It selects one
  60. of the .VOC files from the config file (VOCBOOT.CFG), and plays it.
  61. Simple.
  62.  
  63. -L   --- List Play
  64.  
  65. You can use this option to play ALL the .VOC files listed in the
  66. configuration.  I didn't see much use for it personally, but I included
  67. it because the other program that I saw had it as well.  <Shrug>
  68.  
  69. ***SAMPLE AUTOEXEC.BAT***
  70.  
  71. Somewhere in your AUTOEXEC.BAT file, these lines (or ones like them)
  72. should be there.
  73.  
  74. CD \TBOARD             --- the directory where your files are
  75. VOCBOOT -R             --- here it is!
  76.  
  77. This method will make sure that it can find your .VOC files.  As I said,
  78. there's nothing in the program to make sure you're not lying to it.
  79.  
  80. ***OTHER STUFF***
  81.  
  82. I wrote this program just mainly because I was bored, and the one that I
  83. originally found didn't fit the bill.  I don't want any money for it,
  84. it's not worth it.  It took something like 15 minutes of my time to
  85. write and compile, and was fun.  HOWEVER, I would like to just ask that
  86. if you get it and try it out, just drop me a line.  I've put my name and
  87. address below.  I'd just like to see a) if anyone really does use it,
  88. and b) how far this thing can jump across the world.. <Grin>
  89.  
  90. If you have any comments or suggestions, or would like to discuss the
  91. code for it, you can drop me a line.
  92.  
  93. ***DISCLAIMER***
  94.  
  95. This software is provided as-is, without warranty of any kind.  The
  96. author will assume no liability for any damages, direct or consequental,
  97. from it's use.  This program may be distributed freely without charge as
  98. long as it is unaltered, and this document is included with it.  This
  99. product is being released into the "FREEWARE" market, meaning that it is
  100. free for all to use in it's UNALTERED FORM.  This program is
  101. copyright (C) 1992, MicroProcessor Controls.
  102.  
  103. ***THE LAST WORD***
  104.  
  105. Thank you for trying this program!  Don't forget to write.
  106.  
  107. Greg Baughman
  108. Microprocessor Controls
  109. 510 Albert Ave.
  110. Joliet, IL 60433-1101
  111.  
  112.  
  113.