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