Contents of the SOUND2.DOC file
SOUNDER Version 2.0
Copyright 1991 by Chuck Steenburgh
Did you ever want to include beeps and tones in your batch files?
For years, programs with names like BEEP.COM have been floating around,
producing annoying high-pitched squeals in batch files. While these
have generally done the trick, after a while the repetitious sound gen-
erated by these utilities gets on one's nerves.
Different variations of the basic BEEP.COM program tried in vain
to find that "most pleasing tone" that would not annoy you, but still
alert you to a potential danger. After all, a BEEP.COM that plays
"love story" sounds great, but doesn't exactly grab your attention when
used to warn you that you're about to reformat your hard drive.
SOUNDER to the rescue! SOUNDER makes absolutely no claim about
not producing annoying tones. In fact, SOUNDER has ten different annoy-
ing tones, just for you! SOUNDER is different from the standard BEEP.COM
program in that it randomly varies not only the frequency of the tone that
you hear, but also the number of tones heard. In my experience, no mat-
ter how "perfect" the tone in question is, after a few dozen repetitions
it really begins to sound terrible. SOUNDER will produce from one to
three distinct tones, and sound them for a total length of approximately
1/2 second (this is on a 12Mhz XT, expect variations due to hardware).
This way, you still getting that eye-catching (ear-catching?) sound, but
with enough variation so that it doesn't really get to be all that annoy-
ing. 1,110 different tone combinations are possible.
To use this program in your batch files, simply put the program where
your machine can find it (in the current directory or on the DOS path) and
add the line "SOUND2" to your batch file in the appropriate place.
Beginning with Version 2.0, SOUNDER accepts command line arguments to
specify tone frequency and duration for producing a single tone. Use the
where freq=frequency in hz and dur=duration in 1/18 seconds. Entering
SOUND2 without arguments produces the random tone(s) described above. For
SOUND2 440 18 (produces a 440hz tone for 1 second)
SOUND2 (produces 1 to 3 random tones for 1 second)
Error messages: SOUNDER 2.0 will produce an error message if command
line parameters are improperly entered.
"Incorrect number of parameters"- you MUST enter the FREQUENCY and the
DURATION on the command line, or no arguments at all. You may enter addi-
tional arguments but they will be ignored.
"Parameter outside allowable range"- the allowable range for the two
parameters is as follows:
The frequency limits are imposed by hardware and the human ear. The
duration limit was added to prevent you from accidentally sounding a tone
for more than five or six seconds. (I wouldn't want to be the cause of
someone's computer moaning for ten minutes because they accidentally re-
versed their parameters.) If this arbitrary limit presents a problem,
please let me know and I can change or eliminate it.
Like other utilities that I have written, you are free to use and
distribute this file as much as you like. While registration is not
required, a voluntary contribution of $5 will be greatly appreciated and
will motivate me to produce enhanced versions of this program. Sending
in your $5 donation will also get you the latest copy of MARGARINE (cur-
rently 1.20), my simple text file formatting aid.
This documentation file was formatted using MARGARINE 1.20, producing
the nifty left margin you see here.
304A N. Main Street
Lexington, VA 24450