home *** CD-ROM | disk | FTP | other *** search
/ Mega A/V / mega_av.zip / mega_av / SOUNDUTL / SPUT115.ZIP / SPUTTER.DOC < prev    next >
Text File  |  1991-03-03  |  152KB  |  3,468 lines

  1.  
  2.  
  3.                   The SPUTTER Sound System for the PC
  4.                                 v1.15
  5.  
  6.                       VersaWare / Adrienne Cousins
  7.                             30 Jennifer St
  8.                           Littleton, MA 01460
  9.                          508-486-3083 (voice)
  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.           You can also attach sound files to individual key presses.
  28.  
  29.         * Supports many different output devices, including the PC internal
  30.           speaker, Speech Thing, Voice Master, Sound Master, Sound Blaster,
  31.           AdLib Music Card, Disney Sound Source and any other Digital to
  32.           Analog Converter.
  33.  
  34.         * Supports many different digitized sound file formats including
  35.           Covox (Speech Thing, Voice Master, Sound Master), Creative Labs
  36.           (Sound Blaster), Tandy, Macintosh, Amiga, IBM CVSD files,
  37.           Turtle Beach Softworks 16-bit (SampleVision), and 12-bit files.
  38.  
  39.         * Supports Adlib .ROL and Creative Labs .CMF synthesized music
  40.           files on Adlib & SoundBlaster boards.
  41.  
  42.         * Includes a complete text to synthesized speech package that
  43.           provides interchangable voice files and complete user control
  44.           over pronounciation and inflection.
  45.  
  46.         * Can randomly select sound files to provide variation without
  47.           having to change batch files regularly.
  48.  
  49.         * Can resample digitized sound files, to change the playback rate
  50.           of a file so that it can be played on slower machines.
  51.  
  52.         * Includes enhanced support for DESQview and runs as a well-behaved
  53.           program in a DESQview window.
  54.  
  55.  
  56.                         ----------------------------------
  57.  
  58.  
  59.   First a little trivia... since I'm always asked where I got the name
  60.   'Sputter' here it is...
  61.  
  62.   The first program to be written was the digitized file player, and I wanted
  63.   to give it a name that would be an acronym and still have a nice ring to it.
  64.   Hence, (S)oundfile (P)layer (UT)ility formed the acronym SPUT.  It was easy
  65.   enough to say and just happened to remind me of the word SPUTTER.  The
  66.   definition of SPUTTER is:
  67.  
  68.         SPUTTER 1: To spit out small particles in short bursts, often with
  69.                    corresponding sounds or noises. (American Heritage)
  70.                 2: To utter words hastily or explosively in excitement
  71.                    or confusion. (Merriam-Webster)
  72.                 3: To make small popping sounds. (Merriam-Webster)
  73.  
  74.   Sounded like a perfect choice to me!
  75.  
  76.                    ---------------------------------------
  77.  
  78.   The documentation is divided into the following sections:
  79.  
  80.         1. Installation Guide
  81.  
  82.         2. Quick Start User's Guide
  83.  
  84.            2.1  Starting the File Manager Shell
  85.            2.2  Adding Sounds to your batch files
  86.            2.3  Starting the Event Monitor
  87.            2.4  File naming conventions
  88.            2.5  Enlarging the environment space
  89.  
  90.         3. Reference Manual
  91.  
  92.            3.1  SPUTTER - File Manager
  93.  
  94.                 3.1.1  Command syntax and switches
  95.                 3.1.2  Special function keys
  96.  
  97.            3.2  SPUTMON - Event Monitor
  98.  
  99.                 3.2.1  Command syntax and switches
  100.                 3.2.2  Event definition file format
  101.                        Event types
  102.                        Event parameters
  103.                 3.2.3  Playing .ROL files from the event monitor
  104.                 3.2.4  Playing .CMF files from the event monitor
  105.                 3.2.5  Executing DOS commands & batch files
  106.                 3.2.6  Executing Smooth Talker from the event monitor
  107.                 3.2.7  Using the Event Monitor with DESQview
  108.                 3.2.8  Error messages
  109.                 3.2.9  Trouble shooting problems
  110.  
  111.            3.3  SPUT - Sound & Text Player Utility
  112.  
  113.                 3.3.1  Command syntax and switches
  114.                 3.3.2  Special function keys
  115.                 3.3.3  Screen output
  116.                 3.3.4  Environment variables
  117.                 3.3.5  Dictionary file format
  118.                 3.3.6  Phoneme definitions
  119.                 3.3.7  Phoneme special functions
  120.                 3.3.8  Error messages
  121.                 3.3.9  Trouble shooting 
  122.  
  123.            3.4  SPUTROL  - ROL File Player Utility
  124.  
  125.                 3.4.1  Command syntax and switches
  126.                 3.4.2  Special function keys
  127.                 3.4.3  Screen output
  128.                 3.4.4  Environment variables
  129.                 3.4.5  Error messages
  130.  
  131.            3.5  SPUTCMF  - CMF File Player Utility
  132.  
  133.                 3.5.1  Command syntax and switches
  134.                 3.5.2  Special function keys
  135.                 3.5.3  Screen output
  136.                 3.5.4  Environment variables
  137.                 3.5.5  Error messages
  138.  
  139.            3.6  SPUTWAVE - Waveform Viewer
  140.  
  141.            3.7  SPUTST   - Smooth Talker Utility
  142.  
  143.            3.8  SPUTONE  - DESQview One-window Utility
  144.  
  145.         4. Miscellaneous
  146.  
  147.            4.1  Acknowledgements
  148.            4.2  Technical support
  149.            4.3  Registration
  150.            4.4  Future enhancements
  151.            4.5  Sources of sound files
  152.            4.6  Speaker output quality
  153.            4.7  Disclaimer
  154.  
  155.  
  156.   *************************************************************************
  157.                        SECTION 1 - INSTALLATION GUIDE
  158.   *************************************************************************
  159.  
  160.   Sputter is distributed in the following ZIP files, where 'nnn' is the
  161.   latest version number (ie SPUT114 is version 1.14):
  162.  
  163.         SPUTnnnA.ZIP    All the required Sputter software & text files.
  164.  
  165.         SPUTnnnB.ZIP    Sample digitized sound files.
  166.                         These files are playable on all sound devices.
  167.  
  168.         SPUTnnnC.ZIP    Sample .ROL and .CMF files with associated
  169.                         drivers and instrument files.
  170.                         These files are for AdLib and SoundBlaster boards.
  171.  
  172.  
  173.   These three ZIP files are always distributed by the author to the
  174.   following BBS's:
  175.  
  176.         Creative Labs BBS    San Jose CA  (CASJO)  408-986-1488 / 1489
  177.         Channel One BBS      Cambridge MA (MABOS)  617-354-8873
  178.         Exec-PC BBS          Milwaukee WI (WIMIL)  414-789-4210
  179.  
  180.  
  181.            ------------------------------------------------------
  182.  
  183.   Installation of SPUTTER is very simple, just execute the following steps.
  184.  
  185.   1) Create a directory for the Sputter software & associated drivers,
  186.      and separate directories for the sound files.  The following is only
  187.      an example, any preferred directory names may be used:
  188.  
  189.                 \SPUT           for all the software
  190.                 \SPUT\SND       for digitized sound files
  191.                 \SPUT\ROL       for .ROL music files
  192.                 \SPUT\CMF       for .CMF music files
  193.  
  194.   2) Add the SPUT directory to your PATH statement.
  195.  
  196.   3) Place all of the Sputter programs and required files in the SPUT
  197.      directory.  Those files are as follows:
  198.  
  199.         SPUTTER.COM             File Manager
  200.         SPUTMON.COM             Event Monitor
  201.         SPUT.COM                Sound & Text file player
  202.         SPUTROL.COM             ROL file player
  203.         SPUTCMF.COM             CMF file player
  204.         SPUT.PHD                Voice file for text-to-speech
  205.         SPUT.DIC                Sample Dictionary file for text-to-speech
  206.         SPUTMON.DEF             Sample Event definition file
  207.         SM-PIF.DVP              DESQview PIF for the Sputter Event Monitor
  208.         SM-SCRIP.TXT            DESQview script file for SM-PIF.DVP
  209.         SM-SCRIP.DVS            DESQview script file for SM-PIF.DVP
  210.         SP-PIF.DVP              DESQview PIF for the Sputter Player Window
  211.         SPUTONE.SHR             DESQview shared program
  212.  
  213.   If you are using a SoundBlaster or AdLib card to play .ROL music files
  214.   the following files are also required from the SPUTnnnC.ZIP file:
  215.  
  216.         SOUND.COM               AdLib FM Sound driver
  217.         STANDARD.BNK            AdLib Instrument Bank file
  218.  
  219.   If you are using a SoundBlaster or AdLib card to play .CMF music files
  220.   the following file is also required from the SPUTnnnC.ZIP file:
  221.  
  222.         SBFMDRV.COM             Creative Labs FM sound driver
  223.  
  224.   The following files are also included in the distribution, but are not
  225.   necessary for execution:
  226.  
  227.         SPUTTER.DOC             Sputter documentation file
  228.         KEYS.TXT                List of scan-codes for KEY events.
  229.         KEYS.DEF                Samples of KEY event definitions.
  230.         LICENSE.TXT             Licensing information.
  231.         MAILER.TXT              Registration mailer.
  232.         PHONES.TXT              List of Phonemes from the Doc file
  233.         SAMPLES.TXT             Samples of the Phoneme-functions
  234.         WHATS.NEW               Description of the latest changes
  235.         FUTURE.TXT              What's planned for future releases
  236.         USES.TXT                Some ideas for using Sputter
  237.  
  238.   4) If you are using any sound device other than the PC Internal Speaker,
  239.      you must add a line to define the port address of your sound board:
  240.  
  241.      For VoiceMasterKey I     SET SPUTARG=/P1          (or 2,3,4)
  242.      For VoiceMasterKey II    SET SPUTARG=/P5          (or 6,7,8)
  243.      For SpeechThing          SET SPUTARG=/P5          (or 6,7,8)
  244.      For DisneySoundSource    SET SPUTARG=/P5-D        (or 6,7,8)
  245.      For SoundBlaster         SET SPUTARG=/P220-S/IR3  (or 230,240,250,260)
  246.      For AdLib card           SET SPUTARG=/P388-A
  247.  
  248.      You may also include any permanent switches you want to define for
  249.      the sound file player:
  250.  
  251.                 SET SPUTARG=/Q2
  252.  
  253.   5) Add a line to your AUTOEXEC.BAT file to define the path in which
  254.      your sound files are stored similar to the following example:
  255.  
  256.                 SET SPUTDIR=C:\SPUT\SND
  257.  
  258.   6) If you are using a SoundBlaster or AdLib card to play .ROL music files,
  259.      add a line to define the path to your ROL files:
  260.  
  261.                 SET SROLDIR=C:\SPUT\ROL
  262.  
  263.      and you may optionally add a line to define any permanent switches
  264.      you want to define for the ROL file player:
  265.  
  266.                 SET SROLARG=/Q2
  267.  
  268.   7) If you are using a SoundBlaster or AdLib card to play .CMF music files,
  269.      add a line to define the path to your CMF files:
  270.  
  271.                 SET SCMFDIR=C:\SPUT\CMF
  272.      
  273.      and a similar line to define any permanent switches for the CMF player:
  274.  
  275.                 SET SCMFARG=/Q2
  276.  
  277.  
  278.   *************************************************************************
  279.                     SECTION 2 - QUICK START USER'S GUIDE
  280.   *************************************************************************
  281.                SECTION 2.1 - Starting the File Manager Shell
  282.   *************************************************************************
  283.  
  284.   To start the Sputter Sound System, you must be at the DOS prompt.  Type
  285.   'SPUTTER ' followed by the drive:directory that contains the sound files
  286.   you want to work with, then press the ENTER key:
  287.  
  288.                 SPUTTER C:\SPUT\SND <enter>
  289.  
  290.   or, if you are already in the directory you want to work with, just type
  291.   the following:
  292.  
  293.                 SPUTTER <enter>
  294.  
  295.   From the File Manager, just place the highlight bar on the file you want
  296.   played and press the ENTER key.  Many other functions are available
  297.   within the File Manager, which can all be found in the pull-down menus.
  298.  
  299.  
  300.   *************************************************************************
  301.                SECTION 2.2 - Adding Sounds to your batch files
  302.   *************************************************************************
  303.  
  304.   To play a specific sound file from a batch file, just insert the following
  305.   line, wherever you want the sound file to be played:
  306.  
  307.                 SPUT <filename>                 for a sound file
  308.         or      SPUTROL <filename>              for a .ROL file
  309.         or      SPUTCMF <filename>              for a .CMF file
  310.  
  311.   Where <filename> is the name of the sound file you want to be played.
  312.  
  313.   To play a randomly selected sound file, just insert the following line
  314.   wherever you want to hear a sound file:
  315.  
  316.                 SPUT *                          for a sound file
  317.         or      SPUTROL *                       for a .ROL file
  318.         or      SPUTCMF *                       for a .CMF file
  319.  
  320.   To disable the screen output from the SPUT player utility, you can add the
  321.   /Q switch to each of above command lines, or you can just put it in the
  322.   environment once so that all screen output will be disabled as follows:
  323.  
  324.                 SET SPUTARG=/Q2                 for sound files
  325.         or      SET SROLARG=/Q2                 for .ROL files
  326.         or      SET SCMFARG=/Q2                 for .CMF files
  327.  
  328.  
  329.   *************************************************************************
  330.                   SECTION 2.3 - Starting the Event Monitor
  331.   *************************************************************************
  332.  
  333.   To setup the Event Monitor, you must first create an event definition file.
  334.   A sample event definition file SPUTMON.DEF has been included in the
  335.   distribution which may be modified to your preferences.
  336.     
  337.   To load the Event Monitor, type 'SPUTMON ' followed by the name of the
  338.   event definition file, then press the ENTER key:
  339.  
  340.                 SPUTMON SPUTMON.DEF <enter>
  341.  
  342.  
  343.   *************************************************************************
  344.                 SECTION 2.4 - FILE NAMING CONVENTIONS
  345.   *************************************************************************
  346.  
  347.         All of the Sputter player programs, have the ability to randomly
  348.         select the sound file to be played.  This is a convenient way of
  349.         adding variation to your system so you don't tire of hearing the
  350.         same sound clips over and over again.
  351.  
  352.         At the same time, the player programs are also smart enough to
  353.         recognize different file formats by the contents of the file,
  354.         therefore making the extension not important.  This permits the
  355.         renaming of sound files to any filename and extension that's
  356.         preferred or convenient.
  357.  
  358.         These two features combined, provide a powerful way of randomly
  359.         selecting specific types of sound files.  For example, if sound files
  360.         are categorized in the following way:
  361.  
  362.                 *.MUS           music sound clips
  363.                 *.TUN           cartoon sound clips
  364.                 *.ANI           animal sounds
  365.                 *.SFX           special sound effects
  366.                 *.MOV           quotes from movies
  367.  
  368.         then the command 'SPUT *.MUS' would randomly select one of the
  369.         music sound clips, 'SPUT *.ANI' would select an animal sound, etc.
  370.         The command 'SPUT *.*' would select a file from any category.
  371.  
  372.         Another example of this, is if you defined a BEEP event for the
  373.         Event Monitor SPUTMON by adding the following line to the event
  374.         definition file as follows:
  375.  
  376.                 B *.ANI
  377.  
  378.         This would play a different animal sound in place of each system
  379.         beep.
  380.  
  381.         Another method of sound file categorization is by directory, where
  382.         sound files of similar type are stored in a separate directory for
  383.         each category.  Then the following commands would randomly select
  384.         files from the appropriate categories:
  385.  
  386.                 SPUT \SPUT\SND\CARTOONS\*
  387.                 SPUT \SPUT\SND\MOVIES\*
  388.                 SPUT \SPUT\SND\ANIMALS\*
  389.  
  390.         Note that the filename and extension hold no special meaning
  391.         for SPUT.  Any information needed for playback is retrieved
  392.         from within the file.  Any reference to extensions within the
  393.         SPUTTER documentation, is simply to aid you in determining the
  394.         file format.  SPUT can always determine the file format from
  395.         the contents of the file regardless of the filename & extension.
  396.  
  397.  
  398.   *************************************************************************
  399.                SECTION 2.5 - ENLARGING THE ENVIRONMENT SPACE
  400.   *************************************************************************
  401.  
  402.   The environment is just an area of memory that DOS reserves for the purpose
  403.   of defining variables that can be viewed by any program running.
  404.  
  405.   Each time you add a 'SET' command to your AUTOEXEC.BAT file, the string
  406.   that you type after the word 'SET' is stored in the environment space.
  407.  
  408.   The more of these 'SET' commands that you have, the greater the chance
  409.   that you'll get to see the 'out of environment space' message from DOS
  410.   while your system is booting up.  Not to worry... there is a solution.
  411.  
  412.   In your CONFIG.SYS file, add a line similar to the following:
  413.  
  414.                 SHELL=C:\DOS\COMMAND.COM/E:512/P
  415.  
  416.   The number after the '/E:' is the number of bytes that will be reserved
  417.   for your environment space, and you can set it to whatever you require.
  418.   The default is 128.
  419.  
  420.  
  421.   *************************************************************************
  422.                         SECTION 3 - REFERENCE MANUAL
  423.   *************************************************************************
  424.   *************************************************************************
  425.                      SECTION 3.1 - SPUTTER File Manager
  426.   *************************************************************************
  427.  
  428.   This section describes the point-and-play file manager named SPUTTER.
  429.   From the File Manager, sound files can be played, viewed in waveform,
  430.   viewed in ascii/hex mode, copied, renamed, moved and deleted, either
  431.   individually or in tagged groups.
  432.  
  433.   ---------------------------------------
  434.   3.1.1 SPUTTER COMMAND SYNTAX & SWITCHES
  435.   ---------------------------------------
  436.  
  437.   To start the File Manager, simply type 'SPUTTER' at the DOS prompt and
  438.   SPUTTER presents an alphabetized listing of the current directory with
  439.   a menu on the right.  An optional drive and directory may be specified
  440.   as the directory to be used, instead of the current directory.
  441.  
  442.   The command syntax for SPUTTER is as follows:
  443.  
  444.         SPUTTER [d:] [\directory] [/E] [/S] [/D] [/T] [/O]
  445.  
  446.   Optionally, the /E,/S,/D,/T and /O command line switches sort the
  447.   initial directory listing by Extension, Size, Date (/D and/T are the
  448.   same), or Original DOS order.  Once on screen, function keys can be
  449.   used for subsequent sorts.
  450.  
  451.   Once started, SPUTTER will initialize the display as follows:
  452.  
  453.         . The top line is the Menu line, and is activated with the F10
  454.           function key or the slash key (/).
  455.  
  456.         . The second line shows the currently displayed drive & directory.
  457.  
  458.         . The large window on the left is the directory window and contains
  459.           a list of files in the current directory.
  460.           The file attributes (Archive, Hidden, Read-only and System) are
  461.           shown by the appropriate letters to the right of the time for
  462.           each listed file.  A period is displayed for any file attributes
  463.           that are not set.
  464.  
  465.         . The mid-sized window on the upper right is the info window and
  466.           contains various counters, and the state of the toggle switches.
  467.  
  468.         . The smaller window on the lower right is the preview window
  469.           and gives a peek at the contents of the currently highlighted file.
  470.  
  471.         . The line below the windows is the message line and displays
  472.           various prompts and messages.
  473.  
  474.         . The next line is the input line, used for entering data.
  475.  
  476.         . The last line is the function key menu.
  477.  
  478.  
  479.   DOS wildcards ? and * are supported for COPY, MOVE and DELETE operations.
  480.  
  481.   -----------------------------------
  482.   3.1.2 SPUTTER SPECIAL FUNCTION KEYS
  483.   -----------------------------------
  484.  
  485.   Once SPUTTER has been started, the following keys have meaning:
  486.  
  487.   A-Z
  488.         Pressing a letter, moves the highlight bar to the first (then sub-
  489.         sequent) filename beginning with that letter.
  490.  
  491.   Up & Down
  492.         The Up and Down arrow key moves the highlight bar up or down one
  493.         line at a time.
  494.  
  495.   Home & End
  496.         The Home and End keys go to either the first or last file in the
  497.         directory.
  498.  
  499.   PgDn & PgUp
  500.         The Page-Up and Page-Down keys allow you to scroll up and down
  501.         through the entire directory.
  502.  
  503.   Ctrl-PgDn & Ctrl-PgUp
  504.         The Ctrl-Page-Up and Ctrl-Page-Down move to the top and bottom of
  505.         the current display page (21 files).
  506.  
  507.   Left-Arrow & Right-Arrow or Grey+ & Grey-
  508.         These keys are used to mark and unmark files.  After marking or
  509.         unmarking a file, the highlight bar is automatically moved in the
  510.         same direction that it was moved last.
  511.         Multiple files may be tagged for group playing, viewing, copying,
  512.         moving or deleting.
  513.  
  514.   F1 (Help)
  515.         This key activates the Help pull-down menu.
  516.  
  517.   F2 (Args)
  518.         This key displays the SPUT help screen.
  519.  
  520.   F3 (Dir)
  521.         This key will cause SPUTTER to reread the current directory.
  522.         This is useful if files have been created or added to the
  523.         current directory since starting SPUTTER.
  524.  
  525.   F4 (Chdir)
  526.         This key provides a way to change the current drive and
  527.         directory without leaving SPUTTER.
  528.  
  529.   F5 (Mark)
  530.         This key will cause all previously unmarked files to be marked.
  531.         Files with an asterick are considered marked.  To remark files
  532.         with an asterick, press F6 to clear all marks, then F5 to mark
  533.         all files.
  534.  
  535.   F6 (Clear)
  536.         This key will unmark all files including those with astericks.
  537.  
  538.   F7 (Pause)
  539.         This key will toggle the state of the Pause-after-output switch.
  540.  
  541.   F8 (Output)
  542.         This key will toggle the state of the Output switch.
  543.  
  544.   F9
  545.         This key is currently unused.
  546.  
  547.   F10 (Menu)
  548.         This key invokes the top line menu.
  549.  
  550.   ESCAPE
  551.         Pressing this key exits SPUTTER, and returns to the DOS prompt.
  552.  
  553.   F10+File or Alt-F
  554.         This key activates the File menu.
  555.  
  556.   F10+Sound or Alt-S
  557.         This key activates the Sound menu.
  558.  
  559.   F10+Options or Alt-O
  560.         This key activates the Options menu.
  561.  
  562.   F10+Help or Alt-H
  563.         This key activates the Help menu.
  564.  
  565.   F10+Quit or Alt-Q
  566.         This key activates the Quit menu.
  567.  
  568.   F10+Sound+Play or Enter
  569.         The Play function initiates the playback process for either
  570.         the highlighted or marked file(s).  This option requires the
  571.         appropriate player program to be located in a directory that is
  572.         listed in your PATH statement.
  573.  
  574.         The player programs used are SPUT.COM for digitized sound files,
  575.         and text to speech files and SPUTROL.COM for .ROL synthesized
  576.         music files.
  577.  
  578.         When a marked file is successfully played, it's marker arrow is
  579.         replaced by an asterisk.
  580.  
  581.   F10+Sound+Quick or Ctrl-Enter
  582.         The Play with Quick-arguments function initiates playback for the
  583.         highlighted file, after prompting for an argument string.
  584.         The prompt will appear in the message line, and you can enter
  585.         any valid player switch with slashes. (See the appropriate
  586.         section of the documentation for SPUT and SPUTROL switches).
  587.  
  588.         Note that if the /W switch to SPUT is used to create an 8-bit PCM
  589.         file, or the COPY function is used to create files in the same
  590.         directory, those files will not appear in the directory listing
  591.         until you press F3 to re-read the current directory.
  592.  
  593.   F10+Sound+Last or Ctrl-P
  594.         The Play with Last-arguments function initiates playback for the
  595.         highlighted file, using the previously defined argument string.
  596.  
  597.   F10+Sound+Argument or Ctrl-A
  598.         This key invokes the Argument selection menu.  CTRL-A will invoke
  599.         the Argument selection screen for sound files.
  600.  
  601.   F10+Sound+Clear
  602.         This key clear any previously defined argument string.
  603.  
  604.   F10+Sound+Text
  605.         This key invokes the interactive text-to-speech mode.
  606.  
  607.   F10+Sound+Information or Ctrl-I
  608.         Displays complete file information without playback, for the
  609.         highlighted or marked file(s).  Requires SPUT.COM to be in a
  610.         directory that is listed in your PATH statement.
  611.  
  612.   F10+Sound+Wave or Ctrl-W
  613.         Views the highlighted or marked file(s) as a wave form using the
  614.         SPUTWAVE utility.  Requires SPUTWAVE.EXE to be located in a
  615.         directory that is listed in your PATH statement.
  616.  
  617.   F10+File+Copy or Ctrl-C
  618.         Initiates the copy process for the highlighted or marked file(s),
  619.         after prompting for a destination.  Wildcards ? and * are supported
  620.         and renaming while copying is permitted.
  621.  
  622.         When a marked file is successfully copied, it's marker arrow is
  623.         replaced by an asterisk.  If the target disk(ette) becomes
  624.         filled, during a copy operation, SPUTTER automatically attempts
  625.         to find other marked files that will fit, stopping when there are
  626.         none.  Changing the target diskette, and hitting F1 again, will
  627.         copy the remaining marked files.
  628.  
  629.   F10+File+Move or Ctrl-M
  630.         Moves the highlighted or marked file(s), after prompting for a
  631.         destination.  Wildcards ? and * are supported and renaming while
  632.         moving is permitted.
  633.  
  634.         When a marked file is successfully moved, it's marker arrow is
  635.         replaced by an asterisk.  If the target disk(ette) becomes
  636.         filled, during a move operation, SPUTTER automatically attempts
  637.         to find other marked files that will fit, stopping when there are
  638.         none.  Changing the target diskette, and hitting F1 again, will
  639.         move the remaining marked files.
  640.  
  641.   F10+File+Rename or Ctrl-R
  642.         Renames the highlighted file, after prompting for a new filename.
  643.  
  644.   F10+File+Delete or Ctrl-D or Delete
  645.         Deletes the highlighted or marked file(s), after prompting for
  646.         verification.  Wildcards ? and * are supported.
  647.  
  648.   F10+File+View or Ctrl-V
  649.         Views the highlighted or marked file(s).  Requires LIST.COM to
  650.         be located in the PATH.
  651.  
  652.   F10+File+marK or Ctrl-K or F5
  653.         Marks any files that were previously unmarked.
  654.  
  655.   F10+File+cLear or Ctrl-L or F6
  656.         Clears marks on all files.
  657.  
  658.   F10+Options+Output or Ctrl-O or F8
  659.         Enables or disables the option of seeing the output from the player
  660.         utility during playback.  When a file is played with this option
  661.         enabled, the center of the screen is cleared and the player utility
  662.         output is displayed there.  Pressing this key a second time disables
  663.         the option and it defaults to enabled.  
  664.  
  665.   F10+Options+Pause or F7
  666.         This toggles the state of the Pause-after-playback option.
  667.  
  668.   F10+Options+snoW
  669.         This toggles the state of the Video-snow-suppression option.
  670.  
  671.   F10+Options+Verify
  672.         This toggles the state of the Verify-after-copy option.
  673.         
  674.   F10+Options+Unsorted or Ctrl-U
  675.         Displays the directory in it's original unsorted order.
  676.  
  677.   F10+Options+Name or Ctrl-N
  678.         Sorts the directory list by filename.
  679.  
  680.   F10+Options+Extension or Ctrl-E
  681.         Sorts the directory list by extension.
  682.  
  683.   F10+Options+Size or Ctrl-Z
  684.         Sorts the directory list by file size.
  685.  
  686.   F10+Options+Date or Ctrl-T
  687.         Sorts the directory list by date.
  688.  
  689.   F10+Help+Short
  690.         Displays a help screen of short cut keys.
  691.  
  692.   F10+Help+Function
  693.         Displays a help screen of function keys F1 thru F10.
  694.  
  695.   F10+Help+Navigation
  696.         Displays a help screen of keys used for moving the highlight bar
  697.         within the directory window.
  698.  
  699.   F10+Help+Player or Ctrl-S or F2
  700.         Displays the SPUT help screen.  Requires SPUT.COM to be in a
  701.         directory that is listed in your PATH statement.
  702.  
  703.  
  704.   ***************************************************************************
  705.                       SECTION 3.2 - SPUTMON Event Monitor
  706.   ***************************************************************************
  707.  
  708.   This section describes the program named SPUTMON, which stands for (SPUT)ter
  709.   Event (MON)itor.  SPUTMON is a small memory resident utility (under 6k)
  710.   that lets you attach sound files to events that occur on your PC.
  711.  
  712.   Some of the types of events that SPUTMON can detect are as follows:
  713.  
  714.         BELL            replaces the system beep
  715.         KEYBOARD        plays sounds when selected keys are pressed
  716.         TIMER           date/time alarm
  717.         PROGRAM         program execution
  718.         FILE-OPEN       file open (read access)
  719.         FILE-CREATE     file create (write access)
  720.         FILE-RENAME     file rename
  721.         FILE-DELETE     file delete
  722.         INTERRUPT       interrupt 13 or 21
  723.  
  724.   When using SPUTMON the Event Monitor, it is recommended that you keep a
  725.   copy of the player utilities SPUT.COM, SPUTROL.COM and SPUTCMF.COM on a RAM
  726.   disk.  This will reduce system overhead associated with playback at the time
  727.   the events occur.  If you are relying on Sputter to automatically load the
  728.   FM sound drivers SOUND.COM and SBFMDRV.COM, then these should also be copied
  729.   onto the RAM disk.
  730.  
  731.   
  732.   -----------------------------------------
  733.   3.2.1 SPUTMON COMMAND SYNTAX AND SWITCHES
  734.   -----------------------------------------
  735.  
  736.   Typing 'SPUTMON ?' at the DOS prompt, will display the program version and
  737.   an abbreviated help screen.
  738.  
  739.   To load the event monitor into memory type the following command at the
  740.   DOS prompt:
  741.  
  742.                 SPUTMON [<eventfile>] [/switches]
  743.  
  744.   <eventfile>
  745.         This is the name of the event definition file.  If no filename is
  746.         specified, the default of SPUTMON.DEF will be used.  If no directory
  747.         is specified, the current directory is searched, and then the PATH.
  748.  
  749.   ?
  750.         Entering a question mark on the command line, will tell SPUTMON
  751.         to display a short help screen.
  752.  
  753.   /B
  754.         This switch toggles the state of the bells-on-error & retry option
  755.         and defaults to enabled.
  756.  
  757.         When this feature is enabled and SPUTMON is unable to play a file
  758.         at the time an event occurs, a high-pitched bell will sound every 30
  759.         seconds to alert you that what you are doing is preventing playback
  760.         to occur.
  761.  
  762.         If the retry feature has been disabled with the /R switch, SPUTMON
  763.         will play a low pitched buzzer to indicate that playback has been
  764.         cancelled for that event only.
  765.  
  766.         Entering a number after the /B switch, will change the frequency of
  767.         the error/retry bells from 30 seconds to the new value.  Setting
  768.         the value to 0, disables all bells.
  769.  
  770.   /C
  771.         This switch toggles the state of the command-line playback feature
  772.         and defaults to enabled.  This method of playback is only used if
  773.         DESQview is not running, or the /W window playback feature is
  774.         disabled.
  775.  
  776.         When at the DOS prompt, you are actually running COMMAND.COM which
  777.         allocates all of memory to itself.  If an event is triggered, there
  778.         is no available memory for the player program to run or load the
  779.         sound file.  This feature causes the player program to be run from
  780.         the DOS prompt (although you won't actually see the command).
  781.  
  782.         If you are in the middle of typing a line when an event is triggered,
  783.         SPUTMON will not interrupt you.  The playback will just be delayed
  784.         until you enter a carriage return.
  785.  
  786.   /D
  787.         This switch will disable event monitoring, and SPUTMON will
  788.         remain in memory.
  789.  
  790.   /E
  791.         This switch will reenable event monitoring.
  792.  
  793.   /F
  794.         This switch toggles the state of the fast command-line playback
  795.         feature and defaults to enabled.  
  796.  
  797.         If you are idle at the DOS prompt when an event is triggered and
  798.         the FAST feature is enabled, the selected sound file will be played
  799.         immediately with no warning message or delay.
  800.  
  801.         If the FAST playback feature has been disabled, SPUTMON will print
  802.         the following message on the screen:
  803.  
  804.   <SPUTMON is ready to play, press <CTRL-SHIFT> to cancel, <CTRL-ALT> to begin>
  805.  
  806.         then SPUTMON will wait approximately 5 seconds.  If you do nothing,
  807.         or press <CTRL-ALT>, playback will occur.  If you press <CTRL-SHIFT>
  808.         playback for that particular event only will be cancelled.
  809.  
  810.         In both cases, a new DOS prompt will appear, and you may continue
  811.         as usual.
  812.  
  813.   /G
  814.         This switch controls weather the DESQview player window will run
  815.         in the foreground or background.  The default is background.
  816.  
  817.   /I
  818.         This switch is used to reinitialize the event table.  All counters
  819.         are reset to zero, and any events that were marked for playback
  820.         are cancelled.
  821.  
  822.   /M
  823.         This switch toggles the state of the multiple event triggering
  824.         feature, and defaults to disabled.
  825.  
  826.         Normally, when an event occurs, SPUTMON searches the event table
  827.         for a match.  If a match is found, the remainder of the table
  828.         is not checked.  Enabling this feature, tells SPUTMON to check
  829.         the entire table for additional matches.
  830.  
  831.         This switch normally will not affect type T timer events, since
  832.         many clock interrupts will occur for each actual second of time.
  833.  
  834.         Example: If you have the following events defined in your event file
  835.  
  836.                 P  DX.EXE  SHEESH.SND
  837.                 P  *       AHH.SND
  838.  
  839.         With /M disabled, running DX would only play SHEESH.SND.  With
  840.         /M enabled, running DX would play SHEESH.SND and AHH.SND.
  841.  
  842.   /Q
  843.         This switch toggles the quiet screen output feature, and defaults
  844.         to enabled.
  845.  
  846.         Normally SPUTMON sends the appropriate switch to the player program
  847.         to suppress screen output.  Disabling this feature will cause all
  848.         screen output from the player program to be displayed.  This can
  849.         be very useful while writing event definition files.
  850.  
  851.   /R
  852.         This switch toggles the state of the retry playback feature and
  853.         defaults to enabled.
  854.  
  855.         When an event occurs, and SPUTMON is unable to play the sound file,
  856.         in the normal way, or using the /W (DV window) or /C (command line)
  857.         methods, it looks at this switch to decide how to handle the event.
  858.  
  859.         If the retry feature is enabled, SPUTMON will remember that the
  860.         file should be played, and will keep retrying playback until
  861.         successful.  A short high pitched jingle will be heard every 30
  862.         seconds to remind you that a playback is pending.
  863.  
  864.         If the retry feature is disabled, playback will be skipped for
  865.         that particular event only, and you will hear a low pitched buzzer
  866.         if the beep-on-error feature is enabled with /B.
  867.  
  868.   /S
  869.         This switch prints the event table on the screen, which is a list
  870.         of all events being monitored.
  871.  
  872.           TRIGG - is the number of times the event has triggered playback.
  873.           ERROR - is the number of times playback has failed.
  874.           CODE  - is the error code encountered during the last attempted
  875.                   playback.  The first 2 digits are a number representing
  876.                   the process that encountered the error.  A 10xx indicates
  877.                   a player program error.  Any other number is the
  878.                   number of the interrupt handler that encountered the error.
  879.                   (ie: 2108 means playback was attempted by the INT21 handler
  880.                   but failed because of insufficient memory).
  881.           ST    - is the status of the event, with 01 meaning that the event
  882.                   has been marked for playback.
  883.           T     - is the type of file to be played where:
  884.                   1 = Sound file for SPUT.COM  (blank or #S)
  885.                   2 = ROL file for SPUTROL.COM (#R)
  886.                   3 = Text file for SPUT.COM (#S)
  887.                   4 = CMF file for SPUTCMF.COM (#C)
  888.                   5 = DOS command or batch file for COMMAND.COM  (#D)
  889.  
  890.         INT AH AL Disp Trigg Error Code St T Filename     Arguments
  891.         ---------------------------------------------------------------------
  892.          29 FF 07 0C91 00000 00000 0000 00 1 e:\snd\spc\*.ani
  893.          08 FF FF 0C98 00000 00000 0000 00 1 10-19-1990 13:15 255 *.tun
  894.          08 FF FF 0C98 00000 00000 0000 00 1 10-19-1990 13:30 255 *.*
  895.          08 FF FF 0C98 00000 00000 0000 00 1 10-19-1990 12:45 255 *.sfx
  896.          08 FF FF 0C98 00000 00000 0000 00 1 10-19-1990 13:0 255 /ti/r145
  897.          08 FF FF 0C98 00000 00000 0000 00 2 10-19-1990 12:45 255 *
  898.          08 FF FF 0C98 00000 00000 0000 00 2 10-20-1990 12:0 1 bumblbee
  899.          08 FF FF 0C98 00000 00000 0000 00 2 10-19-1990 17:0 1 airnite
  900.          08 FF FF 0C98 00000 00000 0000 00 1 10-20-1990 0:0 1 bed1a
  901.          08 FF FF 0C98 00000 00000 0000 00 1 10-20-1990 0:15 8 bed2a
  902.          08 FF FF 0C98 00000 00000 0000 00 1 10-20-1990 2:0 30 timeup
  903.          21 4B FF 0E07 00000 00000 0000 00 1 CP.EXE       certnly
  904.          21 4B FF 0E07 00000 00000 0000 00 1 DC.EXE       sheesh
  905.          21 4B FF 0E07 00000 00000 0000 00 1 DIRNOTES.COM exc2
  906.          21 4B FF 0E07 00000 00000 0000 00 1 DX.EXE       notsfast
  907.          21 4B FF 0E07 00000 00000 0000 00 1 FGREP.COM    gotit
  908.          21 4B FF 0E07 00000 00000 0000 00 1 LINK.EXE     goodheav
  909.          21 4B FF 0E07 00000 00000 0000 00 1 LIST.COM     heynot
  910.          21 4B FF 0E07 00000 00000 0000 00 1 MAPMEM.EXE   theyrehe
  911.          21 4B FF 0E07 00000 00000 0000 00 1 MASM.EXE     ridic
  912.          21 4B FF 0E07 00000 00000 0000 00 1 MV.EXE       yeah
  913.          21 4B FF 0E07 00000 00000 0000 00 1 NU.EXE       fearnot
  914.          21 4B FF 0E07 00000 00000 0000 00 1 PKUNZIP.EXE  waitmin
  915.          21 4B FF 0E07 00000 00000 0000 00 1 Q.EXE        mistaks
  916.          21 4B FF 0E07 00000 00000 0000 00 1 QU.EXE       hereicom
  917.          21 FF FF 0E53 00000 00000 0000 00 1 *            ahh
  918.         
  919.     Enabled Features  : MONITOR BELLS:30 RETRIES QUIET WINDOW/BG COMMAND FAST
  920.     Disabled Features : MULTIPLES
  921.     Date/Time: 10-19-1990 12:31:58.10 ■ Active Timers: 10
  922.  
  923.   /U
  924.         This switch will cause SPUTMON to remove itself from memory.
  925.         This can only be done successfully, if no other programs have
  926.         become memory resident since SPUTMON was loaded.
  927.  
  928.   /W
  929.         This switch toggles the state of the DESQview player window
  930.         feature and defaults to enabled.
  931.  
  932.         This section is only applicable when DESQview is running.
  933.  
  934.         If this feature is enabled when an event occurs, a separate
  935.         DESQview window will be started in which to run the player program.
  936.         This window will run in the background, and close when playback is
  937.         finished.  It will appear as a 2x2 character box in the upper left
  938.         hand corner of the screen.
  939.  
  940.         All of the attributes of the DV player window can be changed by
  941.         using the DESQview "Change A Program" utility to modify the DVP
  942.         template file SP-PIF.DVP that comes with SPUTTER.  This DVP file
  943.         must be located somewhere in the PATH, in order for SPUTMON to find
  944.         it when becomming memory resident.
  945.  
  946.         Disabling this feature will cause playback to occur in the same
  947.         window in which the event occurred.
  948.  
  949.  
  950.   ------------------------------------------
  951.   3.2.2 SPUTMON EVENT DEFINITION FILE FORMAT
  952.   ------------------------------------------
  953.  
  954.   The event definition file is a simple ascii file, that can be modified
  955.   with any text editor.  The maximum size of the file is limited to 64k
  956.   bytes, including comments.
  957.  
  958.   Each line in the event file defines a single event.  The first "word" of
  959.   each line, defines the event type and the remainder of the line describes
  960.   the event to trigger on and the sound file to play when the event occurs.
  961.  
  962.  
  963.   -------------------
  964.   SPUTMON EVENT TYPES
  965.   -------------------
  966.  
  967.         B <soundfile>
  968.  
  969.                 This is the BEEP event, and will trigger playback of the    
  970.                 specified soundfile in place of the normal speaker beep.
  971.  
  972.                 Example: 'B CHICK.SND' plays a short clip of peeping chicks
  973.                          instead of the normal speaker beep.
  974.  
  975.         K <scan-code> <shift-value> <soundfile>
  976.  
  977.                 The KEYSTROKE event will trigger playback whenever the
  978.                 specified key combination is pressed.
  979.  
  980.                 Example: 'K 3B,04 CERTNLY' plays CERTNLY whenever CTRL-F1
  981.                          is struck.
  982.  
  983.         T <sdate> <stime> <idate> <itime> <repeat> <soundfile>
  984.  
  985.                 The TIMER event will trigger playback whenever the set time
  986.                 <sdate><stime> occurs.  Then the repeat <repeat> is
  987.                 decremented, and the increment <idate><itime> is added to
  988.                 the set time to create the next alarm setting.
  989.  
  990.                 Alarms and repeat counts are reset automatically.
  991.  
  992.         Examples:
  993.                 T 00-00-00 12:00 00-00-00 00:00 0 YEAH.TUN
  994.                   at noon every day
  995.                 T 06-25-90 17:00 00-00-00 00:05 5 WOW.TUN
  996.                   from 5:00pm to 5:25 every 5 minutes on 06-25-90
  997.                 T 07-11-90 00:00 00-00-00 00:01 0 wow.tun
  998.                   every min for 1 day
  999.                 T 07-11-90 12:00 00-01-00 00:00 2 wow.tun
  1000.                   at noon for 2 days
  1001.                 T 07-00-00 12:00 00-01-00 00:00 0 wow.tun
  1002.                   at noon every day in July
  1003.                 T 00-11-00 12:00 01-00-00 00:00 0 wow.tun
  1004.                   at noon on the 11th of every month
  1005.                 T 07-00-90 00:00 00-00-00 01:00 0 wow.tun
  1006.                   every hour in July
  1007.                 T 00-11-00 00:00 00-00-00 01:00 0 wow.tun
  1008.                   every hour on every 11th day
  1009.  
  1010.         P  <progname> <soundfile>
  1011.                 The PROGRAM execution event will trigger playback whenever
  1012.                 the specified program is run.  The program name follows the
  1013.                 same rules for filenames.
  1014.  
  1015.                 Example: 'P Q.EXE MISTAKS.V8' plays Stooge Moe saying "Now
  1016.                          don't make any more mistakes!" when Qedit is run.
  1017.                      or: 'P LIST.COM DOC.TUN' plays Bugs Bunny saying "Whats
  1018.                          up Doc?" whenever LIST is used to view a file.
  1019.  
  1020.         FO <filename> <soundfile>
  1021.                 The FILE-OPEN event will trigger playback whenever the
  1022.                 specified file is opened in read-only mode.
  1023.  
  1024.                 Example: 'FO * CERTNLY.V8' plays Stooge Curly saying
  1025.                          "Certainly!" when any file is opened for reading.
  1026.  
  1027.         FC <filename> <soundfile>
  1028.                 The FILE-CREATE event will trigger playback whenever the
  1029.                 specified file is opened for write access.  The DOS COPY
  1030.                 command will not trigger this event because of insufficient
  1031.                 memory.
  1032.  
  1033.                 Example: 'FC CONFIG.SYS HEYNOT.V8' plays Stooge Curly saying
  1034.                          "Hey not that!" when any program attemps to open
  1035.                           CONFIG.SYS for write access.
  1036.  
  1037.         FR <filename> <soundfile>
  1038.                 The FILE-RENAME event will trigger playback whenever the
  1039.                 specified file is renamed.  The DOS REName command will not
  1040.                 trigger this event.
  1041.  
  1042.                 Example: 'FR AUTOEXEC.BAT MEANING.TUN" plays Bugs Bunny
  1043.                          saying "Whats the meaning of this?" when any program
  1044.                          attempts to rename AUTOEXEC.BAT.
  1045.  
  1046.         FD <filename> <soundfile>
  1047.                 The FILE-DELETE event will trigger playback whenever the
  1048.                 specified file is deleted.  The DOS DELete command will not
  1049.                 trigger this event.
  1050.  
  1051.                 Example: 'FD * AHH.TUN' plays Yosemite Sam yelling "Ahhhhh"
  1052.                          whenever any file is deleted by any program.
  1053.  
  1054.  
  1055.         The following events are called the INT events.  They are more
  1056.         complex to setup than the above events, but are much more powerful.
  1057.         As a reference, I highly recommend "The Interrupt List" by
  1058.         Ralf Brown.  It is available on most BBS's as INTERnnn.ZIP where
  1059.         'nnn' is the latest version number.
  1060.  
  1061.  
  1062.         I  <int> <ah> <al> <soundfile>
  1063.                 The vanilla INT event will trigger playback whenever the
  1064.                 specified interrupt <int> occurs, with <ah> matching the AH
  1065.                 register and <al> matching the AL register.
  1066.  
  1067.                 Example:  'I 21 4C FF THATS.TUN' plays Bugs Bunny saying
  1068.                           "That's that" whenever a program terminates.
  1069.  
  1070.         IA <int> <ah> <al> <filename> <soundfile>
  1071.                 The INT-ASCIZ event will trigger playback whenever the
  1072.                 specified interrupt <int> occurs, with <ah> matching the AH
  1073.                 register and <al> matching the AL register.  An additional
  1074.                 check is done between <filename> and the filename pointed
  1075.                 to by the DS:DX register.
  1076.  
  1077.                 Example:  'IA 21 43 01 MYFILE CERTNLY.V8' plays Stooge Curly
  1078.                           saying "Certainly!" whenever the file attributes of
  1079.                           the file named MYFILE are set.
  1080.  
  1081.         IF <int> <ah> <al> <filename> <soundfile>
  1082.                 The INT-FCB event will trigger playback whenever the
  1083.                 specified interrupt <int> occurs, with <ah> matching the AH
  1084.                 register and <al> matching the AL register.  An additional
  1085.                 check is done between <filename> and the filename in the
  1086.                 File-Control-Block pointed to by the DS:DX register.
  1087.  
  1088.                 Example:  'IF 21 15 FF MYFILE HEYNOT.V8' plays Stooge Curly
  1089.                           saying "Hey, not that!" whenever a sequential
  1090.                           write is done to the file MYFILE.
  1091.  
  1092.         ID <int> <ah> <al> <drive> <soundfile>
  1093.                 The INT-DISK event will trigger playback whenever the
  1094.                 specified interrupt <int> occurs, with <ah> matching the
  1095.                 AH register and <al> matching the AL register.  An additional
  1096.                 check is done between <drive> and the DL register.
  1097.  
  1098.                 Example:  'ID 13 05 ff 01 WARNING.V8' plays the Robot from Lost
  1099.                           in Space saying "Warning Warning" anytime a format
  1100.                           disk track is executed on the A drive.
  1101.  
  1102.  
  1103.   ------------------------
  1104.   SPUTMON EVENT PARAMETERS
  1105.   ------------------------
  1106.  
  1107.   The event type is followed by additional parameters that describe the event
  1108.   on which to trigger playback.
  1109.  
  1110.   Parameters may be separated by commas or any number of spaces.  They may
  1111.   appear in upper or lower case.
  1112.  
  1113.   The parameters used are different for each event type.  All are described
  1114.   below:
  1115.  
  1116.   <filename>
  1117.         A filename that may be up to 12 characters in length, and must
  1118.         include a period and extension.  It may be a single * to indicate
  1119.         a match of any filename.
  1120.  
  1121.   <soundfile>
  1122.         The name of the soundfile to be played at the time the event occurs.
  1123.         It may include a full path specification and any valid player
  1124.         switches.  If the sound file will be played using SPUT, you may
  1125.         also use *.* to invoke random soundfile selection.
  1126.  
  1127.   <scan-code>
  1128.         The scan-code is the hexadecimal number of the key that will trigger
  1129.         a sound file when pressed:
  1130.  
  1131.  -----------------------------------------------------------------------------
  1132.  | esc   01  |   t T     14  |   ; :     27  |   F1      3B  |   Gray +  4E  |
  1133.  | 1 !   02  |   y Y     15  |   ' "     28  |   F2      3C  |   1 End   4F  |
  1134.  | 2 @   03  |   u U     16  |   ` ~     29  |   F3      3D  |   2 Down  50  |
  1135.  | 3 #   04  |   i I     17  |   l-shf   2A  |   F4      3E  |   3 PgDn  51  |
  1136.  | 4 $   05  |   o O     18  |   \ |     2B  |   F5      3F  |   0 Ins   52  |
  1137.  | 5 %   06  |   p P     19  |   z Z     2C  |   F6      40  |   . Del   53  |
  1138.  | 6 ^   07  |   [ {     1A  |   x X     2D  |   F7      41  |               |
  1139.  | 7 &   08  |   ] }     1B  |   c C     2E  |   F8      42  |   Gray *  37  |
  1140.  | 8 *   09  |   enter   1C  |   v V     2F  |   F9      43  |   F11     57  |
  1141.  | 9 (   0A  |   l-ctl   1D  |   b B     30  |   F10     44  |   F12     58  |
  1142.  | 0 )   0B  |   a A     1E  |   n N     31  |   Num     45  |   Break   E1  |
  1143.  | - _   0C  |   s S     1F  |   m M     32  |   Scroll  46  |               |
  1144.  | = +   0D  |   d D     20  |   , <     33  |   7 Home  47  |               |
  1145.  | bksp  0E  |   f F     21  |   . >     34  |   8 Up    48  |               |
  1146.  | tab   0F  |   g G     22  |   r-shf   36  |   9 PgUp  49  |               |
  1147.  | q Q   10  |   h H     23  |   prtscr  37  |   Gray-   4A  |               |
  1148.  | w W   11  |   j J     24  |   l-alt   38  |   4 Left  4B  |               |
  1149.  | e E   12  |   k K     25  |   space   39  |   5       4C  |               |
  1150.  | r R   13  |   l L     26  |   caps    3A  |   6 Right 4D  |               |
  1151.  -----------------------------------------------------------------------------
  1152.  
  1153.   <shift-value>
  1154.         The shift value is a number that represents a combination of shift
  1155.         keys to be pressed at the same time as the action key.
  1156.  
  1157.                 01  Right shift key
  1158.                 02  Left shift key
  1159.                 04  Ctrl key
  1160.                 08  Alt key
  1161.                 10  Right or left shift keys
  1162.  
  1163.         To use multiple shift keys, add the values (eg: 06 = Ctrl and Alt keys)
  1164.  
  1165.   <int>
  1166.         This is the interrupt number in hexadecimal to monitor.      
  1167.         Only interrupts 13 and 21 are supported at this time.
  1168.  
  1169.   <ah>
  1170.         This is the hexadecimal contents of the AH register to be
  1171.         checked at the time of the interrupt.  Use FF to indicate
  1172.         a match on all values.
  1173.  
  1174.   <al>
  1175.         This is the hexadecimal contents of the AL register to be
  1176.         checked at the time of the interrupt.  Use FF to indicate
  1177.         a match on all values.
  1178.  
  1179.   <drive>
  1180.         This is the hexadecimal driver number, with 0 being the
  1181.         A drive, and 1 the B drive.  Use FF to indicate a match on
  1182.         any drive. 
  1183.  
  1184.   <sdate>
  1185.         This is the first date that the alarm should trigger in the
  1186.         format MM-DD-YY.  00 in any field, matches every value.
  1187.         06-00-90 means every day in June 1990.
  1188.  
  1189.   <stime>
  1190.         This is the first time that the alarm should trigger in the
  1191.         format HH:MM. 00:00 means midnight.                                   
  1192.  
  1193.   <idate>
  1194.         This is the increment to add to <sdate> to determine the
  1195.         next date that the alarm should trigger.  The format is
  1196.         MM-DD-YY.  01-00-00 means add 1 to the month for the next
  1197.         alarm date.  00-00-01 means add 1 to the year.
  1198.  
  1199.   <itime>
  1200.         This is the increment to add to <stime> to determine the
  1201.         next time that the alarm should trigger.  The format is
  1202.         HH:MM.  00:05 means 5 minutes later.  01:00 means 1 hour
  1203.         later.
  1204.  
  1205.   <repeat>
  1206.         This is the number of times to add the increment to the
  1207.         set time and reset the alarm.  A value of 0 means non-stop.
  1208.  
  1209.  
  1210.   -----------------------------------------------
  1211.   3.2.3 PLAYING .ROL FILES FROM THE EVENT MONITOR
  1212.   -----------------------------------------------
  1213.  
  1214.   To use SPUTROL to play a ROL file when an event occurs, just insert '#R'
  1215.   before the <soundfile> argument.
  1216.         
  1217.         Example:  'P MYPROG.EXE #R LINUS.ROL'
  1218.              or:  'T 00-00-00 12:00 00-00-00 00:00 1 #R LINUS.ROL'
  1219.  
  1220.         SPUTROL.COM will be used to play LINUS.ROL whenever MYPROG.EXE is
  1221.         executed, and every day at 12:00 noon.
  1222.  
  1223.   This does not require that the sound driver SOUND.COM already be loaded,
  1224.   SPUTROL can automatically load SOUND.COM and unload it when playback is
  1225.   completed thereby saving valuable memory.  If you plan to use this feature,
  1226.   it is recommended that you keep SOUND.COM on a RAMdisk for quicker access.
  1227.  
  1228.         SOUND.COM v1.51 is Copyright by Ad Lib Inc.
  1229.  
  1230.  
  1231.   -----------------------------------------------
  1232.   3.2.4 PLAYING .CMF FILES FROM THE EVENT MONITOR
  1233.   -----------------------------------------------
  1234.  
  1235.   To use SPUTCMF to play a CMF file when an event occurs, just insert '#C'
  1236.   before the <soundfile> argument.
  1237.         
  1238.         Example:  'P MYPROG.EXE #C LINUS.ROL'
  1239.              or:  'T 00-00-00 12:00 00-00-00 00:00 1 #C LINUS.ROL'
  1240.  
  1241.         SPUTCMF.COM will be used to play LINUS.ROL whenever MYPROG.EXE is
  1242.         executed, and every day at 12:00 noon.
  1243.  
  1244.   This does not require that the sound driver SBFMDRV.COM already be loaded,
  1245.   SPUTCMF can automatically load SBFMDRV.COM and unload it when playback is
  1246.   completed thereby saving valuable memory.  If you plan to use this feature,
  1247.   it is recommended that you keep SBFMDRV.COM on a RAMdisk for quicker access.
  1248.  
  1249.         SBFMDRV.COM v1.21 is Copyright by Creative Labs
  1250.  
  1251.  
  1252.   -----------------------------------------------------------------
  1253.   3.2.5 EXECUTING DOS COMMANDS & BATCH FILES FROM THE EVENT MONITOR
  1254.   -----------------------------------------------------------------
  1255.  
  1256.   The Event Monitor also has the ability to start any DOS command, program
  1257.   or batch file when an event occurs.
  1258.  
  1259.   To use this feature, just preceed the <soundfile> argument with '#D'.
  1260.  
  1261.         Example:  'FD DEMO.TMP #D TEST.BAT'
  1262.                   runs TEST.BAT whenever the file DEMO.TMP is deleted.
  1263.  
  1264.  
  1265.   -------------------------------------------------------------
  1266.   3.2.6 EXECUTING SMOOTH TALKER SOFTWARE FROM THE EVENT MONITOR
  1267.   -------------------------------------------------------------
  1268.  
  1269.   Smooth Talker software does not come with The Sputter Sound System.  It
  1270.   is copyright by First Byte Software and licensed by a number of different
  1271.   companies to be packaged with their hardware.
  1272.  
  1273.   Smooth Talker is available from Covox with the Speech Thing as a driver
  1274.   called STDRIVER.SYS and two memory-resident programs called SPEECHV3.EXE
  1275.   and SPEECHV2.EXE (for slower machines).
  1276.  
  1277.   To use the Smooth Talker device driver from Covox, you must add the following
  1278.   line to your CONFIG.SYS file and reboot your system:
  1279.  
  1280.          'DEVICE=STDRIVER.SYS SV3 CRE TTD'
  1281.  
  1282.   Then load SPEECHV3, or SPEECHV2 for slower systems with the following
  1283.   command:
  1284.  
  1285.                 SPEECHV3 <enter>
  1286.         or      SPEECHV2 <enter>        for slower machines
  1287.  
  1288.   Now add a line to the event definition file, to define the event that you
  1289.   want to trigger the playback of synthesized speech.  This event line can
  1290.   be any of the possible event types B,K,T,P,FO,FC,FR,FD as in the following
  1291.   example:
  1292.  
  1293.                 FD DEMO.TMP #D COPY MESSAGE.TXT ST
  1294.                  
  1295.   This example will cause Smooth Talker to convert the text file MESSAGE.TXT
  1296.   to synthesized speech whenever the file DEMO.TMP is deleted.
  1297.  
  1298.   If your STDRIVER is also used by other software supporting Smooth Talker
  1299.   and gets set into a different mode so that the COPY command no longer works,
  1300.   you can use the SPUTST utility to reset it without having to reboot your
  1301.   system.  Just type the following command at the DOS prompt:
  1302.  
  1303.         'SPUTST SV3 CRE TTD'
  1304.  
  1305.                        ----------------------------
  1306.  
  1307.   Smooth Talker is also available from Creative Labs for the Sound Blaster
  1308.   as an executable program called TALK.EXE.
  1309.  
  1310.   Just add a line to the event definition file, to define the event that you
  1311.   want to trigger the playback of synthesized speech.  This event line can
  1312.   be any of the possible event types B,K,T,P,FO,FC,FR,FD,I as in the following
  1313.   example:
  1314.  
  1315.                 FD DEMO.TMP #D TALK MESSAGE.TXT
  1316.                  
  1317.   This example will cause Smooth Talker to convert the text file MESSAGE.TXT
  1318.   to synthesized speech whenever the file DEMO.TMP is deleted.
  1319.  
  1320.  
  1321.   SmoothTalker is Copyright by First Byte Software.
  1322.  
  1323.  
  1324.   -------------------------------------------
  1325.   3.2.7 USING THE EVENT MONITOR WITH DESQVIEW
  1326.   -------------------------------------------
  1327.  
  1328.   SPUTMON can be run in any DESQview window, and will only see events that
  1329.   occur in the same window.  Separate event definition files can be created
  1330.   for each application that runs in a DESQview window, or all windows can
  1331.   use the same event definition file.
  1332.  
  1333.   All timer events should be monitored from a single DESQview window.
  1334.  
  1335.   If the DESQview player window feature of SPUTMON is enabled (/W), a
  1336.   separate window will be started in which to run the player.  This window
  1337.   will run in the background, and close when the player exits.
  1338.  
  1339.   If the player program runs too slowly in a background window, there are
  1340.   a number of options that you can try:
  1341.  
  1342.   1) You can use the SPUTMON /G switch to make the player window run in the
  1343.      foreground instead of in the background.
  1344.  
  1345.   2) You can try changing your foreground/background ticks, in the DESQview
  1346.      advanced setup for performance.
  1347.  
  1348.   3) You can use the SPUTMON /W switch to disable the window-player feature.
  1349.      This will cause playback to occur in the same window that the event
  1350.      occured, and should then be at the correct playback speed.
  1351.  
  1352.   Currently, SPUTMON does not run properly when loaded before DESQview, and
  1353.   this will eventually be resolved.
  1354.  
  1355.  
  1356.   ----------------------------
  1357.   3.2.8 SPUTMON ERROR MESSAGES
  1358.   ----------------------------
  1359.  
  1360.   Event Monitor is not installed
  1361.   Cannot uninstall the Event Monitor; another program was loaded after it
  1362.   Event Monitor has been uninstalled
  1363.   Event Monitor is already Installed
  1364.   Event Monitor installed and active
  1365.   Event table initialized
  1366.   Event Monitoring enabled
  1367.   Event Monitoring disabled
  1368.   Bells on error & retry enabled
  1369.   Bells on error & retry disabled
  1370.   Bells frequency changed to every N seconds
  1371.   Retry playback enabled
  1372.   Retry playback disabled
  1373.   Quiet screen enabled
  1374.   Quiet screen disabled
  1375.   Multiple triggers enabled
  1376.   Multiple triggers disabled
  1377.   DESQview player window enabled
  1378.   DESQview player window disabled
  1379.   Command line playback enabled
  1380.   Command line playback disabled
  1381.   Background window enabled
  1382.   Foreground window enabled
  1383.   Invalid Filespec
  1384.   Failed to find SPUT.COM in current path
  1385.   Failed to find Event file
  1386.   Event file read error
  1387.   No events found
  1388.   Syntax error - on line n of Event Definition File
  1389.   Invalid hexadecimal number - on line n of Event Definition File
  1390.   Invalid decimal number - on line n of Event Definition File
  1391.   Invalid event definition type - on line n of Event Definition File
  1392.   Invalid program or filename - on line n of Event Definition File
  1393.   Invalid soundfile argument - on line n of Event Definition File
  1394.   Invalid date/time format - on line n of Event Definition File
  1395.   Invalid date/time increment - on line n of Event Definition File
  1396.   DVP file not found - DESQview player window disabled
  1397.   DVP file read error
  1398.   COMSPEC variable not found, defaulting to COMMAND.COM
  1399.   Event File being loaded : ..................
  1400.  
  1401.  
  1402.   -----------------------------------------------------
  1403.   3.2.9 TROUBLE SHOOTING PROBLEMS WITH EVENT TRIGGERING
  1404.   -----------------------------------------------------
  1405.  
  1406.   ** No playback occurs at the defined event
  1407.  
  1408.   If playback does not occur when you expect it should, try the following
  1409.   steps to isolate the problem:
  1410.  
  1411.         1)  Enable the bell-on-error option with the command 'SPUTMON/B'.
  1412.             (You can check the state of the switch with SPUTMON/S)
  1413.         2)  Reinitialize the event table counters with the command 'SPUTMON/I'
  1414.         2)  Perform the same sequence of commands that should cause
  1415.             playback to occur.
  1416.         3)  Display a status with the command 'SPUTMON/S' and make a note
  1417.             of the CODE field.  This is the error code.
  1418.         4)  Continue reading to find the problem.
  1419.  
  1420.  
  1421.   ** Hear a buzzer instead of playback and Error Code = xx02
  1422.  
  1423.   An error code of xx02 indicates that SPUTMON could not run the player  
  1424.   utility.  When SPUTMON is initially loaded, it searches the current
  1425.   PATH found in the environment, to find all of the player utilities.
  1426.   If these files are later moved or deleted, SPUTMON will no longer be able
  1427.   to call upon them to play soundfiles.
  1428.  
  1429.   To resolve this problem, replace the player program that was moved
  1430.   or deleted, or unload and reload SPUTMON.
  1431.  
  1432.   The player programs referenced by SPUTMON are SPUT.COM, SPUTROL.COM,
  1433.   SPUTCMF.COM, COMMAND.COM and 4DOS.COM.
  1434.  
  1435.  
  1436.   ** Hear a buzzer instead of playback and Error Code = xx08
  1437.  
  1438.   An error code of xx08 indicates insufficient memory.  This means that
  1439.   the currently running program already has all of available memory
  1440.   allocated to it, and there is not enough remaining memory to run the
  1441.   player utility.
  1442.  
  1443.   This error will only occur if you have disabled the DESQview-player-
  1444.   window feature (/W) and the command-line-playback feature (/C) and
  1445.   the retry feature (/R).  Reenabling any of these features will solve
  1446.   this problem.
  1447.  
  1448.   If you choose not to enable these features, an alternative solution 
  1449.   is to use the PROGRAM execution event to trigger playback when the
  1450.   offending program is run, instead of triggering on what the program
  1451.   is doing.  Other than this, nothing else can be done to solve this
  1452.   problem, unless you have access to the source code of the offending
  1453.   program.
  1454.  
  1455.  
  1456.   ** Buzzer instead of playback and Error Code = 10xx
  1457.  
  1458.   An error code of 10xx indicates that SPUTMON ran the player utility, but
  1459.   the player encountered an error.  Refer to the section on the SPUT utility
  1460.   for a list of SPUT error numbers and messages.
  1461.  
  1462.   Normally, SPUTMON runs the player utility with the proper switches so
  1463.   there will be no screen output while other programs are running.
  1464.   Disabling this feature with the /Q switch, will allow the player to
  1465.   display all it's normal screen output, including error messages.
  1466.  
  1467.  
  1468.   ** No playback when event is caused by any of the SPUTTER utilities
  1469.  
  1470.   This has been done intentionally, otherwise invoking any of the SPUTTER
  1471.   utilities causes multiple soundfiles to be played.  Enough is enough I say.
  1472.   All SPUTTER utilities issue a special command to SPUTMON to temporarily
  1473.   disable triggering of events caused by the SPUTTER utilities.
  1474.   Triggering and playback of type T timer events will continue uninterrupted.
  1475.  
  1476.  
  1477.   ** Here is a list of other possible error codes that can be returned from
  1478.      DOS when attempting to execute the Player Utility SPUT:
  1479.  
  1480.         01h function number invalid
  1481.         02h file not found
  1482.         03h path not found
  1483.         04h too many open files (no handles available)
  1484.         05h access denied
  1485.         06h invalid handle
  1486.         07h memory control block destroyed
  1487.         08h insufficient memory
  1488.         09h memory block address invalid
  1489.         0Ah environment invalid (usually >32K in length)
  1490.         0Bh format invalid
  1491.         0Ch access code invalid
  1492.         0Dh data invalid
  1493.         0Fh invalid drive
  1494.         10h attempted to remove current directory
  1495.         11h not same device
  1496.         12h no more files
  1497.         13h disk write-protected
  1498.         14h unknown unit
  1499.         15h drive not ready
  1500.         16h unknown command
  1501.         17h data error (CRC)
  1502.         18h bad request structure length
  1503.         19h seek error
  1504.         1Ah unknwon media type (non-DOS disk)
  1505.         1Bh sector not found
  1506.         1Ch printer out of paper
  1507.         1Dh write fault
  1508.         1Eh read fault
  1509.         1Fh general failure
  1510.         20h sharing violation
  1511.         21h lock violation
  1512.         22h disk change invalid
  1513.         23h FCB unavailable
  1514.         24h sharing buffer overflow
  1515.         25h reserved
  1516.         26h (LANtastic) cannot complete file operation
  1517.         27h-31h reserved
  1518.         32h Network request not supported (DOS 3.1 + MS Networks)
  1519.         33h Remote computer not listening
  1520.         34h Duplicate name on network
  1521.         35h Network name not found
  1522.         36h Network busy
  1523.         37h Network device no longer exists
  1524.         38h Network BIOS command limit exceeded
  1525.         39h Network adapter hardware error
  1526.         3Ah Incorrect response from network
  1527.         3Bh Unexpected network error
  1528.         3Ch Incompatible remote adapter
  1529.         3Dh Print queue full
  1530.         3Eh Queue not full
  1531.         3Fh Not enough space to print file
  1532.         40h Network name was deleted
  1533.         41h Network: Access denied
  1534.         42h Network device type incorrect
  1535.         43h Network name not found
  1536.         44h Network name limit exceeded
  1537.         45h Network BIOS session limit exceeded
  1538.         46h Temporarily paused
  1539.         47h Network request not accepted
  1540.         48h (DOS 3.1 + MS Networks) Print/disk redirection paused
  1541.         49h (LANtastic) invalid network version
  1542.         4Ah (LANtastic) account expired
  1543.         4Bh (LANtastic) password expired
  1544.         4Ch (LANtastic) login attempt invalid at this time
  1545.         4Dh-4Fh reserved
  1546.         50h file exists
  1547.         51h reserved
  1548.         52h cannot make directory
  1549.         53h fail on INT 24h
  1550.         54h (DOS 3.3+) too many redirections
  1551.         55h (DOS 3.3+) duplicate redirection
  1552.         56h (DOS 3.3+) invalid password
  1553.         57h (DOS 3.3+) invalid parameter
  1554.         58h (DOS 3.3+) network write fault
  1555.         59h (LANtastic) function not supported on network
  1556.         5Ah (LANtastic) required system component not installed
  1557.  
  1558.  
  1559.   **************************************************************************
  1560.                  SECTION 3.3 - SPUT Soundfile Player UTility
  1561.   **************************************************************************
  1562.  
  1563.   This section describes the digitized sound file player named SPUT.
  1564.  
  1565.   --------------------------------------
  1566.   3.3.1 SPUT COMMAND SYNTAX AND SWITCHES
  1567.   --------------------------------------
  1568.  
  1569.   Typing 'SPUT' with no arguments at the DOS prompt, will print the current
  1570.   version number and a short help screen.
  1571.  
  1572.   The command syntax for SPUT is as follows:
  1573.  
  1574.                 SPUT <soundfile> [/switches]
  1575.  
  1576.   <soundfile>
  1577.         This is the name of the sound file to be played.  Any valid DOS
  1578.         wildcards may be used to have SPUT randomly select a sound file.
  1579.         The extension is not required, and sound files may be renamed
  1580.         using any convenient extension.
  1581.  
  1582.         If no path is specified, the directory specified by the SPUTDIR
  1583.         environment variable will be assumed, otherwise the current
  1584.         directory is assumed.
  1585.  
  1586.         Specifying a directory as part of the filename, will override
  1587.         any directory specified by the SPUTDIR environment variable.  Use
  1588.         ".\filename" to indicate the current directory and ignore the
  1589.         SPUTDIR environment variable.
  1590.  
  1591.   ?
  1592.         Entering a question mark on the command line, will tell SPUT to
  1593.         display a short help screen.
  1594.  
  1595.   /An
  1596.         This switch will enhance the amplitude, or volume, of a soundfile.
  1597.         Using this switch, causes more processing to be performed on each
  1598.         sample of the soundfile, and may actually slow down the playback
  1599.         speed on slower processors.  The higher the N value, the more
  1600.         processing being done on each sample.
  1601.  
  1602.         If using this switch, slows the playback speed on your system, 
  1603.         you can use the /A switch in conjunction with the /W switch to
  1604.         write the file to disk.  The new file will play properly with
  1605.         no switches, and the amplitude will be elevated.
  1606.  
  1607.         Another alternative is to resample the file to a lower playback
  1608.         rate using the /U and /W switches.  Then you can replay the new
  1609.         file using the /A switch without bogging down your system.
  1610.  
  1611.   /Cn
  1612.         This will cause the selected file to be played N times, in a
  1613.         continous loop.  A value of 0 will play indefinetly, until a
  1614.         key is struck.  This is most useful for listening to the quality
  1615.         of a very short sound clip, or can be used as an alarm
  1616.         triggered SPUTMON the Event Monitor.
  1617.  
  1618.   /Dn
  1619.         This switch is used to select the method of output to be used
  1620.         on the currently selected output device.
  1621.  
  1622.         The Internal Speaker has 4 drivers, the default is #1.
  1623.  
  1624.           1 - This method uses a software timing loop to drive the
  1625.               8253 Programmable Interval Timer chip.  The routine
  1626.               calibrates itself by polling the Timer chip while
  1627.               outputting the first 64 bytes of the file.
  1628.               This driver gives the best results, since no additional
  1629.               background noise is caused by interrupts or sampling.
  1630.               It will not cause crashes on slower systems, but it's
  1631.               speed is slightly less accurate than the other methods.
  1632.  
  1633.           2 - This method polls the Timer chip while outputting the
  1634.               sound file.  It's speed is accurate, and like method 1
  1635.               will not cause crashes on slower systems, but it generates
  1636.               slightly more noise than method 3 (interrupts).
  1637.  
  1638.           3 - This method uses Timer interrupts to output the sound file.
  1639.               It's speed is accurate, it generates slightly more noise
  1640.               than method 1 (software timing), but it may crash slower
  1641.               systems when using too fast a speed or oversampling factor.
  1642.               When this method is used in DESQview, the keyboard is
  1643.               automatically disabled to prevent crashing the system.
  1644.  
  1645.           4 - This method uses the 8255 Peripheral Interface Controller
  1646.               to generate sound.  It's speed is accurate, but the sound
  1647.               quality is appreciably lower than the other methods, since
  1648.               only a single bit of each 8-bit sample is actually output.
  1649.  
  1650.         The Sound Blaster has 2 drivers, the default is #2.
  1651.  
  1652.               SPUT will automatically select the correct Sound Blaster
  1653.               driver depending on the environment it is running in, and
  1654.               the file format that is being played.
  1655.  
  1656.           1 - This driver uses the direct mode of output to the Sound
  1657.               Blaster DAC port.  This is completely CPU driven and can
  1658.               be interrupted by background processing in a multitasking
  1659.               environment.
  1660.  
  1661.               This driver has the capability of sending ANY file format
  1662.               from any other source to the Sound Blaster card, but does
  1663.               NOT support formats 42,44,45.
  1664.  
  1665.           2 - This driver uses the DMA mode of the Sound Blaster DAC port.
  1666.               and can also be used in a multitasking environment.
  1667.  
  1668.               This driver can handle formats 42,44,45,48 and any other 8-bit
  1669.               file format (08,28,38), and provides the /SHELL function,
  1670.               but does NOT support any of the other compressed file formats
  1671.               (01-04,11,21,31,81-84).
  1672.  
  1673.   /DE
  1674.         Normally SPUT assumes that other processes already running, are
  1675.         more important than sound playback, so if other tasks are running
  1676.         when SPUT attempts to play a file, playback may be slightly slower
  1677.         than expected.  This is done mainly to not disrupt any communications
  1678.         tasks that might be running when SPUT is started.
  1679.  
  1680.         You may use /DE to force SPUT to run in dedicated mode and pause all
  1681.         other tasks in order to play the soundfile correctly.
  1682.  
  1683.   /DI
  1684.         This switch is used to specify an alternate dictionary file.  The
  1685.         default dictionary filename is SPUT.DIC.  The file is assumed to be
  1686.         located in the current directory or in the PATH.
  1687.         This file is used during text-to-speech translation and contains
  1688.         any pronounciation corrections or user definitions.
  1689.         See the next section for a description of this file.
  1690.  
  1691.   /Fnn
  1692.         The /F switch is used to force SPUT to use a specific file
  1693.         format.  This may be necessary when the file is missing a
  1694.         proper header record, which SPUT needs to determine the
  1695.         file format automatically.
  1696.  
  1697.         If you play a file with no switches, and it does not playback
  1698.         correctly, try using all possible /F switches until the file
  1699.         plays correctly.  If SPUT still fails to playback the file
  1700.         with any of the /F switches, you may have a file format that
  1701.         SPUT doesn't know about.
  1702.  
  1703.         SPUT has the capability of playing ANY digitized sound file
  1704.         on ANY device that it supports, not just the device on which the
  1705.         file was created.  The only exception to this are formats
  1706.         42,44,45 which can only be played on a Sound Blaster card.
  1707.  
  1708.         If you find a file format that SPUT doesn't understand, please
  1709.         send me a copy of the file and any others similar to it, so that
  1710.         I can try to decipher the format and add it to a future release
  1711.         of SPUTTER.
  1712.  
  1713.         File formats:
  1714.  
  1715.         01 - Covox 1-bit ADPCM with 16-byte header (.V1)
  1716.  
  1717.              Adaptive Differential Pulse Code Modulation is a technique
  1718.              of encoding the original waveform into a smaller file.
  1719.              This format uses a series of 16 byte groups with the first
  1720.              byte being an amplitude byte and the remaining 15 bytes
  1721.              are data.  Each data byte contains 8 1-bit samples.  Each
  1722.              of these 16-byte groups decodes into 120 8-bit samples.
  1723.              This format yields a 1:8 or 1/8 compression ratio.
  1724.  
  1725.         02 - Covox 2-bit ADPCM with 16-byte header (.V2)
  1726.  
  1727.              This format uses a series of 2 byte groups where 1 bit of
  1728.              each of the two bytes is combined to form a 2-bit sample.
  1729.              Each two byte group contains 8 of these 2-bit samples.
  1730.              The 2-bit samples are then decoded into 8-bit samples before
  1731.              playback.  This format yields a 2:8 or 1/4 compression ratio.
  1732.  
  1733.         03 - Covox 3-bit ADPCM with 16-byte header (.V3)
  1734.  
  1735.              This format uses a series of 3 byte groups where 1 bit of
  1736.              each of the three bytes is combined to form a 3-bit sample.
  1737.              Each three byte group contains 8 of these 3-bit samples.
  1738.              The 3-bit samples are then decoded into 8-bit samples before
  1739.              playback.  This format yields a 3:8 or 3/8 compression ratio.
  1740.  
  1741.         04 - Covox 4-bit ADPCM with 16-byte header (.V4)
  1742.  
  1743.              This format uses a series of 4 byte groups where 1 bit of
  1744.              each of the four bytes is combined to form a 4-bit sample.
  1745.              Each four byte group contains 8 of these 4-bit samples.
  1746.              The 4-bit samples are then decoded into 8-bit samples before
  1747.              playback.  This format yields a 4:8 or 1/2 compression ratio.
  1748.  
  1749.         08 - Covox 8-bit PCM with 16-byte header (.V8)
  1750.              or Covox 8-bit PCM with 128-byte header (.VMF)
  1751.              or Covox 8-bit PCM with no header (.VMD)
  1752.              or any other 8-bit PCM file
  1753.  
  1754.              Uniform Pulse Code Modulation stores a waveform as a
  1755.              sequence of 8-bit samples representing different amplitudes.
  1756.              The lowest sample is 0, the midpoint is 128 and the highest
  1757.              sample is 255.
  1758.  
  1759.              Programs that use this format:
  1760.              .  Voice Master Key software by Covox
  1761.              .  Deskmate Software by Tandy for 1000SL/TL/2s computers.
  1762.              .  Tandy Sound Digitizer by KSH Software.
  1763.  
  1764.         09 - 12-bit signed PCM
  1765.  
  1766.              This format uses 12-bit signed integers, each stored in a 16-bit
  1767.              word.  The lowest sample is -4095, the midpoint is 0 and the
  1768.              highest sample is 4095.
  1769.  
  1770.         0A - Turtle Beach Softworks 16-bit signed PCM (.SMP)
  1771.  
  1772.              This format uses 16-bit signed integers to represent the data.
  1773.              The format is similar to 8-bit PCM, but stores the actual
  1774.              amplitude level with polarity intact.  The lowest sample is
  1775.              -32767, the mid point is 0 and the highest sample is 32767.
  1776.  
  1777.         10 - Text files
  1778.  
  1779.              Any text file to be translated into speech.
  1780.  
  1781.         11 - IBM 1-bit CVSD format files
  1782.  
  1783.              Continously Variable Slope Delta Modulation records the
  1784.              direction of the waveform bit by bit.  If the wave goes up
  1785.              from the previous sample, a "1" bit is recorded otherwise
  1786.              a "0" bit is recorded.  Absolute silence is recorded as
  1787.              "01010101...".  The bit stream is stored from right to
  1788.              left in each data byte.
  1789.              This format yields a 1:8 or 1/8 compression ratio.
  1790.  
  1791.              Programs that use this format:
  1792.              .  IBM's education software such as "Writing to Read"
  1793.                 with a 128-byte header.
  1794.              .  Compton's Multimedia Encyclopedia program on CD ROM.
  1795.  
  1796.         21 - Digicorder 1-bit CVSD format files
  1797.  
  1798.              This format is similar to format 11, except that the bit
  1799.              stream is stored from left to right within each data byte.
  1800.              This format yields a 1:8 or 1/8 compression ratio.
  1801.  
  1802.              Programs that use this format:
  1803.              .  Digicorder & Mimic by Eletech Electronics with a numeric
  1804.                 extension indicating the recording rate in bits-per-second,
  1805.                 and no header record.
  1806.  
  1807.         28 - Amiga 8-bit PCM with 8SVX variable length header (.SND)
  1808.              or Amiga 8-bit PCM with Sonix 64-byte header (.SND)
  1809.              or Atari 8-bit PCM files (.SND)
  1810.  
  1811.              This format is similar to 8-bit PCM, but stores the actual
  1812.              amplitude level with polarity intact.  The lowest sample is
  1813.              -128, the mid point is 0 and the highest sample is 128.
  1814.  
  1815.              Programs that use this format:
  1816.              .  Perfect Sound by Sunrize Industries for the Amiga
  1817.                 with a 128-byte 8SVX style header record.
  1818.              .  Audio Master for the Amiga, with a 128-byte 8SVX header.
  1819.              .  Sonix for the Amiga, with a 64-byte header record.
  1820.  
  1821.         31 - Voice Toolkit 1-bit format files
  1822.  
  1823.              This format simply takes bit-4 of each original 8-bit sample
  1824.              and stores the bit stream from left to right within each
  1825.              data byte.
  1826.              This format yields a 1:8 or 1/8 compression ratio.
  1827.  
  1828.              Programs that use this format:
  1829.              .  Digitized Voice Toolkit for the PC, by Farpoint
  1830.                 Software; Alan D. Jones, with a .VOI extension.
  1831.                 NOTE: This shareware package includes the schematics
  1832.                 for a build-it-yourself digitizer that is attached to
  1833.                 any COM port for recording.
  1834.  
  1835.         38 - Macintosh 8-bit PCM with MacBinary FSSD 128-byte header (.SND)
  1836.  
  1837.              This file format is the same as format 08, with a different
  1838.              type of header record.  No compression is currently supported.
  1839.  
  1840.         42 - Creative Labs 2-bit ADPCM with 16-byte header (.VOC)
  1841.  
  1842.              This is a compressed file format, that is automatically
  1843.              decompressed by the hardware, and can only be played
  1844.              on a Sound Blaster card.
  1845.  
  1846.         44 - Creative Labs 4-bit ADPCM with 16-byte header (.VOC)
  1847.  
  1848.              This is a compressed file format, that is automatically
  1849.              decompressed by the hardware, and can only be played
  1850.              on a Sound Blaster card.
  1851.  
  1852.         45 - Creative Labs 2.5-bit ADPCM with 16-byte header (.VOC)
  1853.  
  1854.              This is a compressed file format, that is automatically
  1855.              decompressed by the hardware, and can only be played
  1856.              on a Sound Blaster card.
  1857.  
  1858.         48 - Creative Labs 8-bit PCM with 16-byte header (.VOC)
  1859.  
  1860.              This format is the same as format 08, with a different type
  1861.              of header record, and can be played on any device.
  1862.  
  1863.              This format is used by the Sound Blaster card from Creative
  1864.              Labs Inc.
  1865.  
  1866.         81 - Covox 1-bit ADPCM with silence encoding (.V1S)
  1867.  
  1868.              This format is the same as format 01, but includes the use
  1869.              of silence encoding.
  1870.  
  1871.              Silence encoding is a form of compression that uses 3 bytes
  1872.              to represent up to 32640 multiple continous bytes of silence.
  1873.              This technique can save a considerable amount of disk space
  1874.              without affecting the sound quality.  Many periods of silence
  1875.              occur between words and syllables and at the beginning and end
  1876.              of sound files.
  1877.         
  1878.              DEMO123.V8S is an example of a silence encoded file.  You can
  1879.              play it back with no switches for normal playback, or you can
  1880.              use the /F8 switch to hear just the non-silent passages.  The
  1881.              little cracks you'll hear with the /F8 switch are the places
  1882.              where silence has been encoded into just a few bytes.         
  1883.  
  1884.              Currently, only sound files created by Covox programs have
  1885.              silence encoding, but a future release of SPUTTER, will include
  1886.              a utility to rewrite any sound files using silence encoding.
  1887.  
  1888.         82 - Covox 2-bit ADPCM with silence encoding (.V2S)
  1889.  
  1890.              This format is the same as format 02, but includes the use
  1891.              of silence encoding.
  1892.  
  1893.         83 - Covox 3-bit ADPCM with silence encoding (.V3S)
  1894.  
  1895.              This format is the same as format 03, but includes the use
  1896.              of silence encoding.
  1897.  
  1898.         84 - Covox 4-bit ADPCM with silence encoding (.V4S)
  1899.  
  1900.              This format is the same as format 04, but includes the use
  1901.              of silence encoding.
  1902.  
  1903.         88 - Covox 8-bit PCM with silence encoding (.V8S)
  1904.  
  1905.              This format is the same as format 08, but includes the use
  1906.              of silence encoding.
  1907.  
  1908.   /Hi,r
  1909.         This switch will cause high-pass filtering to be applied to the
  1910.         data before being played.  This technique is known as Differential
  1911.         Quantization & is based on the fact that there is considerable
  1912.         correlation between adjacent speech samples.  The interval <i>,
  1913.         determines the distance between samples to be differentiated.
  1914.         Using a repeat value <r> greater than 1 will heighten the effect.
  1915.  
  1916.         This switch can only be used on 8-bit PCM data with no compression
  1917.         or silence encoding.  Using the switch with any other file format
  1918.         will produce an error message.  To apply high-pass filtering to
  1919.         any other file format, you must first use the /W switch to write
  1920.         the desired file out into 8-bit PCM format, and then use the /H
  1921.         switch on the new file.
  1922.  
  1923.   /I
  1924.         This switch will display on screen, all the file information that
  1925.         is normally displayed when the file is played, but without any
  1926.         playback occurring.
  1927.  
  1928.   /IRn
  1929.         This switch allows you to specify the Interrupt Request line that
  1930.         your Sound Blaster card is set for.  The default is 3, with valid
  1931.         values being 2,3,5,7.
  1932.  
  1933.   /K
  1934.         This switch will cause SPUT to ignore all keyboard input while
  1935.         playing a soundfile.
  1936.  
  1937.   /Li,r
  1938.         This switch will cause low-pass filtering to be applied to the
  1939.         data before being played.  This technique is known as Integration.
  1940.         The interval <i> determines the distance between samples to be
  1941.         integrated.  Using a repeat value <r> greater than 1 will heighten
  1942.         the effect.
  1943.  
  1944.         This switch can only be used on 8-bit PCM data with no compression
  1945.         or silence encoding.  See /H for directions on applying low-pass
  1946.         filtering to other file formats.
  1947.  
  1948.   /N
  1949.         This switch will generate very low-level noise in place of dead
  1950.         silence, when playing back files with silence encoding.
  1951.         Sometimes, when periods of silence are obvious, this can help
  1952.         make it more natural sounding.
  1953.  
  1954.   /On
  1955.         The /O switch is used to invoke the oversampling option for the
  1956.         internal speaker only.  This can be used to help eliminate
  1957.         sampling whine in files that were recorded at a sampling rate
  1958.         below 12000 samples-per-second.
  1959.   
  1960.         When the /O switch is used alone, or before the /R switch on
  1961.         the command line, SPUT will use the specified playback rate to
  1962.         calculate a new playback rate to be used while oversampling.
  1963.  
  1964.         For example, if a file plays correctly at a rate of 132 (9622hz)
  1965.         but yields high sampling whine, using the /O2/R132 switches will
  1966.         cause SPUT to double the playback rate from 9622hz to 19244hz
  1967.         and oversample by a factor of 2.  This causes the file to be played
  1968.         back twice as fast, but each byte is being played twice now, so
  1969.         it sounds the same with the sampling whine removed.
  1970.  
  1971.         The switch is ignored, when sending output to any port other
  1972.         than the internal speaker.
  1973.  
  1974.   /Pnnn
  1975.         This switch allows selection of the desired output port.
  1976.  
  1977.         Port Values:
  1978.  
  1979.             0     - Internal speaker (default)
  1980.             1-4   - Voice Master (VM0-3)
  1981.             5-8   - Speech Thing (LPT1-4)
  1982.             9     - Sound Master (SM)
  1983.             nnn   - hex port address of any other Digital to Analog Converter
  1984.             nnn-A - hex port address of an AdLib music card
  1985.             nnn-S - hex port address of a Sound Blaster card
  1986.  
  1987.   /PH
  1988.         This switch will cause SPUT to display the phonemes used to
  1989.         form words during text-to-speech translation.
  1990.  
  1991.   /Qn
  1992.         This switch is used to set the desired level of screen output.
  1993.                 /Q0     display all output
  1994.                 /Q1     display none
  1995.                 /Q2     display errors only
  1996.  
  1997.   /Rnnn
  1998.         The /R switch is used to force SPUT to use a specific playback
  1999.         rate.  This may be necessary when the file is missing a proper
  2000.         header record, or the playback or record rate is not available.
  2001.  
  2002.         When the playback rate is not available, it will default to
  2003.         152 for Macintosh files and 182 for all other files.
  2004.  
  2005.         When the /R switch appears before the /O switch on the command
  2006.         line, SPUT will use the specified playback rate for oversampling
  2007.         and not perform any other calculation.
  2008.             
  2009.         When the /O switch appears before the /R switch on the command
  2010.         line, SPUT will use the specified playback rate to calculate
  2011.         a new playback rate to be used while oversampling.  See the /O
  2012.         switch for details.
  2013.  
  2014.         Rate Frequency Approximations:
  2015.  
  2016.                1  4679hz   152 11473hz   202 22096hz  
  2017.               66  6279hz   161 12559hz   212 27118hz
  2018.              110  8172hz   171 14037hz   222 35094hz
  2019.              132  9622hz   182 16124hz   232 49716hz
  2020.              140 10286hz   192 18643hz   242 85227hz
  2021.  
  2022.   /RSnnn
  2023.         This switch tells SPUT to resample the selected sound file
  2024.         while writing it to disk.  It is only applicable when used in
  2025.         conjunction with the /W switch.
  2026.  
  2027.         Resampling is a process where the playback rate of the specified
  2028.         soundfile is changed to the rate you specify with the /RS switch.
  2029.  
  2030.         Now virtually any sound file can be played on virtually any
  2031.         machine, no matter what the speed of the machine.  If a file
  2032.         will not play properly on a slower machine, just resample it
  2033.         down to a rate that runs properly on that machine.
  2034.  
  2035.         Resampling also has the pleasant side effect of reducing the
  2036.         size of the sound file.  The greater the reduction in playback
  2037.         rate, the greater the reduction in file size.
  2038.  
  2039.   /RU
  2040.         This switch will cause SPUT to display the rule numbers used
  2041.         when forming words during text-to-speech translation.
  2042.   /SH
  2043.         You lucky Sound Blaster owners can use this switch to shell to
  2044.         the DOS prompt while SPUT is playing your sound file in the
  2045.         background.
  2046.  
  2047.         As soon as playback is started, SPUT will start a DOS shell and
  2048.         print the following message:
  2049.  
  2050.                 << Type EXIT anytime to return to SPUT >>
  2051.  
  2052.         You will then see the familiar DOS prompt where you can run any
  2053.         program, to do whatever you like.
  2054.         Whenever you decide to quit the shell, just type 'EXIT' at the DOS
  2055.         prompt and you will return to SPUT.
  2056.  
  2057.         If playback is finished, SPUT will end and return to whatever
  2058.         task it was called by, otherwise SPUT will display the following
  2059.         message and wait for playback to complete before exiting:
  2060.  
  2061.         << Waiting for playback to finish (press ESCAPE to abort) >>
  2062.  
  2063.   /T
  2064.         Use this switch to enhance treble output of a sound file.
  2065.  
  2066.         This uses 3 level non-uniform quantization, which divides the
  2067.         entire amplitude range into 3 ranges and assigns the same amplitude
  2068.         value to all samples falling in the upper and lower ranges.
  2069.         All samples in the low range are set to 0, all samples in the
  2070.         high range are set to 255 and all samples falling in the middle
  2071.         range are doubled up to 127.  Samples in the middle range above
  2072.         127 are clipped.
  2073.  
  2074.   /TI
  2075.         This switch will cause SPUT to digitize the current time.
  2076.  
  2077.   /TX
  2078.         This will cause SPUT to enter interactive text mode and display
  2079.         a prompt (>).  Any words typed will be digitized when the
  2080.         ENTER key is pressed.  Press CTRL-C to exit interactive text
  2081.         mode and return to the DOS prompt.
  2082.  
  2083.         During interactive text mode, phonemes and phoneme-functions may
  2084.         be entered along with regular text to be digitized.  
  2085.  
  2086.   /V<f>
  2087.         This switch is used to specify an alternate voice file.  The
  2088.         default voice filename is SPUT.PHD.  The file is assumed to be
  2089.         located in the current directory or in the PATH.
  2090.  
  2091.   /W<f> 
  2092.         This switch will cause all output to be redirected to a disk file
  2093.         instead of being played.  The format of the output file is
  2094.         always 8-bit PCM with a 16-byte Covox style header record.
  2095.  
  2096.         All file formats are converted to 8-bit PCM just before being
  2097.         output to the selected device.  This switch causes that 8-bit
  2098.         PCM data to be captured to a disk file, which can then be
  2099.         manipulated much more easily than the other file formats.
  2100.  
  2101.         The captured file can be replayed with SPUT using the /H and
  2102.         /L switches for high/low-pass filtering, or the waveform of the
  2103.         file can be viewed with SPUTWAVE, or the file can be edited
  2104.         with a sound file editor.
  2105.  
  2106.         Keep in mind that the samples in the output file will reflect
  2107.         all switches that were active at the time the file was created.
  2108.         If /T is used for treble enhancement, then playing the new file
  2109.         with no switch will sound the same as playing the original with
  2110.         the /T switch.
  2111.  
  2112.  
  2113.   --------------------------------
  2114.   3.3.2 SPUT SPECIAL FUNCTION KEYS
  2115.   --------------------------------
  2116.  
  2117.   The following keys perform special functions while SPUT is playing a
  2118.   sound file.  Any other keys pressed, will be placed in the keyboard
  2119.   input buffer as usual.
  2120.  
  2121.   ESCAPE key
  2122.         Pressing the ESCAPE key during file playback, will cause SPUT to
  2123.         immediately stop playback and exit.  This will not disturb any
  2124.         type ahead already in the keyboard buffer.
  2125.  
  2126.   +
  2127.         Pressing the + key during file playback, will cause SPUT to increase
  2128.         the volume of the sound clip being played.
  2129.  
  2130.         This key has no effect when the Sound Blaster DMA driver is being used.
  2131.         The DMA driver is the default for the Sound Blaster and is selected
  2132.         with the /D2 switch.  If you want to be able to use this function,
  2133.         you must select the other Sound Blaster driver with the /D1 switch.
  2134.         This can be done just for the playing of a single file by giving the
  2135.         switch on the command line as follows:
  2136.  
  2137.                 SPUT <filename>/D1
  2138.  
  2139.         or from the SPUTTER shell, you press the following keys:
  2140.  
  2141.                 <CTRL-ENTER>/D1<ENTER>
  2142.  
  2143.         or you can set this driver to be the normal driver for all playback
  2144.         by setting the environment variable as follows:
  2145.  
  2146.                 SET SPUTARG=/D1
  2147.  
  2148.         The Sound Blaster direct driver, selected with the /D1 switch,
  2149.         requires a system speed of at least 10mhz to work properly.  If
  2150.         the sound file plays too slowly using this driver, then you must
  2151.         the DMA driver (/D2), and cannot use the + key.
  2152.  
  2153.         Pressing the + key too many times will eventually cause the file
  2154.         to play too slowly.
  2155.  
  2156.   -
  2157.         Pressing the - key during file playback, will cause SPUT to decrease
  2158.         the volume of the sound clip being played.
  2159.  
  2160.         This key has no effect when the Sound Blaster DMA driver is being used.
  2161.         (The same notes for the + key apply to this key)
  2162.  
  2163.  
  2164.   ------------------------
  2165.   3.3.3 SPUT SCREEN OUTPUT
  2166.   ------------------------
  2167.  
  2168.   SPUT displays the following information on the screen each time it
  2169.   is run.
  2170.  
  2171.         SPUT vn.nn Player Utility - Copyright 1991, VersaWare / Adrienne Cousins
  2172.         File:E:\SND\TRYAGN.V8   Size:9439/9423  Form:0008/0  Port:022F  Driv:1
  2173.         Rate:180  Over:1  Freq:15495hz  Ampl:0+  Time:0.6s
  2174.         Samples Output:9423  Silence groups:0  Timer Adjust:11
  2175.  
  2176.   or for Macintosh files, the Title from the header is included:
  2177.  
  2178.         SPUT vn.nn Player Utility - Copyright 1991, VersaWare / Adrienne Cousins
  2179.         File:.\HOWYA.SND   Size:11648/11008  Form:0038/0  Port:022F  Driv:1
  2180.         Rate:152  Over:1  Freq:11363hz  Ampl:0+  Time:1.0s  Title:HowYouDoin'?
  2181.         Samples Output:11008  Silence groups:0  Timer Adjust:17
  2182.  
  2183.   or silence encoding statistics are shown when applicable:
  2184.  
  2185.         SPUT vn.nn Player Utility - Copyright 1991, VersaWare / Adrienne Cousins
  2186.         File:F:\SND\EXECUTE.V4S   Size:2682/2666  Form:0084/0  Port:022F  Driv:1
  2187.         Rate:152  Over:1  Freq:11363hz  Time:0.2s
  2188.         Samples Output:12675  Silence groups:10  Timer Adjust:20
  2189.  
  2190.   If you are an unregistered user, you will also see the following message
  2191.   whenever playback is completed
  2192.  
  2193.               ┌───────────────────────────────────────────────────┐
  2194.               │                                                   │
  2195.               │   Thank you for trying The Sputter Sound System   │
  2196.               │        If you use Sputter, please register        │
  2197.               │                                                   │
  2198.               │   Registration will remove this message & delay   │
  2199.               │          and give you additional features         │
  2200.               │                                                   │
  2201.               └───────────────────────────────────────────────────┘
  2202.  
  2203.  
  2204.   File:
  2205.         This is the name of the file entered on the command line to SPUT.
  2206.  
  2207.   Size:
  2208.         The first number is the size of the file in bytes, the second
  2209.         is the actual byte size of the data to be played.
  2210.  
  2211.   Form:
  2212.         The first number is the file format (see /F for definitions)
  2213.         The second number indicates Macintosh file compression:
  2214.  
  2215.                 0 - non-compression
  2216.                 1 - run length encoding (RLE)
  2217.                 2 - Dynamic Lempel-Ziv,Weiss compression
  2218.                 3 - Huffman compression
  2219.  
  2220.   Port:
  2221.         This is the hex address of the port being used for output.
  2222.  
  2223.   Driv:
  2224.         This is the driver number used to drive the output device.
  2225.  
  2226.   Rate:
  2227.         This is the playback rate, specified on the command line, or taken
  2228.         from the header record, or recalculated for oversampling.
  2229.  
  2230.   Over:
  2231.         This is the oversampling factor currently being used.
  2232.  
  2233.   Freq:
  2234.         This is the frequency (samples per second) that the file is being
  2235.         played at.
  2236.  
  2237.   Time:        
  2238.         This is the approximate time it will take to playback the file
  2239.         at the current settings.
  2240.  
  2241.   Title:
  2242.         This only appears when playing Macintosh sound files and comes
  2243.         from the internal header record of the sound file.
  2244.  
  2245.   Samples Output:
  2246.         This is a count of the bytes actually sent to the output device and
  2247.         includes all bytes reconstructed as a result of silence encoding,
  2248.         and compression.  In third example above, the file uses only 6508
  2249.         bytes of disk space to store a file that originally contained
  2250.         12126 bytes of sound.
  2251.  
  2252.   Silence groups:
  2253.         This is how many periods of silence were found in the file, and
  2254.         expanded back to their original length.
  2255.  
  2256.  
  2257.   --------------------------------
  2258.   3.3.4 SPUT ENVIRONMENT VARIABLES
  2259.   --------------------------------
  2260.  
  2261.   SPUTARG
  2262.         This allows you to setup any permanent switches that you would
  2263.         like SPUT to use every time it's run, without having to enter
  2264.         them on the command line.  Any switches specified on the command
  2265.         line, will override the switches in the SPUTARG variable.
  2266.  
  2267.         You can set this value at the DOS prompt, or by including a line
  2268.         in your AUTOEXEC.BAT file with the following command:
  2269.  
  2270.                 SET SPUTARG=/P220-S/IR7
  2271.  
  2272.         This tells SPUT to send all output to a Sound Blaster card
  2273.         at port 220 (hex), using interrupt number 7.
  2274.  
  2275.  
  2276.   SPUTDIR
  2277.         This defines the default directory to find sound files.  If a
  2278.         filename is given on the command line with no drive or directory,
  2279.         SPUT will look for the file in the directory defined by the
  2280.         SPUTDIR variable.
  2281.  
  2282.         You can set this value at the DOS prompt, or from your AUTOEXEC.BAT
  2283.         file with the following command:
  2284.  
  2285.                 SET SPUTDIR=C:\SND  
  2286.  
  2287.         This would tell SPUT to look in the SND directory on the
  2288.         C: drive for all sound files.
  2289.  
  2290.         To force SPUT to play a file in the current directory without
  2291.         having to enter the complete path, use the following command:
  2292.  
  2293.                 SPUT .\<filename>
  2294.  
  2295.  
  2296.   ---------------------------------
  2297.   3.3.5 SPUT DICTIONARY FILE FORMAT
  2298.   ---------------------------------
  2299.  
  2300.         The dictionary file is used to correct SPUT's pronounciation
  2301.         errors or change any other attributes of a word like volume or
  2302.         speed.  You can also use the dictionary to translate words and
  2303.         abbreviations into complete words and phrases. 
  2304.  
  2305.         The format of the file is straight ascii created with any text
  2306.         editor program.  Each entry is 2 lines.
  2307.  
  2308.         The first line is the english word and may be in any case.
  2309.         The second line is the correct phoneme string to be used to
  2310.         pronounce the word, and may also contain simple text, Smooth
  2311.         Talker style phonemes and any special phoneme functions that
  2312.         are described in the following section.
  2313.  
  2314.         The following is an example of a simple phoneme definition to
  2315.         correct a mis-pronounciation:
  2316.  
  2317.                 COW
  2318.                 ~k-ow
  2319.  
  2320.         The following example uses SmoothTalker style phonemes:
  2321.  
  2322.                 diaper
  2323.                 <<~dAY4EYp3ER>>
  2324.  
  2325.         The following example uses phoneme-functions to make the second
  2326.         syllable louder:
  2327.  
  2328.                 FANTASTIC
  2329.                 ~f-ae-n-a3+-t-ae-s-a0-t-ih-k
  2330.  
  2331.         The following example uses phoneme-functions to make the entire
  2332.         word softer:
  2333.  
  2334.                 WHISPER
  2335.                 ~a4--wh-ih-s-p-er-a0
  2336.  
  2337.         The following example uses simple text to define an abbreviation
  2338.         expansion:
  2339.  
  2340.                 DAC
  2341.                 digital to analog converter
  2342.  
  2343.  
  2344.   ------------------------------
  2345.   3.3.6 SPUT PHONEME DEFINITIONS
  2346.   ------------------------------
  2347.  
  2348.   Phoneme strings always start with the tilde character (~) followed by each
  2349.   of the phonemes separated by dashes.  A space or any control character
  2350.   ends the word.  (eg.  ~v-ey-p-er is the word VAPOR)
  2351.   SPUT phonemes are not case sensitive, and are compatible with TRAN phonemes.
  2352.  
  2353.   SmoothTalker phonemes are supported so that any files that already contain
  2354.   SmoothTalker phonemes will be interpreted correctly by SPUT.
  2355.   
  2356.   Many of the SmoothTalker phonemes have the same name as the SPUT
  2357.   phonemes, but those marked with an asterisk (*) are differrent.
  2358.   To create a SmoothTalker phoneme string, start the word with 2 less than
  2359.   signs, followed by the tilde character, then the string of phonemes,
  2360.   followed by 2 greater than signs to end the word. (eg. <<~vEYpER>> )
  2361.   SmoothTalker phonemes are case sensitive.
  2362.  
  2363. ------------------------------------------------------------------------------
  2364.         SPUT Phonemes                   SMOOTH TALKER Phonemes
  2365. ------------------------------------------------------------------------------
  2366.         AE   fAt                        AE      short 'a' last
  2367.         AH   fAther                    *AA      short 'o' cot
  2368.         AW   lAWn                      *AO      intermediate 'o' caught
  2369.         AY   hIde                       AY      dipthong ice
  2370.         B    soB                        b       plosive in bin
  2371.         BB   Back                      
  2372.         CH   CHurCH                     CH      in chin
  2373.         D    soD                        d       plosive in din
  2374.         DD   Dime                      
  2375.         DH   eiTHer                     DH      'th' in then
  2376.         EE   bEEt                      *IY      long 'e' beet
  2377.         EH   gEt                        EH      short 'e' best
  2378.         ER   mURdER                     ER      'ur' 'er' in further
  2379.         EY   gAte                       EY      dipthong in ace
  2380.         F    Fault                      f       fricative in fin
  2381.         G    doG                        g       plosive in give
  2382.         GG   Goat                      
  2383.         H    How                        h       in hit
  2384.         IH   bIt                        IH      short 'i' fit
  2385.         JJ   Jar                        j       in jin or jug
  2386.         J    juDGe                     
  2387.         K    Coat                       k       plosive in kin
  2388.         L    Laugh                      l       in light or love
  2389.         MM   Moat                      
  2390.         M    suM                        m       nasal in might
  2391.         NN   Note                      
  2392.         N    suN                        n       nasal in night
  2393.         NG   suNG                       NG      nasal in sing
  2394.         OH   lOne                      *OW      long 'o' dose
  2395.         OO   fOOl                      *UW      long 'u' lute
  2396.         OR   fOR                       
  2397.         OW   hOW                       *AW      dipthong loud
  2398.         OY   tOY                        OY      dipthong noise
  2399.         P    Pack                       p       plosive in pin
  2400.         R    Rate                       r       in rate
  2401.         S    Sue                        s       silibant in sin
  2402.         SH   SHoe                       SH      silibant in shin
  2403.         T    Time                       t       plosive in tin
  2404.         TH   eTHer                      TH      fricative in thin
  2405.         U    fUll                      *UH      'u' sound in book
  2406.         UH   About                     *AH      short 'u' up
  2407.         V    Vault                      v       in vim
  2408.         W    Wear                       w       in wait or water
  2409.         WH   WHere                      WH      in which or where
  2410.         Y    Young                      y       in yet or yes
  2411.         Z    Zoo                        z       in zen
  2412.         ZH   lieSure                    ZH      in pleasure
  2413.         SPACE
  2414.  
  2415.    The following SmoothTalker phonemes (on the right) have no SPUT
  2416.    equivalents, so the closest sounding phonemes have been substituted.
  2417.  
  2418.         UH                              AX      schwa 'a' in against
  2419.         EH                              IX      duration tween IH,AX in David
  2420.         T                               DX      't' in butter
  2421.         K                               KX      non-aspirated 'k' ice cold
  2422.         T                               TX      non-aspirated 't' misstate
  2423.         T                               PX      non-aspirated 't' white spot
  2424.  
  2425.  
  2426.    ------------------------------------
  2427.    3.3.7 SPUT PHONEME SPECIAL FUNCTIONS
  2428.    ------------------------------------
  2429.  
  2430.    The special phoneme-functions may be used at the > prompt, in a text file
  2431.    or in the exception dictionary.  The changes caused by a phoneme-function
  2432.    remain in effect until another matching phoneme-function is processed.
  2433.  
  2434.    They may appear alone as in the following example:
  2435.         ~A2 loud ~A3 louder ~A3 even louder ~A0 back to normal
  2436.    or as part of a phoneme string as in this example:
  2437.         ~F-AE-N-A3+-T-AE-S-A0-T-IH-K.
  2438.  
  2439.  
  2440.    An   The amplitude function is used to vary the amplitude or volume
  2441.         of the created speech.
  2442.  
  2443.         Use n or n+ to increase the amplitude
  2444.             n- to decrease the amplitude
  2445.             0 to return to normal amplitude
  2446.  
  2447.         ~A1+ or ~A1 increases the volume 1 step.
  2448.         ~A1- decreases the volume 1 step.
  2449.         ~A0 sets the volume back to normal.
  2450.  
  2451.         Example:  At the > prompt type "this is ~a3 louder"
  2452.                   or "this is ~a3- softer"
  2453.                   or "this is loudly"  (LOUDLY is in the dictionary file)
  2454.                   or type "SPUT .\SAMPLES.TXT" to hear more examples.
  2455.  
  2456.    Rn   The rate function is used to vary the rate of the speech.
  2457.  
  2458.         Use n to set a new rate
  2459.             n+ to increase the current rate
  2460.             n- to decrease the current rate
  2461.             0 to return to the normal rate
  2462.  
  2463.         ~R10+ increases the rate by 10 (relative to current rate)
  2464.         ~R10- decreases the rate by 10 (relative to current rate)
  2465.         ~R202 sets the rate to 202 (absolute setting)
  2466.         ~R0 set the rate back to normal.
  2467.  
  2468.         Example:  At the > prompt type "this is ~r10+ faster"
  2469.                   or "this is ~r10- slower"
  2470.                   or type "SPUT .\SAMPLES.TXT" for more examples.
  2471.  
  2472.    Mn   The mode function is used to change between word and letter modes.
  2473.  
  2474.         Use 1 to switch to letter mode
  2475.             0 to switch to word mode (default)        
  2476.  
  2477.         Example:  At the > prompt type "this is ~M1 letter mode"
  2478.                   or "~M0 this is word mode again"
  2479.                   or type "SPUT .\SAMPLES.TXT" for more examples.
  2480.  
  2481.    Pn   The punctuation function is used to change the amount of punctuation
  2482.         that will be pronounced.
  2483.  
  2484.         Use 0 to pronounce no punctuation (none)
  2485.  
  2486.             1 to pronounce some punctuation (default)
  2487.                  # $ % & = @ + < > ! /
  2488.                  and . (point) if followed by a character
  2489.  
  2490.             2 to pronounce most punctuation
  2491.                  all level 1 punctuation and
  2492.                  " ' ( ) * , - : ; ? [ \ ] ^ _ ` { | } ~
  2493.                  and . (period)                   
  2494.  
  2495.             3 to pronounce all punctuation
  2496.                  all level 1+2 punctuation
  2497.                  and all control characters (not yet implemented)
  2498.  
  2499.  
  2500.   -------------------------
  2501.   3.3.8 SPUT ERROR MESSAGES
  2502.   -------------------------
  2503.  
  2504.   (01) Command syntax error, type 'SPUT<enter>' for help
  2505.   (02) Invalid amplitude, use /An or /An- n=1-255
  2506.   (03) Invalid playback rate, use 1-255 default=182/152
  2507.   (04) Invalid file format, use 1-88 default=8
  2508.   (05) Invalid oversample value, use 1-10 default=1
  2509.   (06) Invalid port, use 0-9 or any hex address
  2510.   (07) Invalid high-pass filter, use /Hi,r where i=interval and r=repeat
  2511.   (08) Invalid low-pass filter, use /Li,r where i=interval and r=repeat
  2512.   (09) Invalid continous play value, use 1-254 0-infinite
  2513.   (0A) Filtering disabled, only applicable for 8-bit PCM files
  2514.   (0B) Not enough memory available, file will be truncated
  2515.   (0C) Invalid data length in header record, file has been truncated
  2516.   (0D) Error releasing unused memory
  2517.   (0E) Memory allocation failure
  2518.   (0F) Sound file not found <filename>
  2519.   (10) File read error
  2520.   (11) Error opening output file
  2521.   (12) Error writing header
  2522.   (13) Error writing file
  2523.   (14) Unknown file format, default format 08 may be incorrect
  2524.   (15) Oversampling calculation error, use a smaller Rate or Oversample value
  2525.   (16) File format not supported for this device
  2526.   (17) Invalid driver, for SPKR use 1(software) 2(polling) 3(ints) 4(8255)
  2527.                        for SOUND BLASTER use 1(direct) 2(dma)
  2528.   (18) New rate must be smaller than old playback rate
  2529.   (19) New frequency is too small (max frequency reduction is half)
  2530.   (1A) Voice file not found - <filename>
  2531.   (1B) Insufficient memory to load Voice file
  2532.   (1C) Voice file read error
  2533.   (1D) Sound Blaster initialization failure
  2534.   (1E) Text to phoneme translation error
  2535.   (1F) Dictionary file not found - <filename>
  2536.   (22) Macintosh Resource Fork is missing, default rate of 152 may be incorrect
  2537.   (23) Missing or unknown header record, default rate of 182 may be incorrect
  2538.   (24) Digitizing text files is only available to registered users
  2539.   (25) Another SPUTTER player utility is already running
  2540.   (26) The previous error was detected in an environment variable
  2541.  
  2542.  
  2543.   -----------------------------------------
  2544.   3.3.9 TROUBLE SHOOTING PROBLEMS WITH SPUT
  2545.   -----------------------------------------
  2546.  
  2547.   ** File plays too slowly (with or without any optional switches)
  2548.  
  2549.   This is simply the result of trying to play a file with too high a
  2550.   playback rate on too slow of a machine.  A RATE of 180 seems to be
  2551.   the fastest rate that an 8mhz AT machine can play, with no SPUT switches.
  2552.   Adding switches causes more processing to be done, and will slowdown
  2553.   playback even further.
  2554.  
  2555.   The solution is to run the file through SPUT with the /RS and /W switches
  2556.   to resample the file down to a lower playback rate that the machine
  2557.   can handle (ie: SPUT file/RS100/Wfile2).  If the new file still plays
  2558.   too slowly, then try the process again using a lower playback rate.
  2559.  
  2560.  
  2561.   ****************************************************************************
  2562.                  SECTION 3.4 - SPUTROL ROL File Player Utility
  2563.   ****************************************************************************
  2564.  
  2565.   This section describes the ROL file player program named SPUTROL.  It can
  2566.   only be run on an AdLib Music card or a Sound Blaster card.
  2567.  
  2568.   SPUTROL requires that you also have an FM sound driver by AdLib, called
  2569.   SOUND.COM.  This driver is a memory-resident program and is usually loaded
  2570.   before any attempt is made to play .ROL files.  SPUTROL does not require
  2571.   that the driver be loaded in advance, since it can load the driver and
  2572.   remove it from memory when the song is done.  This will save at least 18k
  2573.   bytes of memory.  SOUND.COM must be located somewhere in the PATH in order
  2574.   for SPUTROL to find it.
  2575.  
  2576.   Playing .ROL files also requires a bank file.  The default bank file name
  2577.   is STANDARD.BNK and this file should also be somewhere in the PATH in order
  2578.   for SPUTROL to find it.
  2579.  
  2580.   Very little memory is required to run SPUTROL, only 12k for the program,
  2581.   and enough additional memory to read the BANK file and the ROL file.
  2582.   That's it!  To play a 5k ROL file with a 10k BANK file requires only 27k
  2583.   of memory.  If you plan on letting SPUTROL load the AdLib FM sound driver
  2584.   SOUND.COM, then an additional 18k of memory will be required, but only
  2585.   for the duration of the song playing.  All memory is released when the
  2586.   song is finished.
  2587.  
  2588.   Another feature of SPUTROL is intelligent instrument substitution.  When
  2589.   an instrument is not found in the bank file, SPUTROL will attempt to find
  2590.   a close match instead of just defaulting to PIANO1.  You can also specify
  2591.   your own instrument substitutions if you prefer.
  2592.  
  2593.  
  2594.   ---------------------------------------
  2595.   3.4.1 SPUTROL COMMAND SYNTAX & SWITCHES
  2596.   ---------------------------------------
  2597.  
  2598.   Typing 'SPUTROL' with no arguments at the DOS prompt, will print the
  2599.   curent version number and a short help screen.
  2600.  
  2601.   The command syntax for SPUTROL is as follows:
  2602.  
  2603.                 SPUTROL <rolfile> [<bankfile>] [/switches]
  2604.  
  2605.   <rolfile>
  2606.         This is the name of the ROL file to be played.  Any valid DOS
  2607.         wildcards may be used to have SPUTROL randomly select a ROL file.
  2608.         The extension is not required, and ROL files may be renamed using
  2609.         any convenient extension.
  2610.  
  2611.         If no path is specified, the directory specified by the SROLDIR
  2612.         environment variable will be assumed, otherwise the current
  2613.         directory is assumed.
  2614.  
  2615.         Specifying a directory as part of the filename, will override
  2616.         any directory specified by the SROLDIR environment variable.  Use
  2617.         ".\filename" to indicate the current directory and ignore the
  2618.         SROLDIR environment variable.
  2619.  
  2620.   [<bankfile>]
  2621.         This argument is optional, and if used is the name of the bank file
  2622.         to be used.  The default name is STANDARD.BNK in the current
  2623.         directory, or any directory in the PATH statement.
  2624.  
  2625.   [/switches]
  2626.         All switches are optional.  The SROLARG environment variable is
  2627.         checked first for any permanent switches.  Any switches given on
  2628.         the command line will then override the SROLARG switches.
  2629.         The valid switches are listed below.
  2630.  
  2631.   ?
  2632.         Entering a question mark on the command line, will tell SPUTROL to
  2633.         display a short help screen.
  2634.  
  2635.   /An
  2636.         This switch can be used to modify the amplitude or volume of
  2637.         a song.  Using a positive number (/An or /An+) will increase the
  2638.         volume, and a negative number (/An- ) will decrease the volume.
  2639.  
  2640.   /Cn
  2641.         This will cause the song file to be played N times, in a
  2642.         continous loop.  A value of 0 will play indefinetly, until the
  2643.         ESCAPE key is struck.
  2644.  
  2645.   /I
  2646.         This switch will display on screen, all the file information that
  2647.         is normally displayed when the file is played, but without any
  2648.         playback occurring.
  2649.  
  2650.   /IF
  2651.         Normally when SPUTROL detects an invalid ROL file, an error message
  2652.         is displayed and the song is not played.  This switch can be used
  2653.         to force SPUTROL to play an invalid ROL file format.
  2654.  
  2655.   /ISold1=new1,old2=new2
  2656.         This switch is used to specify instrument substitutions, where
  2657.         OLD1 is the name of the original instrument and NEW1 is the name
  2658.         of the instrument to be used in its place.  Up to 5 substitutions
  2659.         may be specified, separated by commas.
  2660.  
  2661.   /IN
  2662.         Normally, only the first 6 instruments are displayed for each voice
  2663.         so that the file information will all fit on a single screen.
  2664.         Use this switch to force SPUTROL to display all instruments used
  2665.         for each of the voices.
  2666.  
  2667.   /K
  2668.         This switch causes SPUTROL to kill the song that was left playing
  2669.         in the background.
  2670.  
  2671.   /Mn
  2672.         This switch can be used to change the mode of the song.  Zero is
  2673.         melodic and uses voices 1-8, and one is percussive and uses voices
  2674.         1-6 in melodic mode and voices 7-11 in percussive mode.
  2675.  
  2676.   /NW
  2677.         This is the NOWAIT switch tells SPUTROL to exit as soon as the
  2678.         entire song is loaded into the SOUND driver, and leave the song
  2679.         playing in the background.  This switch can only be used if the
  2680.         AdLib sound driver SOUND.COM was already loaded before SPUTROL was
  2681.         run.
  2682.  
  2683.   /Pnnn
  2684.         This switch allows selection of the disired output port.  The
  2685.         default port address is 388 hex.  No switch is required for
  2686.         either the AdLib or SoundBlaster cards.
  2687.  
  2688.   /Qn
  2689.         This switch is used to set the desired level of screen output.
  2690.                 /Q0       display everything
  2691.                 /Q1       display nothing
  2692.                 /Q2       display errors only
  2693.  
  2694.   /Tn
  2695.         This switch can be used to change the default tempo of the song.
  2696.  
  2697.   /Vnnn
  2698.         This switch can be used to specify a single voice or list of voices
  2699.         to play.  /V246 would play only voices 2, 4 and 6.  This is most
  2700.         useful for proofreading music while creating ROL files, and
  2701.         hearing the balance between instruments.  It is also handy for
  2702.         determining which voice is playing a particular part for which
  2703.         you may want to change an instrument.
  2704.  
  2705.  
  2706.   -----------------------------------
  2707.   3.4.2 SPUTROL SPECIAL FUNCTION KEYS
  2708.   -----------------------------------
  2709.  
  2710.   ESCAPE key
  2711.         Pressing the ESCAPE key during file playback, will cause SPUTROL to
  2712.         immediately stop playback and exit.  This will not disturb any
  2713.         type ahead already in the keyboard buffer.
  2714.  
  2715.   +
  2716.         Pressing the + key during song playback, will cause SPUTROL to
  2717.         increase the volume of the overall song being played.  Within a .ROL
  2718.         file, the volume to play each instrument is specified as a number
  2719.         of 128th's, so that a value of 64 would mean that an instrument
  2720.         would play at half it's normal volume, 128 means full volume.
  2721.  
  2722.         Each press of the + key, increases every instruments volume by
  2723.         five 128th's up to a maximum of 128.
  2724.  
  2725.   -
  2726.         Pressing the - key during song playback, will cause SPUTROL to
  2727.         decrease the volume of the overall song being played.
  2728.         Each press of the - key, decreases every instruments volume by
  2729.         five 128th's down to a minimum of 1.
  2730.  
  2731.  
  2732.   ---------------------------
  2733.   3.4.3 SPUTROL SCREEN OUTPUT
  2734.   ---------------------------
  2735.  
  2736.   SPUTROL displays the following information on the screen each time it
  2737.   is run.
  2738.  
  2739.   SPUTROL vn.nn ROL Player - Copyright 1990-91, VersaWare / Adrienne Cousins
  2740.   Sound driver V1.51 (C) Ad Lib Inc. 1987, 1989
  2741.   Sound driver successfully installed.
  2742.   BNK File: D:\VOX\STANDARD.BNK v1.0 253/256 entries
  2743.   ROL File: E:\ROL\BUMBLBEE.CLS  Mode:0  TPB:8  BPM:2  Tempo:152  TemEvents:1
  2744.   Voice Length Inst  Instrument Names  (VolumeChanges/PitchChanges)
  2745.   ---------------------------------------------------------------------------
  2746.       1  1572    11  VIOLIN1 SYN4 ELGUIT1 CLAR1 SYNBASS1 CLAR1 (38/60)
  2747.       2  1498     8  CLAR1 ELGUIT1 SYN4 VIOLIN1 CLAR1 SYN4 (35/58)
  2748.       3  1608     6  ELGUIT2 ELGUIT2 MARIMBA2 ELGUIT2 MARIMBA2 ELGUIT2 (58/1)
  2749.       4  1592     6  ELGUIT2 ELGUIT2 MARIMBA2 ELGUIT2 MARIMBA2 ELGUIT2 (49/1)
  2750.       5  1592     6  ELGUIT2 ELGUIT2 MARIMBA2 ELGUIT2 MARIMBA2 ELGUIT2 (38/1)
  2751.       6  1608     5  ELGUIT2 ELGUIT2 PIANO1 MARIMBA2 ELGUIT2 (22/1)
  2752.       7  1608     5  ELGUIT2 ELPIANO2 PIANO1 ELPIANO2 PIANO1 (15/5)
  2753.       8  1346     2  ELGUIT2 SYN2 (3/1)
  2754.       9  1251     3  PIANO1 TRUMPET4 SYN4 (7/1)
  2755.      10     0     1  PIANO1 (1/1)
  2756.      11     0     1  PIANO1 (1/1)
  2757.    Time to play: 1:19 ■ Loading song into driver ■ Playback has started 
  2758.  
  2759.   If you are an unregistered user, you will also see the following message
  2760.   whenever playback is completed.
  2761.  
  2762.               ┌───────────────────────────────────────────────────┐
  2763.               │                                                   │
  2764.               │   Thank you for trying The Sputter Sound System   │
  2765.               │        If you use Sputter, please register        │
  2766.               │                                                   │
  2767.               │   Registration will remove this message & delay   │
  2768.               │          and give you additional features         │
  2769.               │                                                   │
  2770.               └───────────────────────────────────────────────────┘
  2771.  
  2772.   Line 1:
  2773.         This is the program title, version and copyright statement.
  2774.  
  2775.   Lines 2 & 3:
  2776.         These lines will only be displayed when the AdLib FM sound driver
  2777.         SOUND.COM has not been loaded prior to running SPUTROL.  In this
  2778.         case, SPUTROL will automatically find and load SOUND.COM and then
  2779.         remove it from memory when playback is completed.  When using this
  2780.         feature, it is recommended that you keep a copy of SOUND.COM on a
  2781.         RAMdisk if available.  The FM sound driver should also be in a
  2782.         directory that is in the current path statement.
  2783.         
  2784.   BNK File:
  2785.         This is the name of the bank file that is being used for playback.
  2786.         Also displayed is the version number of the bank file format, and
  2787.         the number of used/total entries in the bank file.  The PATH is
  2788.         automatically searched to find STANDARD.BNK if a bank file is not
  2789.         specified on the command line.
  2790.  
  2791.   ROL File:
  2792.         This is the name of the ROL file that is being played.
  2793.         The extension is not required when specifying a file to be played,
  2794.         and files may be renamed using any convenient extension.
  2795.  
  2796.   Mode:
  2797.         This is the mode of the file being played.  Zero is melodic mode
  2798.         which uses voices 1-8 and one is percussive mode, which uses voices
  2799.         1-6 in melodic mode and voices 7-11 in percussive mode.
  2800.  
  2801.   TPB:
  2802.         This is the number of ticks-per-beat defined for this song.
  2803.  
  2804.   BPM:
  2805.         This is the number of beats-per-measure defined for this song.
  2806.  
  2807.   Tempo:
  2808.         This is the tempo that the song is being played at, and may be
  2809.         changed with the /T switch.
  2810.  
  2811.   TemEvents:
  2812.         This is the total number of tempo changes that occur in the song.
  2813.  
  2814.   Voice Length Inst Instrument Names (VolumeChanges/PitchChanges)
  2815.         One line of information is printed for each of the 11 voices and
  2816.         contains the following information:
  2817.         Voice - the voice number.
  2818.         Length - the length of the voice in ticks.
  2819.         Inst - the number of instrument changes for this voice.
  2820.         Instrument Names - The names of the instruments for this voice.
  2821.                 An instrument name followed by a slash and another instrument
  2822.                 names indicates that a substitution has been made.
  2823.         (VolChanges/PitChanges) - The number of volume and pitch changes.
  2824.  
  2825.   Time to play:
  2826.         This is the estimated time that the song will take to play.
  2827.  
  2828.   Loading song into driver:
  2829.         This indicates that SPUTROL is in the process of loading the song
  2830.         into the AdLib FM sound driver.
  2831.  
  2832.   Playback has started: 
  2833.         This indicates that SPUTROL has filled the AdLib FM sound driver
  2834.         buffer and the driver has started to play the song.
  2835.  
  2836.  
  2837.   -----------------------------------
  2838.   3.4.4 SPUTROL ENVIRONMENT VARIABLES
  2839.   -----------------------------------
  2840.  
  2841.   SROLARG
  2842.         This allows you to setup any permanent switches that you would
  2843.         like SPUTROL to use every time it's run, without having to enter
  2844.         them on the command line.  Any switches specified on the command
  2845.         line, will override the switches in the SROLARG variable.
  2846.  
  2847.         You can set this value at the DOS prompt, or by including a line
  2848.         in your AUTOEXEC.BAT file with the following command:
  2849.  
  2850.                 SET SROLARG=/Q2
  2851.  
  2852.  
  2853.   SROLDIR
  2854.         This defines the default directory to find ROL files.  If a
  2855.         filename is given on the command line with no drive or directory,
  2856.         SPUTROL will look for the file in the directory defined by the
  2857.         SROLDIR variable.
  2858.  
  2859.         You can set this value at the DOS prompt, or from your AUTOEXEC.BAT
  2860.         file with the following command:
  2861.  
  2862.                 SET SROLDIR=C:\SND\ROL
  2863.  
  2864.         This tells SPUTROL to look in the \SND\ROL directory on the
  2865.         C: drive for all ROL files.
  2866.  
  2867.         To force SPUTROL to play a file in the current directory without
  2868.         having to enter the complete path, use the following command:
  2869.  
  2870.                 SPUTROL .\<filename>
  2871.  
  2872.  
  2873.   ----------------------------
  2874.   3.4.5 SPUTROL ERROR MESSAGES
  2875.   ----------------------------
  2876.  
  2877.   (01) Error releasing unused memory
  2878.   (02) Insufficient memory to load ROL file
  2879.   (03) ROL file not found - <filename>
  2880.   (04) ROL file read error
  2881.   (05) Invalid ROL file format - <filename>
  2882.   (06) BANK file not found - <filename>
  2883.   (07) BANK file read error
  2884.   (08) Invalid BANK file
  2885.   (09) Insufficient memory to load BANK file
  2886.   (10) Command syntax error, type 'SPUTROL<enter>' for help
  2887.   (11) Instrument not found <instrument>
  2888.   (12) SOUND.COM driver not loaded, loading temporarily
  2889.   (13) Invalid amplitude, use /An or /An- (n=1-255)
  2890.   (14) Error loading Tempo Events
  2891.   (15) Error loading Instrument Events
  2892.   (16) Error loading Volume Events
  2893.   (17) Error loading Pitch Events
  2894.   (18) Insufficient memory to load instruments
  2895.   (19) Another SPUTTER player utility is already running
  2896.   (20) Insufficient memory to load SOUND driver
  2897.   (21) Error loading SOUND driver
  2898.   (22) The previous error was detected in an environment variable
  2899.  
  2900.  
  2901.   ****************************************************************************
  2902.                  SECTION 3.5 - SPUTCMF CMF File Player Utility
  2903.   ****************************************************************************
  2904.  
  2905.   This section describes the CMF file player program named SPUTCMF.  It can
  2906.   only be run on an AdLib Music card of a Sound Blaster card.
  2907.  
  2908.   SPUTCMF requires that you also have an FM sound driver by Creative Labs
  2909.   called SBFMDRV.COM.  This driver is a memory-resident program and is
  2910.   usually loaded before any attempt is made to play .CMF files.  SPUTCMF
  2911.   does not require that the driver be loaded in advance, since it can load
  2912.   the driver and remove it from memory when the song is done.  This will save
  2913.   at least 7k bytes of memory.  SBFMDRV.COM must be located somewhere in the
  2914.   PATH in order for SPUTCMF to find it.
  2915.  
  2916.   Very little memory is required to run SPUTCMF, only 6k for the program,
  2917.   and enough additional memory to read the CMF file into memory.
  2918.   That's it!  To play a 5k CMF file requires only 11k of memory.
  2919.   If you plan on letting SPUTCMF load the Creative Labs FM sound driver
  2920.   SBFMDRV.COM, then an additional 7k of memory will be required, but only
  2921.   for the duration of the song playing.  All memory is released when the
  2922.   song is finished.
  2923.  
  2924.  
  2925.   ---------------------------------------
  2926.   3.5.1 SPUTCMF COMMAND SYNTAX & SWITCHES
  2927.   ---------------------------------------
  2928.  
  2929.   Typing 'SPUTCMF' with no arguments at the DOS prompt, will print the
  2930.   version number and a short help screen.
  2931.  
  2932.   The command syntax for SPUTCMF is as follows:
  2933.  
  2934.                 SPUTCMF <cmffile> [/switches]
  2935.  
  2936.   <cmffile>
  2937.         This is the name of the CMF file to be played.  Any valid DOS
  2938.         wildcards may be used to have SPUTCMF randomly select a CMF file.
  2939.         The extension is not required, and CMF files may be renamed using
  2940.         any convenient extension.
  2941.  
  2942.         If no path is specified, the drive:directory specified by the
  2943.         SCMFDIR environment variable will be searched, otherwise the
  2944.         current directory is assumed.
  2945.  
  2946.         Specifying a directory as part of the filename, will override
  2947.         any directory specified by the SCMFDIR environment variable.  Use
  2948.         ".\filename" to indicate the current directory and ignore the
  2949.         SCMFDIR environment variable.
  2950.  
  2951.   [/switches]
  2952.         All switches are optional.  The SCMFARG environment variable is
  2953.         checked first for any permanent switches.  Any switches given on
  2954.         the command line will then override the SCMFARG switches.
  2955.         The valid switches are listed below.
  2956.  
  2957.   ?
  2958.         Entering a question mark on the command line, will tell SPUTCMF to
  2959.         display a short help screen.
  2960.  
  2961.   /Cn
  2962.         This will cause the song file to be played N times, in a
  2963.         continous loop.  A value of 0 will play indefinetly, until the
  2964.         ESCAPE key is struck.
  2965.  
  2966.   /I
  2967.         This switch will display on screen, all the file information that
  2968.         is normally displayed when the file is played, but without any
  2969.         playback occurring.
  2970.  
  2971.   /IF
  2972.         Normally when SPUTCMF detects an invalid CMF file, an error message
  2973.         is displayed and the song is not played.  This switch can be used
  2974.         to force SPUTCMF to play an invalid CMF file format.
  2975.  
  2976.   /K
  2977.         This switch causes SPUTROL to kill the song that was left playing
  2978.         in the background.
  2979.  
  2980.   /NW
  2981.         This is the NOWAIT switch tells SPUTCMF to exit as soon as the
  2982.         entire song is loaded into the FM sound driver, and leave the song
  2983.         playing in the background.  This switch can only be used if the
  2984.         Creative Labs FM sound driver SBFMDRV was already loaded before
  2985.         SPUTCMF was run.
  2986.  
  2987.   /Pnnn
  2988.         This switch allows selection of the disired output port.  The
  2989.         default port address is 220 hex.  No switch is required for the
  2990.         SoundBlaster card.  AdLib cards will require the /P388 switch to
  2991.         work properly.
  2992.  
  2993.   /Qn
  2994.         This switch is used to set the desired level of screen output.
  2995.                 /Q0       display everything
  2996.                 /Q1       display nothing
  2997.                 /Q2       display errors only
  2998.  
  2999.   /SH
  3000.         This switch is used to shell to the DOS prompt while SPUTCMF is 
  3001.         playing your music file in the background.
  3002.  
  3003.         As soon as the song is started, SPUTCMF will start a DOS shell and
  3004.         print the following message:
  3005.  
  3006.                 << Type EXIT anytime to return to SPUTCMF >>
  3007.  
  3008.         You will then see the familiar DOS prompt where you can run any
  3009.         program, to do whatever you like.
  3010.         Whenever you decide to quit the shell, just type 'EXIT' at the DOS
  3011.         prompt and you will return to SPUTCMF.
  3012.  
  3013.         If playback is finished, SPUTCMF will end and return to whatever
  3014.         task it was called by, otherwise SPUTCMF will display the following
  3015.         message and wait for playback to complete before exiting:
  3016.  
  3017.         << Waiting for playback to finish (press ESCAPE to abort) >>
  3018.  
  3019.   /Tn
  3020.         This switch can be used to change the default tempo of the song.
  3021.  
  3022.  
  3023.   -----------------------------------
  3024.   3.5.2 SPUTCMF SPECIAL FUNCTION KEYS
  3025.   -----------------------------------
  3026.  
  3027.   ESCAPE key
  3028.         Pressing the ESCAPE key during file playback, will cause SPUTCMF to
  3029.         immediately stop playback and exit.  This will not disturb any
  3030.         type ahead already in the keyboard buffer.
  3031.  
  3032.  
  3033.   ---------------------------
  3034.   3.5.3 SPUTCMF SCREEN OUTPUT
  3035.   ---------------------------
  3036.  
  3037.   SPUTCMF displays the following information on the screen each time it
  3038.   is run.
  3039.  
  3040.   SPUTCMF vn.nn CMF Player - Copyright 1991, VersaWare / Adrienne Cousins
  3041.   Creative Sound Blaster FM-Driver  Version 1.21
  3042.   Copyright (c) Creative Labs, Inc., 1990.  All rights reserved.
  3043.   Copyright (c) Creative Technology Pte Ltd, 1990.  All rights reserved.
  3044.         Sound Blaster Card Version
  3045.   Driver's I/O address set at 220 Hex
  3046.   Driver installed at INT 80H.
  3047.   CMF File: E:\SND\CMF\CANTINA.CMF  Size:17556  TPB:23  TPS:96  Tempo:250
  3048.   Port:0220  Title:  Composer:  Remarks:
  3049.   Loading song into driver ■ Playback has started 
  3050.  
  3051.   If you are an unregistered user, you will also see the following message
  3052.   whenever playback is completed.
  3053.  
  3054.               ┌───────────────────────────────────────────────────┐
  3055.               │                                                   │
  3056.               │   Thank you for trying The Sputter Sound System   │
  3057.               │        If you use Sputter, please register        │
  3058.               │                                                   │
  3059.               │   Registration will remove this message & delay   │
  3060.               │          and give you additional features         │
  3061.               │                                                   │
  3062.               └───────────────────────────────────────────────────┘
  3063.  
  3064.   Line 1:
  3065.         This is the program title, version and copyright statement.
  3066.  
  3067.   Lines 2 thru 7:
  3068.         These lines will only be displayed when the Creative Labs FM sound
  3069.         driver SBFMDRV.COM has not been loaded prior to running SPUTCMF.  In
  3070.         this case, SPUTCMF will automatically find and load SBFMDRV.COM and
  3071.         remove it from memory when playback is completed.  When using this
  3072.         feature, it is recommended that you keep a copy of SBFMDRV.COM on a
  3073.         RAMdisk if available.  The FM sound driver should also be in a
  3074.         directory that is in the current path statement.
  3075.         
  3076.   CMF File:
  3077.         This is the name of the CMF file that is being played.
  3078.         The extension is not required when specifying a file to be played,
  3079.         and files may be renamed using any convenient extension.
  3080.  
  3081.   TPB:
  3082.         This is the number of ticks-per-beat defined for this song.
  3083.  
  3084.   TPS:
  3085.         This is the number of ticks-per-second defined for this song.
  3086.  
  3087.   Tempo:
  3088.         This is the tempo that the song is being played at, and may be
  3089.         changed with the /T switch.
  3090.  
  3091.   Loading song into driver:
  3092.         This indicates that SPUTCMF is in the process of loading the song
  3093.         information into the Creative Labs FM sound driver.
  3094.  
  3095.   Playback has started: 
  3096.         This indicates that SPUTCMF has passed the music information to
  3097.         the Creative Labs FM sound driver and the driver has started to play
  3098.         the song.
  3099.  
  3100.  
  3101.   -----------------------------------
  3102.   3.5.4 SPUTCMF ENVIRONMENT VARIABLES
  3103.   -----------------------------------
  3104.  
  3105.   SCMFARG
  3106.         This allows you to setup any permanent switches that you would
  3107.         like SPUTCMF to use every time it's run, without having to enter
  3108.         them on the command line.  Any switches specified on the command
  3109.         line, will override the switches in the SCMFARG variable.
  3110.  
  3111.         You can set this value at the DOS prompt, or by including a line
  3112.         in your AUTOEXEC.BAT file with the following command:
  3113.  
  3114.                 SET SCMFARG=/Q2
  3115.  
  3116.  
  3117.   SCMFDIR
  3118.         This defines the default directory to find CMF files.  If a
  3119.         filename is given on the command line with no drive or directory,
  3120.         SPUTCMF will look for the file in the directory defined by the
  3121.         SCMFDIR variable.
  3122.  
  3123.         You can set this value at the DOS prompt, or from your AUTOEXEC.BAT
  3124.         file with the following command:
  3125.  
  3126.                 SET SCMFDIR=C:\SND\CMF
  3127.  
  3128.         This tells SPUTCMF to look in the \SND\CMF directory on the
  3129.         C: drive for all CMF files.
  3130.  
  3131.         To force SPUTCMF to play a file in the current directory without
  3132.         having to enter the complete path, use the following command:
  3133.  
  3134.                 SPUTCMF .\<filename>
  3135.  
  3136.  
  3137.   ----------------------------
  3138.   3.5.5 SPUTCMF ERROR MESSAGES
  3139.   ----------------------------
  3140.  
  3141.   (01) Error releasing unused memory
  3142.   (02) Insufficient memory to load CMF file
  3143.   (03) CMF file not found - <filename>
  3144.   (04) CMF file read error
  3145.   (05) Invalid CMF file format - <filename>
  3146.   (10) Command syntax error, type 'SPUTCMF<enter>' for help
  3147.   (12) SBFMDRV.COM driver not loaded, loading temporarily
  3148.   (19) Another SPUTTER player utility is already running
  3149.   (20) Insufficient memory to load SBFMDRV driver
  3150.   (21) Error loading SBFMDRV driver
  3151.   (22) The previous error was detected in an environment variable
  3152.  
  3153.  
  3154.   ****************************************************************************
  3155.                     SECTION 3.6 - SPUTWAVE Waveform viewer
  3156.   ****************************************************************************
  3157.  
  3158.   This section describes the utility SPUTWAVE, which displays an 8-bit
  3159.   PCM sound file as a wave form on the screen.  An EGA display adapter
  3160.   or better is required and it supports the following syntax & switches:
  3161.  
  3162.         sputwave [<drive:>]<filename> [/On] [/Ln]
  3163.  
  3164.   /On
  3165.         N is a byte offset into file where display should start. 
  3166.   /Ln
  3167.         N is the length of data to display in bytes.  This number must
  3168.         be at least the pixel width of the current screen mode
  3169.         (usually 640), and must not be a value that would exceed the
  3170.         end of the file or a run-time error will occur.  The default data
  3171.         length displayed is 1 meg.
  3172.  
  3173.  
  3174.   ****************************************************************************
  3175.                   SECTION 3.7 - SPUTST Smooth Talker Utility
  3176.   ****************************************************************************
  3177.  
  3178.   This section describes the Smooth Talker Device Driver utility named
  3179.   SPUTST.  This program can be used to send commands to the Smooth Talker
  3180.   Device Driver called STDRIVER.SYS loaded in the CONFIG.SYS file.
  3181.  
  3182.   Simply type 'SPUTST' at the DOS prompt followed by any of the allowed
  3183.   three letter commands, separated by spaces.
  3184.  
  3185.                 SPUTST cm1 cm2 cm3
  3186.  
  3187.   Typing just 'SPUTST' or 'SPUTST ?' will print a short help screen.
  3188.  
  3189.   SPUTST vn.nn Smooth Talker Utility - (C) 1991 VersaWare / Adrienne Cousins
  3190.   Voice Master Mode Commands:
  3191.           EVM     enable Voice Master Mode (digitized data)
  3192.           RDH     read VMF file header (supress playback)
  3193.           PLY     playback data file in buffer
  3194.           SPE     set playback speed 0-255
  3195.           VOL     set playback volume 1-8
  3196.           CKE     use 8253 timer for playback speed
  3197.           CKD     use software timing for playback speed
  3198.           DAC     enable alternate port address 0-65535 (def 408+409)
  3199.           WRA     set repeat playback 1-255 0=key
  3200.           USR     use alternate user address 100h-1FFh
  3201.   Smooth Talker Mode Commands:
  3202.           SV2     enable Smooth Talker Mode (SPEECHV2)
  3203.           SV3     enable Smooth Talker Mode (SPEECHV3)
  3204.           ENG     input will be English strings
  3205.           PHO     input will be phonetic strings
  3206.           XEP     convert next string from English to Phonetics
  3207.           TTE     enable echo of string data to screen
  3208.           TTD     disable echo of string data to screen
  3209.           CRE     enable carriage returns as string terminator
  3210.           CRD     disable carriage returns as string terminator
  3211.           FLU     flush the 255 byte string buffer
  3212.           TON     set voice tone 0=low 1=high
  3213.           SPE     set speed of playback 0-9
  3214.           PIT     set pitch of playback 0-9
  3215.           VOL     set volume of playback 0-9
  3216.   Use "COPY <filename> ST" for text files in Smooth Talker Mode
  3217.   Use "COPY <filename>/B ST" for digitized files in Voice Master Mode
  3218.  
  3219.  
  3220.   ****************************************************************************
  3221.                 SECTION 3.8 - SPUTONE DESQview One-window Utility
  3222.   ****************************************************************************
  3223.  
  3224.   This section describes the DESQview shared program called SPUTONE.SHR.
  3225.  
  3226.   This program is used to prevent multiple copies of the Sputter Player
  3227.   window from being run at the same time from the Event Monitor.
  3228.  
  3229.   The PIF file for the Sputter Player Window is called SP-PIF.DVP and comes
  3230.   already configured to use SPUTONE.SHR as a DESQview shared program.
  3231.  
  3232.   When using Change-a-Program to modify the SP-PIF.DVP file, pressing F1
  3233.   to view the advanced options will show SPUTONE.SHR entered as the shared
  3234.   program name.
  3235.  
  3236.  
  3237.   ****************************************************************************
  3238.                         SECTION 4 - MISCELLANEOUS
  3239.   ****************************************************************************
  3240.  
  3241.   --------------------
  3242.   4.1 ACKNOWLEDGEMENTS
  3243.   --------------------
  3244.  
  3245.   I'd like to thank the following people for their wonderful suggestions
  3246.   and help, without whom the SPUTTER Sound System would not be what it is
  3247.   today.
  3248.  
  3249.         Marty Peter, who first got me thinking about writing my own
  3250.         playback program, instead of relying on other player programs
  3251.         to play my custom sound files.  And for his great suggestion
  3252.         about a point-and-shoot interface that gave birth to the
  3253.         SPUTTER File Manager.
  3254.  
  3255.         Rich Wilson, for his suggestion of adding the BEEP event type to
  3256.         SPUTMON the Event Monitor, his suggestion to invoke playback from
  3257.         the DOS prompt, and for his support and friendship.
  3258.  
  3259.         Bernie Parent and Randy Bechtel, who's feedback made me realize
  3260.         the need to support the slower machines running at 4 and 8mhz.
  3261.         This prompted me to develop additional internal speaker drivers
  3262.         to support these machines.
  3263.         
  3264.         Tom Peters, for his sound clips and text files that mentioned the
  3265.         technique of resampling sound files.  This gave me the idea to
  3266.         implement the resampling algorithym, so that the playback rate
  3267.         of a soundfile can be changed so that it can be played on ANY
  3268.         speed machine.
  3269.  
  3270.         Dan Dubbs, for his suggestions to support the Sound Blaster,
  3271.         and AdLib music cards, the ability to spawn user defined programs
  3272.         and batch files from SPUTMON the Event Monitor, and offering many
  3273.         other neat suggestions.
  3274.  
  3275.         Bruce Tomlin, the author of SoundMaster for the Macintosh, for
  3276.         his help in locating the playback rate in Macintosh sound files.
  3277.  
  3278.         Randy Arntzen, for his idea of adding a Keystroke event type
  3279.         to the Event Monitor.
  3280.  
  3281.         Ed Clarke & Gary Levine, for their help in tracking down an
  3282.         elusive bug in the video display routines.
  3283.  
  3284.         John Fortais, for all his help in tracking down a problem with 4DOS,
  3285.         a VDS related bug, and other player bugs.
  3286.  
  3287.         John Blackwell, for his help in tracking down the Norton related bugs.
  3288.  
  3289.         Bob Senzig, for his suggestion of adding support for the Disney
  3290.         Sound Source, his insight on how the hardware works, and his
  3291.         generosity in lending me a unit for testing.
  3292.  
  3293.         Chong and Goh at Creative Labs, for all their help and for posting
  3294.         Sputter on the Creative Labs BBS.
  3295.  
  3296.         Bob Barry, for his suggestion to use +/- keys to change the volume
  3297.         while playing .ROL files, and to add the /SHell switch to SPUTCMF.
  3298.  
  3299.         Jerry Skoff, for all his feedback for improvements to the
  3300.         documentation
  3301.  
  3302.                               Thank you all !!
  3303.  
  3304.  
  3305.   ---------------------
  3306.   4.2 TECHNICAL SUPPORT
  3307.   ---------------------
  3308.  
  3309.   Technical support for Sputter is available to all users, registered and
  3310.   unregistered.  Please report any problems you may have, so that I can
  3311.   address these problems and clear them up.  If you don't report them, I
  3312.   have no way of knowing that Sputter isn't working for you.
  3313.  
  3314.   Also... please don't think any of your questions are silly.  If something
  3315.   about Sputter isn't clear, I'd like to hear about it so I can clarify the
  3316.   documentation.  I am away of the fact that it's quite heavy on detail
  3317.   and I'm trying to improve it with each new release.
  3318.  
  3319.   I would also be interested in seeing any files that SPUTTER is not
  3320.   able to playback correctly.  You can either mail them to me, or upload
  3321.   them to me direct by calling my voice number.
  3322.  
  3323.   Also, let me know if you have a sound board that Sputter doesn't already
  3324.   support, and I'll see what I can do about adding drivers for it.  If
  3325.   Sputter doesn't have a driver for it, chances are I've just never heard of
  3326.   it - or haven't been able to get my hands on one!
  3327.  
  3328.   How you can reach me:
  3329.  
  3330.         Mail:  VersaWare / Adrienne Cousins
  3331.                30 Jennifer Street
  3332.                Littleton, MA 01460
  3333.  
  3334.         Phone: 508-486-3083 (voice) from 9am-5pm (Eastern time)
  3335.                Please call during the day to schedule evening consultations.
  3336.  
  3337.         EMail: Channel 1 BBS in Cambridge MA at 617-354-8873
  3338.                Exec-PC BBS in Milwaukee WI at 414-789-4210
  3339.                Any BBS that carries the RelayNet Adlib conference
  3340.  
  3341.  
  3342.   ----------------
  3343.   4.3 REGISTRATION
  3344.   ----------------
  3345.  
  3346.   You may use The Sputter Sound System free of charge for a period of
  3347.   10 days.  If after that period of time, you find it useful and
  3348.   continue to use it, a $25 registration fee is required.
  3349.  
  3350.   During this evaluation period, the SPUT, SPUTROL and SPUTCMF player programs
  3351.   will display a shareware message and pause for a few seconds after 
  3352.   playback of each file.  
  3353.  
  3354.   When you register, you will receive your own registration number and
  3355.   instructions for unlocking The Sputter Sound System and removing this 
  3356.   message and delay.  You will also be able to unlock all future shareware
  3357.   releases of The Sputter Sound System.
  3358.  
  3359.   To register, just fill out and print the enclosed registration form
  3360.   MAILER.TXT, attach your check and pop it in the mailbox.  Then you will
  3361.   receive your own registration number in the mail.
  3362.  
  3363.   For instant registration, you can call me by phone and I'll be happy
  3364.   to issue a registration number in advance of receiving your check.
  3365.   This will unlock The Sputter Sound System immediately.
  3366.   See the section on Technical Support for the phone number and hours.
  3367.  
  3368.  
  3369.   -------------------------------
  3370.   4.4 SPUTTER FUTURE ENHANCEMENTS
  3371.   -------------------------------
  3372.  
  3373.   See the file FUTURE.TXT for a list of enhancements that I'm planning on
  3374.   implementing in future releases.
  3375.  
  3376.  
  3377.   --------------------------
  3378.   4.5 SOURCES OF SOUND FILES
  3379.   --------------------------
  3380.  
  3381.   Check out the Amiga & Macintosh conferences of your favorite BBS.
  3382.   These areas are usually chuck full of sound files.  Both types of files
  3383.   usually have the playback rate stored within the file.
  3384.  
  3385.   Some of my favorites are:
  3386.  
  3387.         Exec-PC BBS in Milwaukee WI at 414-789-4210
  3388.         Channel 1 BBS in Cambridge MA at 617-354-8873
  3389.  
  3390.   If you find an especially good source of sound files, let me know and
  3391.   I'll add it to this section, so others can enjoy them too.
  3392.  
  3393.  
  3394.   --------------------------
  3395.   4.6 SPEAKER OUTPUT QUALITY
  3396.   --------------------------
  3397.  
  3398.   If the output volume of your speaker is so low that you can't hear much,
  3399.   one solution is to attach an inexpensive amplified speaker similar to
  3400.   those sold by Radio Shack.  These usually have a volume control knob, and
  3401.   some also have a tone control knob.  Most run on batteries, and some can
  3402.   use an optional AC adapter.  All you need to do is attach the two wires
  3403.   from the external speaker to the two wires on the internal speaker, or
  3404.   you can attach mini jacks.
  3405.  
  3406.   For even better playback quality, you can purchase any of the Digital to
  3407.   Analog Converters available on the market.  Some of the ones that I know
  3408.   about are as follows:
  3409.  
  3410.           Sound Source by Disney; 8-bit D/A sound converter that attaches to
  3411.                 the LPT port.  Has amplified speaker with volume knob and
  3412.                 auxilary headphone jack.  Battery is turned on and off
  3413.                 automatically by software. Sells for under $25.
  3414.  
  3415.         Speech Thing by Covox Inc.; 8-bit D/A sound converter that attaches
  3416.                 to the LPT port. Has amplified speaker with volume knob,
  3417.                 auxilary headphone jack, and optional AC jack.
  3418.                 Comes with manual, graphics-based sound editor and Smooth
  3419.                 Talker text-to-speech software. List $79.95
  3420.  
  3421.         Voice Master I by Covox Inc.; 8-bit plug-in board with D/A and
  3422.                 A/D sound converters with DMA capability. Has dual microphone
  3423.                 inputs, speaker output port and volume control knob.
  3424.                 Comes with manual, microphone headset, graphics-based sound
  3425.                 editor. List $149.95
  3426.  
  3427.         Voice Master II by Covox Inc.; same as Voice Master I in an external
  3428.                 box that attaches to the LPT port, without the DMA ability.
  3429.                 Has dual microphone inputs, built in speaker and output port,
  3430.                 volume control knob, tone control knob.  Comes with manual
  3431.                 microphone headset, graphics-based sound editor. List $219.95
  3432.  
  3433.         Adlib Music Synthesizer Card; 8-bit plug-in board with an FM music
  3434.                 synthesizer chip.
  3435.  
  3436.         Sound Blaster by Creative Labs; 8-bit plug-in board with an FM music
  3437.                 synthesizer chip (AdLib compatible) and an intelligent DAC
  3438.                 with DMA capability for playing and recording digitized sound
  3439.                 files.  Has stereo output port, microphone port, volume
  3440.                 control knob, proprietary hardware decompression, standard
  3441.                 joystick port and built-in MIDI interface.  Includes manual,
  3442.                 and stereo cables with RCA jacks.
  3443.  
  3444.   --------------
  3445.   4.7 DISCLAIMER
  3446.   --------------
  3447.  
  3448.   All of the SPUTTER programs and this documentation are Copyright 1990-1991
  3449.   by VersaWare and Adrienne Cousins, all rights reserved.
  3450.  
  3451.   VersaWare hereby disclaims all warranties relating to this product,
  3452.   whether express or implied, including without limitation any implied
  3453.   warranties of merchantability or fitness for a particular purpose.
  3454.   VersaWare cannot and will not be liable for any special, incidental,
  3455.   consequential, indirect or similar damages due to loss of data or any
  3456.   other reason, even if VersaWare or an authorized VersaWare agent has
  3457.   been advised of the possibility of such damages.  In no event shall the
  3458.   liability for any damages ever exceed the price paid for the license to
  3459.   use software, regardless of the form and/or extent of the claim.  The
  3460.   person using the software bears all risk as to the quality and performance
  3461.   of the software.
  3462.  
  3463.  
  3464.                  -------------------------------------------
  3465.  
  3466.  
  3467.  
  3468.