home *** CD-ROM | disk | FTP | other *** search
/ Audio Plus 10-94 / AUDIOPLUS.ISO / msdos / players / sput111 / sputter.doc < prev    next >
Text File  |  1990-10-29  |  114KB  |  2,624 lines
  1.  
  2.  
  3.                   The SPUTTER Sound System for the PC
  4.                                 v1.11
  5.  
  6.                               VersaWare
  7.                             30 Jennifer St
  8.                           Littleton, MA 01460
  9.                              508-486-3083
  10.  
  11.  
  12.   SPUTTER is a set of programs, that form a full featured sound system that
  13.   allows you to manage and play back many different types of sound files, on
  14.   a variety of different devices.  All conversions are handled automatically,
  15.   regardless of the type of device used to create the sound file.
  16.  
  17.   These are some of the major features of the SPUTTER Sound System:
  18.  
  19.         * Point-and-Play shell with pull-down menus and complete file
  20.           management capabilities to let you play digitized sound
  21.           files, synthesized music files, and text to speech files all
  22.           from within the same program.
  23.  
  24.         * Allows you to attach any of these types of sound files to events
  25.           on your PC such as Program Execution, File access, Disk access,
  26.           Alarm clock settings and replacing the original beep sound.
  27.  
  28.         * Supports many different output devices, including the PC internal
  29.           speaker, Speech Thing, Voice Master, Sound Master, Sound Blaster,
  30.           AdLib Music Card and any other Digital to Analog Converter.
  31.  
  32.         * Supports many different digitized sound file formats including
  33.           Covox (Speech Thing, Voice Master, Sound Master), Creative Labs
  34.           (Sound Blaster), Tandy, Macintosh, Amiga and IBM CVSD files.
  35.           Also supports .ROL synthesized music files (Adlib & Sound Blaster)
  36.           and text to speech synthesized sound.
  37.  
  38.         * Can randomly select sound files to provide variation without
  39.           having to change batch files regularly.
  40.  
  41.         * Can resample digitized sound files, to change the playback rate
  42.           of a file so that it can be played on slower machines.
  43.  
  44.         * Includes enhanced support for DESQview and runs as a well-behaved
  45.           program in a DESQview window.
  46.  
  47.  
  48.   The documentation is divided into the following sections:
  49.  
  50.         1. Installation Guide
  51.  
  52.         2. Quick Start User Guide
  53.  
  54.         3. Reference Manual
  55.  
  56.            3.1  SPUTTER  - File Manager
  57.            3.2  SPUTMON  - Event Monitor
  58.            3.3  SPUT     - Sound & Text Player Utility
  59.            3.4  SPUTROL  - ROL File Player Utility
  60.            3.5  SPUTWAVE - Waveform Viewer
  61.            3.6  SPUTST   - SmoothTalker Utility
  62.  
  63.         4. Miscellaneous
  64.  
  65.  
  66.   *************************************************************************
  67.                        SECTION 1 - INSTALLATION GUIDE
  68.   *************************************************************************
  69.  
  70.   Installation of SPUTTER is very simple, just execute the following steps.
  71.  
  72.   1) Place all of the Sputter programs and required files in a directory
  73.      that is contained in your PATH statement.  Those files are as follows:
  74.  
  75.         SPUTTER.COM             File Manager
  76.         SPUTMON.COM             Event Monitor
  77.         SPUT.COM                Sound & Text file player
  78.         SPUTROL.COM             ROL file player
  79.         SPUT.PHD                Voice file for text-to-speech
  80.         SPUT.DIC                Sample Dictionary file for text-to-speech
  81.         SPUTMON.DEF             Sample Event definition file
  82.         SP-PIF.DVP              DESQview PIF for player window
  83.  
  84.   The following files are required if you will be playing ROL files, and
  85.   are included with the Sputter Demonstration files:
  86.  
  87.         SOUND.COM               AdLib Sound driver
  88.         STANDARD.BNK            AdLib Instrument Bank file
  89.  
  90.   The following files are also included in the distribution, but are not
  91.   necessary for execution:
  92.  
  93.         SPUTTER.DOC             Sputter documentation file
  94.         PHONES.TXT              List of Phonemes from the Doc file
  95.         SAMPLES.TXT             Samples of the Phoneme-functions
  96.         WHATS.NEW               Description of the latest changes
  97.         FUTURE.TXT              What's planned for future releases
  98.         USES.TXT                Some ideas for using Sputter
  99.  
  100.   2) Add a line to your AUTOEXEC.BAT file to define the path in which
  101.      your sound files are stored similar to the following example:
  102.  
  103.                 SET SPUTDIR=C:\SND
  104.  
  105.   3) If you are using any sound device other than the PC Internal Speaker,
  106.      you must add a line to define the port address of your sound board:
  107.  
  108.      For VoiceMasterKey I     SET SPUTARG=/P1          (or 2,3,4)
  109.      For VoiceMasterKey II    SET SPUTARG=/P5          (or 6,7,8)
  110.      For SpeechThing          SET SPUTARG=/P5          (or 6,7,8)
  111.      For SoundBlaster         SET SPUTARG=/P220-S/IR3  (or 230,240,250,260)
  112.      For AdLib card           SET SPUTARG=/P388-A
  113.  
  114.      You may also include any permanent switches you want to define for
  115.      the sound file player:
  116.  
  117.                 SET SPUTARG=/Q2
  118.  
  119.   4) If you are using a SoundBlaster or AdLib card, add a line to define
  120.      the path to your ROL files:
  121.  
  122.                 SET SROLDIR=C:\ROL
  123.      
  124.      and you may optionally add a line to define any permanent switches
  125.      you want to define for the ROL file player:
  126.  
  127.                 SET SROLARG=/Q2
  128.  
  129.   *************************************************************************
  130.                     SECTION 2 - QUICK START USER GUIDE
  131.   *************************************************************************
  132.  
  133.   SPUTTER File Manager:
  134.  
  135.   To start the Sputter Sound System, you must be at the DOS prompt.  Type
  136.   'SPUTTER ' followed by the drive:directory that contains your sound files
  137.   or ROL files, then press the ENTER key:
  138.  
  139.                 SPUTTER C:\SND <enter>
  140.  
  141.   From the File Manager, just place the highlight bar on the file you want
  142.   played and press the ENTER key.  Many other functions are available
  143.   within the File Manager, which can all be found in the pull-down menus.
  144.  
  145.  
  146.   SPUTMON Event Monitor:
  147.  
  148.   To setup the Event Monitor, you must first create an event definition file.
  149.   A sample event definition file SPUTMON.DEF has been included in the
  150.   distribution which may be modified to your preferences.
  151.     
  152.   To load the Event Monitor, type 'SPUTMON ' followed by the name of the
  153.   event definition file, then press the ENTER key:
  154.  
  155.                 SPUTMON SPUTMON.DEF <enter>
  156.  
  157.  
  158.   Now you can enjoy your sound files!
  159.  
  160.   *************************************************************************
  161.                         SECTION 3 - REFERENCE MANUAL
  162.   *************************************************************************
  163.   *************************************************************************
  164.                      SECTION 3.1 - SPUTTER File Manager
  165.   *************************************************************************
  166.  
  167.   This section describes the point-and-play file manager named SPUTTER.
  168.   From the File Manager, sound files can be played, viewed in waveform,
  169.   viewed in ascii/hex mode, copied, renamed, moved and deleted, either
  170.   individually or in tagged groups.
  171.  
  172.         SPUTTER [d:] [\directory] [/E] [/S] [/D] [/T] [/O]
  173.  
  174.   To start the File Manager, simply type 'SPUTTER' at the DOS prompt and
  175.   SPUTTER presents an alphabetized listing of the current directory with
  176.   a menu on the right.  An optional drive and directory may be specified
  177.   as the directory to be used, instead of the current directory.
  178.  
  179.   Optionally, the /E,/S,/D,/T and /O command line switches sort the
  180.   initial directory listing by Extension, Size, Date (/D and/T are the
  181.   same), or Original DOS order.  Once on screen, function keys can be
  182.   used for subsequent sorts.
  183.  
  184.   Once started, SPUTTER will initialize the display as follows:
  185.  
  186.         . The top line is the Menu line, and is activated with the F10
  187.           function key or the slash key (/).
  188.  
  189.         . The second line shows the currently displayed drive & directory.
  190.  
  191.         . The large window on the left is the directory window and contains
  192.           a list of files in the current directory.
  193.           The file attributes (Archive, Hidden, Read-only and System) are
  194.           shown by the appropriate letters to the right of the time for
  195.           each listed file.  A period is displayed for any file attributes
  196.           that are not set.
  197.  
  198.         . The mid-sized window on the upper right is the info window and
  199.           contains various counters, and the state of the toggle switches.
  200.  
  201.         . The smaller window on the lower right is the preview window
  202.           and gives a peek at the contents of the currently highlighted file.
  203.  
  204.         . The line below the windows is the message line and displays
  205.           various prompts and messages.
  206.  
  207.         . The next line is the input line, used for entering data.
  208.  
  209.         . The last line is the function key menu.
  210.  
  211.  
  212.   DOS wildcards ? and * are supported for COPY, MOVE and DELETE operations.
  213.  
  214.   Once SPUTTER has been started, the following keys have meaning:
  215.  
  216.   A-Z
  217.         Pressing a letter, moves the highlight bar to the first (then sub-
  218.         sequent) filename beginning with that letter.
  219.  
  220.   Up & Down
  221.         The Up and Down arrow key moves the highlight bar up or down one
  222.         line at a time.
  223.  
  224.   Home & End
  225.         The Home and End keys go to either the first or last file in the
  226.         directory.
  227.  
  228.   PgDn & PgUp
  229.         The Page-Up and Page-Down keys allow you to scroll up and down
  230.         through the entire directory.
  231.  
  232.   Ctrl-PgDn & Ctrl-PgUp
  233.         The Ctrl-Page-Up and Ctrl-Page-Down move to the top and bottom of
  234.         the current display page (21 files).
  235.  
  236.   Left-Arrow & Right-Arrow or Grey+ & Grey-
  237.         These keys are used to mark and unmark files.  After marking or
  238.         unmarking a file, the highlight bar is automatically moved in the
  239.         same direction that it was moved last.
  240.         Multiple files may be tagged for group playing, viewing, copying,
  241.         moving or deleting.
  242.  
  243.   F1 (Help)
  244.         This key activates the Help pull-down menu.
  245.  
  246.   F2 (Args)
  247.         This key displays the SPUT help screen.
  248.  
  249.   F3 (Dir)
  250.         This key will cause SPUTTER to reread the current directory.
  251.         This is useful if files have been created or added to the
  252.         current directory since starting SPUTTER.
  253.  
  254.   F4 (Chdir)
  255.         This key provides a way to change the current drive and
  256.         directory without leaving SPUTTER.
  257.  
  258.   F5 (Mark)
  259.         This key will cause all previously unmarked files to be marked.
  260.         Files with an asterick are considered marked.  To remark files
  261.         with an asterick, press F6 to clear all marks, then F5 to mark
  262.         all files.
  263.  
  264.   F6 (Clear)
  265.         This key will unmark all files including those with astericks.
  266.  
  267.   F7 (Pause)
  268.         This key will toggle the state of the Pause-after-output switch.
  269.  
  270.   F8 (Output)
  271.         This key will toggle the state of the Output switch.
  272.  
  273.   F9
  274.         This key is currently unused.
  275.  
  276.   F10 (Menu)
  277.         This key invokes the top line menu.
  278.  
  279.   ESCAPE
  280.         Pressing this key exits SPUTTER, and returns to the DOS prompt.
  281.  
  282.   F10+File or Alt-F
  283.         This key activates the File menu.
  284.  
  285.   F10+Sound or Alt-S
  286.         This key activates the Sound menu.
  287.  
  288.   F10+Options or Alt-O
  289.         This key activates the Options menu.
  290.  
  291.   F10+Help or Alt-H
  292.         This key activates the Help menu.
  293.  
  294.   F10+Quit or Alt-Q
  295.         This key activates the Quit menu.
  296.  
  297.   F10+Sound+Play or Enter
  298.         The Play function initiates the playback process for either
  299.         the highlighted or marked file(s).  This option requires the
  300.         appropriate player program to be located in a directory that is
  301.         listed in your PATH statement.
  302.  
  303.         The player programs used are SPUT.COM for digitized sound files,
  304.         and text to speech files and SPUTROL.COM for .ROL synthesized
  305.         music files.
  306.  
  307.         When a marked file is successfully played, it's marker arrow is
  308.         replaced by an asterisk.
  309.  
  310.   F10+Sound+Quick or Ctrl-Enter
  311.         The Play with Quick-arguments function initiates playback for the
  312.         highlighted file, after prompting for an argument string.
  313.         The prompt will appear in the message line, and you can enter
  314.         any valid player switch with slashes. (See the appropriate
  315.         section of the documentation for SPUT and SPUTROL switches).
  316.  
  317.         Note that if the /W switch to SPUT is used to create an 8-bit PCM
  318.         file, or the COPY function is used to create files in the same
  319.         directory, those files will not appear in the directory listing
  320.         until you press F3 to re-read the current directory.
  321.  
  322.   F10+Sound+Last or Ctrl-P
  323.         The Play with Last-arguments function initiates playback for the
  324.         highlighted file, using the previously defined argument string.
  325.  
  326.   F10+Sound+Argument or Ctrl-A
  327.         This key invokes the Argument selection menu.  CTRL-A will invoke
  328.         the Argument selection screen for sound files.
  329.  
  330.   F10+Sound+Clear
  331.         This key clear any previously defined argument string.
  332.  
  333.   F10+Sound+Text
  334.         This key invokes the interactive text-to-speech mode.
  335.  
  336.   F10+Sound+Information or Ctrl-I
  337.         Displays complete file information without playback, for the
  338.         highlighted or marked file(s).  Requires SPUT.COM to be in a
  339.         directory that is listed in your PATH statement.
  340.  
  341.   F10+Sound+Wave or Ctrl-W
  342.         Views the highlighted or marked file(s) as a wave form using the
  343.         SPUTWAVE utility.  Requires SPUTWAVE.EXE to be located in a
  344.         directory that is listed in your PATH statement.
  345.  
  346.   F10+File+Copy or Ctrl-C
  347.         Initiates the copy process for the highlighted or marked file(s),
  348.         after prompting for a destination.  Wildcards ? and * are supported
  349.         and renaming while copying is permitted.
  350.  
  351.         When a marked file is successfully copied, it's marker arrow is
  352.         replaced by an asterisk.  If the target disk(ette) becomes
  353.         filled, during a copy operation, SPUTTER automatically attempts
  354.         to find other marked files that will fit, stopping when there are
  355.         none.  Changing the target diskette, and hitting F1 again, will
  356.         copy the remaining marked files.
  357.  
  358.   F10+File+Move or Ctrl-M
  359.         Moves the highlighted or marked file(s), after prompting for a
  360.         destination.  Wildcards ? and * are supported and renaming while
  361.         moving is permitted.
  362.  
  363.         When a marked file is successfully moved, it's marker arrow is
  364.         replaced by an asterisk.  If the target disk(ette) becomes
  365.         filled, during a move operation, SPUTTER automatically attempts
  366.         to find other marked files that will fit, stopping when there are
  367.         none.  Changing the target diskette, and hitting F1 again, will
  368.         move the remaining marked files.
  369.  
  370.   F10+File+Rename or Ctrl-R
  371.         Renames the highlighted file, after prompting for a new filename.
  372.  
  373.   F10+File+Delete or Ctrl-D or Delete
  374.         Deletes the highlighted or marked file(s), after prompting for
  375.         verification.  Wildcards ? and * are supported.
  376.  
  377.   F10+File+View or Ctrl-V
  378.         Views the highlighted or marked file(s).  Requires LIST.COM to
  379.         be located in the PATH.
  380.  
  381.   F10+File+marK or Ctrl-K or F5
  382.         Marks any files that were previously unmarked.
  383.  
  384.   F10+File+cLear or Ctrl-L or F6
  385.         Clears marks on all files.
  386.  
  387.   F10+Options+Output or Ctrl-O or F8
  388.         Enables or disables the option of seeing the output from the player
  389.         utility during playback.  When a file is played with this option
  390.         enabled, the center of the screen is cleared and the player utility
  391.         output is displayed there.  Pressing this key a second time disables
  392.         the option and it defaults to enabled.  
  393.  
  394.   F10+Options+Pause or F7
  395.         This toggles the state of the Pause-after-playback option.
  396.  
  397.   F10+Options+snoW
  398.         This toggles the state of the Video-snow-suppression option.
  399.  
  400.   F10+Options+Verify
  401.         This toggles the state of the Verify-after-copy option.
  402.         
  403.   F10+Options+Unsorted or Ctrl-U
  404.         Displays the directory in it's original unsorted order.
  405.  
  406.   F10+Options+Name or Ctrl-N
  407.         Sorts the directory list by filename.
  408.  
  409.   F10+Options+Extension or Ctrl-E
  410.         Sorts the directory list by extension.
  411.  
  412.   F10+Options+Size or Ctrl-Z
  413.         Sorts the directory list by file size.
  414.  
  415.   F10+Options+Date or Ctrl-T
  416.         Sorts the directory list by date.
  417.  
  418.   F10+Help+Short
  419.         Displays a help screen of short cut keys.
  420.  
  421.   F10+Help+Function
  422.         Displays a help screen of function keys F1 thru F10.
  423.  
  424.   F10+Help+Navigation
  425.         Displays a help screen of keys used for moving the highlight bar
  426.         within the directory window.
  427.  
  428.   F10+Help+Player or Ctrl-S or F2
  429.         Displays the SPUT help screen.  Requires SPUT.COM to be in a
  430.         directory that is listed in your PATH statement.
  431.  
  432.  
  433.   ***************************************************************************
  434.                       SECTION 3.2 - SPUTMON Event Monitor
  435.   ***************************************************************************
  436.  
  437.   This section describes the program named SPUTMON, which stands for (SPUT)ter
  438.   Event (MON)itor.  SPUTMON is a small memory resident utility (under 5k)
  439.   that lets you attach sound files to events that occur on your PC.
  440.   
  441.   Typing 'SPUTMON ?' at the DOS prompt, will display the program version and
  442.   an abbreviated help screen.
  443.  
  444.   When using SPUTMON the Event Monitor, it is recommended that you keep a
  445.   copy of the player utilities SPUT.COM and SPUTROL.COM on a RAM disk.
  446.   This will reduce system overhead associated with playback at the time
  447.   the events occur.
  448.  
  449.  
  450.   ----------------------------
  451.   SPUTMON SWITCHES & OPERATION
  452.   ----------------------------
  453.  
  454.   ?
  455.         Entering a question mark on the command line, will tell SPUTMON
  456.         to display a short help screen.
  457.  
  458.   /B
  459.         This switch toggles the state of the bells-on-error & retry option
  460.         and defaults to enabled.
  461.  
  462.         When this feature is enabled and SPUTMON is unable to play a file
  463.         at the time an event occurs, a high-pitched bell will sound every 30
  464.         seconds to alert you that what you are doing is preventing playback
  465.         to occur.
  466.  
  467.         If the retry feature has been disabled with the /R switch, SPUTMON
  468.         will play a low pitched buzzer to indicate that playback has been
  469.         cancelled for that event only.
  470.  
  471.         Entering a number after the /B switch, will change the frequency of
  472.         the error/retry bells from 30 seconds to the new value.  Setting
  473.         the value to 0, disables all bells.
  474.  
  475.   /C
  476.         This switch toggles the state of the command-line playback feature
  477.         and defaults to enabled.  This method of playback is only used if
  478.         DESQview is not running, or the /W window playback feature is
  479.         disabled.
  480.  
  481.         When at the DOS prompt, you are actually running COMMAND.COM which
  482.         allocates all of memory to itself.  If an event is triggered, there
  483.         is no available memory for the player program to run or load the
  484.         sound file.  This feature causes the player program to be run from
  485.         the DOS prompt (although you won't actually see the command).
  486.  
  487.         If you are in the middle of typing a line when an event is triggered,
  488.         SPUTMON will not interrupt you.  The playback will just be delayed
  489.         until you enter a carriage return.
  490.  
  491.         If you are idle at the DOS prompt, SPUTMON will print the following
  492.         message on the screen
  493.  
  494.   <SPUTMON is ready to play, press <CTRL-SHIFT> to cancel, <CTRL-ALT> to begin>
  495.  
  496.         then SPUTMON will wait approximately 5 seconds.  If you do nothing,
  497.         or press <CTRL-ALT>, playback will occur.  If you press <CTRL-SHIFT>
  498.         playback for that particular event only will be cancelled.
  499.  
  500.         In both cases, a new DOS prompt will appear, and you may continue
  501.         as usual.
  502.  
  503.   /D
  504.         This switch will disable event monitoring, and SPUTMON will
  505.         remain in memory.
  506.  
  507.   /E
  508.         This switch will reenable event monitoring.
  509.  
  510.   /G
  511.         This switch controls weather the DESQview player window will run
  512.         in the foreground or background.  The default is background.
  513.  
  514.   /I
  515.         This switch is used to reinitialize the event table.  All counters
  516.         are reset to zero, and any events that were marked for playback
  517.         are cancelled.
  518.  
  519.   /M
  520.         This switch toggles the state of the multiple event triggering
  521.         feature, and defaults to disabled.
  522.  
  523.         Normally, when an event occurs, SPUTMON searches the event table
  524.         for a match.  If a match is found, the remainder of the table
  525.         is not checked.  Enabling this feature, tells SPUTMON to check
  526.         the entire table for additional matches.
  527.  
  528.         This switch normally will not affect type T timer events, since
  529.         many clock interrupts will occur for each actual second of time.
  530.  
  531.         Example: If you have the following events defined in your event file
  532.  
  533.                 P  DX.EXE  SHEESH.SND
  534.                 P  *       AHH.SND
  535.  
  536.         With /M disabled, running DX would only play SHEESH.SND.  With
  537.         /M enabled, running DX would play SHEESH.SND and AHH.SND.
  538.  
  539.   /Q
  540.         This switch toggles the quiet screen output feature, and defaults
  541.         to enabled.
  542.  
  543.         Normally SPUTMON sends the appropriate switch to the player program
  544.         to suppress screen output.  Disabling this feature will cause all
  545.         screen output from the player program to be displayed.  This can
  546.         be very useful while writing event definition files.
  547.  
  548.   /R
  549.         This switch toggles the state of the retry playback feature and
  550.         defaults to enabled.
  551.  
  552.         When an event occurs, and SPUTMON is unable to play the sound file,
  553.         in the normal way, or using the /W (DV window) or /C (command line)
  554.         methods, it looks at this switch to decide how to handle the event.
  555.  
  556.         If the retry feature is enabled, SPUTMON will remember that the
  557.         file should be played, and will keep retrying playback until
  558.         successful.  A short high pitched jingle will be heard every 30
  559.         seconds to remind you that a playback is pending.
  560.  
  561.         If the retry feature is disabled, playback will be skipped for
  562.         that particular event only, and you will hear a low pitched buzzer
  563.         if the beep-on-error feature is enabled with /B.
  564.  
  565.   /S
  566.         This switch prints the event table on the screen, which is a list
  567.         of all events being monitored.
  568.  
  569.           TRIGG - is the number of times the event has triggered playback.
  570.           ERROR - is the number of times playback has failed.
  571.           CODE  - is the error code encountered during the last attempted
  572.                   playback.  The first 2 digits are a number representing
  573.                   the process that encountered the error.  A 10xx indicates
  574.                   a player program error.  Any other number is the
  575.                   number of the interrupt handler that encountered the error.
  576.                   (ie: 2108 means playback was attempted by the INT21 handler
  577.                   but failed because of insufficient memory).
  578.           ST    - is the status of the event, with 01 meaning that the event
  579.                   has been marked for playback.
  580.           T     - is the type of file to be played where:
  581.                   1 = Sound file for SPUT.COM  (blank or #S)
  582.                   2 = ROL file for SPUTROL.COM (#R)
  583.                   3 = Text file for SPUT.COM   (blank or #T)
  584.                   4 = Command for COMMAND.COM  (#C)
  585.  
  586.         INT AH AL Disp Trigg Error Code St T Filename     Arguments
  587.         ---------------------------------------------------------------------
  588.          29 FF 07 0C91 00000 00000 0000 00 1 e:\snd\spc\*.ani
  589.          08 FF FF 0C98 00000 00000 0000 00 1 10-19-1990 13:15 255 *.tun
  590.          08 FF FF 0C98 00000 00000 0000 00 1 10-19-1990 13:30 255 *.*
  591.          08 FF FF 0C98 00000 00000 0000 00 1 10-19-1990 12:45 255 *.sfx
  592.          08 FF FF 0C98 00000 00000 0000 00 1 10-19-1990 13:0 255 /ti/r145
  593.          08 FF FF 0C98 00000 00000 0000 00 2 10-19-1990 12:45 255 *
  594.          08 FF FF 0C98 00000 00000 0000 00 2 10-20-1990 12:0 1 bumblbee
  595.          08 FF FF 0C98 00000 00000 0000 00 2 10-19-1990 17:0 1 airnite
  596.          08 FF FF 0C98 00000 00000 0000 00 1 10-20-1990 0:0 1 bed1a
  597.          08 FF FF 0C98 00000 00000 0000 00 1 10-20-1990 0:15 8 bed2a
  598.          08 FF FF 0C98 00000 00000 0000 00 1 10-20-1990 2:0 30 timeup
  599.          21 4B FF 0E07 00000 00000 0000 00 1 CP.EXE       certnly
  600.          21 4B FF 0E07 00000 00000 0000 00 1 DC.EXE       sheesh
  601.          21 4B FF 0E07 00000 00000 0000 00 1 DIRNOTES.COM exc2
  602.          21 4B FF 0E07 00000 00000 0000 00 1 DX.EXE       notsfast
  603.          21 4B FF 0E07 00000 00000 0000 00 1 FGREP.COM    gotit
  604.          21 4B FF 0E07 00000 00000 0000 00 1 LINK.EXE     goodheav
  605.          21 4B FF 0E07 00000 00000 0000 00 1 LIST.COM     heynot
  606.          21 4B FF 0E07 00000 00000 0000 00 1 MAPMEM.EXE   theyrehe
  607.          21 4B FF 0E07 00000 00000 0000 00 1 MASM.EXE     ridic
  608.          21 4B FF 0E07 00000 00000 0000 00 1 MV.EXE       yeah
  609.          21 4B FF 0E07 00000 00000 0000 00 1 NU.EXE       fearnot
  610.          21 4B FF 0E07 00000 00000 0000 00 1 PKUNZIP.EXE  waitmin
  611.          21 4B FF 0E07 00000 00000 0000 00 1 Q.EXE        mistaks
  612.          21 4B FF 0E07 00000 00000 0000 00 1 QU.EXE       hereicom
  613.          21 FF FF 0E53 00000 00000 0000 00 1 *            ahh
  614.         
  615.     Enabled: MONITOR BELLS:30 RETRY QUIET WINDOW/BG COMMAND ■ Disabled: MULTI
  616.     Date/Time: 10-19-1990 12:31:58.10 ■ Active Timers: 10
  617.  
  618.   /U
  619.         This switch will cause SPUTMON to remove itself from memory.
  620.         This can only be done successfully, if no other programs have
  621.         become memory resident since SPUTMON was loaded.
  622.  
  623.   /W
  624.         This switch toggles the state of the DESQview player window
  625.         feature and defaults to enabled.
  626.  
  627.         This section is only applicable when DESQview is running.
  628.  
  629.         If this feature is enabled when an event occurs, a separate
  630.         DESQview window will be started in which to run the player program.
  631.         This window will run in the background, and close when playback is
  632.         finished.  It will appear as a 2x2 character box in the upper left
  633.         hand corner of the screen.
  634.  
  635.         All of the attributes of the DV player window can be changed by
  636.         using the DESQview "Change A Program" utility to modify the DVP
  637.         template file SP-PIF.DVP that comes with SPUTTER.  This DVP file
  638.         must be located somewhere in the PATH, in order for SPUTMON to find
  639.         it when becomming memory resident.
  640.  
  641.         Disabling this feature will cause playback to occur in the same
  642.         window in which the event occurred.
  643.  
  644.   <eventfile>
  645.         This is the name of the event definition file.  If no filename is
  646.         specified, the default of SPUTMON.DEF will be used.  If no directory
  647.         is specified, the current directory is searched, and then the PATH.
  648.  
  649.  
  650.   -----------------
  651.   EVENT FILE FORMAT
  652.   -----------------
  653.  
  654.   The event definition file is a simple ascii file, that can be modified
  655.   with any text editor.  The maximum size of the file is limited to 64k
  656.   bytes, including comments.
  657.  
  658.   Each line in the event file defines a single event.  The first "word" of
  659.   each line, defines the event type and the remainder of the line describes
  660.   the particular event to trigger on.
  661.  
  662.  
  663.   -----------
  664.   EVENT TYPES
  665.   -----------
  666.  
  667.         B <soundfile>
  668.                 This is the BEEP event, and will trigger playback of the    
  669.                 specified soundfile in place of the normal speaker beep.
  670.  
  671.                 Example: 'B CHICK.SND' plays a short clip of peeping chicks
  672.                          instead of the normal speaker beep.
  673.  
  674.         T <sdate> <stime> <idate> <itime> <repeat> <soundfile>
  675.  
  676.                 The TIMER event will trigger playback whenever the set time
  677.                 <sdate><stime> occurs.  Then the repeat <repeat> is
  678.                 decremented, and the increment <idate><itime> is added to
  679.                 the set time to create the next alarm setting.
  680.  
  681.                 Alarms and repeat counts are reset automatically.
  682.  
  683.         Examples:
  684.                 T 00-00-00 12:00 00-00-00 00:00 0 YEAH.TUN
  685.                   at noon every day
  686.                 T 06-25-90 17:00 00-00-00 00:05 5 WOW.TUN
  687.                   from 5:00pm to 5:25 every 5 minutes on 06-25-90
  688.                 T 07-11-90 00:00 00-00-00 00:01 0 wow.tun
  689.                   every min for 1 day
  690.                 T 07-11-90 12:00 00-01-00 00:00 2 wow.tun
  691.                   at noon for 2 days
  692.                 T 07-00-00 12:00 00-01-00 00:00 0 wow.tun
  693.                   at noon every day in July
  694.                 T 00-11-00 12:00 01-00-00 00:00 0 wow.tun
  695.                   at noon on the 11th of every month
  696.                 T 07-00-90 00:00 00-00-00 01:00 0 wow.tun
  697.                   every hour in July
  698.                 T 00-11-00 00:00 00-00-00 01:00 0 wow.tun
  699.                   every hour on every 11th day
  700.  
  701.         P  <progname> <soundfile>
  702.                 The PROGRAM execution event will trigger playback whenever
  703.                 the specified program is run.  The program name follows the
  704.                 same rules for filenames.
  705.  
  706.                 Example: 'P Q.EXE MISTAKS.V8' plays Stooge Moe saying "Now
  707.                          don't make any more mistakes!" when Qedit is run.
  708.                      or: 'P LIST.COM DOC.TUN' plays Bugs Bunny saying "Whats
  709.                          up Doc?" whenever LIST is used to view a file.
  710.  
  711.         FO <filename> <soundfile>
  712.                 The FILE-OPEN event will trigger playback whenever the
  713.                 specified file is opened in read-only mode.
  714.  
  715.                 Example: 'FO * CERTNLY.V8' plays Stooge Curly saying
  716.                          "Certainly!" when any file is opened for reading.
  717.  
  718.         FC <filename> <soundfile>
  719.                 The FILE-CREATE event will trigger playback whenever the
  720.                 specified file is opened for write access.  The DOS COPY
  721.                 command will not trigger this event because of insufficient
  722.                 memory.
  723.  
  724.                 Example: 'FC CONFIG.SYS HEYNOT.V8' plays Stooge Curly saying
  725.                          "Hey not that!" when any program attemps to open
  726.                           CONFIG.SYS for write access.
  727.  
  728.         FR <filename> <soundfile>
  729.                 The FILE-RENAME event will trigger playback whenever the
  730.                 specified file is renamed.  The DOS REName command will not
  731.                 trigger this event.
  732.  
  733.                 Example: 'FR AUTOEXEC.BAT MEANING.TUN" plays Bugs Bunny
  734.                          saying "Whats the meaning of this?" when any program
  735.                          attempts to rename AUTOEXEC.BAT.
  736.  
  737.         FD <filename> <soundfile>
  738.                 The FILE-DELETE event will trigger playback whenever the
  739.                 specified file is deleted.  The DOS DELete command will not
  740.                 trigger this event.
  741.  
  742.                 Example: 'FD * AHH.TUN' plays Yosemite Sam yelling "Ahhhhh"
  743.                          whenever any file is deleted by any program.
  744.  
  745.  
  746.         The following events are called the INT events.  They are more
  747.         complex to setup than the above events, but are much more powerful.
  748.         As a reference, I highly recommend "The Interrupt List" by
  749.         Ralf Brown.  It is available on most BBS's as INTER290.ZIP.
  750.  
  751.  
  752.         I  <int> <ah> <al> <soundfile>
  753.                 The vanilla INT event will trigger playback whenever the
  754.                 specified interrupt <int> occurs, with <ah> matching the AH
  755.                 register and <al> matching the AL register.
  756.  
  757.                 Example:  'I 21 4C FF THATS.TUN' plays Bugs Bunny saying
  758.                           "That's that" whenever a program terminates.
  759.  
  760.         IA <int> <ah> <al> <filename> <soundfile>
  761.                 The INT-ASCIZ event will trigger playback whenever the
  762.                 specified interrupt <int> occurs, with <ah> matching the AH
  763.                 register and <al> matching the AL register.  An additional
  764.                 check is done between <filename> and the filename pointed
  765.                 to by the DS:DX register.
  766.  
  767.                 Example:  'IA 21 43 01 MYFILE CERTNLY.V8' plays Stooge Curly
  768.                           saying "Certainly!" whenever the file attributes of
  769.                           the file named MYFILE are set.
  770.  
  771.         IF <int> <ah> <al> <filename> <soundfile>
  772.                 The INT-FCB event will trigger playback whenever the
  773.                 specified interrupt <int> occurs, with <ah> matching the AH
  774.                 register and <al> matching the AL register.  An additional
  775.                 check is done between <filename> and the filename in the
  776.                 File-Control-Block pointed to by the DS:DX register.
  777.  
  778.                 Example:  'IF 21 15 FF MYFILE HEYNOT.V8' plays Stooge Curly
  779.                           saying "Hey, not that!" whenever a sequential
  780.                           write is done to the file MYFILE.
  781.  
  782.         ID <int> <ah> <al> <drive> <soundfile>
  783.                 The INT-DISK event will trigger playback whenever the
  784.                 specified interrupt <int> occurs, with <ah> matching the
  785.                 AH register and <al> matching the AL register.  An additional
  786.                 check is done between <drive> and the DL register.
  787.  
  788.                 Example:  'ID 13 05 ff 01 WARNING.V8' plays the Robot from Lost
  789.                           in Space saying "Warning Warning" anytime a format
  790.                           disk track is executed on the A drive.
  791.  
  792.  
  793.   --------------------
  794.   EVENT FILE ARGUMENTS
  795.   --------------------
  796.  
  797.   The event type is followed by additional arguments that describe the event
  798.   on which to trigger playback.
  799.  
  800.   Arguments may be separated by commas or any number of spaces.  They may
  801.   appear in upper or lower case.
  802.  
  803.   The arguments used are different for each event type.  All are described
  804.   below:
  805.  
  806.   <filename>
  807.         A filename that may be up to 12 characters in length, and must
  808.         include a period and extension.  It may be a single * to indicate
  809.         a match of any filename.
  810.  
  811.   <soundfile>
  812.         The name of the soundfile to be played at the time the event occurs.
  813.         It may include a full path specification and any valid player
  814.         switches.  If the sound file will be played using SPUT, you may
  815.         also use *.* to invoke random soundfile selection.
  816.  
  817.   <int>
  818.         This is the interrupt number in hexadecimal to monitor.      
  819.         Only interrupts 13 and 21 are supported at this time.
  820.  
  821.   <ah>
  822.         This is the hexadecimal contents of the AH register to be
  823.         checked at the time of the interrupt.  Use FF to indicate
  824.         a match on all values.
  825.  
  826.   <al>
  827.         This is the hexadecimal contents of the AL register to be
  828.         checked at the time of the interrupt.  Use FF to indicate
  829.         a match on all values.
  830.  
  831.   <drive>
  832.         This is the hexadecimal driver number, with 0 being the
  833.         A drive, and 1 the B drive.  Use FF to indicate a match on
  834.         any drive. 
  835.  
  836.   <sdate>
  837.         This is the first date that the alarm should trigger in the
  838.         format MM-DD-YY.  00 in any field, matches every value.
  839.         06-00-90 means every day in June 1990.
  840.  
  841.   <stime>
  842.         This is the first time that the alarm should trigger in the
  843.         format HH:MM. 00:00 means midnight.                                   
  844.  
  845.   <idate>
  846.         This is the increment to add to <sdate> to determine the
  847.         next date that the alarm should trigger.  The format is
  848.         MM-DD-YY.  01-00-00 means add 1 to the month for the next
  849.         alarm date.  00-00-01 means add 1 to the year.
  850.  
  851.   <itime>
  852.         This is the increment to add to <stime> to determine the
  853.         next time that the alarm should trigger.  The format is
  854.         HH:MM.  00:05 means 5 minutes later.  01:00 means 1 hour
  855.         later.
  856.  
  857.   <repeat>
  858.         This is the number of times to add the increment to the
  859.         set time and reset the alarm.  A value of 0 means non-stop.
  860.  
  861.  
  862.   -------------------------------------------------------------
  863.   USING SPUTROL.COM FOR FM MUSIC ON SOUND BLASTER & ADLIB CARDS
  864.   -------------------------------------------------------------
  865.  
  866.   To use SPUTROL to play a ROL file when an event occurs, just insert '#R'
  867.   before the <soundfile> argument.
  868.         
  869.         Example:  'P MYPROG.EXE #R LINUS.ROL'
  870.              or:  'T 00-00-00 12:00 00-00-00 00:00 1 #R LINUS.ROL'
  871.  
  872.         SPUTROL.COM will be used to play LINUS.ROL whenever MYPROG.EXE is
  873.         executed, and every day at 12:00 noon.
  874.  
  875.   This does not require that the sound driver SOUND.COM already be loaded,
  876.   SPUTROL can automatically load SOUND.COM and unload it when playback is
  877.   completed thereby saving valuable memory.  If you plan to use this feature,
  878.   it is recommended that you keep SOUND.COM on a RAMdisk for quicker access.
  879.  
  880.         SOUND.COM v1.51 is Copyright by Ad Lib Inc.
  881.  
  882.  
  883.   ------------------------------------------------
  884.   TRIGGERING OTHER PLAYERS, PROGRAMS & BATCH FILES
  885.   ------------------------------------------------
  886.  
  887.   The Event Monitor also has the ability to start other sound file players,
  888.   programs and batch files when an event occurs.
  889.  
  890.   To use this feature, just preceed the <soundfile> argument with '#C'.
  891.  
  892.         Example:  'FD DEMO.TMP #C TEST.BAT'
  893.                   runs TEST.BAT when the file DEMO.TMP is deleted.
  894.  
  895.  
  896.   -----------------------------------------
  897.   USING SMOOTH TALKER SOFTWARE WITH SPUTMON
  898.   -----------------------------------------
  899.  
  900.   To use Smooth Talker text to speech software, you must add the following
  901.   line to your CONFIG.SYS file and reboot your system:
  902.  
  903.          'DEVICE=STDRIVER.SYS SV3 CRE TTD'
  904.  
  905.   Then load SPEECHV3 into memory.  (If using SPEECHV2, you must enter SV2
  906.   instead of SV3 on the above line added to CONFIG.SYS).
  907.   
  908.   Now you can use the #C file type to convert text files to synthesized speech
  909.   using your Smooth Talker Software.
  910.  
  911.   Example: 'FD DEMO.TMP #C COPY MESSAGE.TXT ST'
  912.                  
  913.            Smooth Talker will convert the text file MESSAGE.TXT to synthesized
  914.            speech whenever the file DEMO.TMP is deleted.
  915.  
  916.   If your STDRIVER is also used by other software supporting Smooth Talker
  917.   and gets set into a different mode so that the COPY command no longer works,
  918.   you can use the SPUTST utility to reset it without having to reboot your
  919.   system.  Just type the following command at the DOS prompt:
  920.  
  921.         'SPUTST SV3 CRE TTD'
  922.  
  923.   SmoothTalker is Copyright by First Byte Software.
  924.  
  925.  
  926.   ---------------------------
  927.   USING SPUTMON WITH DESQVIEW
  928.   ---------------------------
  929.  
  930.   SPUTMON can be run in any DESQview window, and will only see events that
  931.   occur in the same window.  Separate event definition files can be created
  932.   for each application that runs in a DESQview window, or all windows can
  933.   use the same event definition file.
  934.  
  935.   All timer events can be monitored from a single DESQview window.
  936.  
  937.   If the DESQview player window feature is enabled (/W), a separate window
  938.   will be started in which to run the player.  This window will run in the
  939.   background, and close when the player exits.
  940.  
  941.   If the player program runs too slowly in a background window, you can use
  942.   /W to disable the window-player feature.  This will cause playback to occur
  943.   in the same window that the event occured, and should then be at the correct
  944.   playback speed.
  945.  
  946.   Currently, SPUTMON does not run properly when loaded before DESQview.
  947.  
  948.  
  949.   ---------------------
  950.   SPUTMON Error messages
  951.   ---------------------
  952.  
  953.   Not Installed
  954.   Cannot Uninstall
  955.   Uninstalled
  956.   Already Installed
  957.   Event table initialized
  958.   Event Monitoring enabled
  959.   Event Monitoring disabled
  960.   Bells on error & retry enabled
  961.   Bells on error & retry disabled
  962.   Bells frequency changed to every N seconds
  963.   Retry playback enabled
  964.   Retry playback disabled
  965.   Quiet screen enabled
  966.   Quiet screen disabled
  967.   Multiple triggers enabled
  968.   Multiple triggers disabled
  969.   DESQview player window enabled
  970.   DESQview player window disabled
  971.   Command line playback enabled
  972.   Command line playback disabled
  973.   Background window enabled
  974.   Foreground window enabled
  975.   Invalid Filespec
  976.   Failed to find SPUT.COM in current path
  977.   Failed to find Event file
  978.   Event file read error
  979.   No events found
  980.   Syntax error - on line n of Event Definition File
  981.   Invalid hexadecimal number - on line n of Event Definition File
  982.   Invalid decimal number - on line n of Event Definition File
  983.   Invalid event definition type - on line n of Event Definition File
  984.   Invalid program or filename - on line n of Event Definition File
  985.   Invalid soundfile argument - on line n of Event Definition File
  986.   Invalid date/time format - on line n of Event Definition File
  987.   Invalid date/time increment - on line n of Event Definition File
  988.   DVP file not found - DESQview player window disabled
  989.   DVP file read error
  990.  
  991.   -----------------------------------------------
  992.   TROUBLE SHOOTING PROBLEMS WITH EVENT TRIGGERING
  993.   -----------------------------------------------
  994.  
  995.   ** No playback occurs at the defined event
  996.  
  997.   If playback does not occur when you expect it should, try the following
  998.   steps to isolate the problem:
  999.  
  1000.         1)  Enable the beep-on-error option with the command 'SPUTMON/B'.
  1001.             (You can check the state of the switch with SPUTMON/S)
  1002.         2)  Reinitialize the event table counters with the command 'SPUTMON/I'
  1003.         2)  Perform the same sequence of commands that should cause
  1004.             playback to occur.
  1005.         3)  Display a status with the command 'SPUTMON/S' and make a note
  1006.             of the CODE field.  This is the error code.
  1007.         4)  Continue reading to find the problem.
  1008.  
  1009.  
  1010.   ** Hear a buzzer instead of playback and Error Code = xx02
  1011.  
  1012.   An error code of xx02 indicates that SPUTMON could not run the player  
  1013.   utility.  When SPUTMON is initially loaded, it searches the current
  1014.   PATH found in the environment, to find all of the player utilities.
  1015.   If these files are later moved or deleted, SPUTMON will no longer be able
  1016.   to call upon them to play soundfiles.
  1017.  
  1018.   To resolve this problem, replace the player program that was moved
  1019.   or deleted, or unload and reload SPUTMON.
  1020.  
  1021.   The supported player programs are SPUT.COM, PLAYROL.EXE, TRAN.EXE and
  1022.   COMMAND.COM.
  1023.  
  1024.  
  1025.   ** Hear a buzzer instead of playback and Error Code = xx08
  1026.  
  1027.   An error code of xx08 indicates insufficient memory.  This means that
  1028.   the currently running program already has all of available memory
  1029.   allocated to it, and there is not enough remaining memory to run the
  1030.   player utility.
  1031.  
  1032.   This error will only occur if you have disabled the DESQview-player-
  1033.   window feature (/W) and the command-line-playback feature (/C) and
  1034.   the retry feature (/R).  Reenabling any of these features will solve
  1035.   this problem.
  1036.  
  1037.   If you choose not to enable these features, an alternative solution 
  1038.   is to use the PROGRAM execution event to trigger playback when the
  1039.   offending program is run, instead of triggering on what the program
  1040.   is doing.  Other than this, nothing else can be done to solve this
  1041.   problem, unless you have access to the source code of the offending
  1042.   program.
  1043.  
  1044.  
  1045.   ** Buzzer instead of playback and Error Code = 10xx
  1046.  
  1047.   An error code of 10xx indicates that SPUTMON ran the player utility, but
  1048.   the player encountered an error.  Refer to the section on the SPUT utility
  1049.   for a list of SPUT error numbers and messages.
  1050.  
  1051.   Normally, SPUTMON runs the player utility with the proper switches so
  1052.   there will be no screen output while other programs are running.
  1053.   Disabling this feature with the /Q switch, will allow the player to
  1054.   display all it's normal screen output, including error messages.
  1055.  
  1056.  
  1057.   ** No playback when event is caused by any of the SPUTTER utilities
  1058.  
  1059.   This has been done intentionally, otherwise invoking any of the SPUTTER
  1060.   utilities causes multiple soundfiles to be played.  Enough is enough I say.
  1061.   All SPUTTER utilities issue a special command to SPUTMON to temporarily
  1062.   disable triggering of events caused by the SPUTTER utilities.
  1063.   Triggering and playback of type T timer events will continue uninterrupted.
  1064.  
  1065.  
  1066.   ** Here is a list of other possible error codes that can be returned from
  1067.      DOS when attempting to execute the Player Utility SPUT:
  1068.  
  1069.         01h function number invalid
  1070.         02h file not found
  1071.         03h path not found
  1072.         04h too many open files (no handles available)
  1073.         05h access denied
  1074.         06h invalid handle
  1075.         07h memory control block destroyed
  1076.         08h insufficient memory
  1077.         09h memory block address invalid
  1078.         0Ah environment invalid (usually >32K in length)
  1079.         0Bh format invalid
  1080.         0Ch access code invalid
  1081.         0Dh data invalid
  1082.         0Fh invalid drive
  1083.         10h attempted to remove current directory
  1084.         11h not same device
  1085.         12h no more files
  1086.         13h disk write-protected
  1087.         14h unknown unit
  1088.         15h drive not ready
  1089.         16h unknown command
  1090.         17h data error (CRC)
  1091.         18h bad request structure length
  1092.         19h seek error
  1093.         1Ah unknwon media type (non-DOS disk)
  1094.         1Bh sector not found
  1095.         1Ch printer out of paper
  1096.         1Dh write fault
  1097.         1Eh read fault
  1098.         1Fh general failure
  1099.         20h sharing violation
  1100.         21h lock violation
  1101.         22h disk change invalid
  1102.         23h FCB unavailable
  1103.         24h sharing buffer overflow
  1104.         25h reserved
  1105.         26h (LANtastic) cannot complete file operation
  1106.         27h-31h reserved
  1107.         32h Network request not supported (DOS 3.1 + MS Networks)
  1108.         33h Remote computer not listening
  1109.         34h Duplicate name on network
  1110.         35h Network name not found
  1111.         36h Network busy
  1112.         37h Network device no longer exists
  1113.         38h Network BIOS command limit exceeded
  1114.         39h Network adapter hardware error
  1115.         3Ah Incorrect response from network
  1116.         3Bh Unexpected network error
  1117.         3Ch Incompatible remote adapter
  1118.         3Dh Print queue full
  1119.         3Eh Queue not full
  1120.         3Fh Not enough space to print file
  1121.         40h Network name was deleted
  1122.         41h Network: Access denied
  1123.         42h Network device type incorrect
  1124.         43h Network name not found
  1125.         44h Network name limit exceeded
  1126.         45h Network BIOS session limit exceeded
  1127.         46h Temporarily paused
  1128.         47h Network request not accepted
  1129.         48h (DOS 3.1 + MS Networks) Print/disk redirection paused
  1130.         49h (LANtastic) invalid network version
  1131.         4Ah (LANtastic) account expired
  1132.         4Bh (LANtastic) password expired
  1133.         4Ch (LANtastic) login attempt invalid at this time
  1134.         4Dh-4Fh reserved
  1135.         50h file exists
  1136.         51h reserved
  1137.         52h cannot make directory
  1138.         53h fail on INT 24h
  1139.         54h (DOS 3.3+) too many redirections
  1140.         55h (DOS 3.3+) duplicate redirection
  1141.         56h (DOS 3.3+) invalid password
  1142.         57h (DOS 3.3+) invalid parameter
  1143.         58h (DOS 3.3+) network write fault
  1144.         59h (LANtastic) function not supported on network
  1145.         5Ah (LANtastic) required system component not installed
  1146.  
  1147.  
  1148.   **************************************************************************
  1149.                  SECTION 3.3 - SPUT Soundfile Player UTility
  1150.   **************************************************************************
  1151.  
  1152.   This section describes the program named SPUT, which stands for (S)oundfile
  1153.   (P)layer (UT)ility.  SPUT is the foundation of the entire SPUTTER Sound
  1154.   System.
  1155.  
  1156.   Typing 'SPUT' with no arguments at the DOS prompt, will print the version
  1157.   number and a short help screen.
  1158.  
  1159.   If you are an unregistered user, you will also see the following message
  1160.   whenever playback is completed
  1161.  
  1162.               ┌───────────────────────────────────────────────────┐
  1163.               │                                                   │
  1164.               │   Thank you for trying The Sputter Sound System   │
  1165.               │        If you use Sputter, please register        │
  1166.               │                                                   │
  1167.               │   Registration will remove this message & delay   │
  1168.               │          and give you additional features         │
  1169.               │                                                   │
  1170.               └───────────────────────────────────────────────────┘
  1171.  
  1172.  
  1173.   ---------------------
  1174.   SPUT FILE INFORMATION
  1175.   ---------------------
  1176.  
  1177.   SPUT displays the following information on the screen each time it
  1178.   is run.
  1179.  
  1180.         SPUT v1.11 Player Utility - Copyright 1990, VersaWare / Adrienne Cousins
  1181.         File:E:\SND\TRYAGN.V8   Size:9439/9423  Form:0008/0  Port:022F  Driv:1
  1182.         Rate:180  Over:1  Freq:15495hz  Ampl:0+  Time:0.6s
  1183.         Samples Output:9423  Silence groups:0  Timer Adjust:11
  1184.  
  1185.   or for Macintosh files, the Title from the header is included:
  1186.  
  1187.         SPUT v1.11 Player Utility - Copyright 1990, VersaWare / Adrienne Cousins
  1188.         File:.\HOWYA.SND   Size:11648/11008  Form:0038/0  Port:022F  Driv:1
  1189.         Rate:152  Over:1  Freq:11363hz  Ampl:0+  Time:1.0s  Title:HowYouDoin'?
  1190.         Samples Output:11008  Silence groups:0  Timer Adjust:17
  1191.  
  1192.   or silence encoding statistics are shown when applicable:
  1193.  
  1194.         SPUT v1.11 Player Utility - Copyright 1990, VersaWare / Adrienne Cousins
  1195.         File:F:\SND\EXECUTE.V4S   Size:2682/2666  Form:0084/0  Port:022F  Driv:1
  1196.         Rate:152  Over:1  Freq:11363hz  Time:0.2s
  1197.         Samples Output:12675  Silence groups:10  Timer Adjust:20
  1198.  
  1199.  
  1200.   File:
  1201.         This is the name of the file entered on the command line to SPUT.
  1202.  
  1203.   Size:
  1204.         The first number is the size of the file in bytes, the second
  1205.         is the actual byte size of the data to be played.
  1206.  
  1207.   Form:
  1208.         The first number is the file format (see /F for definitions)
  1209.         The second number indicates Macintosh file compression:
  1210.  
  1211.                 0 - non-compression
  1212.                 1 - run length encoding (RLE)
  1213.                 2 - Dynamic Lempel-Ziv,Weiss compression
  1214.                 3 - Huffman compression
  1215.  
  1216.   Port:
  1217.         This is the hex address of the port being used for output.
  1218.  
  1219.   Driv:
  1220.         This is the driver number used to drive the output device.
  1221.  
  1222.   Rate:
  1223.         This is the playback rate, specified on the command line, or taken
  1224.         from the header record, or recalculated for oversampling.
  1225.  
  1226.   Over:
  1227.         This is the oversampling factor currently being used.
  1228.  
  1229.   Freq:
  1230.         This is the frequency (samples per second) that the file is being
  1231.         played at.
  1232.  
  1233.   Time:        
  1234.         This is the approximate time it will take to playback the file
  1235.         at the current settings.
  1236.  
  1237.   Title:
  1238.         This only appears when playing Macintosh sound files and comes
  1239.         from the internal header record of the sound file.
  1240.  
  1241.   Samples Output:
  1242.         This is a count of the bytes actually sent to the output device and
  1243.         includes all bytes reconstructed as a result of silence encoding,
  1244.         and compression.  In third example above, the file uses only 6508
  1245.         bytes of disk space to store a file that originally contained
  1246.         12126 bytes of sound.
  1247.  
  1248.   Silence groups:
  1249.         This is how many periods of silence were found in the file, and
  1250.         expanded back to their original length.
  1251.  
  1252.  
  1253.   --------------------------
  1254.   SPUT ENVIRONMENT VARIABLES
  1255.   --------------------------
  1256.  
  1257.   SPUTARG
  1258.         This allows you to setup any permanent switches that you would
  1259.         like SPUT to use every time it's run, without having to enter
  1260.         them on the command line.  Any switches specified on the command
  1261.         line, will override the switches in the SPUTARG variable.
  1262.  
  1263.         You can set this value at the DOS prompt, or by including a line
  1264.         in your AUTOEXEC.BAT file with the following command:
  1265.  
  1266.                 set sputarg=/p220s/ir7
  1267.  
  1268.         This tells SPUT to send all output to a Sound Blaster card
  1269.         at port 220 (hex), using interrupt number 7.
  1270.  
  1271.  
  1272.   SPUTDIR
  1273.         This defines the default directory to find sound files.  If a
  1274.         filename is given on the command line with no drive or directory,
  1275.         SPUT will look for the file in the directory defined by the
  1276.         SPUTDIR variable.
  1277.  
  1278.         You can set this value at the DOS prompt, or from your AUTOEXEC.BAT
  1279.         file with the following command:
  1280.  
  1281.                 set sputdir=c:\sound
  1282.  
  1283.         This would tell SPUT to look in the SOUND directory on the
  1284.         C: drive for all sound files.
  1285.  
  1286.         To force SPUT to play a file in the current directory without
  1287.         having to enter the complete path, use the following command:
  1288.  
  1289.                 sput .\filename
  1290.  
  1291.  
  1292.   ------------------------
  1293.   SPUT SYNTAX AND SWITCHES
  1294.   ------------------------
  1295.  
  1296.   Syntax:  SPUT <soundfile> [/switches]
  1297.  
  1298.   ESCAPE key
  1299.         Pressing the ESCAPE key during file playback, will cause SPUT to
  1300.         immediately stop playback and exit.  This will not disturb any
  1301.         type ahead already in the keyboard buffer.
  1302.  
  1303.   ?
  1304.         Entering a question mark on the command line, will tell SPUT to
  1305.         display a short help screen.
  1306.  
  1307.   <soundfile>
  1308.         This is the name of the sound file to be played.  If no directory
  1309.         is specified, the directory specified by the environment variable
  1310.         SPUTDIR will be used.  If the SPUTDIR variable does not exist, the
  1311.         current directory is assumed.
  1312.  
  1313.         Specifying a directory as part of the filename, will override
  1314.         any directory specified by the SPUTDIR environment variable.  Use
  1315.         ".\filename" to indicate the current directory and ignore the
  1316.         SPUTDIR environment variable.
  1317.  
  1318.         Wildcards within the filename, tell SPUT to randomly select and
  1319.         play a file that matches the wildcard mask.  This provides a
  1320.         way to have SPUT vary the sound files that are played without
  1321.         always having to change your batch files.
  1322.  
  1323.         Sound files can be categorized in two different ways, the first
  1324.         is by directory, where sound files are categorized and stored in
  1325.         separate directories, with a different directory for each category.
  1326.         To randomly play any file of a particularily category, just specify
  1327.         the directory.  The command "SPUT \SND\CARTOONS\*.*" would randomly
  1328.         select and play a file from the CARTOONS sub-directory and the
  1329.         command "SPUT \SND\ERRORS\*.*" would randomly select and play a
  1330.         file from the ERRORS sub-directory.
  1331.  
  1332.         The other method of categorization is by file extension.  This
  1333.         method keeps all sound files in the same directory, with files of
  1334.         the same category having the same file extension.  Then the command
  1335.         "SPUT \SND\*.MUS" would randomly select one of the files with the
  1336.         .MUS extension from the SND directory.  The command "SPUT *.*"
  1337.         would then select and play a file from any category.
  1338.  
  1339.         Note that the filename and extension hold no special meaning
  1340.         for SPUT.  Any information needed for playback is retrieved
  1341.         from within the file.  Any reference to extensions within the
  1342.         SPUTTER documentation, is simply to aid you in determining the
  1343.         file format.  SPUT can always determine the file format from
  1344.         the contents of the file regardless of the filename & extension.
  1345.  
  1346.   /An
  1347.         This switch will enhance the amplitude, or volume, of a soundfile.
  1348.         Using this switch, causes more processing to be performed on each
  1349.         sample of the soundfile, and may actually slow down the playback
  1350.         speed on slower processors.  The higher the N value, the more
  1351.         processing being done on each sample.
  1352.  
  1353.         If using this switch, slows the playback speed on your system, 
  1354.         you can use the /A switch in conjunction with the /W switch to
  1355.         write the file to disk.  The new file will play properly with
  1356.         no switches, and the amplitude will be elevated.
  1357.  
  1358.         Another alternative is to resample the file to a lower playback
  1359.         rate using the /U and /W switches.  Then you can replay the new
  1360.         file using the /A switch without bogging down your system.
  1361.  
  1362.   /Cn
  1363.         This will cause the selected file to be played N times, in a
  1364.         continous loop.  A value of 0 will play indefinetly, until a
  1365.         key is struck.  This is most useful for listening to the quality
  1366.         of a very short sound clip, or can be used as an alarm
  1367.         triggered SPUTMON the Event Monitor.
  1368.  
  1369.   /Dn
  1370.         This switch is used to select the method of output to be used
  1371.         on the currently selected output device.
  1372.  
  1373.         The Internal Speaker has 4 drivers, the default is #1.
  1374.  
  1375.           1 - This method uses a software timing loop to drive the
  1376.               8253 Programmable Interval Timer chip.  The routine
  1377.               calibrates itself by polling the Timer chip while
  1378.               outputting the first 64 bytes of the file.
  1379.               This driver gives the best results, since no additional
  1380.               background noise is caused by interrupts or sampling.
  1381.               It will not cause crashes on slower systems, but it's
  1382.               speed is slightly less accurate than the other methods.
  1383.  
  1384.           2 - This method polls the Timer chip while outputting the
  1385.               sound file.  It's speed is accurate, and like method 1
  1386.               will not cause crashes on slower systems, but it generates
  1387.               slightly more noise than method 3 (interrupts).
  1388.  
  1389.           3 - This method uses Timer interrupts to output the sound file.
  1390.               It's speed is accurate, it generates slightly more noise
  1391.               than method 1 (software timing), but it may crash slower
  1392.               systems when using too fast a speed or oversampling factor.
  1393.               When this method is used in DESQview, the keyboard is
  1394.               automatically disabled to prevent crashing the system.
  1395.  
  1396.           4 - This method uses the 8255 Peripheral Interface Controller
  1397.               to generate sound.  It's speed is accurate, but the sound
  1398.               quality is appreciably lower than the other methods, since
  1399.               only a single bit of each 8-bit sample is actually output.
  1400.  
  1401.         The Sound Blaster has 2 drivers, the default is #1.
  1402.  
  1403.               SPUT will automatically select the correct Sound Blaster
  1404.               driver depending on the environment it is running in, and
  1405.               the file format that is being played.
  1406.  
  1407.           1 - This driver uses the direct mode of output to the Sound
  1408.               Blaster DAC port.  This is completely CPU driven and can
  1409.               be interrupted by background processing in a multitasking
  1410.               environment.
  1411.  
  1412.               This driver has the capability of sending ANY file format
  1413.               from any other source to the Sound Blaster card, but does
  1414.               NOT support formats 42,44,45.
  1415.  
  1416.           2 - This driver uses the DMA mode of the Sound Blaster DAC port.
  1417.               It cannot be used in a multitasking environment, since there
  1418.               would be a conflict between the DMA and memory paging.
  1419.               This is also true of the VOUT.EXE utility that comes with the
  1420.               Sound Blaster card.  (This will be resolved in a future
  1421.               release of SPUT.)
  1422.  
  1423.               This driver can handle formats 42,44,45,48 and any other 8-bit
  1424.               file format (08,28,38), and provides the /SHELL function,
  1425.               but does NOT support any of the other compressed file formats
  1426.               (01-04,11,21,31,81-84).
  1427.  
  1428.   /DE
  1429.         Normally SPUT assumes that other processes already running, are
  1430.         more important than sound playback, so if other tasks are running
  1431.         when SPUT attempts to play a file, playback may be slightly slower
  1432.         than expected.  This is done mainly to not disrupt any communications
  1433.         tasks that might be running when SPUT is started.
  1434.  
  1435.         You may use /DE to force SPUT to run in dedicated mode and pause all
  1436.         other tasks in order to play the soundfile correctly.
  1437.  
  1438.   /DI
  1439.         This switch is used to specify an alternate dictionary file.  The
  1440.         default dictionary filename is SPUT.DIC.  The file is assumed to be
  1441.         located in the current directory or in the PATH.
  1442.         This file is used during text-to-speech translation and contains
  1443.         any pronounciation corrections or user definitions.
  1444.         See the next section for a description of this file.
  1445.  
  1446.   /Fnn
  1447.         The /F switch is used to force SPUT to use a specific file
  1448.         format.  This may be necessary when the file is missing a
  1449.         proper header record, which SPUT needs to determine the
  1450.         file format automatically.
  1451.  
  1452.         If you play a file with no switches, and it does not playback
  1453.         correctly, try using all possible /F switches until the file
  1454.         plays correctly.  If SPUT still fails to playback the file
  1455.         with any of the /F switches, you may have a file format that
  1456.         SPUT doesn't know about.
  1457.  
  1458.         SPUT has the capability of playing ANY file format on ANY device
  1459.         that it supports, not just the device that the file format may
  1460.         have been created on.  The only exception to this are formats
  1461.         42,44,45 which can only be played on a Sound Blaster card.
  1462.  
  1463.         If you find a file format that SPUT doesn't understand, please
  1464.         send me a copy of the file and any others similar to it, so that
  1465.         I can try to decipher the format and add it to a future release
  1466.         of SPUTTER.
  1467.  
  1468.         File formats:
  1469.  
  1470.         01 - Covox 1-bit ADPCM with 16-byte header (.V1)
  1471.  
  1472.              Adaptive Differential Pulse Code Modulation is a technique
  1473.              of encoding the original waveform into a smaller file.
  1474.              This format uses a series of 16 byte groups with the first
  1475.              byte being an amplitude byte and the remaining 15 bytes
  1476.              are data.  Each data byte contains 8 1-bit samples.  Each
  1477.              of these 16-byte groups decodes into 120 8-bit samples.
  1478.              This format yields a 1:8 or 1/8 compression ratio.
  1479.  
  1480.         02 - Covox 2-bit ADPCM with 16-byte header (.V2)
  1481.  
  1482.              This format uses a series of 2 byte groups where 1 bit of
  1483.              each of the two bytes is combined to form a 2-bit sample.
  1484.              Each two byte group contains 8 of these 2-bit samples.
  1485.              The 2-bit samples are then decoded into 8-bit samples before
  1486.              playback.  This format yields a 2:8 or 1/4 compression ratio.
  1487.  
  1488.         03 - Covox 3-bit ADPCM with 16-byte header (.V3)
  1489.  
  1490.              This format uses a series of 3 byte groups where 1 bit of
  1491.              each of the three bytes is combined to form a 3-bit sample.
  1492.              Each three byte group contains 8 of these 3-bit samples.
  1493.              The 3-bit samples are then decoded into 8-bit samples before
  1494.              playback.  This format yields a 3:8 or 3/8 compression ratio.
  1495.  
  1496.         04 - Covox 4-bit ADPCM with 16-byte header (.V4)
  1497.  
  1498.              This format uses a series of 4 byte groups where 1 bit of
  1499.              each of the four bytes is combined to form a 4-bit sample.
  1500.              Each four byte group contains 8 of these 4-bit samples.
  1501.              The 4-bit samples are then decoded into 8-bit samples before
  1502.              playback.  This format yields a 4:8 or 1/2 compression ratio.
  1503.  
  1504.         08 - Covox 8-bit PCM with 16-byte header (.V8)
  1505.              or Covox 8-bit PCM with 128-byte header (.VMF)
  1506.              or Covox 8-bit PCM with no header (.VMD)
  1507.              or any other 8-bit PCM file
  1508.  
  1509.              Uniform Pulse Code Modulation stores a waveform as a
  1510.              sequence of 8-bit numbers representing different amplitudes.
  1511.              Amplitude levels -128 to -1 are represented by the numbers
  1512.              0  to 127, level 0 is represented by 128 and levels 1 to 128
  1513.              are represented by the numbers 129 to 255. 
  1514.  
  1515.              Programs that use this format:
  1516.              .  Deskmate Software by Tandy for 1000SL/TL/2s computers.
  1517.              .  Tandy Sound Digitizer by KSH Software.
  1518.  
  1519.         10 - Text files
  1520.  
  1521.              Any text file to be translated into speech.
  1522.  
  1523.         11 - IBM 1-bit CVSD format files
  1524.  
  1525.              Continously Variable Slope Delta Modulation records the
  1526.              direction of the waveform bit by bit.  If the wave goes up
  1527.              from the previous sample, a "1" bit is recorded otherwise
  1528.              a "0" bit is recorded.  Absolute silence is recorded as
  1529.              "01010101...".  The bit stream is stored from right to
  1530.              left in each data byte.
  1531.              This format yields a 1:8 or 1/8 compression ratio.
  1532.  
  1533.              Programs that use this format:
  1534.              .  IBM's education software such as "Writing to Read"
  1535.                 with a 128-byte header.
  1536.              .  Compton's Multimedia Encyclopedia program on CD ROM.
  1537.  
  1538.         21 - Digicorder 1-bit CVSD format files
  1539.  
  1540.              This format is similar to format 11, except that the bit
  1541.              stream is stored from left to right within each data byte.
  1542.              This format yields a 1:8 or 1/8 compression ratio.
  1543.  
  1544.              Programs that use this format:
  1545.              .  Digicorder & Mimic by Eletech Electronics with a numeric
  1546.                 extension indicating the recording rate in bits-per-second,
  1547.                 and no header record.
  1548.  
  1549.         28 - Amiga 8-bit PCM with 8SVX variable length header (.SND)
  1550.              or Amiga 8-bit PCM with Sonix 64-byte header (.SND)
  1551.              or Atari 8-bit PCM files (.SND)
  1552.  
  1553.              This format is similar to 8-bit PCM, but stores the actual
  1554.              amplitude level with polarity intact.  Negative amplitudes
  1555.              are represented by -128 to -1, level 0 is represented by 0
  1556.              and positive amplitudes are represented by +1 to +128.
  1557.  
  1558.              Programs that use this format:
  1559.              .  Perfect Sound by Sunrize Industries for the Amiga
  1560.                 with a 128-byte 8SVX style header record.
  1561.              .  Audio Master for the Amiga, with a 128-byte 8SVX header.
  1562.              .  Sonix for the Amiga, with a 64-byte header record.
  1563.  
  1564.         31 - Voice Toolkit 1-bit format files
  1565.  
  1566.              This format simply takes bit-4 of each original 8-bit sample
  1567.              and stores the bit stream from left to right within each
  1568.              data byte.
  1569.              This format yields a 1:8 or 1/8 compression ratio.
  1570.  
  1571.              Programs that use this format:
  1572.              .  Digitized Voice Toolkit for the PC, by Farpoint
  1573.                 Software; Alan D. Jones, with a .VOI extension.
  1574.                 NOTE: This shareware package includes the schematics
  1575.                 for a build-it-yourself digitizer that is attached to
  1576.                 any COM port for recording.
  1577.  
  1578.         38 - Macintosh 8-bit PCM with MacBinary FSSD 128-byte header (.SND)
  1579.  
  1580.              This file format is the same as format 08, with a different
  1581.              type of header record.  No compression is currently supported.
  1582.  
  1583.         42 - Creative Labs 2-bit ADPCM with 16-byte header (.VOC)
  1584.  
  1585.              This is a compressed file format, that is automatically
  1586.              decompressed by the hardware, and can only be played
  1587.              on a Sound Blaster card.
  1588.  
  1589.         44 - Creative Labs 4-bit ADPCM with 16-byte header (.VOC)
  1590.  
  1591.              This is a compressed file format, that is automatically
  1592.              decompressed by the hardware, and can only be played
  1593.              on a Sound Blaster card.
  1594.  
  1595.         45 - Creative Labs 2.5-bit ADPCM with 16-byte header (.VOC)
  1596.  
  1597.              This is a compressed file format, that is automatically
  1598.              decompressed by the hardware, and can only be played
  1599.              on a Sound Blaster card.
  1600.  
  1601.         48 - Creative Labs 8-bit PCM with 16-byte header (.VOC)
  1602.  
  1603.              This format is the same as format 08, with a different type
  1604.              of header record, and can be played on any device.
  1605.  
  1606.              This format is used by the Sound Blaster and Game Blaster
  1607.              cards from Creative Labs.
  1608.  
  1609.         81 - Covox 1-bit ADPCM with silence encoding (.V1S)
  1610.  
  1611.              This format is the same as format 01, but includes the use
  1612.              of silence encoding.
  1613.  
  1614.              Silence encoding is a form of compression that uses 3 bytes
  1615.              to represent up to 32640 multiple continous bytes of silence.
  1616.              This technique can save a considerable amount of disk space
  1617.              without affecting the sound quality.  Many periods of silence
  1618.              occur between words and syllables and at the beginning and end
  1619.              of sound files.
  1620.         
  1621.              DEMO123.V8S is an example of a silence encoded file.  You can
  1622.              play it back with no switches for normal playback, or you can
  1623.              use the /F8 switch to hear just the non-silent passages.  The
  1624.              little cracks you'll hear with the /F8 switch are the places
  1625.              where silence has been encoded into just a few bytes.         
  1626.  
  1627.              Currently, only sound files created by Covox programs have
  1628.              silence encoding, but a future release of SPUTTER, will include
  1629.              a utility to rewrite any sound files using silence encoding.
  1630.  
  1631.         82 - Covox 2-bit ADPCM with silence encoding (.V2S)
  1632.  
  1633.              This format is the same as format 02, but includes the use
  1634.              of silence encoding.
  1635.  
  1636.         83 - Covox 3-bit ADPCM with silence encoding (.V3S)
  1637.  
  1638.              This format is the same as format 03, but includes the use
  1639.              of silence encoding.
  1640.  
  1641.         84 - Covox 4-bit ADPCM with silence encoding (.V4S)
  1642.  
  1643.              This format is the same as format 04, but includes the use
  1644.              of silence encoding.
  1645.  
  1646.         88 - Covox 8-bit PCM with silence encoding (.V8S)
  1647.  
  1648.              This format is the same as format 08, but includes the use
  1649.              of silence encoding.
  1650.  
  1651.   /Hi,r
  1652.         This switch will cause high-pass filtering to be applied to the
  1653.         data before being played.  This technique is known as Differential
  1654.         Quantization & is based on the fact that there is considerable
  1655.         correlation between adjacent speech samples.  The interval <i>,
  1656.         determines the distance between samples to be differentiated.
  1657.         Using a repeat value <r> greater than 1 will heighten the effect.
  1658.  
  1659.         This switch can only be used on 8-bit PCM data with no compression
  1660.         or silence encoding.  Using the switch with any other file format
  1661.         will produce an error message.  To apply high-pass filtering to
  1662.         any other file format, you must first use the /W switch to write
  1663.         the desired file out into 8-bit PCM format, and then use the /H
  1664.         switch on the new file.
  1665.  
  1666.   /I
  1667.         This switch will display on screen, all the file information that
  1668.         is normally displayed when the file is played, but without any
  1669.         playback occurring.
  1670.  
  1671.   /IRn
  1672.         This switch allows you to specify the Interrupt Request line that
  1673.         your Sound Blaster card is set for.  The default is 3, with valid
  1674.         values being 2,3,5,7.
  1675.  
  1676.   /K
  1677.         This switch will cause SPUT to ignore all keyboard input while
  1678.         playing a soundfile.
  1679.  
  1680.   /Li,r
  1681.         This switch will cause low-pass filtering to be applied to the
  1682.         data before being played.  This technique is known as Integration.
  1683.         The interval <i> determines the distance between samples to be
  1684.         integrated.  Using a repeat value <r> greater than 1 will heighten
  1685.         the effect.
  1686.  
  1687.         This switch can only be used on 8-bit PCM data with no compression
  1688.         or silence encoding.  See /H for directions on applying low-pass
  1689.         filtering to other file formats.
  1690.  
  1691.   /N
  1692.         This switch will generate very low-level noise in place of dead
  1693.         silence, when playing back files with silence encoding.
  1694.         Sometimes, when periods of silence are obvious, this can help
  1695.         make it more natural sounding.
  1696.  
  1697.   /On
  1698.         The /O switch is used to invoke the oversampling option for the
  1699.         internal speaker only.  This can be used to help eliminate
  1700.         sampling whine in files that were recorded at a sampling rate
  1701.         below 12000 samples-per-second.
  1702.   
  1703.         When the /O switch is used alone, or before the /R switch on
  1704.         the command line, SPUT will use the specified playback rate to
  1705.         calculate a new playback rate to be used while oversampling.
  1706.  
  1707.         For example, if a file plays correctly at a rate of 132 (9622hz)
  1708.         but yields high sampling whine, using the /O2/R132 switches will
  1709.         cause SPUT to double the playback rate from 9622hz to 19244hz
  1710.         and oversample by a factor of 2.  This causes the file to be played
  1711.         back twice as fast, but each byte is being played twice now, so
  1712.         it sounds the same with the sampling whine removed.
  1713.  
  1714.         The switch is ignored, when sending output to any port other
  1715.         than the internal speaker.
  1716.  
  1717.   /Pnnn
  1718.         This switch allows selection of the desired output port.
  1719.  
  1720.         Port Values:
  1721.  
  1722.             0     - Internal speaker (default)
  1723.             1-4   - Voice Master (VM0-3)
  1724.             5-8   - Speech Thing (LPT1-4)
  1725.             9     - Sound Master (SM)
  1726.             nnn   - hex port address of any other Digital to Analog Converter
  1727.             nnn-A - hex port address of an AdLib music card
  1728.             nnn-S - hex port address of a Sound Blaster card
  1729.  
  1730.   /PH
  1731.         This switch will cause SPUT to display the phonemes used to
  1732.         form words during text-to-speech translation.
  1733.  
  1734.   /Qn
  1735.         This switch is used to set the desired level of screen output.
  1736.                 /Q0     display all output
  1737.                 /Q1     display none
  1738.                 /Q2     display errors only
  1739.  
  1740.   /Rnnn
  1741.         The /R switch is used to force SPUT to use a specific playback
  1742.         rate.  This may be necessary when the file is missing a proper
  1743.         header record, or the playback or record rate is not available.
  1744.  
  1745.         When the playback rate is not available, it will default to
  1746.         152 for Macintosh files and 182 for all other files.
  1747.  
  1748.         When the /R switch appears before the /O switch on the command
  1749.         line, SPUT will use the specified playback rate for oversampling
  1750.         and not perform any other calculation.
  1751.             
  1752.         When the /O switch appears before the /R switch on the command
  1753.         line, SPUT will use the specified playback rate to calculate
  1754.         a new playback rate to be used while oversampling.  See the /O
  1755.         switch for details.
  1756.  
  1757.         Rate Frequency Approximations:
  1758.  
  1759.                1  4679hz   152 11473hz   202 22096hz  
  1760.               66  6279hz   161 12559hz   212 27118hz
  1761.              110  8172hz   171 14037hz   222 35094hz
  1762.              132  9622hz   182 16124hz   232 49716hz
  1763.              140 10286hz   192 18643hz   242 85227hz
  1764.  
  1765.   /RSnnn
  1766.         This switch tells SPUT to resample the selected sound file
  1767.         while writing it to disk.  It is only applicable when used in
  1768.         conjunction with the /W switch.
  1769.  
  1770.         Resampling is a process where the playback rate of the specified
  1771.         soundfile is changed to the rate you specify with the /RS switch.
  1772.  
  1773.         Now virtually any sound file can be played on virtually any
  1774.         machine, no matter what the speed of the machine.  If a file
  1775.         will not play properly on a slower machine, just resample it
  1776.         down to a rate that runs properly on that machine.
  1777.  
  1778.         Resampling also has the pleasant side effect of reducing the
  1779.         size of the sound file.  The greater the reduction in playback
  1780.         rate, the greater the reduction in file size.
  1781.  
  1782.   /RU
  1783.         This switch will cause SPUT to display the rule numbers used
  1784.         when forming words during text-to-speech translation.
  1785.  
  1786.   /SH
  1787.         You lucky Sound Blaster owners can use this switch to shell to
  1788.         the DOS prompt while SPUT is playing your sound file in the
  1789.         background.
  1790.  
  1791.         As soon as playback is started, SPUT will start a DOS shell and
  1792.         print the following message:
  1793.  
  1794.                 ** Type EXIT anytime to return to SPUT **
  1795.  
  1796.         You will then see the familiar DOS prompt where you can run any
  1797.         program, to do whatever you like (including running SPUT as long
  1798.         as you access a different sound port).
  1799.         Whenever you decide to quit the shell, just type 'EXIT' at the DOS
  1800.         prompt and you will return to SPUT.
  1801.  
  1802.         If playback is finished, SPUT will end and return to whatever
  1803.         task it was called by, otherwise SPUT will display the following
  1804.         message and wait for playback to complete before exiting:
  1805.  
  1806.         ** Waiting for playback to finish (press ESCAPE to abort) **
  1807.  
  1808.   /T
  1809.         Use this switch to enhance treble output of a sound file.
  1810.  
  1811.         This uses 3 level non-uniform quantization, which divides the
  1812.         entire amplitude range into 3 ranges and assigns the same amplitude
  1813.         value to all samples falling in the upper and lower ranges.
  1814.         All samples in the low range are set to 0, all samples in the
  1815.         high range are set to 255 and all samples falling in the middle
  1816.         range are doubled up to 127.  Samples in the middle range above
  1817.         127 are clipped.
  1818.  
  1819.   /TI
  1820.         This switch will cause SPUT to digitize the current time.
  1821.  
  1822.   /TX
  1823.         This will cause SPUT to enter interactive text mode and display
  1824.         a prompt (>).  Any words typed will be digitized when the
  1825.         ENTER key is pressed.  Press CTRL-C to exit interactive text
  1826.         mode and return to the DOS prompt.
  1827.  
  1828.         During interactive text mode, phonemes and phoneme-functions may
  1829.         be entered along with regular text to be digitized.  
  1830.  
  1831.   /V<f>
  1832.         This switch is used to specify an alternate voice file.  The
  1833.         default voice filename is SPUT.PHD.  The file is assumed to be
  1834.         located in the current directory or in the PATH.
  1835.  
  1836.   /W<f> 
  1837.         This switch will cause all output to be redirected to a disk file
  1838.         instead of being played.  The format of the output file is
  1839.         always 8-bit PCM with a 16-byte Covox style header record.
  1840.  
  1841.         All file formats are converted to 8-bit PCM just before being
  1842.         output to the selected device.  This switch causes that 8-bit
  1843.         PCM data to be captured to a disk file, which can then be
  1844.         manipulated much more easily than the other file formats.
  1845.  
  1846.         The captured file can be replayed with SPUT using the /H and
  1847.         /L switches for high/low-pass filtering, or the waveform of the
  1848.         file can be viewed with SPUTWAVE, or the file can be edited
  1849.         with a sound file editor.
  1850.  
  1851.         Keep in mind that the samples in the output file will reflect
  1852.         all switches that were active at the time the file was created.
  1853.         If /T is used for treble enhancement, then playing the new file
  1854.         with no switch will sound the same as playing the original with
  1855.         the /T switch.
  1856.  
  1857.  
  1858.   ---------------------------
  1859.   SPUT DICTIONARY FILE FORMAT
  1860.   ---------------------------
  1861.  
  1862.         The dictionary file is used to correct SPUT's pronounciation
  1863.         errors or change any other attributes of a word like volume or
  1864.         speed.  You can also use the dictionary to translate words and
  1865.         abbreviations into complete words and phrases. 
  1866.  
  1867.         The format of the file is straight ascii created with any text
  1868.         editor program.  Each entry is 2 lines.
  1869.  
  1870.         The first line is the english word and may be in any case.
  1871.         The second line is the correct phoneme string to be used to
  1872.         pronounce the word, and may also contain simple text, Smooth
  1873.         Talker style phonemes and any special phoneme functions that
  1874.         are described in the following section.
  1875.  
  1876.         The following is an example of a simple phoneme definition to
  1877.         correct a mis-pronounciation:
  1878.  
  1879.                 COW
  1880.                 ~k-ow
  1881.  
  1882.         The following example uses SmoothTalker style phonemes:
  1883.  
  1884.                 diaper
  1885.                 <<~dAY4EYp3ER>>
  1886.  
  1887.         The following example uses phoneme-functions to make the second
  1888.         syllable louder:
  1889.  
  1890.                 FANTASTIC
  1891.                 ~f-ae-n-a3+-t-ae-s-a0-t-ih-k
  1892.  
  1893.         The following example uses phoneme-functions to make the entire
  1894.         word softer:
  1895.  
  1896.                 WHISPER
  1897.                 ~a4--wh-ih-s-p-er-a0
  1898.  
  1899.         The following example uses simple text to define an abbreviation
  1900.         expansion:
  1901.  
  1902.                 DAC
  1903.                 digital to analog converter
  1904.  
  1905.  
  1906.   ------------------------
  1907.   SPUT PHONEME DEFINITIONS
  1908.   ------------------------
  1909.  
  1910.   Phoneme strings always start with the tilde character (~) followed by each
  1911.   of the phonemes separated by dashes.  A space or any control character
  1912.   ends the word.  (eg.  ~v-ey-p-er is the word VAPOR)
  1913.   SPUT phonemes are not case sensitive, and are compatible with TRAN phonemes.
  1914.  
  1915.   SmoothTalker phonemes are supported so that any files that already contain
  1916.   SmoothTalker phonemes will be interpreted correctly by SPUT.
  1917.   
  1918.   Many of the SmoothTalker phonemes have the same name as the SPUT
  1919.   phonemes, but those marked with an asterisk (*) are differrent.
  1920.   To create a SmoothTalker phoneme string, start the word with 2 less than
  1921.   signs, followed by the tilde character, then the string of phonemes,
  1922.   followed by 2 greater than signs to end the word. (eg. <<~vEYpER>> )
  1923.   SmoothTalker phonemes are case sensitive.
  1924.  
  1925. ------------------------------------------------------------------------------
  1926.         SPUT Phonemes                   SMOOTH TALKER Phonemes
  1927. ------------------------------------------------------------------------------
  1928.         AE   fAt                        AE      short 'a' last
  1929.         AH   fAther                    *AA      short 'o' cot
  1930.         AW   lAWn                      *AO      intermediate 'o' caught
  1931.         AY   hIde                       AY      dipthong ice
  1932.         B    soB                        b       plosive in bin
  1933.         BB   Back                      
  1934.         CH   CHurCH                     CH      in chin
  1935.         D    soD                        d       plosive in din
  1936.         DD   Dime                      
  1937.         DH   eiTHer                     DH      'th' in then
  1938.         EE   bEEt                      *IY      long 'e' beet
  1939.         EH   gEt                        EH      short 'e' best
  1940.         ER   mURdER                     ER      'ur' 'er' in further
  1941.         EY   gAte                       EY      dipthong in ace
  1942.         F    Fault                      f       fricative in fin
  1943.         G    doG                        g       plosive in give
  1944.         GG   Goat                      
  1945.         H    How                        h       in hit
  1946.         IH   bIt                        IH      short 'i' fit
  1947.         JJ   Jar                        j       in jin or jug
  1948.         J    juDGe                     
  1949.         K    Coat                       k       plosive in kin
  1950.         L    Laugh                      l       in light or love
  1951.         MM   Moat                      
  1952.         M    suM                        m       nasal in might
  1953.         NN   Note                      
  1954.         N    suN                        n       nasal in night
  1955.         NG   suNG                       NG      nasal in sing
  1956.         OH   lOne                      *OW      long 'o' dose
  1957.         OO   fOOl                      *UW      long 'u' lute
  1958.         OR   fOR                       
  1959.         OW   hOW                       *AW      dipthong loud
  1960.         OY   tOY                        OY      dipthong noise
  1961.         P    Pack                       p       plosive in pin
  1962.         R    Rate                       r       in rate
  1963.         S    Sue                        s       silibant in sin
  1964.         SH   SHoe                       SH      silibant in shin
  1965.         T    Time                       t       plosive in tin
  1966.         TH   eTHer                      TH      fricative in thin
  1967.         U    fUll                      *UH      'u' sound in book
  1968.         UH   About                     *AH      short 'u' up
  1969.         V    Vault                      v       in vim
  1970.         W    Wear                       w       in wait or water
  1971.         WH   WHere                      WH      in which or where
  1972.         Y    Young                      y       in yet or yes
  1973.         Z    Zoo                        z       in zen
  1974.         ZH   lieSure                    ZH      in pleasure
  1975.         SPACE
  1976.  
  1977.    The following SmoothTalker phonemes (on the right) have no SPUT
  1978.    equivalents, so the closest sounding phonemes have been substituted.
  1979.  
  1980.         UH                              AX      schwa 'a' in against
  1981.         EH                              IX      duration tween IH,AX in David
  1982.         T                               DX      't' in butter
  1983.         K                               KX      non-aspirated 'k' ice cold
  1984.         T                               TX      non-aspirated 't' misstate
  1985.         T                               PX      non-aspirated 't' white spot
  1986.  
  1987.  
  1988.    ----------------------
  1989.    SPUT PHONEME FUNCTIONS
  1990.    ----------------------
  1991.  
  1992.    The special phoneme-functions may be used at the > prompt, in a text file
  1993.    or in the exception dictionary.  The changes caused by a phoneme-function
  1994.    remain in effect until another matching phoneme-function is processed.
  1995.  
  1996.    They may appear alone as in the following example:
  1997.         ~A2 loud ~A3 louder ~A3 even louder ~A0 back to normal
  1998.    or as part of a phoneme string as in this example:
  1999.         ~F-AE-N-A3+-T-AE-S-A0-T-IH-K.
  2000.  
  2001.  
  2002.    An   The amplitude function is used to vary the amplitude or volume
  2003.         of the created speech.
  2004.  
  2005.         Use n or n+ to increase the amplitude
  2006.             n- to decrease the amplitude
  2007.             0 to return to normal amplitude
  2008.  
  2009.         ~A1+ or ~A1 increases the volume 1 step.
  2010.         ~A1- decreases the volume 1 step.
  2011.         ~A0 sets the volume back to normal.
  2012.  
  2013.         Example:  At the > prompt type "this is ~a3 louder"
  2014.                   or "this is ~a3- softer"
  2015.                   or "this is loudly"  (LOUDLY is in the dictionary file)
  2016.                   or type "SPUT .\SAMPLES.TXT" to hear more examples.
  2017.  
  2018.    Rn   The rate function is used to vary the rate of the speech.
  2019.  
  2020.         Use n to set a new rate
  2021.             n+ to increase the current rate
  2022.             n- to decrease the current rate
  2023.             0 to return to the normal rate
  2024.  
  2025.         ~R10+ increases the rate by 10 (relative to current rate)
  2026.         ~R10- decreases the rate by 10 (relative to current rate)
  2027.         ~R202 sets the rate to 202 (absolute setting)
  2028.         ~R0 set the rate back to normal.
  2029.  
  2030.         Example:  At the > prompt type "this is ~r10+ faster"
  2031.                   or "this is ~r10- slower"
  2032.                   or type "SPUT .\SAMPLES.TXT" for more examples.
  2033.  
  2034.    Mn   The mode function is used to change between word and letter modes.
  2035.  
  2036.         Use 1 to switch to letter mode
  2037.             0 to switch to word mode (default)        
  2038.  
  2039.         Example:  At the > prompt type "this is ~M1 letter mode"
  2040.                   or "~M0 this is word mode again"
  2041.                   or type "SPUT .\SAMPLES.TXT" for more examples.
  2042.  
  2043.    Pn   The punctuation function is used to change the amount of punctuation
  2044.         that will be pronounced.
  2045.  
  2046.         Use 0 to pronounce no punctuation (none)
  2047.  
  2048.             1 to pronounce some punctuation (default)
  2049.                  # $ % & = @ + < > ! /
  2050.                  and . (point) if followed by a character
  2051.  
  2052.             2 to pronounce most punctuation
  2053.                  all level 1 punctuation and
  2054.                  " ' ( ) * , - : ; ? [ \ ] ^ _ ` { | } ~
  2055.                  and . (period)                   
  2056.  
  2057.             3 to pronounce all punctuation
  2058.                  all level 1+2 punctuation
  2059.                  and all control characters (not yet implemented)
  2060.  
  2061.  
  2062.   -------------------
  2063.   SPUT ERROR MESSAGES
  2064.   -------------------
  2065.  
  2066.   (01) Command syntax error, type 'SPUT<enter>' for help
  2067.   (02) Invalid amplitude, use /An or /An- n=1-255
  2068.   (03) Invalid playback rate, use 1-255 default=182/152
  2069.   (04) Invalid file format, use 1-88 default=8
  2070.   (05) Invalid oversample value, use 1-10 default=1
  2071.   (06) Invalid port, use 0-9 or any hex address
  2072.   (07) Invalid high-pass filter, use /Hi,r where i=interval and r=repeat
  2073.   (08) Invalid low-pass filter, use /Li,r where i=interval and r=repeat
  2074.   (09) Invalid continous play value, use 1-254 0-infinite
  2075.   (0A) Filtering disabled, only applicable for 8-bit PCM files
  2076.   (0B) Not enough memory available, file will be truncated
  2077.   (0C) Invalid data length in header record, file has been truncated
  2078.   (0D) Error releasing unused memory
  2079.   (0E) Memory allocation failure
  2080.   (0F) Sound file not found <filename>
  2081.   (10) File read error
  2082.   (11) Error opening output file
  2083.   (12) Error writing header
  2084.   (13) Error writing file
  2085.   (14) Unknown file format, default format 08 may be incorrect
  2086.   (15) Oversampling calculation error, use a smaller Rate or Oversample value
  2087.   (16) File format not supported for this device
  2088.   (17) Invalid driver, for SPKR use 1(software) 2(polling) 3(ints) 4(8255)
  2089.                        for SOUND BLASTER use 1(direct) 2(dma)
  2090.   (18) New rate must be smaller than old playback rate
  2091.   (19) New frequency is too small (max frequency reduction is half)
  2092.   (1A) Voice file not found - <filename>
  2093.   (1B) Insufficient memory to load Voice file
  2094.   (1C) Voice file read error
  2095.   (1D) Sound Blaster initialization failure
  2096.   (1E) Text to phoneme translation error
  2097.   (1F) Dictionary file not found - <filename>
  2098.   (22) Macintosh Resource Fork is missing, default rate of 152 may be incorrect
  2099.   (23) Missing or unknown header record, default rate of 182 may be incorrect
  2100.   (24) Digitizing text files is only available to registered users
  2101.   (25) Another SPUTTER player utility is already running
  2102.  
  2103.  
  2104.   ---------------------------------------
  2105.   TROUBLE SHOOTING PROBLEMS WITH PLAYBACK
  2106.   ---------------------------------------
  2107.  
  2108.   ** File plays too slowly (with or without any optional switches)
  2109.  
  2110.   This is simply the result of trying to play a file with too high a
  2111.   playback rate on too slow of a machine.  A RATE of 180 seems to be
  2112.   the fastest rate that an 8mhz AT machine can play, with no SPUT switches.
  2113.   Adding switches causes more processing to be done, and will slowdown
  2114.   playback even further.
  2115.  
  2116.   The solution is to run the file through SPUT with the /RS and /W switches
  2117.   to resample the file down to a lower playback rate that the machine
  2118.   can handle (ie: SPUT file/RS100/Wfile2).  If the new file still plays
  2119.   too slowly, then try the process again using a lower playback rate.
  2120.  
  2121.  
  2122.   ****************************************************************************
  2123.                  SECTION 3.4 - SPUTROL ROL File Player Utility
  2124.   ****************************************************************************
  2125.  
  2126.   This section describes the ROL file player program named SPUTROL.
  2127.  
  2128.   Very little memory is required to run SPUTROL, only 12k for the program,
  2129.   and enough additional memory to read the BANK file and the ROL file.
  2130.   That's it!  To play a 5k ROL file with a 10k BANK file requires only 27k
  2131.   of memory.  If you plan on letting SPUTROL load the AdLib sound driver
  2132.   SOUND.COM, then an additional 18k of memory will be required, but only
  2133.   for the duration of the song playing.  All memory is released when the
  2134.   song is finished.
  2135.  
  2136.   Another feature of SPUTROL is intelligent instrument substitution.  When
  2137.   an instrument is not found in the Bank file, SPUTROL will attempt to find
  2138.   a close match instead of defaulting to PIANO1.  You can also specify
  2139.   your own instrument substitutions if you prefer.
  2140.  
  2141.   Typing 'SPUTROL' with no arguments at the DOS prompt, will print the
  2142.   version number and a short help screen.
  2143.  
  2144.   If you are an unregistered user, you will also see the following message
  2145.   whenever playback is completed.
  2146.  
  2147.               ┌───────────────────────────────────────────────────┐
  2148.               │                                                   │
  2149.               │   Thank you for trying The Sputter Sound System   │
  2150.               │        If you use Sputter, please register        │
  2151.               │                                                   │
  2152.               │   Registration will remove this message & delay   │
  2153.               │          and give you additional features         │
  2154.               │                                                   │
  2155.               └───────────────────────────────────────────────────┘
  2156.  
  2157.  
  2158.   ------------------------
  2159.   SPUTROL FILE INFORMATION
  2160.   ------------------------
  2161.  
  2162.   SPUTROL displays the following information on the screen each time it
  2163.   is run.
  2164.  
  2165.   SPUTROL v1.11 ROL Player - Copyright 1990, VersaWare / Adrienne Cousins
  2166.   Sound driver V1.51 (C) Ad Lib Inc. 1987, 1989
  2167.   Sound driver successfully installed.
  2168.   BNK File: D:\VOX\STANDARD.BNK v1.0 253/256 entries
  2169.   ROL File: E:\ROL\BUMBLBEE.CLS  Mode:0  TPB:8  BPM:2  Tempo:152  TemEvents:1
  2170.   Voice Length Inst  Instrument Names  (VolumeChanges/PitchChanges)
  2171.   ---------------------------------------------------------------------------
  2172.       1  1572    11  VIOLIN1 SYN4 ELGUIT1 CLAR1 SYNBASS1 CLAR1 (38/60)
  2173.       2  1498     8  CLAR1 ELGUIT1 SYN4 VIOLIN1 CLAR1 SYN4 (35/58)
  2174.       3  1608     6  ELGUIT2 ELGUIT2 MARIMBA2 ELGUIT2 MARIMBA2 ELGUIT2 (58/1)
  2175.       4  1592     6  ELGUIT2 ELGUIT2 MARIMBA2 ELGUIT2 MARIMBA2 ELGUIT2 (49/1)
  2176.       5  1592     6  ELGUIT2 ELGUIT2 MARIMBA2 ELGUIT2 MARIMBA2 ELGUIT2 (38/1)
  2177.       6  1608     5  ELGUIT2 ELGUIT2 PIANO1 MARIMBA2 ELGUIT2 (22/1)
  2178.       7  1608     5  ELGUIT2 ELPIANO2 PIANO1 ELPIANO2 PIANO1 (15/5)
  2179.       8  1346     2  ELGUIT2 SYN2 (3/1)
  2180.       9  1251     3  PIANO1 TRUMPET4 SYN4 (7/1)
  2181.      10     0     1  PIANO1 (1/1)
  2182.      11     0     1  PIANO1 (1/1)
  2183.    Time to play: 1:19 ■ Loading song into driver ■ Playback has started 
  2184.  
  2185.   1st line:
  2186.         This is the program title, version and copyright statement.
  2187.  
  2188.   2nd and 3rd lines:
  2189.         These lines will only be displayed when the AdLib sound driver
  2190.         SOUND.COM has not been loaded prior to running SPUTROL.  In this
  2191.         case, SPUTROL will automatically find and load SOUND.COM and then
  2192.         remove it from memory when playback is completed.  When using this
  2193.         feature, it is recommended that you keep a copy of SOUND.COM on a
  2194.         RAMdisk if available.  The sound driver should also be in a
  2195.         directory that is in the current path statement.
  2196.         
  2197.   BNK File:
  2198.         This is the name of the bank file that is being used for playback.
  2199.         Also displayed is the version number of the bank file format, and
  2200.         the number of used/total entries in the bank file.  The PATH is
  2201.         automatically searched to find STANDARD.BNK if a bank file is not
  2202.         specified on the command line.
  2203.  
  2204.   ROL File:
  2205.         This is the name of the ROL file that is being played.
  2206.         The extension is not required when specifying a file to be played,
  2207.         and files may be renamed using any convenient extension.
  2208.  
  2209.   Mode:
  2210.         This is the mode of the file being played.  Zero is melodic mode
  2211.         which uses voices 1-8 and one is percussive mode, which uses voices
  2212.         1-6 in melodic mode and voices 7-11 in percussive mode.
  2213.  
  2214.   TPB:
  2215.         This is the number of ticks-per-beat defined for this song.
  2216.  
  2217.   BPM:
  2218.         This is the number of beats-per-measure defined for this song.
  2219.  
  2220.   Tempo:
  2221.         This is the tempo that the song is being played at, and may be
  2222.         changed with the /T switch.
  2223.  
  2224.   TemEvents:
  2225.         This is the total number of tempo changes that occur in the song.
  2226.  
  2227.   Voice Length Inst Instrument Names (VolumeChanges/PitchChanges)
  2228.         One line of information is printed for each of the 11 voices and
  2229.         contains the following information:
  2230.         Voice - the voice number.
  2231.         Length - the length of the voice in ticks.
  2232.         Inst - the number of instrument changes for this voice.
  2233.         Instrument Names - The names of the instruments for this voice.
  2234.                 An instrument name followed by a slash and another instrument
  2235.                 names indicates that a substitution has been made.
  2236.         (VolChanges/PitChanges) - The number of volume and pitch changes.
  2237.  
  2238.   Time to play:
  2239.         This is the estimated time that the song will take to play.
  2240.  
  2241.   Loading song into driver:
  2242.         This indicates that SPUTROL is in the process of loading the song
  2243.         into the AdLib sound driver.
  2244.  
  2245.   Playback has started: 
  2246.         This indicates that SPUTROL has filled the AdLib sound driver
  2247.         buffer and the driver has started to play the song.
  2248.  
  2249.  
  2250.   -----------------------------
  2251.   SPUTROL ENVIRONMENT VARIABLES
  2252.   -----------------------------
  2253.  
  2254.   SROLARG
  2255.         This allows you to setup any permanent switches that you would
  2256.         like SPUTROL to use every time it's run, without having to enter
  2257.         them on the command line.  Any switches specified on the command
  2258.         line, will override the switches in the SROLARG variable.
  2259.  
  2260.         You can set this value at the DOS prompt, or by including a line
  2261.         in your AUTOEXEC.BAT file with the following command:
  2262.  
  2263.                 set srolarg=/q2
  2264.  
  2265.  
  2266.   SROLDIR
  2267.         This defines the default directory to find ROL files.  If a
  2268.         filename is given on the command line with no drive or directory,
  2269.         SPUTROL will look for the file in the directory defined by the
  2270.         SROLDIR variable.
  2271.  
  2272.         You can set this value at the DOS prompt, or from your AUTOEXEC.BAT
  2273.         file with the following command:
  2274.  
  2275.                 set sroldir=c:\rol
  2276.  
  2277.         This tells SPUTROL to look in the ROL directory on the
  2278.         C: drive for all ROL files.
  2279.  
  2280.         To force SPUTROL to play a file in the current directory without
  2281.         having to enter the complete path, use the following command:
  2282.  
  2283.                 sputrol .\filename
  2284.  
  2285.  
  2286.   -------------------------
  2287.   SPUTROL SYNTAX & SWITCHES
  2288.   -------------------------
  2289.  
  2290.   Syntax:  SPUTROL <rolfile> [<bankfile>] [/switches]
  2291.  
  2292.   <rolfile>
  2293.         This is the name of the ROL file to be played.  Any valid DOS
  2294.         wildcards may be used to have SPUTROL randomly select a ROL file.
  2295.         The extension is not required, and ROL files may be renamed using
  2296.         any convenient extension.
  2297.  
  2298.         If no path is specified, the drive:directory specified by the
  2299.         SROLDIR environment variable will be searched, otherwise the
  2300.         current directory is assumed.
  2301.  
  2302.         Specifying a directory as part of the filename, will override
  2303.         any directory specified by the SROLDIR environment variable.  Use
  2304.         ".\filename" to indicate the current directory and ignore the
  2305.         SROLDIR environment variable.
  2306.  
  2307.   [<bankfile>]
  2308.         This argument is optional, and if used is the name of the bank file
  2309.         to be used.  The default name is STANDARD.BNK in the current
  2310.         directory, or any directory in the PATH statement.
  2311.  
  2312.   [/switches]
  2313.         All switches are optional.  The SROLARG environment variable is
  2314.         checked first for any permanent switches.  Any switches given on
  2315.         the command line will then override the SROLARG switches.
  2316.         The valid switches are listed below.
  2317.  
  2318.   ESCAPE key
  2319.         Pressing the ESCAPE key during file playback, will cause SPUTROL to
  2320.         immediately stop playback and exit.  This will not disturb any
  2321.         type ahead already in the keyboard buffer.
  2322.  
  2323.   ?
  2324.         Entering a question mark on the command line, will tell SPUTROL to
  2325.         display a short help screen.
  2326.  
  2327.   /An
  2328.         This switch can be used to modify the amplitude or volume of
  2329.         a song.  Using a positive number (/An or /An+) will increase the
  2330.         volume, and a negative number (/An- ) will decrease the volume.
  2331.  
  2332.   /Cn
  2333.         This will cause the song file to be played N times, in a
  2334.         continous loop.  A value of 0 will play indefinetly, until the
  2335.         ESCAPE key is struck.
  2336.  
  2337.   /I
  2338.         This switch will display on screen, all the file information that
  2339.         is normally displayed when the file is played, but without any
  2340.         playback occurring.
  2341.  
  2342.   /IF
  2343.         Normally when SPUTROL detects an invalid ROL file, an error message
  2344.         is displayed and the song is not played.  This switch can be used
  2345.         to force SPUTROL to play an invalid ROL file format.
  2346.  
  2347.   /ISold1=new1,old2=new2
  2348.         This switch is used to specify instrument substitutions, where
  2349.         OLD1 is the name of the original instrument and NEW1 is the name
  2350.         of the instrument to be used in its place.  Up to 5 substitutions
  2351.         may be specified, separated by commas.
  2352.  
  2353.   /IN
  2354.         Normally, only the first 6 instruments are displayed for each voice
  2355.         so that the file information will all fit on a single screen.
  2356.         Use this switch to force SPUTROL to display all instruments used
  2357.         for each of the voices.
  2358.  
  2359.   /K
  2360.         This switch causes SPUTROL to kill the song that was left playing
  2361.         in the background.
  2362.  
  2363.   /Mn
  2364.         This switch can be used to change the mode of the song.  Zero is
  2365.         melodic and uses voices 1-8, and one is percussive and uses voices
  2366.         1-6 in melodic mode and voices 7-11 in percussive mode.
  2367.  
  2368.   /NW
  2369.         This is the NOWAIT switch tells SPUTROL to exit as soon as the
  2370.         entire song is loaded into the SOUND driver, and leave the song
  2371.         playing in the background.  This switch can only be used if the
  2372.         AdLib sound driver SOUND.COM was already loaded before SPUTROL was
  2373.         run.
  2374.  
  2375.   /Pnnn
  2376.         This switch allows selection of the disired output port.  The
  2377.         default port address is 388 hex.  No switch is required for
  2378.         either the AdLib or SoundBlaster cards.
  2379.  
  2380.   /Qn
  2381.         This switch is used to set the desired level of screen output.
  2382.                 /Q0       display everything
  2383.                 /Q1       display nothing
  2384.                 /Q2       display errors only
  2385.  
  2386.   /Tn
  2387.         This switch can be used to change the default tempo of the song.
  2388.  
  2389.   /Vnnn
  2390.         This switch can be used to specify a single voice or list of voices
  2391.         to play.  /V246 would play only voices 2, 4 and 6.  This is most
  2392.         useful for proofreading music while creating ROL files, and
  2393.         hearing the balance between instruments.  It is also handy for
  2394.         determining which voice is playing a particular part for which
  2395.         you may want to change an instrument.
  2396.  
  2397.  
  2398.   ----------------------
  2399.   SPUTROL ERROR MESSAGES
  2400.   ----------------------
  2401.  
  2402.   (01) Error releasing unused memory
  2403.   (02) Insufficient memory to load ROL file
  2404.   (03) ROL file not found - <filename>
  2405.   (04) ROL file read error
  2406.   (05) Invalid ROL file format - <filename>
  2407.   (06) BANK file not found - <filename>
  2408.   (07) BANK file read error
  2409.   (08) Invalid BANK file
  2410.   (09) Insufficient memory to load BANK file
  2411.   (10) Command syntax error, type 'SPUTROL<enter>' for help
  2412.   (11) Instrument not found <instrument>
  2413.   (12) SOUND.COM driver not loaded, loading temporarily
  2414.   (13) Invalid amplitude, use /An or /An- (n=1-255)
  2415.   (14) Error loading Tempo Events
  2416.   (15) Error loading Instrument Events
  2417.   (16) Error loading Volume Events
  2418.   (17) Error loading Pitch Events
  2419.   (18) Insufficient memory to load instruments
  2420.   (19) Another SPUTTER player utility is already running
  2421.   (20) Insufficient memory to load SOUND driver
  2422.   (21) Error loading SOUND driver
  2423.  
  2424.  
  2425.   ****************************************************************************
  2426.                     SECTION 3.5 - SPUTWAVE Waveform viewer
  2427.   ****************************************************************************
  2428.  
  2429.   This section describes the utility SPUTWAVE, which displays an 8-bit
  2430.   PCM sound file as a wave form on the screen.  An EGA display adapter
  2431.   or better is required and it supports the following syntax & switches:
  2432.  
  2433.         sputwave [<drive:>]<filename> [/On] [/Ln]
  2434.  
  2435.   /On
  2436.         N is a byte offset into file where display should start. 
  2437.   /Ln
  2438.         N is the length of data to display in bytes.  This number must
  2439.         be at least the pixel width of the current screen mode
  2440.         (usually 640), and must not be a value that would exceed the
  2441.         end of the file or a run-time error will occur.  The default data
  2442.         length displayed is 1 meg.
  2443.  
  2444.  
  2445.   ****************************************************************************
  2446.                   SECTION 3.6 - SPUTST Smooth Talker Utility
  2447.   ****************************************************************************
  2448.  
  2449.   This section describes the Smooth Talker Device Driver utility named
  2450.   SPUTST.  This program can be used to send commands to the Smooth Talker
  2451.   Device Driver called STDRIVER.SYS loaded in the CONFIG.SYS file.
  2452.  
  2453.   Simply type 'SPUTST' at the DOS prompt followed by any of the allowed
  2454.   three letter commands, separated by spaces.
  2455.  
  2456.                 SPUTST cm1 cm2 cm3
  2457.  
  2458.   Typing just 'SPUTST' or 'SPUTST ?' will print a short help screen.
  2459.  
  2460.   SPUTST v1.11 Smooth Talker Utility - (C) 1990 VersaWare / Adrienne Cousins
  2461.   Voice Master Mode Commands:
  2462.           EVM     enable Voice Master Mode (digitized data)
  2463.           RDH     read VMF file header (supress playback)
  2464.           PLY     playback data file in buffer
  2465.           SPE     set playback speed 0-255
  2466.           VOL     set playback volume 1-8
  2467.           CKE     use 8253 timer for playback speed
  2468.           CKD     use software timing for playback speed
  2469.           DAC     enable alternate port address 0-65535 (def 408+409)
  2470.           WRA     set repeat playback 1-255 0=key
  2471.           USR     use alternate user address 100h-1FFh
  2472.   Smooth Talker Mode Commands:
  2473.           SV2     enable Smooth Talker Mode (SPEECHV2)
  2474.           SV3     enable Smooth Talker Mode (SPEECHV3)
  2475.           ENG     input will be English strings
  2476.           PHO     input will be phonetic strings
  2477.           XEP     convert next string from English to Phonetics
  2478.           TTE     enable echo of string data to screen
  2479.           TTD     disable echo of string data to screen
  2480.           CRE     enable carriage returns as string terminator
  2481.           CRD     disable carriage returns as string terminator
  2482.           FLU     flush the 255 byte string buffer
  2483.           TON     set voice tone 0=low 1=high
  2484.           SPE     set speed of playback 0-9
  2485.           PIT     set pitch of playback 0-9
  2486.           VOL     set volume of playback 0-9
  2487.   Use "COPY <filename> ST" for text files in Smooth Talker Mode
  2488.   Use "COPY <filename>/B ST" for digitized files in Voice Master Mode
  2489.  
  2490.   ****************************************************************************
  2491.                         SECTION 4 - MISCELLANEOUS
  2492.   ****************************************************************************
  2493.  
  2494.   ----------------
  2495.   ACKNOWLEDGEMENTS
  2496.   ----------------
  2497.  
  2498.   I'd like to thank the following people for their wonderful suggestions
  2499.   and help, without whom the SPUTTER Sound System would not be what it is
  2500.   today.
  2501.  
  2502.         Marty Peter, who first got me thinking about writing my own
  2503.         playback program, instead of relying on other player programs
  2504.         to play my custom sound files.  And for his great suggestion
  2505.         about a point-and-shoot interface that gave birth to the
  2506.         SPUTTER File Manager.
  2507.  
  2508.         Rich Wilson, for his suggestion of adding the BEEP event type to
  2509.         SPUTMON the Event Monitor, his suggestion to invoke playback from
  2510.         the DOS prompt, and for his support and friendship.
  2511.  
  2512.         Bernie Parent and Randy Bechtel, who's feedback made me realize
  2513.         the need to support the slower machines running at 4 and 8mhz.
  2514.         This prompted me to develop additional internal speaker drivers
  2515.         to support these machines.
  2516.         
  2517.         Tom Peters, for his sound clips and text files that mentioned the
  2518.         technique of resampling sound files.  This gave me the idea to
  2519.         implement the resampling algorithym, so that the playback rate
  2520.         of a soundfile can be changed so that it can be played on ANY
  2521.         speed machine.
  2522.  
  2523.         Dan Dubbs, for his suggestions to support the Sound Blaster,
  2524.         and AdLib music cards, the ability to spawn user defined programs
  2525.         and batch files from SPUTMON the Event Monitor, and offering many
  2526.         other neat suggestions.
  2527.  
  2528.         Bruce Tomlin, the author of SoundMaster for the Macintosh, for
  2529.         his help in locating the playback rate in Macintosh sound files.
  2530.  
  2531.  
  2532.                               Thank you all !!
  2533.  
  2534.  
  2535.   ---------------------------
  2536.   SPUTTER FUTURE ENHANCEMENTS
  2537.   ---------------------------
  2538.  
  2539.   See the file FUTURE.TXT for a list of enhancements that I'm planning on
  2540.   implementing in future releases.
  2541.  
  2542.  
  2543.   ----------------------
  2544.   SOURCES OF SOUND FILES
  2545.   ----------------------
  2546.  
  2547.   Check out the Amiga & Macintosh conferences of your favorite BBS.
  2548.   These areas are usually chuck full of sound files.  Both types of files
  2549.   usually have the playback rate stored within the file.
  2550.  
  2551.   Some of my favorites are Exec-PC in Milwaukee WI at 414-789-4210 and
  2552.   Channel 1 in Cambridge MA at 617-354-8873.  I can always be reached
  2553.   on either of these systems.
  2554.  
  2555.   If you find an especially good source of sound files, let me know and
  2556.   I'll add it to this section, so others can enjoy them too.
  2557.  
  2558.  
  2559.   ----------------------
  2560.   SPEAKER OUTPUT QUALITY
  2561.   ----------------------
  2562.  
  2563.   If the output volume of your speaker is so low that you can't hear much,
  2564.   the solution is to attach an inexpensive amplified speaker similar to
  2565.   those sold by Radio Shack.  These usually have a volume control knob, and
  2566.   some also have a tone control knob.  Most run on batteries, and some can
  2567.   use an optional AC adapter.  All you need to do is attach the two wires
  2568.   from the external speaker to the two wires on the internal speaker, or
  2569.   you can attach mini jacks.
  2570.  
  2571.   For even better playback quality, you can purchase any of the Digital to
  2572.   Analog Converters available on the market.  Let me know if you have a board
  2573.   that Sputter doesn't already support, and I'll see about adding support for
  2574.   it.
  2575.  
  2576.  
  2577.   ------------
  2578.   REGISTRATION
  2579.   ------------
  2580.  
  2581.   You may use the SPUTTER Sound System free of charge for a period of
  2582.   10 days.  If after that period of time, you find it useful and
  2583.   continue to use it, a $25 registration fee is required.
  2584.  
  2585.   During this evaluation period, the SPUT and SPUTROL Player Utilities
  2586.   will display a shareware message and pause for a few seconds after 
  2587.   playback of each file.  
  2588.  
  2589.   When you register, you will receive your own registration number and
  2590.   instructions for unlocking the SPUTTER Sound System and removing this 
  2591.   message and delay.  You will also be able to unlock all future shareware
  2592.   releases of The SPUTTER Sound System.
  2593.  
  2594.   I always appreciate any feedback you might have about the SPUTTER Sound
  2595.   System, and would be interested in seeing any files that SPUTTER is not
  2596.   able to playback correctly.  You can either mail them to me, or upload
  2597.   them to one of the BBSs listed in the above sections.
  2598.  
  2599.  
  2600.   ----------
  2601.   DISCLAIMER
  2602.   ----------
  2603.  
  2604.   All of the SPUTTER programs and this documentation are Copyright 1990
  2605.   by VersaWare and Adrienne Cousins, all rights reserved.
  2606.  
  2607.   VersaWare hereby disclaims all warranties relating to this product,
  2608.   whether express or implied, including without limitation any implied
  2609.   warranties of merchantability or fitness for a particular purpose.
  2610.   VersaWare cannot and will not be liable for any special, incidental,
  2611.   consequential, indirect or similar damages due to loss of data or any
  2612.   other reason, even if VersaWare or an authorized VersaWare agent has
  2613.   been advised of the possibility of such damages.  In no event shall the
  2614.   liability for any damages ever exceed the price paid for the license to
  2615.   use software, regardless of the form and/or extent of the claim.  The
  2616.   person using the software bears all risk as to the quality and performance
  2617.   of the software.
  2618.  
  2619.  
  2620.                  -------------------------------------------
  2621.  
  2622.  
  2623.  
  2624.