tdeaccessibility/kttsd/plugins/freetts/freettsconf.h

/****************************************************************************
	Configuration widget and functions for FreeTTS (interactive) plug in
	-------------------
	Copyright : (C) 2004 Paul Giannaros
	-------------------
	Original author: Paul Giannaros <ceruleanblaze@gmail.com>
	Current Maintainer: Paul Giannaros <ceruleanblaze@gmail.com>
 ******************************************************************************/

/***************************************************************************
 *																					*
 *	 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 <tqstringlist.h>

#include <kdebug.h>
#include <kconfig.h>

#include <pluginconf.h>

#include "freettsconfigwidget.h"
#include "freettsproc.h"

class TQStringList;
class KProgressDialog;

class FreeTTSConf : public PlugInConf {
	Q_OBJECT
	TQ_OBJECT
	
	public:
		/** Constructor */
		FreeTTSConf( TQWidget* parent = 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