X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=libchimara%2Fchimara-glk.h;h=b3ea8b86002db3d8bfcaac774929217eaf3898db;hb=28c6b69cb8e971a9959066fe896edcc4ae412935;hp=df6aaefd99bfed197c3d66be9501afb47073390d;hpb=b397495e945570aaacee0eb8fa25704d03761401;p=projects%2Fchimara%2Fchimara.git diff --git a/libchimara/chimara-glk.h b/libchimara/chimara-glk.h index df6aaef..b3ea8b8 100644 --- a/libchimara/chimara-glk.h +++ b/libchimara/chimara-glk.h @@ -39,6 +39,14 @@ typedef struct _ChimaraGlkClass { void(* iliad_screen_update) (ChimaraGlk *self, gboolean typing); } ChimaraGlkClass; +/** + * ChimaraGlkWindowType: + * @CHIMARA_GLK_TEXT_BUFFER: The styles for text buffer windows. + * @CHIMARA_GLK_TEXT_GRID: The styles for text grid windows. + * + * Specifies the type of windows for which to retrieve the style tag with + * chimara_glk_get_tag(). + */ typedef enum { CHIMARA_GLK_TEXT_BUFFER, CHIMARA_GLK_TEXT_GRID @@ -66,6 +74,34 @@ typedef enum _ChimaraError { CHIMARA_PLUGIN_ALREADY_RUNNING } ChimaraError; +/** + * ChimaraResourceType: + * @CHIMARA_RESOURCE_SOUND: A sound file. + * @CHIMARA_RESOURCE_IMAGE: An image file. + * + * The type of resource that the Glk program is requesting, passed to a + * #ChimaraResourceLoadFunc. + */ +typedef enum _ChimaraResourceType { + CHIMARA_RESOURCE_SOUND, + CHIMARA_RESOURCE_IMAGE +} ChimaraResourceType; + +/** + * ChimaraResourceLoadFunc: + * @usage: A #ChimaraResourceType constant. + * @resnum: The resource number to look for. + * @user_data: A pointer to provide to the callback. + * + * The type of function passed to chimara_glk_set_resource_load_callback(). It + * takes a #ChimaraResourceType constant, @usage, to indicate what sort of + * resource to look for; @resnum is the resource number to look for, and + * @user_data is the user data provided along with the callback. The function + * must return an allocated string containing the filename where the resource + * can be found. + */ +typedef gchar * (*ChimaraResourceLoadFunc)(ChimaraResourceType usage, guint32 resnum, gpointer user_data); + /** * CHIMARA_ERROR: * @@ -86,15 +122,19 @@ void chimara_glk_set_css_from_string(ChimaraGlk *glk, const gchar *css); void chimara_glk_set_spacing(ChimaraGlk *glk, guint spacing); guint chimara_glk_get_spacing(ChimaraGlk *glk); gboolean chimara_glk_run(ChimaraGlk *glk, const gchar *plugin, int argc, char *argv[], GError **error); +gboolean chimara_glk_run_file(ChimaraGlk *self, GFile *plugin_file, int argc, char *argv[], GError **error); void chimara_glk_stop(ChimaraGlk *glk); void chimara_glk_wait(ChimaraGlk *glk); +void chimara_glk_unload_plugin(ChimaraGlk *glk); gboolean chimara_glk_get_running(ChimaraGlk *glk); void chimara_glk_feed_char_input(ChimaraGlk *glk, guint32 keyval); void chimara_glk_feed_line_input(ChimaraGlk *glk, const gchar *text); +gboolean chimara_glk_is_char_input_pending(ChimaraGlk *glk); +gboolean chimara_glk_is_line_input_pending(ChimaraGlk *glk); GtkTextTag *chimara_glk_get_tag(ChimaraGlk *glk, ChimaraGlkWindowType window, const gchar *name); -const gchar **chimara_glk_get_tag_names(ChimaraGlk *glk); -gint chimara_glk_get_num_tag_names(ChimaraGlk *glk); +const gchar **chimara_glk_get_tag_names(ChimaraGlk *glk, unsigned int *num_tags); void chimara_glk_update_style(ChimaraGlk *glk); +void chimara_glk_set_resource_load_callback(ChimaraGlk *glk, ChimaraResourceLoadFunc func, gpointer user_data, GDestroyNotify destroy_user_data); G_END_DECLS