2 * X11 GUI for slide puzzle game
3 * Copyright © 2022-2023 Nick Bowler
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <https://www.gnu.org/licenses/>.
19 #ifndef RRACE_MOTIF_H_
20 #define RRACE_MOTIF_H_
26 /* If set, _NET_WM_ICON property will be added/updated to toplevel window. */
27 #define FLAG_USE_EWMH_ICONS 1u
29 /* If set, the goal will be displayed over the main play area. */
30 #define FLAG_VIEW_GOAL_ON_GAME 2u
32 /* If set, the Xt timer update process is currently installed. */
33 #define FLAG_TIMER_RUNNING 4u
39 struct xcounter *timer;
44 uint_least32_t render_game_mask;
45 uint_least16_t render_goal_mask;
46 uint_least16_t game_tile_sz, goal_tile_sz;
49 uint_least32_t tile_colour[TILE_MAX-1][3];
52 void ui_initialize(struct app_state *state, Widget shell);
53 void ui_show_about(struct app_state *state, Widget shell);
54 void ui_timer_update(struct app_state *state, int_fast32_t elapsed);
56 void x11_initialize(struct app_state *state, Widget shell);
57 void x11_redraw_icon(struct app_state *state, Widget shell);
58 void x11_redraw_game(struct app_state *state, uint_fast32_t mask);
61 * Redraw goal tiles immediately. The mask specifies which tiles will
62 * be redrawn, in the same bit arrangement as the board goal bitmaps.
63 * Tiles corresponding to set bits in mask are redrawn, and tiles
64 * corresponding to clear bits are not redrawn.
66 * Additionally, if icon_shell is non-null (with the caller passing the
67 * application shell widget), the program's icon pixmap is updated to
68 * match the current goal.
70 void x11_redraw_goal(struct app_state *state, uint_fast32_t mask,
74 * Mark tiles for redraw. The redraw is not performed immediately, but
75 * rather a background task is installed to perform the redraw at a later
78 * The mode parameter may be one of the following enumerated values:
80 * * RENDER_MODE_GAME: mark game tiles for update.
81 * * RENDER_MODE_GOAL: mark goal tiles for update.
82 * * RENDER_MODE_BOTH: mark both game and goal tiles for update (probably
83 * only useful if mask has all bits set).
85 void x11_queue_render(struct app_state *state, uint_fast32_t mask, int mode);