Converts the specified text string into its equivalent phonemic representation.
- macOS 10.5+
A speech channel whose associated synthesizer and properties are to be used in the conversion process.
The text from which to extract phonemic data.
On return, a
CFStringobject that contains the extracted phonemic data. The caller is responsible for releasing this object.
A result code. See Result Codes.
Copy function is the Core Foundation-based equivalent of the
Converting textual data into phonemic data is particularly useful during application development, when you might wish to adjust phrases that your application generates to produce smoother speech. By first converting the target phrase into phonemes, you can see what the synthesizer will try to speak. Then you need correct only the parts that would not have been spoken the way you want.
The data the
Copy function stores in the
phonemes parameter corresponds precisely to the phonemes that would be spoken had the input text been sent to
Speak instead. All current property settings for the speech channel specified by
chan are applied to the converted speech. No callbacks are generated while the
Copy function is generating its output.