tint2/src/util/area.h

/**************************************************************************
* Copyright (C) 2008 thierry lorthiois (lorthiois@bbsoft.fr)
* 
* base class for all graphical objects (panel, taskbar, task, systray, clock, ...).
* Area is at the begining of each graphical object so &object == &area.
* 
* Area manage the background and border drawing, size and padding.
* Area manage also the tree of visible objects
*   panel -> taskbars -> tasks
*         -> clock
*         -> systray -> icons
* 
* un objet comprend les actions:
* 1) redraw(obj)
*    force l'indicateur 'redraw' sur l'objet
*    parcoure la liste des sous objets => redraw(obj)
* 2) draw(obj)
*    dessine le background, dessine le contenu dans pmap
*    parcoure la liste des sous objets => draw(obj)
*    le pmap de l'objet se base sur le pmap de l'objet parent (cumul des couches)
* 3) draw_background(obj)
*    dessine le fond dans pmap
* 4) draw_foreground(obj) = 0 : fonction virtuelle à redéfinir
*    dessine le contenu dans pmap
*    si l'objet n'a pas de contenu, la fonction est nulle
* 5) resize_width(obj, width) = 0 : fonction virtuelle à redéfinir
*    recalcule la largeur de l'objet (car la hauteur est fixe)
*    - taille systray calculée à partir de la liste des icones
*    - taille clock calculée à partir de l'heure
*    - taille d'une tache calculée à partir de la taskbar (ajout, suppression, taille)
*    - taille d'une taskbar calculée à partir de la taille du panel et des autres objets
* 6) voir refresh(obj)
* 
* Implémentation :
* - l'objet est en fait une zone (area). 
*   l'imbrication des sous objet doit permettre de gérer le layout.
* - les taches ont 2 objets : l'un pour la tache inactive et l'autre pour la tache active
*   draw(obj) est appellé sur le premier objet automatiquement 
*   et draw_foreground(obj) lance l'affichage du 2 ieme objet
*   ainsi la taskbar gère bien une liste d'objets mais draw(obj) dessine les 2 objets
* - les fonctions de refresh et de draw sont totalement dissociées
* 
* ----------------------------------------------------
* A évaluer :
* 1. voir comment définir et gérer le panel_layout avec les objets
*    => peut on s'affranchir des données spécifiques à chaque objet ?
*    => comment gérer l'affichage du layout ?
*    => comment configurer le layout ?
*    => voir le cumul des couches et l'imbrication entre objet et parent ?
* 2. voir la fonction de refresh des objets ??
*    surtout le refresh des taches qui est différent pour la tache active
* 
* 3. tester l'implémentation et évaluer les autres abstractions possibles ?
* 
* 4. comment gérer le groupage des taches
* 
* voir resize_taskbar(), resize_clock() et resize_tasks()
* voir les taches actives et inactives ?? une seule tache est active !
* variable widthChanged ou bien emission d'un signal ???
*
* 6) config(obj) configure un objet (définie les positions verticales)
*
**************************************************************************/

#ifndef AREA_H
#define AREA_H

#include <X11/Xlib.h>
#include <pango/pangocairo.h>

#include "common.h"



typedef struct
{
   double color[3];
   double alpha;
   int width;
   int rounded;
} Border;


typedef struct
{
   double color[3];
   double alpha;
} Color;


typedef struct {
   // need redraw Pixmap
   int redraw;
   
   int paddingx, paddingy;   
   int width, height;
   Pixmap pmap;
   
   Color back;
   Border border;
   
   // absolute coordinate in panel
   int posx, posy;
   // parent Area
   void *parent;

   // pointer to function
   // draw_foreground : return 1 if width changed, return O otherwise
   int (*draw_foreground)(void *obj, cairo_t *c);
   void (*add_child)(void *obj);
   int (*remove_child)(void *obj);
   
   // list of child
   GSList *list;
} Area;


// redraw an area and childs
void redraw (Area *a);

// draw background and foreground
// return 1 if width changed, return O otherwise
int  draw (Area *a);
void draw_background (Area *a, cairo_t *c);

void refresh (Area *a);
void remove_area (Area *a);
void add_area (Area *a);

#endif