[Kde-accessibility] KDE Speech API Draft 2 and new KTTSD

[Gary Cramblitt]

I have posted for comment Draft 2 of the KDE Text-to-speech API at the 
following URL.

http://home.comcast.net/~garycramblitt/oss/apidocs/kttsd/html/classkspeech.html

Please note that this is a high-level API for KDE applications to interface 
with KTTSD, the KDE Text-to-speech daemon.  It is not the same as the KTTSD  
Plugin API that is also currently being discussed on this list, although it 
is related of course.

Some of the links on this page will take you to other pages that represent the 
internal documentation for KTTSD.  Until I figure out how to keep Doxygen 
from generating such links, please try to stay on page classkspeech.html in 
your browser.

Comments welcome.

In addition, changes to KTTSD have been committed to CVS (kdenonbeta).  
Summary of changes:

        *   Draft 2 of the KDE Text-to-speech API.  See /libktts/kspeech.h.
        *   Moved all the GUI stuff out of KTTSD into kttsmgr.  KTTSD is a 
pure non-GUI deamon now.
        *   Added text job manager as a KPart (kttsjobmgr) for GUI interface.
        *   Replaced existing configuration manager (kcmkttsd) with 
kcmkttsmgr, which includes kttsjobmgr. (kcmkttsd remains for now but will be 
deleted in the future.)
        *   Fixed several typos and minor bugs.
        *   Fixed Kate and KHTML Plugins.
        *   Updated README, TODO and this file.

IMPORTANT note to developers using KTTSD:  The startText, stopText, resumeText 
DCOP methods now take a jobNum argument, which you can code as 0 to operate 
against the last text job your app queued. 
See /plugins/kate-plugin/katekttsd.cpp for example, or /libktts/kspeech.h.

When using the dcop command-line utility, you must specify the jobNum argument 
to startText, resumeText, stopText.  If you code as 0, it will apply to the 
last queued text job.  For example,

    dcop kttsd kspeech startText 0

Two files in the kttsd/kttsd directory have been moved to kttsd/libktts.  To 
avoid build problems, you have to either do a "make -f Makefile.common 
cvs-clean" or just delete the following files from kttsd/kttsd:

  kspeech.h
  kttsdui.ui

-- 
Gary Cramblitt (aka PhantomsDad)