You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
532 lines
17 KiB
532 lines
17 KiB
/***************************************************** vim:set ts=4 sw=4 sts=4:
|
|
KControl module for KTTSD configuration and job management
|
|
-------------------
|
|
Copyright : (C) 2002-2003 by José Pablo Ezequiel "Pupeno" Fernández
|
|
Copyright : (C) 2004 by Gary Cramblitt <garycramblitt@comcast.net>
|
|
-------------------
|
|
Original author: José Pablo Ezequiel "Pupeno" Fernández <pupeno@kde.org>
|
|
Current Maintainer: 2004 by 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; version 2 of the License. *
|
|
* *
|
|
***************************************************************************/
|
|
|
|
#ifndef KCMKTTSMGR_H
|
|
#define KCMKTTSMGR_H
|
|
|
|
#include "config.h"
|
|
|
|
// TQt includes.
|
|
#include <tqmap.h>
|
|
#include <tqlistview.h>
|
|
|
|
// KDE includes.
|
|
#include <kcmodule.h>
|
|
#include <ktrader.h>
|
|
#include <kdebug.h>
|
|
#include <kparts/part.h>
|
|
|
|
// KTTS includes.
|
|
#include "addtalker.h"
|
|
#include "kcmkttsmgrwidget.h"
|
|
#include "kspeech_stub.h"
|
|
#include "kspeechsink.h"
|
|
|
|
class PlugInConf;
|
|
class KttsFilterConf;
|
|
class KListViewItem;
|
|
class KAboutData;
|
|
class KConfig;
|
|
class TQPopupMenu;
|
|
|
|
/**
|
|
* @author José Pablo Ezequiel "Pupeno" Fernández
|
|
* @author Gary Cramblitt
|
|
*/
|
|
|
|
class KCMKttsMgr :
|
|
public KCModule,
|
|
public KSpeech_stub,
|
|
virtual public KSpeechSink
|
|
{
|
|
Q_OBJECT
|
|
|
|
|
|
public:
|
|
KCMKttsMgr(TQWidget *parent, const char *name, const TQStringList &);
|
|
|
|
~KCMKttsMgr();
|
|
|
|
/**
|
|
* This method is invoked whenever the module should read its
|
|
* configuration (most of the times from a config file) and update the
|
|
* user interface. This happens when the user clicks the "Reset" button in
|
|
* the control center, to undo all of his changes and restore the currently
|
|
* valid settings. NOTE that this is not called after the modules is loaded,
|
|
* so you probably want to call this method in the constructor.
|
|
*/
|
|
void load();
|
|
|
|
/**
|
|
* This function gets called when the user wants to save the settings in
|
|
* the user interface, updating the config files or wherever the
|
|
* configuration is stored. The method is called when the user clicks "Apply"
|
|
* or "Ok".
|
|
*/
|
|
void save();
|
|
|
|
/**
|
|
* This function is called to set the settings in the module to sensible
|
|
* default values. It gets called when hitting the "Default" button. The
|
|
* default values should probably be the same as the ones the application
|
|
* uses when started without a config file.
|
|
*/
|
|
void defaults();
|
|
|
|
/**
|
|
* This is a static method which gets called to realize the modules settings
|
|
* durign the startup of KDE. NOTE that most modules do not implement this
|
|
* method, but modules like the keyboard and mouse modules, which directly
|
|
* interact with the X-server, need this method. As this method is static,
|
|
* it can avoid to create an instance of the user interface, which is often
|
|
* not needed in this case.
|
|
*/
|
|
static void init();
|
|
|
|
/**
|
|
* The control center calls this function to decide which buttons should
|
|
* be displayed. For example, it does not make sense to display an "Apply"
|
|
* button for one of the information modules. The value returned can be set by
|
|
* modules using setButtons.
|
|
*/
|
|
int buttons();
|
|
|
|
/**
|
|
* This function returns the small quickhelp.
|
|
* That is displayed in the sidebar in the KControl
|
|
*/
|
|
TQString quickHelp() const;
|
|
|
|
/**
|
|
* Return the about information for this module
|
|
*/
|
|
const KAboutData* aboutData() const;
|
|
|
|
public slots:
|
|
/**
|
|
* This slot is used to emit the signal changed when any widget changes the configuration
|
|
*/
|
|
void configChanged()
|
|
{
|
|
if (!m_suppressConfigChanged)
|
|
{
|
|
// kdDebug() << "KCMKttsMgr::configChanged: Running"<< endl;
|
|
m_changed = true;
|
|
emit changed(true);
|
|
}
|
|
};
|
|
/**
|
|
* This slot is called whenever user checks/unchecks item in Filters list.
|
|
*/
|
|
void slotFiltersList_stateChanged();
|
|
|
|
protected:
|
|
/** DCOP Methods connected to DCOP Signals emitted by KTTSD. */
|
|
/** Most of these are not used */
|
|
|
|
/**
|
|
* This signal is emitted when KTTSD starts or restarts after a call to reinit.
|
|
*/
|
|
virtual void kttsdStarted();
|
|
/**
|
|
* This signal is emitted just before KTTSD exits.
|
|
*/
|
|
virtual void kttsdExiting();
|
|
|
|
// virtual void resizeEvent( TQResizeEvent ev );
|
|
|
|
private:
|
|
enum widgetPages
|
|
{
|
|
wpGeneral = 0, // General tab.
|
|
wpTalkers = 1, // Talkers tab.
|
|
wpNotify = 2, // Notify tab.
|
|
wpFilters = 3, // Filters tab.
|
|
wpInterruption = 4, // Interruption tab.
|
|
wpAudio = 5, // Audio tab.
|
|
wpJobs = 6 // Jobs tab.
|
|
};
|
|
|
|
enum NotifyListViewColumn
|
|
{
|
|
nlvcEventSrcName = 0,
|
|
nlvcEventName = 0,
|
|
nlvcActionName = 1,
|
|
nlvcTalkerName = 2,
|
|
nlvcEventSrc = 3, // hidden
|
|
nlvcEvent = 4, // hidden
|
|
nlvcAction = 5, // hidden
|
|
nlvcTalker = 6 // hidden
|
|
};
|
|
|
|
enum TalkerListViewColumn
|
|
{
|
|
tlvcTalkerID,
|
|
tlvcLanguage,
|
|
tlvcSynthName,
|
|
tlvcVoice,
|
|
tlvcGender,
|
|
tlvcVolume,
|
|
tlvcRate
|
|
};
|
|
|
|
enum FilterListViewColumn
|
|
{
|
|
flvcUserName, // Name of filter as set by user and displayed.
|
|
flvcFilterID, // Internal ID assigned to the filter (hidden).
|
|
flvcPlugInName, // Name of the filter plugin (from .desktop file, hidden).
|
|
flvcMultiInstance // True if multiple instances of this plugin are possible. (hidden)
|
|
};
|
|
|
|
enum SbdListViewColumn
|
|
{
|
|
slvcUserName, // Name of filter as set by user and displayed.
|
|
slvcFilterID, // Internal ID assigned to the filter (hidden).
|
|
slvcPlugInName, // Name of the filter plugin (from .desktop file, hidden).
|
|
slvcMultiInstance // True if multiple instances of this plugin are possible. (hidden)
|
|
};
|
|
|
|
enum SbdButtonIDs
|
|
{
|
|
sbdBtnEdit = 1,
|
|
sbdBtnUp = 2,
|
|
sbdBtnDown = 3,
|
|
sbdBtnAdd = 4,
|
|
sbdBtnRemove = 5
|
|
};
|
|
|
|
/**
|
|
* Conversion functions for percent boxes to/from sliders.
|
|
*/
|
|
int percentToSlider(int percentValue);
|
|
int sliderToPercent(int sliderValue);
|
|
|
|
/**
|
|
* Given a language code and plugin name, returns a normalized default talker code.
|
|
* @param languageCode Language code.
|
|
* @param plugInName Name of the plugin.
|
|
* @return Full normalized talker code.
|
|
*
|
|
* Example returned from defaultTalkerCode("en", "Festival")
|
|
* <voice lang="en" name="fixed" gender="neutral"/>
|
|
* <prosody volume="medium" rate="medium"/>
|
|
* <kttsd synthesizer="Festival" />
|
|
*/
|
|
TQString defaultTalkerCode(const TQString &languageCode, const TQString &plugInName);
|
|
|
|
/**
|
|
* Given an item in the talker listview and a talker code, sets the columns of the item.
|
|
* @param talkerItem TQListViewItem.
|
|
* @param talkerCode Talker Code.
|
|
*/
|
|
void updateTalkerItem(TQListViewItem* talkerItem, const TQString &talkerCode);
|
|
|
|
/**
|
|
* Loads the configuration plugin for a named Talker plugin.
|
|
* @param name DesktopEntryName of the Synthesizer.
|
|
* @return Pointer to the configuration plugin for the Talker.
|
|
*/
|
|
PlugInConf* loadTalkerPlugin(const TQString& name);
|
|
|
|
/**
|
|
* Loads the configuration plugin for a named Filter plugin.
|
|
* @param plugInName DesktopEntryName of the plugin.
|
|
* @return Pointer to the configuration plugin for the Filter.
|
|
*/
|
|
KttsFilterConf* loadFilterPlugin(const TQString& plugInName);
|
|
|
|
/**
|
|
* Display the Talker Configuration Dialog.
|
|
*/
|
|
void configureTalker();
|
|
|
|
/**
|
|
* Display the Filter Configuration Dialog.
|
|
*/
|
|
void configureFilterItem( bool sbd );
|
|
void configureFilter();
|
|
|
|
/**
|
|
* Add a filter.
|
|
*/
|
|
void addFilter( bool sbd );
|
|
|
|
/**
|
|
* Remove a filter.
|
|
*/
|
|
void removeFilter( bool sbd );
|
|
|
|
/**
|
|
* Move an item in a KListView up or down.
|
|
*/
|
|
void lowerItemPriority( KListView* lView );
|
|
void higherItemPriority( KListView* lView );
|
|
|
|
/**
|
|
* Count number of configured Filters with the specified plugin name.
|
|
*/
|
|
int countFilterPlugins(const TQString& filterPlugInName);
|
|
|
|
/**
|
|
* Uses KTrader to convert a translated Filter Plugin Name to DesktopEntryName.
|
|
* @param name The translated plugin name. From Name= line in .desktop file.
|
|
* @return DesktopEntryName. The name of the .desktop file (less .desktop).
|
|
* TQString() if not found.
|
|
*/
|
|
TQString FilterNameToDesktopEntryName(const TQString& name);
|
|
|
|
/**
|
|
* Uses KTrader to convert a DesktopEntryName into a translated Filter Plugin Name.
|
|
* @param desktopEntryName The DesktopEntryName.
|
|
* @return The translated Name of the plugin, from Name= line in .desktop file.
|
|
*/
|
|
TQString FilterDesktopEntryNameToName(const TQString& desktopEntryName);
|
|
|
|
/**
|
|
* Loads notify events from a file. Clearing listview if clear is True.
|
|
*/
|
|
TQString loadNotifyEventsFromFile( const TQString& filename, bool clear);
|
|
|
|
/**
|
|
* Saves notify events to a file.
|
|
*/
|
|
TQString saveNotifyEventsToFile(const TQString& filename);
|
|
|
|
/**
|
|
* Adds an item to the notify listview.
|
|
* message is only needed if action = nactSpeakCustom.
|
|
*/
|
|
TQListViewItem* addNotifyItem(
|
|
const TQString& eventSrc,
|
|
const TQString& event,
|
|
int action,
|
|
const TQString& message,
|
|
TalkerCode& talkerCode);
|
|
|
|
/**
|
|
* Main widget
|
|
*/
|
|
KCMKttsMgrWidget *m_kttsmgrw;
|
|
|
|
/**
|
|
* Object holding all the configuration
|
|
*/
|
|
KConfig *m_config;
|
|
|
|
/**
|
|
* KTTS Job Manager.
|
|
*/
|
|
KParts::ReadOnlyPart *m_jobMgrPart;
|
|
|
|
/**
|
|
* Plugin configuration dialog.
|
|
*/
|
|
KDialogBase* m_configDlg;
|
|
|
|
/**
|
|
* Sentence Boundary Detector button popup menu.
|
|
*/
|
|
TQPopupMenu* m_sbdPopmenu;
|
|
|
|
/**
|
|
* Talker(synth) Plugin currently loaded into configuration dialog.
|
|
*/
|
|
PlugInConf *m_loadedTalkerPlugIn;
|
|
|
|
/**
|
|
* Filter Plugin currently loaded into configuration dialog.
|
|
*/
|
|
KttsFilterConf *m_loadedFilterPlugIn;
|
|
|
|
/**
|
|
* Last talker ID. Used to generate a new ID.
|
|
*/
|
|
int m_lastTalkerID;
|
|
|
|
/**
|
|
* Last filter ID. Used to generate a new ID.
|
|
*/
|
|
int m_lastFilterID;
|
|
|
|
/**
|
|
* Last SBD filter ID. Used to generate to new ID.
|
|
*/
|
|
int m_lastSbdID;
|
|
|
|
/**
|
|
* True if the configuration has been changed.
|
|
*/
|
|
bool m_changed;
|
|
|
|
/**
|
|
* When True, suppresses emission of changed() signal. Used to suppress this
|
|
* signal while loading configuration.
|
|
*/
|
|
bool m_suppressConfigChanged;
|
|
|
|
/**
|
|
* Dictionary mapping language names to codes.
|
|
*/
|
|
TQMap<TQString, TQString> m_languagesToCodes;
|
|
|
|
/**
|
|
* A TQMap of languages codes indexed by synthesizer that supports them.
|
|
*/
|
|
SynthToLangMap m_synthToLangMap;
|
|
|
|
/**
|
|
* Default Talker Code for notifications.
|
|
*/
|
|
TQString m_defaultNotifyTalkerCode;
|
|
|
|
private slots:
|
|
/**
|
|
* Add a talker/filter.
|
|
* This is a wrapper function that takes the parameters for the real talker from the
|
|
* widgets to later call it.
|
|
*/
|
|
void slot_addTalker();
|
|
void slot_addNormalFilter();
|
|
void slot_addSbdFilter();
|
|
|
|
/**
|
|
* Remove talker/filter.
|
|
* This is a wrapper function that takes the parameters for the real removeTalker from the
|
|
* widgets to later call it.
|
|
*/
|
|
void slot_removeTalker();
|
|
void slot_removeNormalFilter();
|
|
void slot_removeSbdFilter();
|
|
|
|
/**
|
|
* This slot is called whenever user clicks the higher*Priority button (up).
|
|
*/
|
|
void slot_higherTalkerPriority();
|
|
void slot_higherNormalFilterPriority();
|
|
void slot_higherSbdFilterPriority();
|
|
|
|
/**
|
|
* This slot is called whenever user clicks the lower*Priority button (down).
|
|
*/
|
|
void slot_lowerTalkerPriority();
|
|
void slot_lowerNormalFilterPriority();
|
|
void slot_lowerSbdFilterPriority();
|
|
|
|
/**
|
|
* Update the status of the Talker/Filter buttons.
|
|
*/
|
|
void updateTalkerButtons();
|
|
void updateFilterButtons();
|
|
void updateSbdButtons();
|
|
|
|
/**
|
|
* This signal is emitted whenever user checks/unchecks the Enable TTS System check box.
|
|
*/
|
|
void enableKttsdToggled(bool checked);
|
|
|
|
/**
|
|
* This signal is emitted whenever user checks/unchecks the GStreamer radio button.
|
|
*/
|
|
void slotGstreamerRadioButton_toggled(bool state);
|
|
|
|
/**
|
|
* This signal is emitted whenever user checks/unchecks the ALSA radio button.
|
|
*/
|
|
void slotAlsaRadioButton_toggled(bool state);
|
|
|
|
/**
|
|
* This is emitted whenever user activates the ALSA pcm combobox.
|
|
*/
|
|
void slotPcmComboBox_activated();
|
|
|
|
/**
|
|
* This signal is emitted whenever user checks/unchecks the aKode radio button.
|
|
*/
|
|
void slotAkodeRadioButton_toggled(bool state);
|
|
|
|
/**
|
|
* User has requested to display the Talker/Filter Configuration Dialog.
|
|
*/
|
|
void slot_configureTalker();
|
|
void slot_configureNormalFilter();
|
|
void slot_configureSbdFilter();
|
|
|
|
/**
|
|
* Slots for the Talker/Filter Configuration dialogs.
|
|
*/
|
|
void slotConfigTalkerDlg_ConfigChanged();
|
|
void slotConfigFilterDlg_ConfigChanged();
|
|
void slotConfigTalkerDlg_DefaultClicked();
|
|
void slotConfigFilterDlg_DefaultClicked();
|
|
void slotConfigTalkerDlg_CancelClicked();
|
|
void slotConfigFilterDlg_CancelClicked();
|
|
|
|
/**
|
|
* Slots for Speed setting.
|
|
*/
|
|
void timeBox_valueChanged(int percentValue);
|
|
void timeSlider_valueChanged(int sliderValue);
|
|
|
|
/**
|
|
* Keep Audio CheckBox slot.
|
|
*/
|
|
void keepAudioCheckBox_toggled(bool checked);
|
|
|
|
/**
|
|
* Notify tab slots.
|
|
*/
|
|
void slotNotifyEnableCheckBox_toggled(bool checked);
|
|
void slotNotifyAddButton_clicked();
|
|
void slotNotifyRemoveButton_clicked();
|
|
void slotNotifyClearButton_clicked();
|
|
void slotNotifyLoadButton_clicked();
|
|
void slotNotifySaveButton_clicked();
|
|
void slotNotifyListView_selectionChanged();
|
|
void slotNotifyPresentComboBox_activated(int index);
|
|
void slotNotifyActionComboBox_activated(int index);
|
|
void slotNotifyTestButton_clicked();
|
|
void slotNotifyMsgLineEdit_textChanged(const TQString& text);
|
|
void slotNotifyTalkerButton_clicked();
|
|
|
|
/**
|
|
* Other slots.
|
|
*/
|
|
void slotTabChanged();
|
|
};
|
|
|
|
/// This is a small helper class to detect when user checks/unchecks a Filter in Filters tab
|
|
/// and emit changed() signal.
|
|
class KttsCheckListItem : public TQCheckListItem
|
|
{
|
|
public:
|
|
KttsCheckListItem( TQListView *parent,
|
|
const TQString &text, Type tt = RadioButtonController,
|
|
KCMKttsMgr* kcmkttsmgr = 0);
|
|
KttsCheckListItem( TQListView *parent, TQListViewItem *after,
|
|
const TQString &text, Type tt = RadioButtonController,
|
|
KCMKttsMgr* kcmkttsmgr = 0);
|
|
|
|
protected:
|
|
virtual void stateChange(bool);
|
|
|
|
private:
|
|
KCMKttsMgr* m_kcmkttsmgr;
|
|
};
|
|
|
|
#endif
|