Chapter 4 - Speech Manager / Speech Manager Reference

Legacy Document

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.

Voice Specification Records
A voice specification record provides a unique specification that you must use to obtain information about a voice. You also must use a voice specification record if you wish to create a speech channel that generates speech in a voice other than the current system default voice. The VoiceSpec data type defines a voice specification record. In Pascal, the VoiceSpecPtr data type defines a pointer to a voice specification record. The VoiceSpecPtr data type is not defined in the interface files for C programmers. If you are programming in C and you need to pass a variable of type VoiceSpecPtr to a Speech Manager routine, simply pass a pointer to a voice specification record instead.
TYPE VoiceSpec =
RECORD
   creator:    OSType;        {ID of required synthesizer}
   id:         OSType;        {ID of voice on the synthesizer}
END;
Field Description

creator
The synthesizer that is required to use the voice. This is equivalent to the value contained in the synthManufacturer field of a speech version information record and that contained in the synthCreator field of a speech extension data record. The set of OSType values specified entirely by space characters and lowercase letters is reserved.
id
The voice ID of the voice for the synthesizer. Every voice on a synthesizer has a unique ID.
IMPORTANT
To ensure compatibility with future versions of the Speech Manager, you should never fill in the fields of a voice specification record yourself. Instead, you should create a voice specification record by using the MakeVoiceSpec function.