Previous Book Contents Book Index Next

Inside Macintosh: Sound /
Chapter 4 - Speech Manager / Speech Manager Reference


Legacy Documentclose button

Important: Inside Macintosh: Sound is deprecated as of Mac OS X v10.5. For new audio development in Mac OS X, use Core Audio. See the Audio page in the ADC Reference Library.

Data Structures

This section describes the data structures defined by the Speech Manager.

The speech channel record contains information internal to the Speech Manager. Speech channels, which process Speech Manager text and commands, are defined as pointers to Speech Manager records.

A voice specification record provides a unique specification of a voice. You can create such a record with the MakeVoiceSpec function and then pass it to the GetVoiceDescription function to obtain information about the voice. This information is contained in a voice description record. Or, you can use the GetVoiceInfo function to obtain information about the file that stores a voice. This information is contained in a voice file information record.

By using the GetSpeechInfo function, you can obtain information about a speech channel, as well as information about its synthesizer. Such information is returned in speech status information records, speech error information records, and speech version information records.

The GetSpeechInfo function also allows you to obtain information about the phonemes defined for a synthesizer. Information about a single phoneme is contained in a phoneme information record. A phoneme descriptor record contains phoneme information records for all of the phonemes that a synthesizer supports.

Synthesizers that use the GetSpeechInfo or SetSpeechInfo function to allow exploitation of synthesizer-specific features often require that data passed to it be formatted in a particular way. The speech extension data record allows your application to exchange data in any format with a synthesizer.

The SpeakString, SpeakText, and SpeakBuffer functions can process both text and commands embedded in that text. So that commands can be distinguished from text, the commands must be enclosed by command delimiters. The delimiter information record allows your application to change the command delimiters.


Subtopics
Voice Specification Records
Voice Description Records
Voice File Information Records
Speech Status Information Records
Speech Error Information Records
Speech Version Information Records
Phoneme Information Records
Phoneme Descriptor Records
Speech Extension Data Records
Delimiter Information Records

Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996