Combine x11_redraw_icon and x11_redraw_goal.

[rrace.git] / src / motif.h

diff --git a/src/motif.h b/src/motif.h
index 076f4f60cfd58da466a9e8b78b02cc3b45a8b3cc..361abd98b12690807dff01e59e1166e794625e41 100644 (file)
--- a/src/motif.h
+++ b/src/motif.h
@@ -55,9 +55,21 @@ 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);
 
+/*
+ * 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