Carbon


SetSpeechRate

Header: SpeechSynthesis.h Carbon status: Supported

Sets the speech rate of a designated speech channel.

OSErr SetSpeechRate (
    SpeechChannel chan, 
    Fixed rate
);
Parameter descriptions
chan

The speech channel whose rate you wish to set.

rate

The new speech rate for the speech channel, expressed as a fixed-point, words-per-minute value.

function result

A result code.

DISCUSSION

The SetSpeechRate function adjusts the speech rate on the speech channel specified by the chan parameter to the rate specified by the rate parameter. As a general rule, typical speaking rates range from around 150 words per minute to around 180 words per minute. It is important to keep in mind, however, that users will differ greatly in their ability to understand synthesized speech at a particular rate based upon their level of experience listening to the voice and their ability to anticipate the types of utterances they will encounter.

SPECIAL CONSIDERATIONS

You can call the SetSpeechRate 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)