1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
/***************************************************** vim:set ts=4 sw=4 sts=4:
Manages all the Talker (synth) plugins.
-------------------
Copyright:
(C) 2004-2005 by Gary Cramblitt <garycramblitt@comcast.net>
-------------------
Original author: 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 _TALKERMGR_H_
#define _TALKERMGR_H_
// Qt includes.
#include <tqstring.h>
#include <tqstringlist.h>
#include <tqmap.h>
#include <tqptrlist.h>
// KTTS includes.
#include "talkercode.h"
#include "pluginproc.h"
class TalkerMgr: public QObject
{
public:
/**
* Constructor.
*/
TalkerMgr(TQObject *parent = 0, const char *name = 0);
/**
* Destructor.
*/
~TalkerMgr();
/**
* Load all the configured plug ins populating loadedPlugIns
*/
int loadPlugIns(KConfig* config);
/**
* Get a list of the talkers configured in KTTS.
* @return A TQStringList of fully-specified talker codes, one
* for each talker user has configured.
*/
TQStringList getTalkers();
/**
* Returns a list of all the loaded plugins.
*/
TQPtrList<PlugInProc> getLoadedPlugIns();
/**
* Given a talker code, returns pointer to the closest matching plugin.
* @param talker The talker (language) code.
* @return Index to m_loadedPlugins array of Talkers.
*
* If a plugin has not been loaded to match the talker, returns the default
* plugin.
*/
int talkerToPluginIndex(const TQString& talker) const;
/**
* Given a talker code, returns pointer to the closest matching plugin.
* @param talker The talker (language) code.
* @return Pointer to closest matching plugin.
*
* If a plugin has not been loaded to match the talker, returns the default
* plugin.
*/
PlugInProc* talkerToPlugin(const TQString& talker) const;
/**
* Given a talker code, returns the parsed TalkerCode of the closest matching Talker.
* @param talker The talker (language) code.
* @return Parsed TalkerCode structure.
*
* If a plugin has not been loaded to match the talker, returns the default
* plugin.
*
* The returned TalkerCode is a copy and should be destroyed by caller.
*
* TODO: When picking a talker, %KTTSD will automatically determine if text contains
* markup and pick a talker that supports that markup, if available. This
* overrides all other attributes, i.e, it is treated as an automatic "top priority"
* attribute.
*/
TalkerCode* talkerToTalkerCode(const TQString& talker);
/**
* Given a Talker Code, returns the Talker ID of the talker that would speak
* a text job with that Talker Code.
* @param talkerCode Talker Code.
* @return Talker ID of the talker that would speak the text job.
*/
TQString talkerCodeToTalkerId(const TQString& talkerCode);
/**
* Get the user's default talker.
* @return A fully-specified talker code.
*
* @see talkers
* @see getTalkers
*/
TQString userDefaultTalker() const;
/**
* Determine whether the currently-configured speech plugin supports a speech markup language.
* @param talker Code for the talker to do the speaking. Example "en".
* If NULL, defaults to the user's default talker.
* @param markupType The kttsd code for the desired speech markup language.
* @return True if the plugin currently configured for the indicated
* talker supports the indicated speech markup language.
* @see kttsdMarkupType
*/
bool supportsMarkup(const TQString& talker, const uint markupType) const;
/**
* Try to automatically configure a Talker in the specified language.
* @param langCode Two-letter language code.
* @param config KConfig to be updated if successful.
* @return True if successful.
*
* If successful, the KConfig rc file is updated but the talker has not been loaded.
*/
bool autoconfigureTalker(const TQString& langCode, KConfig* config);
private:
/**
* Array of the loaded plug ins for different Talkers.
* Array of parsed Talker Codes for the plugins.
*/
TQPtrList<PlugInProc> m_loadedPlugIns;
TQStringList m_loadedTalkerIds;
TalkerCode::TalkerCodeList m_loadedTalkerCodes;
/**
* Cache of talker codes and index of closest matching Talker.
*/
mutable TQMap<TQString,int> m_talkerToPlugInCache;
};
#endif // _TALKERMGR_H_
|
