Carbon


GetSpeechPitch

Header: SpeechSynthesis.h Carbon status: Supported

Determines a speech channel’s current speech pitch.

OSErr GetSpeechPitch (
    SpeechChannel chan, 
    Fixed *pitch
);
Parameter descriptions
chan

The speech channel whose pitch you wish to determine.

pitch

On return, a pointer to the current pitch of the voice in the speech channel, expressed as a fixed-point frequency value.

function result

A result code.

DISCUSSION

Typical voice frequencies range from around 90 hertz for a low-pitched male voice to perhaps 300 hertz for a high-pitched child’s voice. These frequencies correspond to approximate pitch values in the ranges of 30.000 to 40.000 and 55.000 to 65.000, respectively. For information about the mathematical relationship between pitches and frequencies expressed in hertz.

SPECIAL CONSIDERATIONS

You can call the GetSpeechPitch function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)