home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / CHSNDV11.ZIP / CHATSND.DOC next >
Text File  |  1995-02-24  |  8KB  |  193 lines
  1.  
  2.                 Chatsound Test II v1.1
  3.  
  4.         Copyright (c) 1994-1995 by Adam Harvey/Inphact Software
  5.                  All Rights Reserved.
  6.  
  7.  
  8. Introduction
  9. ════════════─────────────────────────────────────────────────────────────────
  10.  
  11.    I began this program when I was having trouble finding the correct
  12.  settings for void chatsound() while writing an emergency chat mod for
  13.  WWIV v4.23.  The void chatsound() is a 10-15 line piece of code in the WWIV
  14.  source, which, when given six integers, will play a "wheeping" sound locally
  15.  to get the SysOp's attention.  I just couldn't get the "wheep" to sound like
  16.  what I thought an emergency chat page should sound like.  After changing
  17.  the integers about 20 times and compiling each time, I decided there had to
  18.  be an easier way.  I quickly wrote up Chatsound Test.  It was a small
  19.  text-based program that when you entered 6 numbers it played the sound and
  20.  quit.  I decided it'd be a fun project and possibly helpful for other SysOps
  21.  if I modified the program, made it graphical, and a lot easier to use.
  22.  So Chatsound Test II was born.
  23.  
  24.  
  25. Description
  26. ═══════════──────────────────────────────────────────────────────────────────
  27.  
  28.    Chatsound Test II is for WWIV SysOps who would like to quickly find the
  29.  exact settings for calling void chatsound while modifying their registered
  30.  WWIV BBS.  The void may be used anywhere in the source code, and is called
  31.  like this:
  32.  
  33.     chatsound(10,200,5,15,40,5);
  34.  
  35.  ■ The first number is the Starting Frequency.  This is, obviously, where
  36.    the sound will start.
  37.  ■ The second number is the Ending Frequency.  This is the point at which the
  38.    sound will end.
  39.  ■ The third number is the amount to change.  If this number is, for example,
  40.    2, the void chatsound() will start at the Starting Frequency, and play
  41.    a sound, then go up 2 frequencies each time until it reaches the Ending
  42.    Frequency.
  43.  ■ The fourth number is the first delay.  This delay determines how long to
  44.    play the current frequency before it changes to the next highest.
  45.  ■ The fifth number is the second delay.  This delay is how long the sound 
  46.    will pause in between repeating the play loop.
  47.  ■ And finally, the sixth number is the number of times you wish the loop
  48.    to repeat.
  49.  
  50.  NOTE:  If you enter a string, try testing it, and find that nothing happens
  51.     (or basically nothing happens), don't worry.  There are a few times
  52.     when the settings don't make any sounds.  For example, if you make 
  53.     the Starting Frequency higher than the Ending, nothing will happen.
  54.     Just don't worry.  The program DOES work.  :)
  55.  
  56.    If you are not sure how you wish to set these categories, it is very easy
  57.  to edit and test them using Chatsound Test II.
  58.  
  59.  
  60. Program Commands
  61. ═════════════════────────────────────────────────────────────────────────────
  62.  
  63.  ■ UP ──────── Move the edit cursor up and down over the categories and the
  64.  ■ DOWN        Test Sound box.
  65.  
  66.  ■ TAB ─────── Move the edit cursor to the next category.
  67.  
  68.  ■ ESCAPE ──── Quit at any time.
  69.  ■ Q
  70.  
  71.  ■ ? ───────── Bring up the help/information screens.
  72.  
  73.  ■ BACKSPACE ─ Abort viewing the help/information screens.
  74.  
  75.  ■ RETURN ──── Edit the currently highlighted category.  (Also aborts edit)
  76.  
  77.  ■ T ───────── Test the sound using the current settings.
  78.  
  79.  ■ SPACE ───── Test the sound using the current settings if the Test Sound
  80.  ■ RETURN      box is marked.
  81.  
  82.  
  83. Copyright/License
  84. ═════════════════────────────────────────────────────────────────────────────
  85.  
  86.    This document and the program files ("the software") are copyrighted by
  87.  the author.  The copyright owner hereby licenses you to use the software
  88.  given these restrictions:
  89.  
  90.     ■ The software shall be supplied in its original, unmodified form, which
  91.       includes this documentation;
  92.  
  93.     ■ The software may not be included or bundled with other goods or
  94.       services unless specific permission is first obtained in writing
  95.       from the author;
  96.  
  97.     ■ No fee is charged; an exception is granted to non-profit user's
  98.       groups, which are permitted to charge a small fee (not to exceed $5)
  99.       for materials, handling, postage, and general overhead.  No other
  100.       organization is permitted to charge any amount for distribution of
  101.       copies of the software or documentation, or to include copies of the
  102.       software or documentation with sales of their own products.
  103.  
  104.   The software and documentation are Copyright (c) 1994-1995 by Adam Harvey
  105.  
  106.  
  107. Disclaimer
  108. ══════════───────────────────────────────────────────────────────────────────
  109.  
  110.  The author makes no warranties, expressed or implied, as to the quality or
  111.  performance of this program.  Your use of this program constitutes your
  112.  release of the author from liability or litigation for any indirect or
  113.  consequential damages arising from the use of this program or its associated
  114.  files.
  115.  
  116.  In no event will the author be liable to you for any damages, including any
  117.  lost profits, lost savings or other incidental or consequential damages
  118.  arising out of your use or inability to use the program, or for any claim by
  119.  any other party.
  120.  
  121.  The WWIV source code cannot be modified or possesed by a non-registered
  122.  user.  If you have a copy of the source code, are editing it for someone
  123.  else, or are using a compiled version of the source and are not a registered
  124.  WWIV SysOp yourself, then you are using/holding the program illegally!
  125.  
  126.  
  127. Revision Information
  128. ════════════════════─────────────────────────────────────────────────────────
  129.  
  130. Version 0.19.5ß (1/3/95)
  131.   ■ Spotnick fixed the getch() crash and cleaned up some of the code.
  132.  
  133. Version 0.34ß (1/8/95)
  134.   ■ Support for monochrome monitors.  Edit highlight color is different so
  135.     if the monitor is black and white, you can see which category is being
  136.     edited.  (Thanks, Moody!)
  137.  
  138. Version 1.0 (1/11/95)
  139.   ■ Initial release
  140.  
  141. Version 1.1 (2/24/95)
  142.   ■ Cleaned up a few pieces of code
  143.   ■ Documentation updated
  144.   ■ Added 'Q' to allow Quit
  145.  
  146.   ─────
  147.  
  148.   This program has been tested on a 486 and 386 machine in both MS-DOS and
  149.   Windows and has not encountered problems.  It has not been tested on any
  150.   286 machine.  If you have a 286, and find that you cannot run the program,
  151.   please contact me!
  152.  
  153. Credits
  154. ═══════──────────────────────────────────────────────────────────────────────
  155.  
  156.   ■ WWIV BBS Software Copyright (c) 1988-1994 by Wayne Bell.  Portions of
  157.     his code (the void chatsound) are used in this program.
  158.   ■ MS-DOS and Windows are trademarks of the Microsoft Corporation.
  159.   ■ Chris McRae for some of the documentation info and disclaimers.
  160.   ■ Mike Vitale for his comments, help, and acting like he wasn't bored.
  161.   ■ Virus for the piece of code he gave me when the getch() function was
  162.     crashing.  It is no longer used, but he helped a lot.  Let's see what's
  163.     in store in the future...
  164.   ■ Dark Shadow for showing me how to print the ANSI files.
  165.   ■ Spotnick for figuring out the getch() crash and making some of the
  166.     code cleaner.
  167.   ■ Moody for pointing out that anyone using a monochrome monitor or who
  168.     was color blind could not tell which category was being edited.
  169.  
  170.  
  171. Contact & Donation Information
  172. ══════════════════════════════───────────────────────────────────────────────
  173.  
  174.  How to contact the author:
  175.  
  176.    WWIVnet ─── 1@10220
  177.    FarLink ─── 1@1
  178.    TriNet ──── 1@4
  179.    Internet ── aharvey@nerc1.nerc.com
  180.    BBS ─────── The Far Site BBS [ASV] ∙ (609)921-9450
  181.  
  182.  If you would like to support Inphact Software and possible future projects,
  183.  please feel free to donate!  Make checks payable to Adam Harvey.  I'd also
  184.  like to hear from you if you use this program:  bug reports, possible
  185.  feature additions, or just saying "hi."  Send snail mail to:
  186.  
  187.     Adam Harvey
  188.     c/o Inphact Software
  189.     26 Hornor Lane
  190.     Princeton, NJ  08540-3937
  191.  
  192. ────────────────────────────────══ [EOF] ══──────────────────────────────────
  193.