[Kde-accessibility] Changes to KTTSD

[Gary Cramblitt]

The following new method has been added to the KSpeech interface:

/**
* Say a plain text job.  This is a convenience method that
* combines @ref setText and @ref startText into a single call.
* @param text           The message to be spoken.
* @param talker         Code for the talker to do the speaking.  Example "en".
*                       If NULL, defaults to the user's default plugin.
*                       If no plugin has been configured for the specified 
Talker code,
*                       defaults to the closest matching talker.
* @return               Job number.
*
* Plain text is parsed into individual sentences using the current sentence 
delimiter.
* Call @ref setSentenceDelimiter to change the sentence delimiter prior to
* calling setText.
* Call @ref getTextCount to retrieve the sentence count after calling setText.
*
* The text may contain speech mark language, such as Sable, JSML, or SSML,
* provided that the speech plugin/engine support it.  In this case,
* sentence parsing follows the semantics of the markup language.
*
* The job is marked speakable.
* If there are other speakable jobs preceeding this one in the queue,
* those jobs continue speaking and when finished, this job will begin 
speaking.
* If there are no other speakable jobs preceeding this one, it begins 
speaking.
*
* @see getTextCount
*
* @since KDE 3.5
*/
virtual uint sayText(const QString &text, const QString &talker) = 0;

***************************
IMPORTANT
***************************
Be sure to update and install kdelibs/interfaces/kspeech before compiling 
kttsd or all of kdeaccessibility:

cd kdelibs/interfaces/kspeech
cvs up
make install

Also, after discussing with Gunnar and other users, all Messages and Warnings 
now pass through regular filters before being spoken.  Previously, only 
regular text jobs and notifications were filtered.   Screen Reader Outputs 
remain unfiltered.  Warnings and Messages do not pass through the Sentence 
Boundary Detector (SBD) filters.

These changes are for KDE 3.5 and later and will not be backported to KDE 
3.4.1.

Regards.

-- 
Gary Cramblitt (aka PhantomsDad)
KDE Text-to-Speech Maintainer
http://accessibility.kde.org/developer/kttsd/index.php