(Page 4 of 17 in this chapter)


ttsJump

Description

Moves the current position of speech within a text buffer supplied to ttsSpeak.

Prototype

DWORD ttsJump(CTAHD ctahd,
int nbytes)

ctahd CT Access handle returned by ctaCreateContext.

nbytes Number of bytes to jump in speech. A negative number indicates a jump backward. A positive number indicates a jump forward.

Return Values

Events

None.

Details

This function moves speech forward or backward a specified number of bytes within a text buffer. A positive entry jumps forward; a negative entry jumps backward. If the jump moves to the middle of a word, the entire word is spoken.

When a jump reaches the end of a buffer, the last word of the buffer is spoken. When a jump reaches the beginning of a buffer, the first word is spoken.

ttsJump moves speech forward or backward a specified number of characters, rather than a specific period of time. How many seconds the jump moves depends on the speed at which speech is taking place. For example, the default speed of text-to-speech speed is 150 words per minute, or approximately 15 bytes per second (assuming six characters per word). When speech takes place at the default speed, a jump of 75 bytes moves over approximately five seconds of text.

See Also

ttsSetGain, ttsSetPitch, ttsSetSpeed, ttsSpeak



(Page 4 of 17 in this chapter)


tech_support@nmss.com
Copyright © 1997, Natural MicroSystems, Inc. All rights reserved.