gui.h
1
2
3
4
5
6
7
8
9
10
11
12
#ifndef _INCL_GUI_H_
#define _INCL_GUI_H_
#include "universal.h"
#ifdef __cplusplus
extern "C" {
#endif
typedef enum
{
MOJOGUI_PRIORITY_NEVER_TRY = 0,
13
MOJOGUI_PRIORITY_USER_REQUESTED,
14
15
MOJOGUI_PRIORITY_TRY_FIRST,
MOJOGUI_PRIORITY_TRY_NORMAL,
16
17
MOJOGUI_PRIORITY_TRY_LAST,
MOJOGUI_PRIORITY_TOTAL
18
19
} MojoGuiPluginPriority;
21
22
23
/*
* Abstract GUI interfaces.
*/
25
26
27
28
29
30
31
typedef struct MojoGuiSetupOptions MojoGuiSetupOptions;
struct MojoGuiSetupOptions
{
const char *description;
boolean value;
boolean is_group_parent;
uint64 size;
32
int opaque; // GUI drivers shouldn't touch this.
33
void *guiopaque; // For GUI drivers. App won't touch or free this.
34
35
36
37
MojoGuiSetupOptions *next_sibling;
MojoGuiSetupOptions *child;
};
38
39
40
41
42
43
44
45
#define MOJOGUI_ENTRY_POINT MojoSetup_Gui_GetInterface
#define MOJOGUI_ENTRY_POINT_STR DEFINE_TO_STR(MOJOGUI_ENTRY_POINT)
// Increment this value when MojoGui's structure changes.
#define MOJOGUI_INTERFACE_REVISION 1
typedef struct MojoGui MojoGui;
struct MojoGui
47
48
49
50
51
52
uint8 (*priority)(void);
const char* (*name)(void);
boolean (*init)(void);
void (*deinit)(void);
void (*msgbox)(const char *title, const char *text);
boolean (*promptyn)(const char *title, const char *text);
53
54
boolean (*start)(const char *title, const char *splash);
void (*stop)(void);
55
int (*readme)(const char *name, const uint8 *data, size_t len,
56
boolean can_back, boolean can_fwd);
57
int (*options)(MojoGuiSetupOptions *opts,
58
boolean can_back, boolean can_fwd);
59
60
char * (*destination)(const char **recommendations, int recnum,
int *command, boolean can_back, boolean can_fwd);
61
boolean (*insertmedia)(const char *medianame);
62
63
boolean (*progress)(const char *type, const char *component,
int percent, const char *item);
66
67
typedef const MojoGui* (*MojoGuiEntryPoint)(int revision,
const MojoSetupEntryPoints *e);
69
70
71
#if !BUILDING_EXTERNAL_PLUGIN
extern const MojoGui *GGui;
const MojoGui *MojoGui_initGuiPlugin(void);
72
73
74
void MojoGui_deinitGuiPlugin(void);
#else
75
76
__EXPORT__ const MojoGui *MOJOGUI_ENTRY_POINT(int revision,
const MojoSetupEntryPoints *e);
78
79
80
81
82
/*
* We do this as a macro so we only have to update one place, and it
* enforces some details in the plugins. Without effort, plugins don't
* support anything but the latest version of the interface.
*/
83
#define MOJOGUI_PLUGIN(module) \
84
85
86
87
88
89
90
static const MojoSetupEntryPoints *entry = NULL; \
static uint8 MojoGui_##module##_priority(void); \
static const char* MojoGui_##module##_name(void) { return #module; } \
static boolean MojoGui_##module##_init(void); \
static void MojoGui_##module##_deinit(void); \
static void MojoGui_##module##_msgbox(const char *title, const char *text); \
static boolean MojoGui_##module##_promptyn(const char *t1, const char *t2); \
91
92
static boolean MojoGui_##module##_start(const char *t, const char *s); \
static void MojoGui_##module##_stop(void); \
93
static int MojoGui_##module##_readme(const char *name, const uint8 *data, \
94
95
size_t len, boolean can_back, \
boolean can_fwd); \
96
static int MojoGui_##module##_options(MojoGuiSetupOptions *opts, \
97
boolean can_back, boolean can_fwd); \
98
99
static char *MojoGui_##module##_destination(const char **r, int recnum, \
int *command, boolean can_back, boolean can_fwd); \
100
static boolean MojoGui_##module##_insertmedia(const char *medianame); \
101
102
static boolean MojoGui_##module##_progress(const char *typ, const char *comp, \
int percent, const char *item); \
103
const MojoGui *MojoGuiPlugin_##module(int rev, const MojoSetupEntryPoints *e) \
105
106
107
108
109
110
111
112
if (rev == MOJOGUI_INTERFACE_REVISION) { \
static const MojoGui retval = { \
MojoGui_##module##_priority, \
MojoGui_##module##_name, \
MojoGui_##module##_init, \
MojoGui_##module##_deinit, \
MojoGui_##module##_msgbox, \
MojoGui_##module##_promptyn, \
113
114
115
MojoGui_##module##_start, \
MojoGui_##module##_stop, \
MojoGui_##module##_readme, \
116
MojoGui_##module##_options, \
117
MojoGui_##module##_destination, \
118
MojoGui_##module##_insertmedia, \
119
MojoGui_##module##_progress, \
120
121
}; \
entry = e; \
122
123
124
return &retval; \
} \
return NULL; \
127
#define CREATE_MOJOGUI_ENTRY_POINT(module) \
128
const MojoGui *MOJOGUI_ENTRY_POINT(int rev, const MojoSetupEntryPoints *e) \
130
return MojoGuiPlugin_##module(rev, e); \
133
#endif
135
136
137
/*
* make some decisions about which GUI plugins to build...
138
139
* We list them all here, but some are built, some aren't. Some are DLLs,
* some aren't...
140
141
142
*/
// Probably want to support this always, unless explicitly overridden.
143
const MojoGui *MojoGuiPlugin_stdio(int rev, const MojoSetupEntryPoints *e);
144
const MojoGui *MojoGuiPlugin_gtkplus2(int rev, const MojoSetupEntryPoints *e);
145
const MojoGui *MojoGuiPlugin_macosx(int rev, const MojoSetupEntryPoints *e);
147
148
// !!! FIXME: Qt? KDE? Gnome? Console? Cocoa?
149
150
151
152
153
154
#ifdef __cplusplus
}
#endif
#endif
155
// end of gui.h ...