/**************************************************************************** Configuration widget and functions for FreeTTS (interactive) plug in ------------------- Copyright : (C) 2004 Paul Giannaros ------------------- Original author: Paul Giannaros Current Maintainer: Paul Giannaros ******************************************************************************/ /*************************************************************************** * * * 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 _FREETTSCONF_H_ #define _FREETTSCONF_H_ #include #include #include #include #include "freettsconfigwidget.h" #include "freettsproc.h" class TQStringList; class KProgressDialog; class FreeTTSConf : public PlugInConf { Q_OBJECT TQ_OBJECT public: /** Constructor */ FreeTTSConf( TQWidget* tqparent = 0, const char* name = 0, const TQStringList &args = TQStringList()); /** Destructor */ ~FreeTTSConf(); /** 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(KConfig *config, const TQString &configGroup); /** 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(KConfig *config, const TQString &configGroup); /** 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 function informs the plugin of the desired language to be spoken * by the plugin. The plugin should attempt to adapt itself to the * specified language code, choosing sensible defaults if necessary. * If the passed-in code is TQString(), no specific language has * been chosen. * @param lang The desired language code or Null if none. * * If the plugin is unable to support the desired language, that is OK. * Language codes are given by ISO 639-1 and are in lowercase. * The code may also include an ISO 3166 country code in uppercase * separated from the language code by underscore (_). For * example, en_GB. If your plugin supports the given language, but * not the given country, treat it as though the country * code were not specified, i.e., adapt to the given language. */ void setDesiredLanguage(const TQString &lang); /** * Return fully-specified talker code for the configured plugin. This code * uniquely identifies the configured instance of the plugin and distinquishes * one instance from another. If the plugin has not been fully configured, * i.e., cannot yet synthesize, return TQString(). * @return Fully-specified talker code. */ TQString getTalkerCode(); /** * Function searches the $PATH for a file. If it exists, it returns the full path * to that file. If not, then it returns an empty TQString. * @param name The name of the file to search for. * @returns The full path to the file or an empty TQString. */ private slots: void configChanged(bool t = true) { emit changed(t); }; void slotFreeTTSTest_clicked(); void slotSynthFinished(); void slotSynthStopped(); private: /// Language code. TQString m_languageCode; /// Configuration Widget. FreeTTSConfWidget *m_widget; /// FreeTTS synthesizer. FreeTTSProc *m_freettsProc; /// Synthesized wave file name. TQString m_waveFile; /// Progress dialog. KProgressDialog* m_progressDlg; }; #endif