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 long pixel;
  32         unsigned short red, green, blue;
  33 } XColor;
  34
  35 typedef struct stub_widget *Widget;
  36
  37 #endif
  38
  39 enum { COLOUR_PRIMARY, COLOUR_DARK, COLOUR_LIGHT, COLOUR_MAX };
  40
  41 /*
  42  * Helpers for drawing window icons in various sizes.  The tileXX functions
  43  * draw one (out of 9) tiles at a particular size using a particular colour
  44  * set.  Call for each tile position to draw a complete icon.
  45  */
  46 enum { ICON_16x16, ICON_24x24, ICON_32x32, ICON_48x48, ICON_MAX };
  47 #define EWMH_ICON_NELEM (2+16*16 + 2+24*24 + 2+32*32 + 2+48*48)
  48
  49 void ewmh_tile16(unsigned long *icon, const XColor *c, int tile_x, int tile_y);
  50 void ewmh_tile24(unsigned long *icon, const XColor *c, int tile_x, int tile_y);
  51 void ewmh_tile32(unsigned long *icon, const XColor *c, int tile_x, int tile_y);
  52 void ewmh_tile48(unsigned long *icon, const XColor *c, int tile_x, int tile_y);
  53
  54 /*
  55  * Allocate storage for the EWMH _NET_WM_ICON array.  The sizes array is
  56  * populated with pointers to the beginning of each icon's pixel data.  For
  57  * example, sizes[ICON_24x24] points to the first pixel of the 24x24 image.
  58  *
  59  * The returned value can then be passed to XChangeProperty to set the icon,
  60  * (use EWMH_ICON_NELEM for the number of elements) and must be freed by the
  61  * caller.
  62  */
  63 void *ewmh_icon_alloc(unsigned long **sizes);
  64
  65 /*
  66  * Check if the root window indicates support for EWMH icons.  Returns 1 if
  67  * supported, or 0 otherwise.
  68  */
  69 int ewmh_probe_wm_icon(Widget shell);
  70
  71 #endif