X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=libchimara%2Fchimara-glk.c;h=5cdf63eba1ab7d64a241380d76d86f73cd7cb5dc;hb=ae4847f3dc67b8bdddf6e3e8dbec0348995efaef;hp=625460243e7caa9579e2b2138f29993b8464a2d9;hpb=07c4e25bfcbc35efcdd99139cff3ba61e03a507e;p=projects%2Fchimara%2Fchimara.git

diff --git a/libchimara/chimara-glk.c b/libchimara/chimara-glk.c
index 6254602..5cdf63e 100644
--- a/libchimara/chimara-glk.c
+++ b/libchimara/chimara-glk.c
@@ -22,6 +22,7 @@
 #include "glkunix.h"
 #include "init.h"
 #include "magic.h"
+#include "style.h"
 
 #define CHIMARA_GLK_MIN_WIDTH 0
 #define CHIMARA_GLK_MIN_HEIGHT 0
@@ -70,13 +71,6 @@
  * #include <gtk/gtk.h>
  * #include <libchimara/chimara-glk.h>
  *
- * static gboolean
- * quit(void)
- * {
- *     gtk_main_quit();
- *     return TRUE;
- * }
- *
  * int
  * main(int argc, char *argv[])
  * {
@@ -93,10 +87,15 @@
  *     /<!---->* Construct the window and its contents. We quit the GTK main loop
  *      * when the window's close button is clicked. *<!---->/
  *     window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
- *     g_signal_connect(window, "delete-event", G_CALLBACK(quit), NULL);
+ *     g_signal_connect(window, "delete-event", G_CALLBACK(gtk_main_quit), NULL);
  *     glk = chimara_glk_new();
  *     gtk_container_add(GTK_CONTAINER(window), glk);
  *     gtk_widget_show_all(window);
+ *
+ *     /<!---->* Add a reference to the ChimaraGlk widget, since we want it to
+ *      * persist after the window's delete-event -- otherwise it will be destroyed
+ *      * with the window. *<!---->/
+ *     g_object_ref(glk);
  *     
  *     /<!---->* Start the Glk program in a separate thread *<!---->/
  *     if(!chimara_glk_run(CHIMARA_GLK(glk), "./plugin.so", 2, plugin_argv, &error))
@@ -111,6 +110,7 @@
  *      * it is still running, and wait for it to exit. *<!---->/
  *     chimara_glk_stop(CHIMARA_GLK(glk));
  *     chimara_glk_wait(CHIMARA_GLK(glk));
+ *     g_object_unref(glk);
  *
  *     return 0;
  * }
@@ -305,6 +305,8 @@ chimara_glk_finalize(GObject *object)
 	g_free(priv->program_name);
 	g_free(priv->program_info);
 	g_free(priv->story_name);
+	g_free(priv->styles);
+	g_free(priv->glk_styles);
 
 	/* Chain up to parent */
     G_OBJECT_CLASS(chimara_glk_parent_class)->finalize(object);
@@ -1372,3 +1374,99 @@ chimara_glk_feed_line_input(ChimaraGlk *glk, const gchar *text)
 	g_async_queue_push(priv->line_input_queue, g_strdup(text));
 	event_throw(glk, evtype_ForcedLineInput, NULL, 0, 0);
 }
+
+/**
+ * chimara_glk_get_tag:
+ * @glk: a #ChimarGlk widget
+ * @window: The type of window to retrieve the tag for
+ * @name: The name of the tag to retrieve
+ *
+ * Use this function to get a #GtkTextTag so style properties can be changed.
+ * See also #chimara_glk_set_css_from_string.
+ *
+ * The layout of the text in Chimara is controlled by two sets of tags: one set
+ * describing the style in text buffers and one for text grids. See also the
+ * GLK specification for the difference between the two. The main narrative of
+ * a game is usually rendered in text buffers, whereas text grids are mostly
+ * used for status bars and in game menus.
+ *
+ * The following tag names are supported:
+ * <itemizedlist>
+ *	<listitem><para>normal</para></listitem>
+ *	<listitem><para>emphasized</para></listitem>
+ *	<listitem><para>preformatted</para></listitem>
+ *	<listitem><para>header</para></listitem>
+ *	<listitem><para>subheader</para></listitem>
+ *	<listitem><para>alert</para></listitem>
+ *	<listitem><para>note</para></listitem>
+ *	<listitem><para>block-quote</para></listitem>
+ *	<listitem><para>input</para></listitem>
+ *	<listitem><para>user1</para></listitem>
+ *	<listitem><para>user2</para></listitem>
+ *	<listitem><para>hyperlink</para></listitem>
+ *	<listitem><para>pager</para></listitem>
+ * </itenizedlist>
+ */
+GtkTextTag*
+chimara_glk_get_tag(ChimaraGlk *glk, ChimaraGlkWindowType window, const gchar *name)
+{
+	CHIMARA_GLK_USE_PRIVATE(glk, priv);
+
+	switch(window) {
+	case CHIMARA_GLK_TEXT_BUFFER:
+		return GTK_TEXT_TAG( g_hash_table_lookup(priv->styles->text_buffer, name) );
+		break;
+	case CHIMARA_GLK_TEXT_GRID:
+		return GTK_TEXT_TAG( g_hash_table_lookup(priv->styles->text_grid, name) );
+		break;
+	default:
+		ILLEGAL_PARAM("Unknown window type: %u", window);
+		return NULL;
+	}
+}
+
+/**
+ * chimara_glk_get_tag:
+ * @glk: a #ChimarGlk widget
+ *
+ * Retrieves the possible tag names to use in #chimara_glk_get_tag.
+ */
+const gchar**
+chimara_glk_get_tag_names(ChimaraGlk *glk)
+{
+	return style_get_tag_names();
+}
+
+/**
+ * chimara_glk_get_num_tag_names:
+ * @glk: a #ChimaraGlk widget
+ *
+ * Retrieves the number of style tags returned by #chimara_glk_get_tag_names.
+ */
+gint
+chimara_glk_get_num_tag_names(ChimaraGlk *glk)
+{
+	return CHIMARA_NUM_STYLES;
+}
+
+/**
+ * chimara_glk_update_style:
+ * @glk: a #ChimaraGlk widget
+ *
+ * Processes style updates and updates the widget to reflect the new style.
+ * Call this every time you change a property of a #GtkTextTag retrieved by
+ * #chimara_glk_get_tag.
+ */
+void
+chimara_glk_update_style(ChimaraGlk *glk)
+{
+	CHIMARA_GLK_USE_PRIVATE(glk, priv);
+	style_update(glk);
+
+	/* Schedule a redraw */
+	g_mutex_lock(priv->arrange_lock);
+	priv->needs_rearrange = TRUE;
+	priv->ignore_next_arrange_event = TRUE;
+	g_mutex_unlock(priv->arrange_lock);
+	gtk_widget_queue_resize( GTK_WIDGET(priv->self) );
+}