X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=libchimara%2Fchimara-glk.h;h=b8ec38cfbc90c7426df96e355d396681a97de6ad;hb=6702e46cbf0d5980a7386038d019c03fb12d3b52;hp=78ea8deae477e6b593f52d946a20a05f9972fd06;hpb=0619b371ff5c35ce062557c9ecf478379020673b;p=rodin%2Fchimara.git diff --git a/libchimara/chimara-glk.h b/libchimara/chimara-glk.h index 78ea8de..b8ec38c 100644 --- a/libchimara/chimara-glk.h +++ b/libchimara/chimara-glk.h @@ -3,7 +3,7 @@ #ifndef __CHIMARA_GLK_H__ #define __CHIMARA_GLK_H__ -#include +#include #include #include @@ -32,11 +32,50 @@ typedef struct _ChimaraGlkClass { /* Signals */ void(* stopped) (ChimaraGlk *self); void(* started) (ChimaraGlk *self); + void(* waiting) (ChimaraGlk *self); void(* char_input) (ChimaraGlk *self, guint32 window_rock, guint keysym); void(* line_input) (ChimaraGlk *self, guint32 window_rock, gchar *text); void(* text_buffer_output) (ChimaraGlk *self, guint32 window_rock, gchar *text); } ChimaraGlkClass; +/** + * ChimaraError: + * + * Error codes returned by #ChimaraGlk widgets and subclasses. + * + * + * CHIMARA_LOAD_MODULE_ERROR + * There was an error opening the plugin containing the Glk + * program. The error message from g_module_error() is appended to the GError message. + * + * + * CHIMARA_NO_GLK_MAIN + * The plugin containing the Glk program did not export a + * glk_main() function. + * + * + * CHIMARA_PLUGIN_NOT_FOUND + * An appropriate interpreter plugin for the autodetected + * game file type could not be found. + * + * + */ +typedef enum _ChimaraError { + CHIMARA_LOAD_MODULE_ERROR, + CHIMARA_NO_GLK_MAIN, + CHIMARA_PLUGIN_NOT_FOUND +} ChimaraError; + +/** + * CHIMARA_ERROR: + * + * The domain of errors raised by Chimara widgets. + */ +#define CHIMARA_ERROR chimara_error_quark() + +GQuark chimara_error_quark(void); GType chimara_glk_get_type(void) G_GNUC_CONST; GtkWidget *chimara_glk_new(void); void chimara_glk_set_interactive(ChimaraGlk *glk, gboolean interactive); @@ -51,9 +90,10 @@ void chimara_glk_set_monospace_font_string(ChimaraGlk *glk, const gchar *font); PangoFontDescription *chimara_glk_get_monospace_font_description(ChimaraGlk *glk); void chimara_glk_set_spacing(ChimaraGlk *glk, guint spacing); guint chimara_glk_get_spacing(ChimaraGlk *glk); -gboolean chimara_glk_run(ChimaraGlk *glk, gchar *plugin, int argc, char *argv[], GError **error); +gboolean chimara_glk_run(ChimaraGlk *glk, const gchar *plugin, int argc, char *argv[], GError **error); void chimara_glk_stop(ChimaraGlk *glk); void chimara_glk_wait(ChimaraGlk *glk); +gboolean chimara_glk_get_running(ChimaraGlk *glk); G_END_DECLS