Select interface for Text-to-Speech operations
$tts_dll node dllpath [langspec] [wavspec]
This command is required to specify a TTS interface DLL to be used when text-to-speech is to be used. For more information see the topic Using Text-to-Speech.
The parameters on this command are used as follows:
| node | the nodename of the machine which is to load this DLL, or * for all nodes. |
| dllpath | the full pathname of the DLL, normally in the Program Files\Copia folder (@PFC). Currently one of the following two DLLs must be specified: |
| CF9MSSAPI.DLL | the interface to Microsoft Speech Application Programming Interface (SAPI) 5.x, which is normally installed on Vista, Windows 7 and Windows Server 2008. Although SAPI is available on earlier OS it is not recommended. The CopiaFacts interface has been tested with SAPI 5.3. |
| CF9MSSPEECH.DLL | the interface to Microsoft Speech Server 10.x. Microsoft Speech Server needs to be downloaded from the Microsoft web site as described in the topic Using Text-to-Speech. It is supported for TTS on Vista, Windows 7 and Windows Server 2008. The CopiaFacts interface has been tested with Speech Server 10.2. |
| langspec | a substring of the name of the voice, used to select a specific voice as the default if more than one is installed. Voices can be downloaded from the Microsoft web site as described in the topic Using Text-to-Speech. The first voice name of which the langspec is a substring will be selected. For SAPI, use the voice name, 'Anna'. For Speech Server it is safer to use the language code, for example 'en-US' (because the Spanish speaker is named Helena and the US speaker is named Helen, which causes ambiguity if you install both). |
| wavspec | a keyword to specify the .WAV output format, from the following set: WAVALAW8, WAVMULAW8, WAVALAW11, WAVMULAW11, WAVPCM8, WAV16PCM8. The last is the default. Note that the 11Khz formats are supported by Brooktrout but not by Diva boards, and the default VAV16PCM8 vice-versa. |
 | A wavspec parameter is required for Brooktrout boards/ports, which do not support the default WAV16PCM8 format. See the example below. |
Only one command should be used. It is possible to override the language in an XML file containing text to be spoken.
Examples:
$tts_dll * @PFC\CF9MSSAPI ; use SAPI, only one voice installed
$tts_dll * @PFC\CF9MSSAPI Anna ; use SAPI, pick voice Anna (USA)
$tts_dll * @PFC\CF9MSSPEECH en-US ; use Speech Server, pick Helen (USA)
$tts_dll * @PFC\CF9MSSPEECH en-GB ; use Speech Server, pick Hazel (Great Britain)
$tts_dll * @PFC\CF9MSSPEECH es-ES ; use Speech Server, pick Helena (Spain)
$tts_dll * @PFC\CF9MSSPEECH es-MX ; use Speech Server, pick Hilda (Mexico)
$tts_dll * @PFC\CF9MSSAPI Anna WAVMULAW11 ; use SAPI, Anna, 11Khz format
For Brooktrout (USA):
$tts_dll * @PFC\CF9MSSPEECH en-US WAVMULAW8 ; override output format
