Dogcows Code - chaz/tint2/blob - src/util/area.h

   1 /**************************************************************************
   2 * Copyright (C) 2008 thierry lorthiois (lorthiois@bbsoft.fr)
   3 *
   4 * base class for all graphical objects (panel, taskbar, task, systray, clock, ...).
   5 * Area is at the begining of each object (&object == &area).
   6 *
   7 * Area manage the background and border drawing, size and padding.
   8 * Each Area has one Pixmap (pix).
   9 *
  10 * Area manage the tree of all objects. Parent object drawn before child object.
  11 *   panel -> taskbars -> tasks
  12 *         -> systray -> icons
  13 *         -> clock
  14 *
  15 * draw_foreground(obj) and resize(obj) are virtual function.
  16 *
  17 **************************************************************************/
  18
  19 #ifndef AREA_H
  20 #define AREA_H
  21
  22 #include <glib.h>
  23 #include <X11/Xlib.h>
  24 #include <cairo.h>
  25 #include <cairo-xlib.h>
  26
  27
  28 typedef struct
  29 {
  30         double color[3];
  31         double alpha;
  32         int width;
  33         int rounded;
  34 } Border;
  35
  36
  37 typedef struct
  38 {
  39         double color[3];
  40         double alpha;
  41 } Color;
  42
  43 typedef struct
  44 {
  45         Color back;
  46         Border border;
  47 } Background;
  48
  49
  50 // way to calculate the size
  51 // SIZE_BY_LAYOUT objects : taskbar and task
  52 // SIZE_BY_CONTENT objects : clock, battery, launcher, systray
  53 enum { SIZE_BY_LAYOUT, SIZE_BY_CONTENT };
  54
  55 typedef struct {
  56         // coordinate relative to panel window
  57         int posx, posy;
  58         // width and height including border
  59         int width, height;
  60         Pixmap pix;
  61         Background *bg;
  62
  63         // list of child : Area object
  64         GSList *list;
  65
  66         // object visible on screen.
  67         // An object (like systray) could be enabled but hidden (because no tray icon).
  68         int on_screen;
  69         // way to calculate the size (SIZE_BY_CONTENT or SIZE_BY_LAYOUT)
  70         int size_mode;
  71         // need to calculate position and width
  72         int resize;
  73         // need redraw Pixmap
  74         int redraw;
  75         // paddingxlr = horizontal padding left/right
  76         // paddingx = horizontal padding between childs
  77         int paddingxlr, paddingx, paddingy;
  78         // parent Area
  79         void *parent;
  80         // panel
  81         void *panel;
  82
  83         // each object can overwrite following function
  84         void (*_draw_foreground)(void *obj, cairo_t *c);
  85         // calculate size. return '1' if size changed, '0' otherwise.
  86         int (*_resize)(void *obj);
  87         void (*_add_child)(void *obj);
  88         int (*_remove_child)(void *obj);
  89         const char* (*_get_tooltip_text)(void *obj);
  90 } Area;
  91
  92
  93 void rendering(void *panel);
  94 void size_by_content (Area *a);
  95 void size_by_layout (Area *a, int pos, int level);
  96 // draw background and foreground
  97 void refresh (Area *a);
  98
  99 // set 'redraw' on an area and childs
 100 void set_redraw (Area *a);
 101
 102 // draw pixmap
 103 void draw (Area *a);
 104 void draw_background (Area *a, cairo_t *c);
 105
 106 void remove_area (Area *a);
 107 void add_area (Area *a);
 108 void free_area (Area *a);
 109
 110 // draw rounded rectangle
 111 void draw_rect(cairo_t *c, double x, double y, double w, double h, double r);
 112
 113 // clear pixmap with transparent color
 114 void clear_pixmap(Pixmap p, int x, int y, int w, int h);
 115 #endif
 116