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