Sound a speaker tone for a specified frequency and duration

     TONE(<nFrequency>, <nDuration>) --> NIL


     <nFrequency> is a positive numeric value indicating the frequency of
     the tone to be sounded.

     <nDuration> is a positive numeric value indicating the duration of
     the tone measured in increments of 1/18 of a second.  For example, an
     <nDuration> value of 18 represents one second.

     For both arguments, non-integer values are truncated--not rounded--to
     their integer portion.


     TONE() always returns NIL.


     TONE() is a sound function that indicates various program states to the
     user.  These can be error states, boundary conditions, or the end of a
     time-consuming process.  For example, an error state would sound an
     error tone before alerting the user with a message or interactive dialog
     box.  A boundary condition might indicate that the user is attempting to
     move the cursor past the top or bottom of a column in a TBrowse object.
     A batch process also might indicate its completion with a sound to alert
     the user, in case the user has turned away from the screen.

     TONE() works by sounding the speaker at the specified frequency for the
     specified duration.  The duration is measured in increments of 1/18 of a
     second.  The frequency is measured in hertz (cycles per second).
     Frequencies of less than 20 are inaudible.  The table below shows the
     frequencies of standard musical notes.

     Note:  TONE() works only on IBM PC and 100 percent compatible

     Table of Musical Notes
     Pitch   Frequency    Pitch     Frequency
     C       130.80       mid C     261.70
     C#      138.60       C#        277.20
     D       146.80       D         293.70
     D#      155.60       D#        311.10
     E       164.80       E         329.60
     F       174.60       F         349.20
     F#      185.00       F#        370.00
     G       196.00       G         392.00
     G#      207.70       G#        415.30
     A       220.00       A         440.00
     A#      233.10       A#        466.20
     B       246.90       B         493.90
                          C         523.30


     .  This example is a beep function that indicates that a batch
        operation has completed:

        FUNCTION DoneBeep
           TONE(300, 1)
           TONE(100, 1)
           TONE(300, 1)
           TONE(100, 1)
           RETURN NIL

     .  This example is a tone sequence that indicates invalid
        keystrokes or boundary conditions:

        FUNCTION ErrorBeep
           TONE(100, 3)
           RETURN NIL

 Files   Library is EXTEND.LIB, source file is SOURCE\SAMPLE\EXAMPLEA.ASM.

See Also: SET BELL

One response to “C5_TONE

  1. Pingback: C5 Environment | Viva Clipper !

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.