summaryrefslogtreecommitdiff
path: root/navit/support/espeak/event.h
blob: b158d5eb3dc744b4c65149f634504b17fca7d8b9 (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
#ifndef EVENT_H
#define EVENT_H

/* 
Manage events (sentence, word, mark, end,...), is responsible of calling the external 
callback as soon as the relevant audio sample is played.


The audio stream is composed of samples from synthetised messages or audio icons.
Each event is associated to a sample. 

Scenario:

- event_declare is called for each expected event.

- A timeout is started for the first pending event.

- When the timeout happens, the synth_callback is called.

Note: the timeout is checked against the real progress of the audio stream, which depends on pauses or underruns. If the real progress is lower than the expected one, a new timeout starts.

*/

#include "speak_lib.h"

// Initialize the event component.
// First function to be called.
// the callback will be called when the event actually occurs.
// The callback is detailled in speak_lib.h .
void event_init(void);
void event_set_callback(t_espeak_callback* cb);

// Clear any pending event.
//
// Return: EE_OK: operation achieved 
//         EE_INTERNAL_ERROR.
espeak_ERROR event_clear_all (void);

// Declare a future event
//
// Return: EE_OK: operation achieved 
//         EE_BUFFER_FULL: the event can not be buffered; 
//           you may try after a while to call the function again.
//         EE_INTERNAL_ERROR.
espeak_ERROR event_declare (espeak_EVENT* event);

// Terminate the event component.
// Last function to be called.
void event_terminate(void);

#endif