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         int on_screen;
  68         // way to calculate the size (SIZE_BY_CONTENT or SIZE_BY_LAYOUT)
  69         int size_mode;
  70         // need to calculate position and width
  71         int resize;
  72         // need redraw Pixmap
  73         int redraw;
  74         // paddingxlr = horizontal padding left/right
  75         // paddingx = horizontal padding between childs
  76         int paddingxlr, paddingx, paddingy;
  77         // parent Area
  78         void *parent;
  79         // panel
  80         void *panel;
  81
  82         // each object can overwrite following function
  83         void (*_draw_foreground)(void *obj, cairo_t *c);
  84         // calculate size. return '1' if size changed, '0' otherwise.
  85         int (*_resize)(void *obj);
  86         void (*_add_child)(void *obj);
  87         int (*_remove_child)(void *obj);
  88         const char* (*_get_tooltip_text)(void *obj);
  89 } Area;
  90
  91
  92 void rendering(void *panel);
  93 void size_by_content (Area *a);
  94 void size_by_layout (Area *a, int pos, int level);
  95 // draw background and foreground
  96 void refresh (Area *a);
  97
  98 // set 'redraw' on an area and childs
  99 void set_redraw (Area *a);
 100
 101 // draw pixmap
 102 void draw (Area *a);
 103 void draw_background (Area *a, cairo_t *c);
 104
 105 void remove_area (Area *a);
 106 void add_area (Area *a);
 107 void free_area (Area *a);
 108
 109 // draw rounded rectangle
 110 void draw_rect(cairo_t *c, double x, double y, double w, double h, double r);
 111
 112 // clear pixmap with transparent color
 113 void clear_pixmap(Pixmap p, int x, int y, int w, int h);
 114 #endif
 115