(Page 14 of 17 in this chapter)

ttsSpeak

Description

Speaks text from a single memory-resident buffer.

Prototype

DWORD ttsSpeak(CTAHD ctahd,
char* buffer)
ctahd CT Access context handle returned by ctaCreateContext.
buffer Pointer to a text buffer that the converter speaks. The buffer must be a null terminated text string.

Return Values

SUCCESSThe function has been successfully initiated.
CTAERR_INVALID_STATEText-to-speech is taking place on the specified context.

Events

TTSEVN_SPEAK_DONEThis event is generated when text-to-speech terminates. The event value field contains one of the following:

CTA_REASON_FINISHEDCommand execution completed successfully.

CTA_REASON_STOPPEDSpeech was stopped with ttsStop.

TTSERR_CANT_CONNECT_PCM_OUTPUTThe text-to-speech instance cannot find a PCM channel for the speech output.
TTSERR_CANT_DISCONNECT_PCM_OUTPUT Speech has taken place, but the text-to-speech instance cannot disconnect from the PCM channel.

Details

This function speaks text from a text buffer held in host memory. Text from documents must be read into text buffers before being passed to ttsSpeak. These buffers must end with null terminated strings.
Active speech can be paused or stopped with the functions ttsPause or ttsStop. ttsPause pauses speech until it is resumed with ttsResume. ttsStop interrupts speech and releases the current buffer.
Applications must not free or reuse the speech buffer until the TTSEVN_SPEAK_DONE event is returned.

See Also

ttsPause, ttsResume, ttsSetGain, ttsSetPitch, ttsSetSpeed, ttsStop

(Page 14 of 17 in this chapter)

tech_support@nmss.com

Copyright © 1997, Natural MicroSystems, Inc. All rights reserved.