2 * _NET_WM_ICON helpers for slide puzzle game
3 * Copyright © 2022 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_EWMHICON_H_
20 #define RRACE_EWMHICON_H_
23 * Define X_DISPLAY_MISSING to allow building without X11 (for test purposes)
25 #if !X_DISPLAY_MISSING
26 # include <X11/Intrinsic.h>
29 /* Stub types to allow compilation */
32 unsigned short red, green, blue;
38 * Size of generated EWMH icon data (nelements argument to XChangeProperty).
40 #define EWMH_ICON_NELEM (2+16*16 + 2+24*24 + 2+32*32 + 2+48*48)
43 * Generate EWMH icon data based on a sequence of tile colours. Internally,
44 * this calls icon_tile16 and friends to draw each of the icon patterns.
46 * The sequence specifies the colour of all 9 icon tiles, beginning from the
47 * top left in row-major order. Each value specifies three offsets into
48 * the provided colour map, encoded in the same manner as icon_tile16 et al.
50 * Returns a newly-allocated buffer which is suitable for use directly with
51 * XChangeProperty, and should be freed by the caller.
53 * If allocation fails, a null pointer is returned.
55 void *ewmh_icon_generate(const unsigned long *seq, const XColor *map);
57 #if !X_DISPLAY_MISSING
59 * Check if the root window indicates support for EWMH icons. Returns 1 if
60 * supported, or 0 otherwise.
62 int ewmh_probe_wm_icon(Widget shell);