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
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
#![allow(non_camel_case_types)]
#[repr(C)]
#[derive(Debug, Copy, Clone)]
pub struct pico_system {
_unused: [u8; 0],
}
pub type pico_System = *mut pico_system;
#[repr(C)]
#[derive(Debug, Copy, Clone)]
pub struct pico_resource {
_unused: [u8; 0],
}
pub type pico_Resource = *mut pico_resource;
#[repr(C)]
#[derive(Debug, Copy, Clone)]
pub struct pico_engine {
_unused: [u8; 0],
}
pub type pico_Engine = *mut pico_engine;
pub type pico_Int16 = ::std::os::raw::c_short;
pub type pico_Uint16 = ::std::os::raw::c_ushort;
pub type pico_Int32 = ::std::os::raw::c_int;
pub type pico_Uint32 = ::std::os::raw::c_uint;
pub type pico_Char = ::std::os::raw::c_uchar;
pub type pico_Retstring = [::std::os::raw::c_char; 200usize];
pub type pico_Status = ::std::os::raw::c_int;
extern "C" {
#[doc = "Initializes the Pico system and returns its handle in \'outSystem\'."]
#[doc = "\'memory\' and \'size\' define the location and maximum size of memory"]
#[doc = "in number of bytes that the Pico system will use. The minimum size"]
#[doc = "required depends on the number of engines and configurations of"]
#[doc = "lingware to be used. No additional memory will be allocated by the"]
#[doc = "Pico system. This function must be called before any other API"]
#[doc = "function is called. It may only be called once (e.g. at application"]
#[doc = "startup), unless a call to \'pico_terminate\'."]
pub fn pico_initialize(
memory: *mut ::std::os::raw::c_void,
size: pico_Uint32,
outSystem: *mut pico_System,
) -> pico_Status;
}
extern "C" {
#[doc = "Terminates the Pico system. Lingware resources still being loaded"]
#[doc = "are unloaded automatically. The memory area provided to Pico in"]
#[doc = "\'pico_initialize\' is released. The system handle becomes"]
#[doc = "invalid. It is not allowed to call this function as long as Pico"]
#[doc = "engine instances are existing. No API function may be called after"]
#[doc = "this function, except for \'pico_initialize\', which reinitializes"]
#[doc = "the system."]
pub fn pico_terminate(system: *mut pico_System) -> pico_Status;
}
extern "C" {
#[doc = "Returns in \'outMessage\' a description of the system status or of an"]
#[doc = "error that occurred with the most recently called system-level API"]
#[doc = "function."]
pub fn pico_getSystemStatusMessage(
system: pico_System,
errCode: pico_Status,
outMessage: *mut ::std::os::raw::c_char,
) -> pico_Status;
}
extern "C" {
#[doc = "Returns in \'outNrOfWarnings\' the number of warnings that occurred"]
#[doc = "with the most recently called system-level API function."]
pub fn pico_getNrSystemWarnings(
system: pico_System,
outNrOfWarnings: *mut pico_Int32,
) -> pico_Status;
}
extern "C" {
#[doc = "Returns in \'outMessage\' a description of a warning that occurred"]
#[doc = "with the most recently called system-level API function."]
#[doc = "\'warningIndex\' must be in the range 0..N-1 where N is the number of"]
#[doc = "warnings returned by \'pico_getNrSystemWarnings\'. \'outCode\' returns"]
#[doc = "the warning as an integer code (cf. PICO_WARN_*)."]
pub fn pico_getSystemWarning(
system: pico_System,
warningIndex: pico_Int32,
outCode: *mut pico_Status,
outMessage: *mut ::std::os::raw::c_char,
) -> pico_Status;
}
extern "C" {
#[doc = "Loads a resource file into the Pico system. The number of resource"]
#[doc = "files loaded in parallel is limited by PICO_MAX_NUM_RESOURCES."]
#[doc = "Loading of a resource file may be done at any time (even in"]
#[doc = "parallel to a running engine doing TTS synthesis), but with the"]
#[doc = "general restriction that functions taking a system handle as their"]
#[doc = "first argument must be called in a mutually exclusive fashion. The"]
#[doc = "loaded resource will be available only to engines started after the"]
#[doc = "resource is fully loaded, i.e., not to engines currently"]
#[doc = "running."]
pub fn pico_loadResource(
system: pico_System,
resourceFileName: *const pico_Char,
outResource: *mut pico_Resource,
) -> pico_Status;
}
extern "C" {
#[doc = "Unloads a resource file from the Pico system. If no engine uses the"]
#[doc = "resource file, the resource is removed immediately and its"]
#[doc = "associated internal memory is released, otherwise"]
#[doc = "PICO_EXC_RESOURCE_BUSY is returned."]
pub fn pico_unloadResource(
system: pico_System,
inoutResource: *mut pico_Resource,
) -> pico_Status;
}
extern "C" {
#[doc = "Gets the unique resource name of a loaded resource"]
pub fn pico_getResourceName(
system: pico_System,
resource: pico_Resource,
outName: *mut ::std::os::raw::c_char,
) -> pico_Status;
}
extern "C" {
#[doc = "Creates a voice definition. Resources must be added to the created"]
#[doc = "voice with \'pico_addResourceToVoiceDefinition\' before using the"]
#[doc = "voice in \'pico_newEngine\'. It is an error to create a voice"]
#[doc = "definition with a previously defined voice name. In that case use"]
#[doc = "\'pico_releaseVoiceName\' first."]
pub fn pico_createVoiceDefinition(
system: pico_System,
voiceName: *const pico_Char,
) -> pico_Status;
}
extern "C" {
#[doc = "Adds a mapping pair (\'voiceName\', \'resourceName\') to the voice"]
#[doc = "definition. Multiple mapping pairs can added to a voice defintion."]
#[doc = "When calling \'pico_newEngine\' with \'voiceName\', the corresponding"]
#[doc = "resources from the mappings will be used with that engine."]
pub fn pico_addResourceToVoiceDefinition(
system: pico_System,
voiceName: *const pico_Char,
resourceName: *const pico_Char,
) -> pico_Status;
}
extern "C" {
#[doc = "Releases the voice definition \'voiceName\'."]
pub fn pico_releaseVoiceDefinition(
system: pico_System,
voiceName: *const pico_Char,
) -> pico_Status;
}
extern "C" {
#[doc = "Creates and initializes a new Pico engine instance and returns its"]
#[doc = "handle in \'outEngine\'. Only one instance per system is currently"]
#[doc = "possible."]
pub fn pico_newEngine(
system: pico_System,
voiceName: *const pico_Char,
outEngine: *mut pico_Engine,
) -> pico_Status;
}
extern "C" {
#[doc = "Disposes a Pico engine and releases all memory it occupied. The"]
#[doc = "engine handle becomes invalid."]
pub fn pico_disposeEngine(system: pico_System, inoutEngine: *mut pico_Engine) -> pico_Status;
}
extern "C" {
#[doc = "Puts text \'text\' encoded in UTF8 into the Pico text input buffer."]
#[doc = "\'textSize\' is the maximum size in number of bytes accessible in"]
#[doc = "\'text\'. The input text may also contain text-input commands to"]
#[doc = "change, for example, speed or pitch of the resulting speech"]
#[doc = "output. The number of bytes actually copied to the Pico text input"]
#[doc = "buffer is returned in \'outBytesPut\'. Sentence ends are"]
#[doc = "automatically detected. \'\\0\' characters may be embedded in \'text\'"]
#[doc = "to finish text input or separate independently to be synthesized"]
#[doc = "text parts from each other. Repeatedly calling \'pico_getData\' will"]
#[doc = "result in the content of the text input buffer to be synthesized"]
#[doc = "(up to the last sentence end or \'\\0\' character detected). To empty"]
#[doc = "the internal buffers without finishing synthesis, use the function"]
#[doc = "\'pico_resetEngine\'."]
pub fn pico_putTextUtf8(
engine: pico_Engine,
text: *const pico_Char,
textSize: pico_Int16,
outBytesPut: *mut pico_Int16,
) -> pico_Status;
}
extern "C" {
#[doc = "Gets speech data from the engine. Every time this function is"]
#[doc = "called, the engine performs, within a short time slot, a small"]
#[doc = "amount of processing its input text, and then gives control back to"]
#[doc = "the calling application. Ie. after calling \'pico_putTextUtf8\'"]
#[doc = "(incl. a final embedded \'\\0\'), this function needs to be called"]
#[doc = "repeatedly till \'outBytesReceived\' bytes are returned in"]
#[doc = "\'outBuffer\'. The type of data returned in \'outBuffer\' (e.g. 8 or 16"]
#[doc = "bit PCM samples) is returned in \'outDataType\' and depends on the"]
#[doc = "lingware resources. Possible \'outDataType\' values are listed in"]
#[doc = "picodefs.h (PICO_DATA_*)."]
#[doc = "This function returns PICO_STEP_BUSY while processing input and"]
#[doc = "producing speech output. Once all data is returned and there is no"]
#[doc = "more input text available in the Pico text input buffer,"]
#[doc = "PICO_STEP_IDLE is returned. All other function return values"]
#[doc = "indicate a system error."]
pub fn pico_getData(
engine: pico_Engine,
outBuffer: *mut ::std::os::raw::c_void,
bufferSize: pico_Int16,
outBytesReceived: *mut pico_Int16,
outDataType: *mut pico_Int16,
) -> pico_Status;
}
extern "C" {
#[doc = "Resets the engine and clears all engine-internal buffers, in"]
#[doc = "particular text input and signal data output buffers."]
#[doc = "\'resetMode\' is one of \'PICO_RESET_SOFT\', to be used to flush the engine,"]
#[doc = "or \'PICO_RESET_FULL\', to reset the engine after an engine error."]
pub fn pico_resetEngine(engine: pico_Engine, resetMode: pico_Int32) -> pico_Status;
}
extern "C" {
#[doc = "Returns in \'outMessage\' a description of the engine status or of an"]
#[doc = "error that occurred with the most recently called engine-level API"]
#[doc = "function."]
pub fn pico_getEngineStatusMessage(
engine: pico_Engine,
errCode: pico_Status,
outMessage: *mut ::std::os::raw::c_char,
) -> pico_Status;
}
extern "C" {
#[doc = "Returns in \'outNrOfWarnings\' the number of warnings that occurred"]
#[doc = "with the most recently called engine-level API function."]
pub fn pico_getNrEngineWarnings(
engine: pico_Engine,
outNrOfWarnings: *mut pico_Int32,
) -> pico_Status;
}
extern "C" {
#[doc = "Returns in \'outMessage\' a description of a warning that occurred"]
#[doc = "with the most recently called engine-level API function."]
#[doc = "\'warningIndex\' must be in the range 0..N-1 where N is the number of"]
#[doc = "warnings returned by \'pico_getNrEngineWarnings\'. \'outCode\' returns"]
#[doc = "the warning as an integer code (cf. PICO_WARN_*)."]
pub fn pico_getEngineWarning(
engine: pico_Engine,
warningIndex: pico_Int32,
outCode: *mut pico_Status,
outMessage: *mut ::std::os::raw::c_char,
) -> pico_Status;
}