gui.h 3.47 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
#ifndef _GUI_H_
#define _GUI_H_

/* defines the public API of the GUI */

typedef void gui;
typedef void widget;

#define HORIZONTAL 0
#define VERTICAL   1

12
13
14
#define BACKGROUND_COLOR 0
#define FOREGROUND_COLOR 1

15
16
17
18
19
/* key modifiers */
#define KEY_SHIFT   (1<<0)
#define KEY_CONTROL (1<<1)
#define KEY_ALT     (1<<2)

20
21
22
23
gui *gui_init(void);

/* position = -1 to put at the end */
void widget_add_child(gui *gui, widget *parent, widget *child, int position);
Cedric Roux's avatar
Cedric Roux committed
24
void widget_del_child(gui *gui, widget *parent, widget *child);
25
void widget_dirty(gui *gui, widget *this);
26
27
28

widget *new_toplevel_window(gui *gui, int width, int height, char *title);
widget *new_container(gui *gui, int vertical);
29
widget *new_positioner(gui *gui);
30
31
32
widget *new_label(gui *gui, const char *text);
widget *new_xy_plot(gui *gui, int width, int height, char *label,
    int vruler_width);
Cedric Roux's avatar
Cedric Roux committed
33
widget *new_textlist(gui *gui, int width, int nlines, int background_color);
Cedric Roux's avatar
Cedric Roux committed
34
35
widget *new_timeline(gui *gui, int width, int number_of_sublines,
    int subline_height);
36
widget *new_space(gui *gui, int width, int height);
37

38
39
void label_set_clickable(gui *gui, widget *label, int clickable);

40
41
42
void container_set_child_growable(gui *_gui, widget *_this,
    widget *child, int growable);

43
int xy_plot_new_plot(gui *gui, widget *this, int color);
44
45
void xy_plot_set_range(gui *gui, widget *this,
    float xmin, float xmax, float ymin, float ymax);
Cedric Roux's avatar
Cedric Roux committed
46
void xy_plot_set_points(gui *gui, widget *this,
47
    int plot, int npoints, float *x, float *y);
48
void xy_plot_get_dimensions(gui *gui, widget *this, int *width, int *height);
49

50
void textlist_add(gui *gui, widget *this, const char *text, int position,
Cedric Roux's avatar
Cedric Roux committed
51
    int color);
52
53
void textlist_del(gui *gui, widget *this, int position);
void textlist_add_silent(gui *gui, widget *this, const char *text,
Cedric Roux's avatar
Cedric Roux committed
54
    int position, int color);
55
56
void textlist_del_silent(gui *gui, widget *this, int position);
void textlist_state(gui *_gui, widget *_this,
Cedric Roux's avatar
Cedric Roux committed
57
    int *visible_lines, int *start_line, int *number_of_lines);
58
59
void textlist_set_start_line(gui *gui, widget *this, int line);
void textlist_get_line(gui *gui, widget *this, int line,
Cedric Roux's avatar
Cedric Roux committed
60
    char **text, int *color);
61
void textlist_set_color(gui *gui, widget *this, int line, int color);
62

Cedric Roux's avatar
Cedric Roux committed
63
void timeline_clear(gui *gui, widget *this);
64
void timeline_clear_silent(gui *gui, widget *this);
Cedric Roux's avatar
Cedric Roux committed
65
66
void timeline_add_points(gui *gui, widget *this, int subline, int color,
    int *x, int len);
67
68
void timeline_add_points_silent(gui *gui, widget *this, int subline,
    int color, int *x, int len);
Cedric Roux's avatar
Cedric Roux committed
69
70
void timeline_set_subline_background_color(gui *gui, widget *this,
    int subline, int color);
Cedric Roux's avatar
Cedric Roux committed
71
void timeline_get_width(gui *gui, widget *this, int *width);
Cedric Roux's avatar
Cedric Roux committed
72

73
74
75
76
77
78
79
void gui_loop(gui *gui);

void glock(gui *gui);
void gunlock(gui *gui);

int new_color(gui *gui, char *color);

80
81
/* notifications */
/* known notifications:
82
 * - textlist:
Cedric Roux's avatar
Cedric Roux committed
83
84
85
 *      - scrollup   { void *: NULL }
 *      - scrolldown { void *: NULL }
 *      - click      { int [2]: line, button }
86
87
 * - label:
 *      - click      { int: button } (if enabled)
Cedric Roux's avatar
Cedric Roux committed
88
89
 * - timeline
 *      - resize     { int: width }
90
91
 *      - scrollup   { int [3]: x, y, key_modifiers }
 *      - scrolldown { int [3]: x, y, key_modifiers }
Cedric Roux's avatar
Cedric Roux committed
92
 *      - click      { int: button }
93
94
95
96
97
98
99
100
101
 */

/* same type as in gui_defs.h */
typedef void (*notifier)(void *private, gui *g,
    char *notification, widget *w, void *notification_data);
unsigned long register_notifier(gui *g, char *notification, widget *w,
    notifier handler, void *private);
void unregister_notifier(gui *g, unsigned long notifier_id);

102
#endif /* _GUI_H_ */