Click above to get retro games delivered to your door ever month!

TONE()

Sound a tone with a specified frequency and duration.
---------------------------------------------------------------------------------

 Syntax

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

 Arguments

        <nFrequency>    A non-negative numeric value that specifies the 
                  frequency of the tone in hertz.

        <nDuration>     A positive numeric value which specifies the 
                  duration of the tone in 1/18 of a second units.

 Returns

        TONE()   always returns NIL.    

 Description

      TONE() is a sound function that could be used to irritate the end
      user, his or her dog, and the surrounding neighborhood. The
      frequency  is clamped to the range 0 to 32767 Hz.

 Examples

      If lOk   // Good Sound
         TONE(  500, 1 )
         TONE( 4000, 1 )
         TONE( 2500, 1 )
      Else     // Bad Sound
         TONE(  300, 1 )
         TONE(  499, 5 )
         TONE(  700, 5 )
      EndIf
      

 Tests

      TONE( 800, 1 )                         // same as ? CHR(7)
      TONE( 32000, 200 )                     // any dogs around yet?
      TONE( 130.80, 1 )                      // musical note - C
      TONE( 400, 0 )                         // short beep
      TONE( 700 )                            // short beep
      TONE( 10, 18.2 )                       // 1 second delay
      TONE( -1 )                             // 1/18.2 second delay
      TONE( )                                // 1/18.2 second delay
  

 Tests


Status

      Started

 Compliance

      TONE() works exactly like CA-Clipper's TONE().

 Platforms

      All

 Files

      Library is rtl