#include "panel.h"
-/*
-// TODO : layering & drawing loop
-1) browse tree and resize SIZE_BY_CONTENT node
- - children node are resized before its parent
- - if 'size' changed then 'resize = 1' on the parent
-2) browse tree and resize SIZE_BY_LAYOUT node
- - parent node is resized before its children
- - if 'size' changed then 'resize = 1' on childs with SIZE_BY_LAYOUT
-3) calculate posx of all objects
-4) redraw needed objects
-*/
+/************************************************************
+ * !!! This design is experimental and not yet fully implemented !!!!!!!!!!!!!
+ *
+ * DATA ORGANISATION :
+ * Areas in tint2 are similar to widgets in a GUI.
+ * All graphical objects (panel, taskbar, task, systray, clock, ...) 'inherit' an abstract class 'Area'.
+ * This class 'Area' manage the background, border, size, position and padding.
+ * Area is at the begining of each object (&object == &area).
+ *
+ * tint2 define one panel per monitor. And each panel have a tree of Area.
+ * The root of the tree is Panel.Area. And task, clock, systray, taskbar,... are nodes.
+ *
+ * The tree give the localisation of each object :
+ * - tree's root is in the background while tree's leafe are foreground objects
+ * - position of a node/Area depend on the layout : parent's position (posx, posy), size of previous brothers and parent's padding
+ * - size of a node/Area depend on the content (SIZE_BY_CONTENT objects) or on the layout (SIZE_BY_LAYOUT objects)
+ *
+ * DRAWING AND LAYERING ENGINE :
+ * Redrawing an object (like the clock) could come from an 'external event' (date change)
+ * or from a 'layering event' (position change).
+ * The following 'drawing engine' take care of all 'layering event'.
+ * 1) browse tree SIZE_BY_CONTENT
+ * - resize SIZE_BY_CONTENT node : children are resized before parent
+ * - if 'size' changed then 'resize = 1' on the parent
+ * 2) browse tree SIZE_BY_LAYOUT and POSITION
+ * - resize SIZE_BY_LAYOUT node : parent is resized before children
+ * - if 'size' changed then 'resize = 1' on childs with SIZE_BY_LAYOUT
+ * - calculate position (posx,posy) : parent is calculated before children
+ * - if 'position' changed then 'redraw = 1'
+ * 3) browse tree REDRAW
+ * - redraw needed objects : parent is drawn before children
+ *
+ * CONFIGURE PANEL'S LAYOUT :
+ * 'panel_items' parameter (in config) define the list and the order of nodes in tree's panel.
+ * 'panel_items = SC' define a panel with just Systray and Clock.
+ * So the tree 'Panel.Area' will have 2 childs (Systray and Clock).
+ *
+ * 1) ok
+ * 2) ??
+ * 3) ??
+ * répartition entre niveau global et niveau local ??
+ * size_by_content peut-il modifier redraw=1 en cas de changement ? ou est ce géré par chaque composant ?
+ * size_by_layout peut-il modifier redraw ?
+ *
+ ************************************************************/
-void refresh (Area *a)
-{
- // don't draw and resize hide objects
- if (!a->on_screen) return;
-
- size(a);
- //size_by_content(a);
-
- // don't draw transparent objects (without foreground and without background)
- if (a->redraw) {
- a->redraw = 0;
- // force redraw of child
- GSList *l;
- for (l = a->list ; l ; l = l->next)
- set_redraw(l->data);
-
- //printf("draw area posx %d, width %d\n", a->posx, a->width);
- draw(a);
- }
-
- // draw current Area
- if (a->pix == 0) printf("empty area posx %d, width %d\n", a->posx, a->width);
- XCopyArea (server.dsp, a->pix, ((Panel *)a->panel)->temp_pmap, server.gc, 0, 0, a->width, a->height, a->posx, a->posy);
-
- // and then refresh child object
- GSList *l;
- for (l = a->list; l ; l = l->next)
- refresh(l->data);
-}
-
-
-void size (Area *a)
-{
- GSList *l;
-
- if (a->resize) {
- a->resize = 0;
- // force the resize of childs
- for (l = a->list; l ; l = l->next) {
- Area *area = (Area*)l->data;
- area->resize = 1;
- size(area);
- }
-
- // resize can generate a redraw
- if (a->_resize)
- a->_resize(a);
- }
-}
-// browse tree and resize SIZE_BY_CONTENT node
void size_by_content (Area *a)
{
+ // don't resize hiden objects
+ if (!a->on_screen) return;
+
// children node are resized before its parent
GSList *l;
for (l = a->list; l ; l = l->next)
size_by_content(l->data);
- // calculate current area's size
+ // calculate area's size
if (a->resize && a->size_mode == SIZE_BY_CONTENT) {
a->resize = 0;
- // if 'size' changed then 'resize = 1' on the parent
- a->_resize(a);
- ((Area*)a->parent)->resize = 1;
+ if (a->_resize) {
+ if (a->_resize(a)) {
+ // 'size' changed then 'resize = 1' on the parent
+ ((Area*)a->parent)->resize = 1;
+ }
+ a->redraw = 1;
+ }
}
}
-// browse tree and resize SIZE_BY_LAYOUT node
void size_by_layout (Area *a)
{
- // parent node is resized before its children
+ // don't resize hiden objects
+ if (!a->on_screen) return;
- // calculate current area's size
+ // parent node is resized before its children
+ // calculate area's size
+ GSList *l;
if (a->resize && a->size_mode == SIZE_BY_LAYOUT) {
a->resize = 0;
- // if 'size' changed then 'resize = 1' on the parent
- //if (a->_resize(a))
- //a->parent->resize = 1;
+ if (a->_resize) {
+ if (a->_resize(a)) {
+ // if 'size' changed then 'resize = 1' on childs with SIZE_BY_LAYOUT
+ for (l = a->list; l ; l = l->next) {
+ if (((Area*)l->data)->size_mode == SIZE_BY_LAYOUT)
+ ((Area*)l->data)->resize = 1;
+ }
+ }
+ }
}
- GSList *l;
for (l = a->list; l ; l = l->next)
size_by_layout(l->data);
}
+void refresh (Area *a)
+{
+ // don't draw and resize hide objects
+ if (!a->on_screen) return;
+
+ // don't draw transparent objects (without foreground and without background)
+ if (a->redraw) {
+ a->redraw = 0;
+ // force redraw of child
+ GSList *l;
+ for (l = a->list ; l ; l = l->next)
+ ((Area*)l->data)->redraw = 1;
+// set_redraw(l->data);
+
+ //printf("draw area posx %d, width %d\n", a->posx, a->width);
+ draw(a);
+ }
+
+ // draw current Area
+ if (a->pix == 0) printf("empty area posx %d, width %d\n", a->posx, a->width);
+ XCopyArea (server.dsp, a->pix, ((Panel *)a->panel)->temp_pmap, server.gc, 0, 0, a->width, a->height, a->posx, a->posy);
+
+ // and then refresh child object
+ GSList *l;
+ for (l = a->list; l ; l = l->next)
+ refresh(l->data);
+}
+
+
void set_redraw (Area *a)
{
a->redraw = 1;