home *** CD-ROM | disk | FTP | other *** search
/ Programming Tool Box / SIMS_2.iso / vb_code2 / shuffle1 / readme.txt < prev    next >
Text File  |  1992-05-03  |  4KB  |  102 lines
  1. SYSTEM SOUND SHUFFLER, Ver 1.1
  2.  
  3. What it is
  4. ==========
  5. Shuffler is designed to add some variety to system sound events in 
  6. Windows 3.1.  It lets you designate multiple sound files for each system 
  7. event and "shuffle" between them.  For instance, if you're tired of the 
  8. same Windows Exit Sound every day, put Shuffler in your startup group and 
  9. each time you start Windows Shuffler will randomly select one of your 
  10. designated Windows Exit Sound files to replace the current one.
  11.  
  12.  
  13. System Requirements
  14. ===================
  15. Requires Windows 3.1 and a sound card and driver that will support *.Wav 
  16. files.  In addition, to work with the design files, you'll need the VB 
  17. Professional Toolkit.  If you do not have the Toolkit and you just want 
  18. to run Shuffler, download the compiled program (Shufl2.zip), which 
  19. includes the necessary runtime DLLs.  
  20.  
  21. In order to run Shuffler, the file cmdialog.vbx must be in your path. 
  22. This file is included in Shufl2.zip.  
  23.  
  24.  
  25. How it works
  26. ============
  27. The main Shuffler window shows the following information for each system 
  28. event:
  29.  
  30.   1.    The event name
  31.  
  32.   2.    The current sound file associated with the event (as designated 
  33.     in the Win.ini file)
  34.  
  35.   3.    A list of additional sound files which you've associated with the 
  36.     event (Shuffler chooses from this list when you give it the shuffle 
  37.     command)
  38.  
  39.   4.    A check box indicating whether Shuffling is enabled for this event.  
  40.     When you execute the Shuffle command, Shuffler will assign new 
  41.     sound files only for those events where Shuffling is enabled.  By 
  42.     default, Shuffling is disabled for all events.
  43.  
  44. The above information is stored in a file named "Shuffle.ini" in your 
  45. Windows directory.
  46.  
  47. A brief explanation of the available commands follows:
  48.  
  49.     ADD FILE - Adds a sound file to the list of sound files associated 
  50.     with the selected event.
  51.  
  52.     REMOVE FILE - Removes the selected sound file from the list of 
  53.     sound files associated with the active event.  The sound file is 
  54.     not deleted from disk.
  55.  
  56.     PLAY FILE - Plays the selected sound file.  You can also play a 
  57.     sound file by double clicking on it in the Shuffle Files list box.
  58.     
  59.     SET CURRENT - Assign the selected sound file to the designated 
  60.     system event.  This will update your Win.ini file.
  61.     
  62.     SHUFFLE - A new sound file is randomly selected from the list of 
  63.     associated sound files for all events for which shuffling is enabled.
  64.  
  65.  
  66. Command Line Arguments
  67. =======================
  68. Shuffler recognizes one argument - Shuffle.  This argument causes the 
  69. Shuffle command to be executed without loading the Shuffler form.  If you've 
  70. already configured Shuffler and you just want to shuffle your sound files 
  71. every time you start Windows, put Shuffler in your Startup group with the 
  72. Shuffle argument:
  73.  
  74.     Shuffler shuffle
  75.  
  76.  
  77. Changes to Ver 1.1
  78. =======================
  79.  
  80. If you had the original Shuffler, note that the following changes have been
  81. made to version 1.1:
  82.  
  83.     1.  Shuffler now uses the Windows API function sndPlaySound to play
  84.     sound files.  The previous version used the MCI player from the 
  85.     VB Pro Toolkit and required the file MCI.VBX.  That file is no 
  86.     longer required.
  87.  
  88.     2.  Shuffler no longer maintains a list of sound events in Shuffle.ini.  
  89.     Instead, it reads the events from Win.ini when the program is loaded.
  90.     The advantage to this change is that Shuffler will now pick up new 
  91.     sound events as they're added to your system.  It also prevents 
  92.     Shuffle.ini from getting out of sync with Win.ini
  93.  
  94.  
  95.  
  96. (c) Brian D. Stine, 1992
  97. Uploaded courtesy of Brian Stine, Compuserve ID 73617,323
  98.  
  99. This is freeware.  It is distributed with only one restriction,
  100. and that is that you may not sell the program or charge any fee
  101. for distribution other than a disk copying fee of no more than $10.
  102.