Alter x11_queue_render interface to better match usage.

[rrace.git] / src / motif.h

diff --git a/src/motif.h b/src/motif.h
index c85e8a9a4dfea4ec68d078f6934af7b198e78889..076f4f60cfd58da466a9e8b78b02cc3b45a8b3cc 100644 (file)
--- a/src/motif.h
+++ b/src/motif.h
@@ -57,7 +57,25 @@ 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);
+
+/*
+ * 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