X-Git-Url: https://git.dogcows.com/gitweb?a=blobdiff_plain;f=src%2Futil%2Farea.h;h=2f8d822671b3ef75b486d3fa1535d0b97ab355f5;hb=30ea5428a1a0080d01247458e0b2a8fc63ef582b;hp=2ad26aa6fc3c057b20288ebea2671e14a179f9b8;hpb=d1123a0ede12eb1126eb5eb932d9177de67d46c5;p=chaz%2Ftint2 diff --git a/src/util/area.h b/src/util/area.h index 2ad26aa..2f8d822 100644 --- a/src/util/area.h +++ b/src/util/area.h @@ -1,140 +1,125 @@ /************************************************************************** -* base class for all objects (panel, taskbar, task, systray, clock, ...). -* each object 'inherit' Area and implement draw_foreground if needed. -* -* Area is at the begining of each object so &object == &area. -* -* une zone comprend : -* - fond : couleur / opacité -* - contenu -* - largeur / hauteur -* - paddingx / paddingy -* - pixmap mémorisant l'affichage (évite de redessiner l'objet à chaque rafraichissement) -* - une liste de sous objets +* Copyright (C) 2008 thierry lorthiois (lorthiois@bbsoft.fr) * -* 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 : -* - tous les éléments du panel possèdent 1 objet en début de structure -* panel, taskbar, systray, task, ... -* - l'objet est en fait une zone (area). -* l'imbrication des sous objet doit permettre de gérer le layout. -* - on a une relation 1<->1 entre un objet et une zone graphique -* les taskbar affichent toutes les taches. -* donc on utilise la liste des objets pour gérer la liste des taches. -* - 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 -* 5. la clock est le contenu du panel. mais elle ne tiens pas compte du padding vertical ? -* c'est ok pour la clock. voir l'impact sur paddingx ? -* -* 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 ??? +* base class for all graphical objects (panel, taskbar, task, systray, clock, ...). +* Area is at the begining of each object (&object == &area). * -* 6) config(obj) configure un objet (définie les positions verticales) +* Area manage the background and border drawing, size and padding. +* Each Area has one Pixmap (pix). +* +* Area manage the tree of all objects. Parent object drawn before child object. +* panel -> taskbars -> tasks +* -> systray -> icons +* -> clock +* +* draw_foreground(obj) and resize(obj) are virtual function. * **************************************************************************/ #ifndef AREA_H #define AREA_H +#include #include -#include - -#include "common.h" - +#include +#include typedef struct { - double color[3]; - double alpha; - int width; - int rounded; + double color[3]; + double alpha; + int width; + int rounded; } Border; typedef struct { - double color[3]; - double alpha; + double color[3]; + double alpha; } Color; +typedef struct +{ + Color back; + Border border; +} Background; + + +// way to calculate the size +// SIZE_BY_LAYOUT objects : taskbar and task +// SIZE_BY_CONTENT objects : clock, battery, launcher, systray +enum { SIZE_BY_LAYOUT, SIZE_BY_CONTENT }; 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; + // coordinate relative to panel window + int posx, posy; + // width and height including border + int width, height; + Pixmap pix; + Background *bg; + + // list of child : Area object + GSList *list; + + // object visible on screen. + // An object (like systray) could be enabled but hidden (because no tray icon). + int on_screen; + // way to calculate the size (SIZE_BY_CONTENT or SIZE_BY_LAYOUT) + int size_mode; + // need to calculate position and width + int resize; + // need redraw Pixmap + int redraw; + // paddingxlr = horizontal padding left/right + // paddingx = horizontal padding between childs + int paddingxlr, paddingx, paddingy; + // parent Area + void *parent; + // panel + void *panel; + + // each object can overwrite following function + void (*_draw_foreground)(void *obj, cairo_t *c); + // calculate size. return '1' if size changed, '0' otherwise. + int (*_resize)(void *obj); + void (*_add_child)(void *obj); + int (*_remove_child)(void *obj); + const char* (*_get_tooltip_text)(void *obj); } Area; +// on startup, initialize fixed pos/size +void init_rendering(void *obj, int pos); -// redraw an area and childs -void redraw (Area *a); - +void rendering(void *obj); +void size_by_content (Area *a); +void size_by_layout (Area *a, int pos, int level); // draw background and foreground -// return 1 if width changed, return O otherwise -int draw (Area *a); +void refresh (Area *a); + +// generic resize for SIZE_BY_LAYOUT objects +int resize_by_layout(void *obj); + +// set 'redraw' on an area and childs +void set_redraw (Area *a); + +// hide/unhide area +void hide(Area *a); +void show(Area *a); + +// draw pixmap +void 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); +void free_area (Area *a); + +// draw rounded rectangle +void draw_rect(cairo_t *c, double x, double y, double w, double h, double r); +// clear pixmap with transparent color +void clear_pixmap(Pixmap p, int x, int y, int w, int h); #endif