speech-dispatcher: Characters and Keys in C
4.1.4 Characters and Keys
-------------------------
-- C API function: int spd_char(SPDConnection* connection, SPDPriority
priority, char* character);
Says a character according to user settings for characters. For
example, this can be used for speaking letters under the cursor.
'connection' is the SPDConnection* connection created by
spd_open().
'priority' is the desired priority for this message. Message
Priority Model (ssip)Top.
'character' is a NULL terminated string of chars containing one
UTF-8 character. If it contains more characters, only the first
one is processed.
It returns 0 on success, -1 otherwise.
-- C API function: int spd_wchar(SPDConnection* connection, SPDPriority
priority, wchar_t wcharacter);
The same as spd_char(), but it takes a wchar_t variable as its
argument.
It returns 0 on success, -1 otherwise.
-- C API function: int spd_key(SPDConnection* connection, SPDPriority
priority, char* key_name);
Says a key according to user settings for keys.
'connection' is the SPDConnection* connection created by
spd_open().
'priority' is the desired priority for this message. Message
Priority Model (ssip)Top.
'key_name' is the name of the key in a special format.
Speech Synthesis and Sound Output Commands (ssip)Top, (KEY, the
corresponding SSIP command) for description of the format of
'key_name'
It returns 0 on success, -1 otherwise.