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
- See Also