4.9 multiwave.scm

Sometimes it is convenient to return multiple synthesized wave forms instead of a single wave form. There are two typical situations when this can happen:

• You want to synthesize a long text and you don't want to wait until it is all synthesized, you want to play the resulting audio as soon as possible. The text can be cut into smaller pieces, returning the corresponding wave forms in a sequence.
• The resulting wave form is a mixture of a synthesized texts and sound icons, of different rates or other sound sample parameters. Concatenating them together may reduce the resulting sound quality. So the different sound parts may be better returned separately.

The ‘multiwave.scm’ module provides the following interface for those purposes:

multi-synth type value

This function is similar to the event-synth function (see section events.scm), except that it doesn't return an utterance containing the resulting wave form. Instead, it setups the synthesis for the following multi-next calls.

multi-next

Return the next wave form of the last event synthesized via the multi-synth function. If there is no next wave form, return nil.

If you synthesize an SSML text, the function may return a non-nil symbol instead of a wave form. Then the symbol is a name of the mark just reached.

multi-clear

Throw away the synthesized data. You usually don't need to call this function as the data is cleared on the next multi-synth call automatically, but the function may be useful under special circumstances.

This document was generated by Milan Zamazal on August, 11 2009 using texi2html 1.78.