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.
dllpaththe full pathname of the DLL, normally in the Program Files\Copia folder (@PFC).  Currently one of the following two DLLs must be specified:
CF8MSSAPI.DLLthe 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.
CF8MSSPEECH.DLLthe 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.
lansgspeca 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).
wavspeca 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 TR1034 but not by Diva boards, and the default VAV16PCM8 vice-versa.
A wavspec parameter is required for Brooktrout TR1034 boards, 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\CF8MSSAPI         ; use SAPI, only one voice installed

$tts_dll * @PFC\CF8MSSAPI Anna    ; use SAPI, pick voice Anna (USA)

$tts_dll * @PFC\CF8MSSPEECH en-US ; use Speech Server, pick Helen (USA)

$tts_dll * @PFC\CF8MSSPEECH en-GB ; use Speech Server, pick Hazel (Great Britain)

$tts_dll * @PFC\CF8MSSPEECH es-ES ; use Speech Server, pick Helena (Spain)

$tts_dll * @PFC\CF8MSSPEECH es-MX ; use Speech Server, pick Hilda (Mexico)

$tts_dll * @PFC\CF8MSSAPI Anna WAVMULAW11 ; use SAPI, Anna, 11Khz format

For Brooktrout TR1034 (USA):

$tts_dll * @PFC\CF8MSSPEECH en-US WAVMULAW8 ; override output format