git.lttng.org Git - lttv.git/blob

   1 /* This file is part of the Linux Trace Toolkit viewer
   2  * Copyright (C) 2003-2004 Mathieu Desnoyers
   3  *
   4  * This program is free software; you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License Version 2 as
   6  * published by the Free Software Foundation;
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11  * GNU General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License
  14  * along with this program; if not, write to the Free Software
  15  * Foundation, Inc., 59 Temple Place - Suite 330, Boston,
  16  * MA 02111-1307, USA.
  17  */
  18
  19
  20 #ifndef _DRAW_ITEM_H
  21 #define _DRAW_ITEM_H
  22
  23 #include <lttv/state.h>
  24
  25 typedef struct _histo_DrawContext histo_DrawContext;
  26 typedef struct _histo_DrawInfo histo_DrawInfo;
  27 typedef struct _histo_ItemInfo histo_ItemInfo;
  28
  29 typedef struct _histo_IconStruct histo_IconStruct;
  30
  31 typedef struct _histo_DrawOperation histo_DrawOperation;
  32
  33
  34 typedef struct _histo_PropertiesText histo_PropertiesText;
  35 typedef struct _histo_PropertiesIcon histo_PropertiesIcon;
  36 typedef struct _histo_PropertiesLine histo_PropertiesLine;
  37 typedef struct _histo_PropertiesArc histo_PropertiesArc;
  38 typedef struct _histo_PropertiesBG histo_PropertiesBG;
  39
  40 typedef enum _histo_DrawableItems histo_DrawableItems;
  41 enum _histo_DrawableItems {
  42     ITEM_TEXT, ITEM_ICON, ITEM_LINE, ITEM_POINT, ITEM_BACKGROUND
  43 };
  44
  45 typedef enum _histo_RelPosX {
  46   POS_START, POS_END
  47 } histo_RelPosX;
  48
  49 typedef enum _histo_RelPosY {
  50   OVER, MIDDLE, UNDER
  51 } histo_RelPosY;
  52
  53
  54 /* The DrawContext keeps information about the current drawing position and
  55  * the previous one, so we can use both to draw lines.
  56  *
  57  * over : position for drawing over the middle line.
  58  * middle : middle line position.
  59  * under : position for drawing under the middle line.
  60  *
  61  * the modify_* are used to take into account that we should go forward
  62  * when we draw a text, an arc or an icon, while it's unneeded when we
  63  * draw a line or background.
  64  *
  65  * The modify_* positions are altered by the draw item functions.
  66  *
  67  */
  68
  69
  70 struct _histo_DrawContext {
  71   GdkDrawable *drawable;
  72   GdkGC   *gc;
  73   PangoLayout *pango_layout;
  74
  75   struct {
  76     struct {
  77       gint x;
  78       struct {
  79         gint over;
  80         gint middle;
  81         gint under;
  82       } offset;
  83     } start;
  84
  85     struct {
  86       gint x;
  87       struct {
  88         gint over;
  89         gint middle;
  90         gint under;
  91       } offset;
  92     } end;
  93
  94     struct {
  95       gint over;
  96       gint middle;
  97       gint under;
  98     } y;
  99
 100   } histo_drawinfo;
 101 };
 102
 103
 104
 105
 106 /*
 107  * Structure used to keep information about icons.
 108  */
 109 struct _histo_IconStruct {
 110   GdkPixmap *pixmap;
 111   GdkBitmap *mask;
 112 };
 113
 114
 115 /*
 116  * The Item element is only used so the DrawOperation is modifiable by users.
 117  * During drawing, only the Hook is needed.
 118  */
 119 struct _histo_DrawOperation {
 120   histo_DrawableItems item;
 121   LttvHooks *hook;
 122 };
 123 #if 0
 124 /*
 125  * We define here each items that can be drawn, together with their
 126  * associated priority. Many item types can have the same priority,
 127  * it's only used for quicksorting the operations when we add a new one
 128  * to the array of operations to perform. Lower priorities are executed
 129  * first. So, for example, we may want to give background color a value
 130  * of 10 while a line would have 20, so the background color, which
 131  * is in fact a rectangle, does not hide the line.
 132  */
 133
 134 static int Items_Priorities[] = {
 135   50, /* ITEM_TEXT */
 136   40, /* ITEM_ICON */
 137   20, /* ITEM_LINE */
 138   30, /* ITEM_POINT */
 139   10  /* ITEM_BACKGROUND */
 140 };
 141 #endif //0
 142
 143 /*
 144  * Here are the different structures describing each item type that can be
 145  * drawn. They contain the information necessary to draw the item : not the
 146  * position (this is provided by the DrawContext), but the text, icon name,
 147  * line width, color; all the properties of the specific items.
 148  */
 149
 150 struct _histo_PropertiesText {
 151   GdkColor  *foreground;
 152   GdkColor  *background;
 153   gint       size;
 154   gchar     *text;
 155   struct {
 156     histo_RelPosX    x;
 157     histo_RelPosY    y;
 158   } histo_position;
 159 };
 160
 161
 162 struct _histo_PropertiesIcon {
 163   gchar   *icon_name;
 164   gint    width;
 165   gint    height;
 166   struct {
 167     histo_RelPosX    x;
 168     histo_RelPosY    y;
 169   } histo_position;
 170 };
 171
 172 struct _histo_PropertiesLine {
 173   GdkColor  color;
 174   gint    line_width;
 175   GdkLineStyle  style;
 176   histo_RelPosY    y;
 177 };
 178
 179 struct _histo_PropertiesArc {
 180   GdkColor  *color;
 181   gint    size; /* We force circle by width = height */
 182   gboolean  filled;
 183   struct {
 184     histo_RelPosX    x;
 185     histo_RelPosY    y;
 186   } histo_position;
 187 };
 188
 189 struct _histo_PropertiesBG {
 190   GdkColor  *color;
 191 };
 192
 193
 194
 195 void histo_draw_item( GdkDrawable *drawable,
 196     gint x,
 197     gint y,
 198     LttvTraceState *ts,
 199     LttvTracefileState *tfs,
 200     LttvIAttribute *attributes);
 201
 202 /*
 203  * The tree of attributes used to store drawing operations goes like this :
 204  *
 205  * event_types/
 206  *   "facility-event_type"
 207  * cpus/
 208  *   "cpu name"
 209  * mode_types/
 210  *   "execution mode"/
 211  *     submodes/
 212  *       "submode"
 213  * process_states/
 214  *   "state name"
 215  *
 216  * So if, for example, we want to add a hook to get called each time we
 217  * receive an event that is in state LTTV_STATE_SYSCALL, we put the
 218  * pointer to the GArray of DrawOperation in
 219  * process_states/ "name associated with LTTV_STATE_SYSCALL"
 220  */
 221
 222
 223 #if 0
 224 /*
 225  * The add_operation has to do a quick sort by priority to keep the operations
 226  * in the right order.
 227  */
 228 void add_operation( LttvIAttribute *attributes,
 229       gchar *pathname,
 230       DrawOperation *operation);
 231
 232 /*
 233  * The del_operation seeks the array present at pathname (if any) and
 234  * removes the DrawOperation if present. It returns 0 on success, -1
 235  * if it fails.
 236  */
 237 gint del_operation( LttvIAttribute *attributes,
 238       gchar *pathname,
 239       DrawOperation *operation);
 240
 241 /*
 242  * The clean_operations removes all operations present at a pathname.
 243  * returns 0 on success, -1 if it fails.
 244  */
 245 gint clean_operations(  LttvIAttribute *attributes,
 246       gchar *pathname );
 247
 248
 249 /*
 250  * The list_operations gives a pointer to the operation array associated
 251  * with the pathname. It will be NULL if no operation is present.
 252  */
 253 void list_operations( LttvIAttribute *attributes,
 254       gchar *pathname,
 255       GArray **operation);
 256
 257
 258
 259 /*
 260  * exec_operation executes the operations if present in the attributes, or
 261  * do nothing if not present.
 262  */
 263 void exec_operations( LttvIAttribute *attributes,
 264       gchar *pathname);
 265 #endif //0
 266
 267 /*
 268  * Here follow the prototypes of the hook functions used to draw the
 269  * different items.
 270  */
 271
 272 gboolean histo_draw_text( void *hook_data, void *call_data);
 273 gboolean histo_draw_icon( void *hook_data, void *call_data);
 274 gboolean histo_draw_line( void *hook_data, void *call_data);
 275 gboolean histo_draw_arc( void *hook_data, void *call_data);
 276 gboolean histo_draw_bg( void *hook_data, void *call_data);
 277
 278
 279 #endif // _DRAW_ITEM_H