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.
TextToPhonemes
You can use theTextToPhonemes
function to convert textual data into phonemic data.
FUNCTION TextToPhonemes (chan: SpeechChannel; textBuf: Ptr; textBytes: LongInt; phonemeBuf: Handle; VAR phonemeBytes: LongInt): OSErr;
chan
- A speech channel whose associated synthesizer and voice are to be used for the conversion process.
textBuf
- A pointer to a buffer of text to be converted.
textBytes
- The number of bytes of text to be converted.
phonemeBuf
- A handle to a buffer to be used to store the phonemic data. The
TextToPhonemes
function may resize the relocatable block referenced by this handle.phonemeBytes
- On exit, the number of bytes of phonemic data written to the handle.
DESCRIPTION
TheTextToPhonemes
function converts thetextBytes
bytes of textual data pointed to by thetextBuf
parameter to phonemic data, which it writes into the relocatable block specified by thephonemeBuf
parameter. If necessary,TextToPhonemes
resizes this relocatable block. TheTextToPhonemes
function sets thephonemeBytes
parameter to the number of bytes of phonetic data actually written.
The data returned by
- WARNING
- If the textual data is contained in a relocatable block, a handle to that block must be locked before the
TextToPhonemes
function is called.TextToPhonemes
corresponds precisely to the phonemes that would be spoken had the input text been sent toSpeakText
instead. All current mode settings for the speech channel specified bychan
are applied to the converted speech. No callbacks are generated while theTextToPhonemes
routine is generating its output.SPECIAL CONSIDERATIONS
Because theTextToPhonemes
function might move memory, you should not call it at interrupt time.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for theTextToPhonemes
function are
Trap macro Selector _SoundDispatch
$0A5C000C RESULT CODES