Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdeaccessibility@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

4 files changed, 552 insertions, 0 deletions

diff --git a/kttsd/kttsmgr/Makefile.am b/kttsd/kttsmgr/Makefile.am
new file mode 100644
index 0000000..747408d
--- /dev/null
+++ b/kttsd/kttsmgr/Makefile.am
@@ -0,0 +1,34 @@
+# Include paths.
+INCLUDES = \
+	$(KTTS_KSPEECH_INCLUDE) \
+	$(all_includes)
+
+# Let automoc handle all of the metsource files (moc).
+METASOURCES = AUTO
+
+#########################################################################
+# APPLICATION SECTION
+#########################################################################
+# This is the program that gets installed.  It's name is used for all
+# of the other Makefile.am variables.
+bin_PROGRAMS = kttsmgr
+
+kspeech_DIR = $(KTTS_KSPEECH_DIR)
+kspeechsink_DIR = $(KTTS_KSPEECH_DIR)
+
+# The source, library search path, and link libraries.
+kttsmgr_SOURCES =  \
+	kspeech.stub \
+	kspeechsink.skel \
+	kttsmgr.cpp
+
+kttsmgr_LDFLAGS = $(all_libraries) $(KDE_RPATH)
+kttsmgr_LDADD = \
+	$(LIB_KUTILS) \
+	$(LIB_KDEUI)
+
+# Header files that should not be installed.
+noinst_HEADERS = kttsmgr.h
+
+# K Menu entry.
+xdg_apps_DATA = kttsmgr.desktop
diff --git a/kttsd/kttsmgr/kttsmgr.cpp b/kttsd/kttsmgr/kttsmgr.cpp
new file mode 100644
index 0000000..80b66b9
--- /dev/null
+++ b/kttsd/kttsmgr/kttsmgr.cpp
@@ -0,0 +1,334 @@
+/***************************************************** vim:set ts=4 sw=4 sts=4:
+  KTTS Manager Program
+  --------------------
+  Copyright:
+  (C) 2004 by Gary Cramblitt <garycramblitt@comcast.net>
+  -------------------
+  Original author: Gary Cramblitt <garycramblitt@comcast.net>
+  Current Maintainer: Gary Cramblitt <garycramblitt@comcast.net>
+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ ******************************************************************************/
+
+// Qt includes.
+#include <qimage.h>
+
+// KDE includes.
+#include <kconfig.h>
+#include <kuniqueapplication.h>
+#include <kcmultidialog.h>
+#include <kaboutdata.h>
+#include <kcmdlineargs.h>
+#include <kdebug.h>
+#include <ksystemtray.h>
+#include <kiconloader.h>
+#include <kpopupmenu.h>
+#include <kaboutapplication.h>
+#include <dcopclient.h>
+#include <kdeversion.h>
+
+// KTTSMgr includes.
+#include "kspeech.h"
+#include "kttsmgr.h"
+
+static const KCmdLineOptions options[] =
+{
+    { "s", 0, 0 },
+    { "systray", I18N_NOOP("Start minimized in system tray"), 0 },
+    { "a", 0, 0 },
+    { "autoexit", I18N_NOOP("Exit when speaking is finished and minimized in system tray"), 0 },
+    KCmdLineLastOption
+};
+
+int main (int argc, char *argv[])
+{
+    KGlobal::locale()->setMainCatalogue("kttsd");
+
+    KAboutData aboutdata("kttsmgr", I18N_NOOP("KTTSMgr"),
+        "0.3.5.2", I18N_NOOP("Text-to-Speech Manager"),
+        KAboutData::License_GPL, "(C) 2002, José Pablo Ezequiel Fernández");
+    aboutdata.addAuthor("José Pablo Ezequiel Fernández",I18N_NOOP("Original Author"),"pupeno@pupeno.com");
+    aboutdata.addAuthor("Gary Cramblitt", I18N_NOOP("Maintainer"),"garycramblitt@comcast.net");
+    aboutdata.addAuthor("Gunnar Schmi Dt", I18N_NOOP("Contributor"),"gunnar@schmi-dt.de");
+    aboutdata.addAuthor("Olaf Schmidt", I18N_NOOP("Contributor"),"ojschmidt@kde.org");
+    aboutdata.addAuthor("Paul Giannaros", I18N_NOOP("Contributor"), "ceruleanblaze@gmail.com");
+    aboutdata.addCredit("Jorge Luis Arzola", I18N_NOOP("Testing"), "arzolacub@hotmail.com");
+    aboutdata.addCredit("David Powell", I18N_NOOP("Testing"), "achiestdragon@gmail.com");
+    KCmdLineArgs::init( argc, argv, &aboutdata );
+
+    KCmdLineArgs::addCmdLineOptions( options );
+
+    KUniqueApplication::addCmdLineOptions();
+
+    if(!KUniqueApplication::start())
+    {
+        kdDebug() << "kttsmgr is already running" << endl;
+        return (0);
+    }
+
+    KUniqueApplication app;
+
+#if KDE_VERSION >= KDE_MAKE_VERSION (3,3,90)
+    QPixmap icon = KGlobal::iconLoader()->loadIcon("kttsd", KIcon::Panel);
+    aboutdata.setProgramLogo(icon.convertToImage());
+#endif
+
+    // The real work of KTTS Manager is done in the KControl Module kcmkttsd.
+    KCMultiDialog dlg(KCMultiDialog::Plain, i18n("KDE Text-to-Speech Manager"), 0, "kttsmgrdlg", false);
+    dlg.addModule("kcmkttsd");
+
+    dlg.setIcon(KGlobal::iconLoader()->loadIcon("kttsd", KIcon::Small));
+
+    // Get SysTray and ShowMainWindow options.
+    KConfig* config = new KConfig("kttsdrc");
+    config->setGroup("General");
+    bool embedInSysTray = config->readBoolEntry("EmbedInSysTray", true);
+    // Can only hide main window if we are in the system tray, otherwise, no way
+    // for user to do anything.
+    bool showMainWindowOnStartup = true;
+    if (embedInSysTray)
+        showMainWindowOnStartup = config->readBoolEntry("ShowMainWindowOnStartup", true);
+
+    // If --systray option specified, start minimized in system tray.
+    KCmdLineArgs *args = KCmdLineArgs::parsedArgs();
+    if (args->isSet("systray"))
+    {
+        embedInSysTray = true;
+        showMainWindowOnStartup = false;
+    }
+
+    KttsMgrTray* tray = 0;
+    if (embedInSysTray)
+    {
+        tray = new KttsMgrTray(&dlg);
+        tray->show();
+    }
+    else app.setMainWidget(&dlg);
+
+    if (showMainWindowOnStartup)
+#if KDE_VERSION < KDE_MAKE_VERSION (3,3,0)
+        dlg.show();
+#else
+    {
+        if (embedInSysTray)
+            tray->setActive();
+        else
+            dlg.show();
+    }
+#endif
+    int result = app.exec();
+    delete tray;
+    return result;
+}
+
+/*  KttsToolTip class */
+
+KttsToolTip::KttsToolTip ( QWidget* parent ) : QToolTip(parent)
+{
+}
+
+/*virtual*/ void KttsToolTip::maybeTip ( const QPoint & p )
+{
+    Q_UNUSED(p);
+
+    if (!parentWidget()->inherits("KttsMgrTray"))
+        return;
+
+    KttsMgrTray* kttsMgrTray = dynamic_cast<KttsMgrTray*>(parentWidget());
+
+    QRect r(kttsMgrTray->geometry());
+    if ( !r.isValid() )
+        return;
+
+    QString status = "<qt><b>KTTSMgr</b> - ";
+    status += i18n("<qt>Text-to-Speech Manager");
+    status += "<br/><br/>";
+    status += kttsMgrTray->getStatus();
+    status += "</qt>";
+
+    tip(r, status);
+}
+
+/*  KttsMgrTray class */
+
+KttsMgrTray::KttsMgrTray(QWidget *parent):
+    DCOPStub("kttsd", "KSpeech"),
+    DCOPObject("kkttsmgr_kspeechsink"),
+    KSystemTray(parent, "kttsmgrsystemtray")
+{
+    QPixmap icon = KGlobal::iconLoader()->loadIcon("kttsd", KIcon::Small);
+    setPixmap (icon);
+
+    // QToolTip::add(this, i18n("Text-to-speech manager"));
+    m_toolTip = new KttsToolTip(this);
+
+    int id;
+    id = contextMenu()->idAt(0);
+    if (id != -1) contextMenu()->changeTitle(id, icon, "KTTSMgr");
+
+    id = contextMenu()->insertItem (KGlobal::iconLoader()->loadIcon("klipper", KIcon::Small),
+        i18n("&Speak Clipboard Contents"), this, SLOT(speakClipboardSelected()));
+    id = contextMenu()->insertItem (KGlobal::iconLoader()->loadIcon("stop", KIcon::Small),
+        i18n("&Hold"), this, SLOT(holdSelected()));
+    id = contextMenu()->insertItem (KGlobal::iconLoader()->loadIcon("exec", KIcon::Small),
+        i18n("Resume"), this, SLOT(resumeSelected()));
+    id = contextMenu()->insertSeparator();
+    id = contextMenu()->insertItem (KGlobal::iconLoader()->loadIcon("contents", KIcon::Small),
+        i18n("KTTS &Handbook"), this, SLOT(helpSelected()));
+    id = contextMenu()->insertItem (KGlobal::iconLoader()->loadIcon("kttsd", KIcon::Small),
+        i18n("&About KTTSMgr"), this, SLOT(aboutSelected()));
+
+    connect(this, SIGNAL(quitSelected()), this, SLOT(quitSelected()));
+    // If --autoexit option given, exit when speaking stops.
+    KCmdLineArgs *args = KCmdLineArgs::parsedArgs();
+    if (args->isSet("autoexit"))
+    {
+        connectDCOPSignal("kttsd", "KSpeech",
+            "textFinished(QCString,uint)",
+            "textFinished(QCString,uint)",
+            false);
+        // Install an event filter so we can check when KTTSMgr becomes inconified to the systray.
+        parent->installEventFilter(this);
+    }
+}
+
+KttsMgrTray::~KttsMgrTray()
+{
+    delete m_toolTip;
+}
+
+void KttsMgrTray::textFinished(const QCString& /*appId*/, uint /*jobNum*/)
+{
+    // kdDebug() << "KttsMgrTray::textFinished: running" << endl;
+    exitWhenFinishedSpeaking();
+}
+
+/*virtual*/ bool KttsMgrTray::eventFilter( QObject* /*o*/, QEvent* e )
+{
+    if ( e->type() == QEvent::Hide ) exitWhenFinishedSpeaking();
+    return false;
+}
+
+void KttsMgrTray::exitWhenFinishedSpeaking()
+{
+    // kdDebug() << "KttsMgrTray::exitWhenFinishedSpeaking: running" << endl;
+    if ( parentWidget()->isShown() ) return;
+    QString jobNums = getTextJobNumbers();
+    QStringList jobNumsList = QStringList::split(jobNums, ",");
+    uint jobNumsListCount = jobNumsList.count();
+    // Since there can only be 2 Finished jobs at a time, more than 2 jobs means at least
+    // one job is not Finished.
+    if (jobNumsListCount > 2) return;
+    // Exit if all jobs are Finished or there are no jobs.
+    for (uint ndx=0; ndx < jobNumsListCount; ++ndx)
+    {
+        if (getTextJobState(jobNumsList[ndx].toInt()) != KSpeech::jsFinished) return;
+    }
+    kapp->quit();
+}
+
+/**
+* Convert a KTTSD job state integer into a display string.
+* @param state          KTTSD job state
+* @return               Display string for the state.
+*/
+QString KttsMgrTray::stateToStr(int state)
+{
+    switch( state )
+    {
+        case KSpeech::jsQueued: return        i18n("Queued");
+        case KSpeech::jsSpeakable: return     i18n("Waiting");
+        case KSpeech::jsSpeaking: return      i18n("Speaking");
+        case KSpeech::jsPaused: return        i18n("Paused");
+        case KSpeech::jsFinished: return      i18n("Finished");
+        default: return                       i18n("Unknown");
+    }
+}
+
+QString KttsMgrTray::getStatus()
+{
+    if (!isKttsdRunning()) return i18n("Text-to-Speech System is not running");
+    uint jobCount = getTextJobCount();
+    QString status = i18n("1 job", "%n jobs", jobCount);
+    if (jobCount > 0)
+    {
+        uint job = getCurrentTextJob();
+        int jobState = 0;
+        if (job != 0)
+        {
+            // kdDebug() << "KttsMgrTray::getStatus: job = " << job << endl;
+            jobState = getTextJobState(job);
+            int sentenceCount = getTextCount(job);
+            uint seq = moveRelTextSentence(0, job);
+            status += i18n(", current job %1 at sentence %2 of %3 sentences"
+                ).arg(stateToStr(jobState)).arg(seq).arg(sentenceCount);
+        }
+    }
+    return status;
+}
+
+void KttsMgrTray::speakClipboardSelected()
+{
+    if (!isKttsdRunning())
+    {
+        QString error;
+        if (KApplication::startServiceByDesktopName("kttsd", QStringList(), &error) != 0)
+            kdError() << "Starting KTTSD failed with message " << error << endl;
+    }
+    speakClipboard();
+}
+
+void KttsMgrTray::aboutSelected()
+{
+    KAboutApplication aboutDlg(kapp->aboutData(), 0, "kttsmgraboutdlg", true);
+    aboutDlg.exec();
+}
+
+void KttsMgrTray::helpSelected()
+{
+    kapp->invokeHelp(QString::null,"kttsd");
+}
+
+void KttsMgrTray::quitSelected()
+{
+    // kdDebug() << "Running KttsMgrTray::quitSelected" << endl;
+    kapp->quit();
+}
+
+void KttsMgrTray::holdSelected()
+{
+    if (isKttsdRunning())
+    {
+        uint jobNum = getCurrentTextJob();
+        pauseText(jobNum);
+    }
+}
+
+void KttsMgrTray::resumeSelected()
+{
+    if (isKttsdRunning())
+    {
+        uint jobNum = getCurrentTextJob();
+        resumeText(jobNum);
+    }
+}
+
+bool KttsMgrTray::isKttsdRunning()
+{
+    DCOPClient *client = kapp->dcopClient();
+    return (client->isApplicationRegistered("kttsd"));
+}
+
+#include "kttsmgr.moc"
diff --git a/kttsd/kttsmgr/kttsmgr.desktop b/kttsd/kttsmgr/kttsmgr.desktop
new file mode 100644
index 0000000..318d7a3
--- /dev/null
+++ b/kttsd/kttsmgr/kttsmgr.desktop
@@ -0,0 +1,98 @@
+[Desktop Entry]
+Type=Application
+Name=kttsmgr
+Name[pt_BR]=Gerenciador ktts
+Name[tr]=Kttsmgr
+GenericName=Text-to-Speech Manager
+GenericName[bg]=Синтез на глас
+GenericName[ca]=Gestor de text a veu
+GenericName[cs]=Správce zvukové syntézy
+GenericName[da]=Tekst-til-tale håndtering
+GenericName[de]=Sprachausgabeverwaltung
+GenericName[el]=Διαχειριστής κειμένου-σε-ομιλία
+GenericName[es]=Administrador de texto a voz
+GenericName[et]=Teksti kõneks muutmise haldur
+GenericName[eu]=Testutik hizketarako kudeatzailea
+GenericName[fa]=مدیر متن به گفتار
+GenericName[fi]=Teksti puheeksi -hallintaohjelma
+GenericName[fr]=Gestionnaire de synthèse vocale
+GenericName[ga]=Bainisteoir Téacs-go-Caint
+GenericName[gl]=Xestor de Texto-para-Fala
+GenericName[he]=מנהל טקסט לדיבור
+GenericName[hu]=Szövegfelolvasás-kezelő
+GenericName[is]=Texti-í-tal stjóri
+GenericName[it]=Gestore della pronuncia
+GenericName[ja]=テキスト読み上げマネージャ
+GenericName[ka]=ტექსტი-გახმოვანების მმართველი
+GenericName[km]=ឧបករណ៍​គ្រប់គ្រង​អត្ថបទ​ដែល​ត្រូវ​និយាយ
+GenericName[mk]=Менаџер за текст-во-говор
+GenericName[ms]=Pengurus Teks-ke-Tutur
+GenericName[mt]=Manaġer Test-għal-Vuċi
+GenericName[nb]=Styring for tekst-til-tale
+GenericName[nds]=Vörleespleger
+GenericName[ne]=पाठ वाचक प्रबन्धक
+GenericName[nl]=Tekst-tot-spraak-beheerder
+GenericName[pa]=ਪਾਠ ਤੋਂ ਬੋਲੀ ਮੈਨੇਜਰ
+GenericName[pl]=Menedżer odczytywania tekstu
+GenericName[pt]=Gestor do Texto para Fala
+GenericName[pt_BR]=Gerenciador de Conversão de Texto para Fala do KDE
+GenericName[ru]=Управление синтезом речи
+GenericName[sk]=Správca text-na-reč
+GenericName[sl]=Upravitelj besedila v govor
+GenericName[sr]=Менаџер за текст у говор
+GenericName[sr@Latn]=Menadžer za tekst u govor
+GenericName[sv]=Text-till-tal hantering
+GenericName[ta]=உரையில் இருந்து பேச்சு மேலாளர்
+GenericName[tg]=Идоракунии таҳлили овоз
+GenericName[tr]=Metinden Konuşmaya Yöneticisi
+GenericName[uk]=Менеджер для синтезу мовлення з тексту
+GenericName[vi]=Trình quản lý Văn bản sang Tiếng nói
+GenericName[zh_TW]=文字轉語音管理員
+Icon=kttsd
+Exec=kttsmgr -caption "%c" %i %u
+Comment=KDE Text-to-speech Manager
+Comment[bg]=Мениджър на синтезатора на глас
+Comment[ca]=Gestor de text a veu de KDE
+Comment[cs]=Správce hlasové syntézy KDE
+Comment[da]=KDE's Tekst-til-tale håndtering
+Comment[de]=KDE Verwaltung für Sprachausgabe
+Comment[el]=KDE διαχειριστής κειμένου-σε-ομιλία
+Comment[es]=Administrador de texto a voz de KDE
+Comment[et]=KDE teksti kõneks muutmise haldur
+Comment[eu]=KDE-ren testutik hizketarako kudeatzailea
+Comment[fa]=مدیر متن به گفتار KDE
+Comment[fi]=KDE Teksti puheeksi -hallintaohjelma
+Comment[fr]=Gestionnaire de synthèse vocale pour KDE
+Comment[ga]=Bainisteoir Téacs-go-Caint KDE
+Comment[gl]=Xestor de Texto-para-fala de KDE
+Comment[he]=מנהל טקסט לדיבור של KDE
+Comment[hu]=KDE-s szövegfelolvasás-kezelő
+Comment[is]=KDE texti-í-tal stjóri
+Comment[it]=Gestore della pronuncia di KDE
+Comment[ja]=KDE テキスト読み上げマネージャ
+Comment[ka]=KDE ტექსტი-გახმოვანების მმართველი
+Comment[km]=ឧបករណ៍​គ្រប់គ្រង​អត្ថបទ​ដែល​ត្រូវ​និយាយ​របស់ KDE
+Comment[mk]=Менаџер на KDE за текст-во-говор
+Comment[ms]=Pengurus Teks-ke-tutur KDE
+Comment[nb]=Styring for KDEs tekst-til-tale
+Comment[nds]=Vörleespleger för KDE
+Comment[ne]=केडीई पाठ वाचक प्रबन्धक
+Comment[nl]=KDE Tekst-tot-spraak-beheer
+Comment[pa]=KDE ਪਾਠ ਤੋਂ ਬੋਲੀ ਮੈਨੇਜਰ
+Comment[pl]=Menedżer odczytywania tekstu dla KDE
+Comment[pt]=Gestor do Texto para Fala do KDE
+Comment[pt_BR]=Gerenciador de Conversão de Texto para Fala do KDE
+Comment[ru]=Менеджер движков синтеза речи
+Comment[sk]=KDE text-na-reč manažér
+Comment[sl]=Upravitelj besedila v govor v KDE
+Comment[sr]=KDE-ов менаџер за текст у говор
+Comment[sr@Latn]=KDE-ov menadžer za tekst u govor
+Comment[sv]=KDE:s text-till-tal hantering
+Comment[ta]=கேடியி உரையில் இருந்து பேச்சு மேலாளர்
+Comment[tg]=Идоракунандаи микшерҳои таҳлили овоз
+Comment[tr]=KDE Metinden Konuşmaya yöneticisi
+Comment[uk]=Менеджер KDE для синтезу мовлення з тексту
+Comment[vi]=Trình quản lý Văn bản sang Tiếng nói KDE
+Comment[zh_TW]=KDE 文字轉語音管理員
+Terminal=false
+Categories=Qt;KDE;Utility;Accessibility;
diff --git a/kttsd/kttsmgr/kttsmgr.h b/kttsd/kttsmgr/kttsmgr.h
new file mode 100644
index 0000000..e13233a
--- /dev/null
+++ b/kttsd/kttsmgr/kttsmgr.h
@@ -0,0 +1,86 @@
+/***************************************************** vim:set ts=4 sw=4 sts=4:
+  KTTS Manager Program
+  --------------------
+  Copyright:
+  (C) 2004 by Gary Cramblitt <garycramblitt@comcast.net>
+  -------------------
+  Original author: Gary Cramblitt <garycramblitt@comcast.net>
+  Current Maintainer: Gary Cramblitt <garycramblitt@comcast.net>
+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
+ ******************************************************************************/
+
+#ifndef KTTSMGR_H
+#define KTTSMGR_H
+
+// Qt includes.
+#include <qevent.h>
+#include <qtooltip.h>
+
+// KDE includes.
+#include <ksystemtray.h>
+
+// KTTS includes.
+#include "kspeech_stub.h"
+#include "kspeechsink.h"
+
+class KttsToolTip: public QToolTip
+{
+    public:
+        KttsToolTip ( QWidget* parent );
+
+    protected:
+        virtual void maybeTip ( const QPoint & p );
+};
+
+class KttsMgrTray: public KSystemTray, public KSpeech_stub, virtual public KSpeechSink
+{
+    Q_OBJECT
+
+    public:
+        KttsMgrTray(QWidget *parent=0);
+        ~KttsMgrTray();
+
+        void setExitWhenFinishedSpeaking();
+        QString getStatus();
+
+    protected:
+        // ASYNC textStarted(const QCString& appId, uint jobNum);
+        ASYNC textFinished(const QCString& appId, uint jobNum);
+        virtual bool eventFilter( QObject* o, QEvent* e );
+
+    private slots:
+
+        void speakClipboardSelected();
+        void holdSelected();
+        void resumeSelected();
+        void aboutSelected();
+        void helpSelected();
+        void quitSelected();
+
+    private:
+        /**
+         * Convert a KTTSD job state integer into a display string.
+         * @param state          KTTSD job state
+         * @return               Display string for the state.
+         */
+        QString stateToStr(int state);
+
+        bool isKttsdRunning();
+        void exitWhenFinishedSpeaking();
+        KttsToolTip* m_toolTip;
+};
+
+#endif    // KTTSMGR_H