src/ewmhicon.h

   1 /*
   2  * _NET_WM_ICON helpers for slide puzzle game
   3  * Copyright © 2022 Nick Bowler
   4  *
   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.
   9  *
  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.
  14  *
  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/>.
  17  */
  18
  19 #ifndef EWMHICON_H_
  20 #define EWMHICON_H_
  21
  22 /*
  23  * Define X_DISPLAY_MISSING to allow building without X11 (for test purposes)
  24  */
  25 #if !X_DISPLAY_MISSING
  26 #  include <X11/Intrinsic.h>
  27 #else
  28
  29 /* Stub types to allow compilation */
  30 typedef struct {
  31         unsigned short red, green, blue;
  32 } XColor;
  33
  34 typedef struct stub_widget *Widget;
  35
  36 #endif
  37
  38 enum { COLOUR_PRIMARY, COLOUR_DARK, COLOUR_LIGHT, COLOUR_MAX };
  39
  40 /*
  41  * Helpers for drawing window icons in various sizes.  The tileXX functions
  42  * draw one (out of 9) tiles at a particular size using a particular colour
  43  * set.  Call for each tile position to draw a complete icon.
  44  */
  45 enum { ICON_16x16, ICON_24x24, ICON_32x32, ICON_48x48, ICON_MAX };
  46 #define EWMH_ICON_NELEM (2+16*16 + 2+24*24 + 2+32*32 + 2+48*48)
  47
  48 void ewmh_tile16(unsigned long *icon, const XColor *c, int tile_x, int tile_y);
  49 void ewmh_tile24(unsigned long *icon, const XColor *c, int tile_x, int tile_y);
  50 void ewmh_tile32(unsigned long *icon, const XColor *c, int tile_x, int tile_y);
  51 void ewmh_tile48(unsigned long *icon, const XColor *c, int tile_x, int tile_y);
  52
  53 /*
  54  * Allocate storage for the EWMH _NET_WM_ICON array.  The sizes array is
  55  * populated with pointers to the beginning of each icon's pixel data.  For
  56  * example, sizes[ICON_24x24] points to the first pixel of the 24x24 image.
  57  *
  58  * The returned value can then be passed to XChangeProperty to set the icon,
  59  * (use EWMH_ICON_NELEM for the number of elements) and must be freed by the
  60  * caller.
  61  */
  62 void *ewmh_icon_alloc(unsigned long **sizes);
  63
  64 /*
  65  * Check if the root window indicates support for EWMH icons.  Returns 1 if
  66  * supported, or 0 otherwise.
  67  */
  68 int ewmh_probe_wm_icon(Widget shell);
  69
  70 #endif