summaryrefslogtreecommitdiff
path: root/navit/support/espeak/fifo.h
blob: 0077d5db6dc8769d2d61e574ab66e709238ddaa1 (plain)
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
#ifndef FIFO_H
#define FIFO_H

// Helps to add espeak commands in a first-in first-out queue 
// and run them asynchronously.

#include "espeak_command.h"
#include "speak_lib.h"

// Initialize the fifo component.
// First function to be called.
void fifo_init(void);

// Add an espeak command.
//
// Note: this function fails if too many commands are already buffered.
// In such a case, the calling function could wait and then add again its command. 
//
// Return: EE_OK: operation achieved 
//         EE_BUFFER_FULL: the command can not be buffered; 
//           you may try after a while to call the function again.
//         EE_INTERNAL_ERROR.
espeak_ERROR fifo_add_command (t_espeak_command* c);

// Add two espeak commands in a single transaction.
//
// Note: this function fails if too many commands are already buffered.
// In such a case, the calling function could wait and then add again these commands. 
//
// Return: EE_OK: operation achieved 
//         EE_BUFFER_FULL: at least one command can not be buffered; 
//           you may try after a while to call the function again.
//         EE_INTERNAL_ERROR.
espeak_ERROR fifo_add_commands (t_espeak_command* c1, t_espeak_command* c2);

// The current running command must be stopped and the awaiting commands are cleared.
// Return: EE_OK: operation achieved 
//         EE_INTERNAL_ERROR.
espeak_ERROR fifo_stop (void);

// Is there a running command?
// Returns 1 if yes; 0 otherwise.
int fifo_is_busy (void);

// Terminate the fifo component.
// Last function to be called.
void fifo_terminate(void);

// Indicates if the running command is still enabled.
//
// Note: this function is mainly called by the SynthCallback (speak_lib.cpp)
// It indicates if the actual wave sample can still be played. It is helpful for 
// stopping speech as soon as a cancel command is applied. 
//
// Returns 1 if yes, or 0 otherwise.
int fifo_is_command_enabled(void);

#endif