X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=libchimara%2Fchimara-glk.h;h=dfa669e3afa1b4f281712ec65a47876be89dfbd3;hb=cbd4cb7f8c62b2ba51329a4cb082a96115a7529d;hp=78ea8deae477e6b593f52d946a20a05f9972fd06;hpb=0619b371ff5c35ce062557c9ecf478379020673b;p=rodin%2Fchimara.git diff --git a/libchimara/chimara-glk.h b/libchimara/chimara-glk.h index 78ea8de..dfa669e 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,12 @@ 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); +void chimara_glk_feed_char_input(ChimaraGlk *glk, guint32 keycode); +void chimara_glk_feed_line_input(ChimaraGlk *glk, const gchar *text); G_END_DECLS