Functions and Directives Functions and Directives

Function Sound() Foundation

Creates one or more tones of specified frequency and duration.

Syntax
Sound( <nFrequency|cToneSeries>, ;  // Type: NC
       [<nDuration|lTimer>]    , ;  // Type: NL
       [<lTimer>]                ;  // Type:  L   Default: .F.
     ) --> cNullString
Description

Sound() can be called in either of two ways:

A:

Sound( <nFrequency>, [<nDuration>], [<lTimer>] )

This creates a single tone of <nFrequency> Hertz. <nDuration> is the length of the tone signal in 1/100 seconds (<lTimer>==.F.) or in 1/18.2 seconds (<lTimer>==.T.)

B:

Sound( <cToneSeries>, [<lTimer>] )

Here <cToneSeries> is a string which encodes a series of tones in binary format. Both <nFrequency> and <nDuration> are defined as two byte values as returned by I2bin(). So each four bytes in the string define one tone of the specified frequency and duration. <lTimer> defines the unit for <nDuration> as under A.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.