(Page 3 of 17 in this chapter)


ttsGetStatus

Description

Retrieves the current status for a specific text-to-speech context.

Prototype

DWORD ttsGetStatus(CTAHD ctahd,
TTS_STATUS *status,
unsigned size)

ctahd CT Access handle returned by ctaCreateContext.

status Pointer to a buffer that receives the TTS_STATUS data structure. The TTS_FIRMWARE_VERSION_INFO substructure holds vendor version information for the NaturalText firmware that performs text-to-speech conversion on the Diva board.

typedef struct
{    
        DWORD          size;                  /*  size  of  this  structure          */        TTS_VOICE  voice;                /*  speaking  voice                          */        TTSBOOL      isUEDLinked;    /*  TRUE   =  UED loaded,
                                                            FALSE  =  otherwise                      */
        TTS_STATE  state;                /*  State  of  the  service              */        TTSBOOL      isPaused;          /*  True  =  paused
FALSE = otherwise */ INT16 gain; /* volume attenuation(dB) */ INT16 pitch; /* baseline pitch (Hz) */ INT16 speed; /* speech rate (words per min)*/
TTS_FIRMWARE_VERSION_INFO firmware_version;
}TTS_STATUS;
typedef struct

{

DWORD size; /* structure size */

char vendor_id[TTS_FIRMWARE_VENDOR_ID_LEN + 1];
short version;
short revision;
char date[TTS_FIRMWARE_DATE_LEN + 1]; /* Build date.*/

char language[TTS_FIRMWARE_LANGUAGE_LEN + 1];

char architecture[TTS_FIRMWARE_ARCHITECTURE_LEN + 1];

}TTS_FIRMWARE_VERSION_INFO;


size Size (in bytes) of the status structure.

Return Values

Events

Details

This function retrieves the current status of a text-to-speech service for a specific CT Access context.

language may return one of the following values:

architecture may return one of the following values:

See Also

ttsSetGain, ttsSetPitch, ttsSetSpeed, ttsSpeak



(Page 3 of 17 in this chapter)


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