home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / annc_12.zip / ANNOUNCE.DOC next >
Text File  |  1994-09-01  |  9KB  |  201 lines
  1.  ┌──────┐ ┌───┐  ┌─┐ ┌───┐  ┌─┐ ┌──────┐ ┌─┐ ┌─┐ ┌───┐  ┌─┐ ┌─────┐ ┌─────┐
  2.  │ ┌──┐ │ │   └┐ │ │ │   └┐ │ │ │ ┌──┐ │ │ │ │ │ │   └┐ │ │ │ ┌─┐ │ │ ┌───┘
  3.  │ └──┘ │ │ ├┐ └┐│ │ │ ├┐ └┐│ │ │ │  │ │ │ │ │ │ │ ├┐ └┐│ │ │ │ └─┘ │ └─┐
  4.  │ ┌──┐ │ │ │└┐ └┤ │ │ │└┐ └┤ │ │ │  │ │ │ │ │ │ │ │└┐ └┤ │ │ │ ┌─┐ │ ┌─┘
  5.  │ │  │ │ │ │ └┐   │ │ │ └┐   │ │ └──┘ │ │ └─┘ │ │ │ └┐   │ │ └─┘ │ │ └───┐
  6.  └─┘  └─┘ └─┘  └───┘ └─┘  └───┘ └──────┘ └─────┘ └─┘  └───┘ └─────┘ └─────┘tm
  7.  
  8.     The Audio Batch Enhancer!
  9.     Spice up your batch files!
  10.     Spice up your life!
  11.  
  12.  
  13.     ANNOUNCE  ver 1.2      (c)1991,94 Steven L. Brenner
  14.  
  15.     ANNOUNCE is a copyrighted program and is NOT public domain or freeware.
  16.  
  17.  
  18.     What ANNOUNCE does
  19.     ==================
  20.     In short - plays sounds using your built in internal PC speaker.
  21.     How loud it plays depends on the location of your PC speaker in your PC
  22.     and how you PC case is situated.
  23.  
  24.  
  25.     What ANNOUNCE doesn't do
  26.     ========================
  27.     ANNOUNCE aside for Help, or error messages does NOT write ANY information
  28.     to the screen.  This was done to help keep the size of the program down
  29.     and not interfer with its use in batch files/menu systems, etc.
  30.  
  31.  
  32.     ANNOUNCE parameters/options
  33.     ===========================
  34.     Usage: ANNOUNCE [options] [loop condition]
  35.           Options:/? /c /d /e /h /n /r /v /rs
  36.                   /?   = HELP      (this informaiton)
  37.                   /c # = chirp     (#=number of chirps)
  38.                   /d   = done
  39.                   /e   = error
  40.                   /h   = HELP      (this display)
  41.                   /n # = next      (#=number of notes played, default=3)
  42.                   /r # = random    (#=number of notes played, default=10)
  43.                   /v # = violation (#=number of cycles, default=5)
  44.                   /rs  = randomly select an ANNOUNCE selection
  45.           Loop condition:/x # #
  46.                   /L # # = loop (repeat) until any key is hit
  47.                            1st #=number of seconds between loops
  48.                                  If # not specified, default is 15 sec loop
  49.                            2nd #=number of times to loop, unless a key is hit
  50.                                  Default is loop until any key is hit
  51.  
  52.           Loop returns error condition of 0 if key is hit, 1 if loop times out
  53.  
  54.           default is /d (1 time, no loops)
  55.           '/' is optional and has no effect
  56.  
  57.     NOTE: the naming scheme for the selections are in part decriptive and in
  58.           part what I used the selection to represent.
  59.  
  60.  
  61.     Examples of using ANNOUNCE
  62.     ==========================
  63.     ANNOUNCE V 3 L 10 1000
  64.         Plays 'violation' 3 times, every 10 seconds for 1000 times
  65.         (loops 1000 times) unless a key is hit.
  66.  
  67.         If a key is NOT hit, the DOS ERRORLEVEL is set at 1 when ANNOUNCE
  68.         times-out and exists to DOS.
  69.         If a key is hit the DOS errorlevel is set at 0.
  70.  
  71.         You can check for a timed-out loop in your batch files by using the
  72.         line:
  73.         IF ERRORLEVEL=1 GOTO ERROR_LABEL
  74.         Where 'ERROR_LABEL' is a goto label in your batch file.  See DEMO.BAT
  75.         for a working example of this.  If you are using DOS version 5.0 or
  76.         higher you can type 'HELP BATCH' at the DOS prompt for help with batch
  77.         files or refer to your DOS manuals (yech).
  78.  
  79.     ANNOUNCE N
  80.         Plays 'next' - 3 notes the default number.
  81.  
  82.     ANNOUNCE C 1 L 2 100
  83.         Plays 'chirp' 1 time, every 2 seconds for 100 times
  84.         (loops 100 times) unless a key is hit.
  85.         See 1st example for information on looping, time-outs, etc.
  86.  
  87.     ANNOUNCE R 9 L 1 999999
  88.         Plays 'random' 9 time, every 1 second for 999999 times
  89.         (loops 999999 times) unless a key is hit.
  90.         See 1st example for information on looping, time-outs, etc.
  91.  
  92.     WARNING: for selections of 'next', 'random', and 'violation'
  93.              If you select too high a number for number of notes played
  94.              (the optional 2nd value, see ANNOUNCE parameters above), for
  95.              example: ANNOUNCE R 999999
  96.              You WILL lockup your PC until ANNOUNCE finishes playing.  Which
  97.              could be a LONG, LONG time.  Hitting a key will have no effect
  98.              until the selected number of notes has finished playing, THEN if
  99.              you have hit a key ANNOUNCE will exit to DOS.
  100.              --------------
  101.              If you want a continous stream of playing - set the number of
  102.              notes so that they are longer than a second and set the loop time
  103.              for 1 second.  In the example above:
  104.                 ANNOUNCE R 9 L 1 999999
  105.              will play a continous stream of 8999991 notes unless someone
  106.              hits a key on the keyboard (or shoots your PC).
  107.              --------------
  108.  
  109.  
  110.     Why ANNOUNCE came into being.
  111.     =============================
  112.        I was working PC support in a company that had about 50 PCs, most of
  113.     which were not on a network.  Periodically I would have to perform
  114.     software upgrades (we had a number of custom inhouse applications) on
  115.     all PCs and if I installed them all myself I would loose the better part
  116.     of a day or more just going from station to station swapping disks.
  117.        The obvious solution was to create an installation package and at the
  118.     appropriate time use CTRL-G to have the computer beep and post a screen
  119.     message saying 'Please insert the 2nd disk now' or whatever was
  120.     appropriate, then when finished have the user pass the disks on to the
  121.     next PC station.
  122.        THE PROBLEM IS THAT THIS NEVER WORKED.
  123.        One application which was updated every 2 weeks required a 3 disk
  124.     installation package (yes, the files were compressed) and even with
  125.     elaberate screen messages and personal instructions to the users, I
  126.     would come back hours later to find the update disks at the first or
  127.     second PC, at disk one or two and the PC user blissfully ignoring the
  128.     screen messages.
  129.        So I created ANNOUNCE.  When the first disk finished installing, a
  130.     message was posted on the screen like "Please Insert Disk #2, and Hit
  131.     Any Key" and ANNOUNCE was called.  I had ANNOUNCE set to play the 'next'
  132.     medly ever 10 seconds for 5 minutes (ANNOUNCE n /L 10 30).  If the user
  133.     followed the instructions ANNOUNCE would stop when the keyboard was hit,
  134.     otherwise after 5 minutes I would have ANNOUNCE play something a little
  135.     more catchy/obnoxious like 'chirp' 5 times every minute.  If the user
  136.     inserted the wrong disk in, I had ANNOUNCE play something different.
  137.        Well it worked!  The first time I used it I got a page from one of the
  138.     users asking why her PC was chirping.  After the first few PCs I had
  139.     users from other stations assisting any one who was slow or confused.
  140.     This resolved one of my biggest headaches.
  141.  
  142.     Registering ANNOUNCE
  143.     ====================
  144.     This program is NOT public domain or freeware!
  145.  
  146.     Please register your copy of ANNOUNCE by sending $5.00
  147.     (check or money order, no cash please) to:
  148.  
  149.          Steven L. Brenner
  150.          13591 Sioux Rd.
  151.          Westminster, CA. 92683
  152.  
  153.     See ANNOUNCE.REG for registration from and more info.
  154.     If you can not afford the full registration, send what you can.
  155.  
  156.     For use by corporations and other institutions, please contact me for a
  157.     licensing arrangement.  Customizing and other special licensing are
  158.     available upon request.
  159.  
  160.     If you have comments, suggestions, etc. I would appreciate hearing from
  161.     you.  I can also be contacted on CompuServe at id# 71051,3035
  162.  
  163.  
  164.     Warranty/Disclaimer
  165.     ===================
  166.     This document and the program files ANNOUNCE.EXE and ANNOUNCE.BAT ("the
  167.     software") are copyrighted by the author.  The copyright owner hereby
  168.     licenses you to use the software given these restrictions:
  169.  
  170.           o  the program shall  be supplied in its  original, unmodified 
  171.              form, which includes this documentation; 
  172.  
  173.           o  for-profit use without a license is prohibited; 
  174.  
  175.           o  the program may not be included - or bundled - with other
  176.              goods or services.  Exceptions may be granted upon written
  177.              request only. 
  178.  
  179.           o  no fee is charged;  an exception is granted to not for profit
  180.              user's groups, which are permitted to charge a small fee (not to
  181.              exceed  $5) for materials, handling, postage, and general
  182.              overhead.   No other organization is permitted to charge any
  183.              amount for distribution of copies of the software or
  184.              documentation, or to include copies of the software or
  185.              documentation with sales of their own products.
  186.  
  187.     There is no warranty  of any kind.  The  copyright owner may not be
  188.     held liable for any damages, including any lost profits or other
  189.     incidental or consequential damages arising out of or inability to
  190.     use the software.  By using the software, you agree to this. 
  191.  
  192.  
  193.     Copyright information
  194.     =====================
  195.     The software and documentation are: 
  196.  
  197.                 Copyright (C) 1991-1994 by
  198.                    Steven L. Brenner
  199.                    13591 Sioux Rd.
  200.                    Westminster, CA. 92683
  201.