X-Git-Url: http://git.draconx.ca/gitweb/rrace.git/blobdiff_plain/31d8eda9987703c64fc63f4ddb4088cf3be5b7cc..5a4a23e5e8032dfa1f7b73facb32f0c9ab200765:/src/motif.h

diff --git a/src/motif.h b/src/motif.h
index 28e1b76..361abd9 100644
--- a/src/motif.h
+++ b/src/motif.h
@@ -20,7 +20,6 @@
 #define RRACE_MOTIF_H_
 
 #include <inttypes.h>
-#include "ewmhicon.h"
 #include "colour.h"
 #include "game.h"
 
@@ -56,9 +55,39 @@ void ui_timer_update(struct app_state *state, int_fast32_t elapsed);
 
 void x11_initialize(struct app_state *state, Widget shell);
 void x11_redraw_icon(struct app_state *state, Widget shell);
-void x11_redraw_goal(struct app_state *state, uint_fast32_t mask);
 void x11_redraw_game(struct app_state *state, uint_fast32_t mask);
-void x11_queue_render(struct app_state *state, uint_fast32_t game_mask,
-                                               uint_fast16_t goal_mask);
+
+/*
+ * Redraw goal tiles immediately.  The mask specifies which tiles will
+ * be redrawn, in the same bit arrangement as the board goal bitmaps.
+ * Tiles corresponding to set bits in mask are redrawn, and tiles
+ * corresponding to clear bits are not redrawn.
+ *
+ * Additionally, if icon_shell is non-null (with the caller passing the
+ * application shell widget), the program's icon pixmap is updated to
+ * match the current goal.
+ */
+void x11_redraw_goal(struct app_state *state, uint_fast32_t mask,
+                                              Widget icon_shell);
+
+/*
+ * Mark tiles for redraw.  The redraw is not performed immediately, but
+ * rather a background task is installed to perform the redraw at a later
+ * time.
+ *
+ * The mode parameter may be one of the following enumerated values:
+ *
+ *   * RENDER_MODE_GAME: mark game tiles for update.
+ *   * RENDER_MODE_GOAL: mark goal tiles for update.
+ *   * RENDER_MODE_BOTH: mark both game and goal tiles for update (probably
+ *                       only useful if mask has all bits set).
+ */
+void x11_queue_render(struct app_state *state, uint_fast32_t mask, int mode);
+
+enum {
+	RENDER_MODE_GOAL = 1,
+	RENDER_MODE_GAME = 2,
+	RENDER_MODE_BOTH = 3
+};
 
 #endif