1 /* This file is part of the Linux Trace Toolkit viewer
2 * Copyright (C) 2003-2004 Mathieu Desnoyers
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;
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.
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,
21 /******************************************************************************
24 * This file contains methods responsible for drawing a generic type of data
25 * in a drawable. Doing this generically will permit user defined drawing
26 * behavior in a later time.
28 * This file provides an API which is meant to be reusable for all viewers that
29 * need to show information in line, icon, text, background or point form in
30 * a drawable area having time for x axis. The y axis, in the control flow
31 * viewer case, is corresponding to the different processes, but it can be
32 * reused integrally for cpu, and eventually locks, buffers, network
33 * interfaces... What will differ between the viewers is the precise
34 * information which interests us. We may think that the most useful
35 * information for control flow are some specific events, like schedule
36 * change, and processes'states. It may differ for a cpu viewer : the
37 * interesting information could be more the execution mode of each cpu.
38 * This API in meant to make viewer's writers life easier : it will become
39 * a simple choice of icons and line types for the precise information
40 * the viewer has to provide (agremented with keeping supplementary records
41 * and modifying slightly the DrawContext to suit the needs.)
43 * We keep each data type in attributes, keys to specific information
44 * being formed from the GQuark corresponding to the information received.
45 * (facilities / facility_name / events / eventname.)
46 * (cpus/cpu_name, process_states/ps_name,
47 * execution_modes/em_name, execution_submodes/es_name).
48 * The goal is then to provide a generic way to print information on the
49 * screen for all this different information.
51 * Information can be printed as
53 * - text (text + color + size + position (over or under line)
54 * - icon (icon filename, corresponding to a loaded icon, accessible through
55 * a GQuark. Icons are loaded statically at the guiControlFlow level during
56 * module initialization and can be added on the fly if not present in the
57 * GQuark.) The habitual place for xpm icons is in
58 * ${prefix}/share/LinuxTraceToolkit.) + position (over or under line)
59 * - line (color, width, style)
60 * - Arc (big points) (color, size)
61 * - background color (color)
63 * An item is a leaf of the attributes tree. It is, in that case, including
64 * all kind of events categories we can have. It then associates each category
65 * with one or more actions (drawing something) or nothing.
67 * Each item has an array of hooks (hook list). Each hook represents an
68 * operation to perform. We seek the array each time we want to
69 * draw an item. We execute each operation in order. An operation type
70 * is associated with each hook to permit user listing and modification
71 * of these operations. The operation type is also used to find the
72 * corresponding priority for the sorting. Operation type and priorities
73 * are enum and a static int table.
75 * The array has to be sorted by priority each time we add a task in it.
76 * A priority is associated with each operation type. It permits
77 * to perform background color selection before line or text drawing. We also
78 * draw lines before text, so the text appears over the lines.
80 * Executing all the arrays of operations for a specific event (which
81 * implies information for state, event, cpu, execution mode and submode)
82 * has to be done in a same DrawContext. The goal there is to keep the offset
83 * of the text and icons over and under the middle line, so a specific
84 * event could be printed as ( R Si 0 for running, scheduled in, cpu 0 ),
85 * text being easy to replace with icons. The DrawContext is passed as
86 * call_data for the operation hooks.
88 * We use the lttv global attributes to keep track of the loaded icons.
89 * If we need an icon, we look for it in the icons / icon name pathname.
90 * If found, we use the pointer to it. If not, we load the pixmap in
91 * memory and set the pointer to the GdkPixmap in the attributes. The
92 * structure pointed to contains the pixmap and the mask bitmap.
94 * Author : Mathieu Desnoyers, October 2003
104 #include <lttv/hook.h>
105 #include <lttv/attribute.h>
106 #include <lttv/iattribute.h>
109 #include <lttv/tracecontext.h>
110 #include <lttv/state.h>
111 #include <lttv/lttv.h>
114 #include "drawitem.h"
117 #define MAX_PATH_LEN 256
119 /* drawing hook functions */
120 gboolean draw_text( void *hook_data, void *call_data)
122 PropertiesText *properties = (PropertiesText*)hook_data;
123 DrawContext *draw_context = (DrawContext*)call_data;
125 PangoContext *context;
127 PangoFontDescription *font_desc;// = pango_font_description_new();
128 PangoRectangle ink_rect;
130 layout = draw_context->pango_layout;
132 context = pango_layout_get_context(layout);
133 font_desc = pango_context_get_font_description(context);
135 pango_font_description_set_size(font_desc, properties->size*PANGO_SCALE);
136 pango_layout_context_changed(layout);
138 pango_layout_set_text(layout, properties->text, -1);
139 pango_layout_get_pixel_extents(layout, &ink_rect, NULL);
143 gboolean enough_space = FALSE;
144 gint width = ink_rect.width;
146 switch(properties->position.x) {
148 x = draw_context->drawinfo.start.x;
149 switch(properties->position.y) {
151 offset = &draw_context->drawinfo.start.offset.over;
152 x += draw_context->drawinfo.start.offset.over;
153 y = draw_context->drawinfo.y.over;
156 offset = &draw_context->drawinfo.start.offset.middle;
157 x += draw_context->drawinfo.start.offset.middle;
158 y = draw_context->drawinfo.y.middle;
161 offset = &draw_context->drawinfo.start.offset.under;
162 x += draw_context->drawinfo.start.offset.under;
163 y = draw_context->drawinfo.y.under;
166 /* verify if there is enough space to draw */
167 if(unlikely(x + width <= draw_context->drawinfo.end.x)) {
173 x = draw_context->drawinfo.end.x;
174 switch(properties->position.y) {
176 offset = &draw_context->drawinfo.end.offset.over;
177 x += draw_context->drawinfo.end.offset.over;
178 y = draw_context->drawinfo.y.over;
181 offset = &draw_context->drawinfo.end.offset.middle;
182 x += draw_context->drawinfo.end.offset.middle;
183 y = draw_context->drawinfo.y.middle;
186 offset = &draw_context->drawinfo.end.offset.under;
187 x += draw_context->drawinfo.end.offset.under;
188 y = draw_context->drawinfo.y.under;
191 /* verify if there is enough space to draw */
192 if(unlikely(x - width >= draw_context->drawinfo.start.x)) {
199 if(unlikely(enough_space))
200 gdk_draw_layout_with_colors(draw_context->drawable,
204 layout, properties->foreground, properties->background);
210 /* To speed up the process, search in already loaded icons list first. Only
211 * load it if not present.
213 gboolean draw_icon( void *hook_data, void *call_data)
215 PropertiesIcon *properties = (PropertiesIcon*)hook_data;
216 DrawContext *draw_context = (DrawContext*)call_data;
218 LttvIAttribute *attributes = LTTV_IATTRIBUTE(lttv_global_attributes());
219 LttvAttributeValue value;
220 gchar icon_name[MAX_PATH_LEN] = "icons/";
221 IconStruct *icon_info;
223 strcat(icon_name, properties->icon_name);
225 g_assert(lttv_iattribute_find_by_path(attributes, icon_name,
226 LTTV_POINTER, &value));
227 if(unlikely(*(value.v_pointer) == NULL))
229 *(value.v_pointer) = icon_info = g_new(IconStruct,1);
231 icon_info->pixmap = gdk_pixmap_create_from_xpm(draw_context->drawable,
232 &icon_info->mask, NULL, properties->icon_name);
236 icon_info = *(value.v_pointer);
241 gboolean enough_space = FALSE;
242 gint width = properties->width;
244 switch(properties->position.x) {
246 x = draw_context->drawinfo.start.x;
247 switch(properties->position.y) {
249 offset = &draw_context->drawinfo.start.offset.over;
250 x += draw_context->drawinfo.start.offset.over;
251 y = draw_context->drawinfo.y.over;
254 offset = &draw_context->drawinfo.start.offset.middle;
255 x += draw_context->drawinfo.start.offset.middle;
256 y = draw_context->drawinfo.y.middle;
259 offset = &draw_context->drawinfo.start.offset.under;
260 x += draw_context->drawinfo.start.offset.under;
261 y = draw_context->drawinfo.y.under;
264 /* verify if there is enough space to draw */
265 if(unlikely(x + width <= draw_context->drawinfo.end.x)) {
271 x = draw_context->drawinfo.end.x;
272 switch(properties->position.y) {
274 offset = &draw_context->drawinfo.end.offset.over;
275 x += draw_context->drawinfo.end.offset.over;
276 y = draw_context->drawinfo.y.over;
279 offset = &draw_context->drawinfo.end.offset.middle;
280 x += draw_context->drawinfo.end.offset.middle;
281 y = draw_context->drawinfo.y.middle;
284 offset = &draw_context->drawinfo.end.offset.under;
285 x += draw_context->drawinfo.end.offset.under;
286 y = draw_context->drawinfo.y.under;
289 /* verify if there is enough space to draw */
290 if(unlikely(x - width >= draw_context->drawinfo.start.x)) {
297 if(unlikely(enough_space)) {
298 gdk_gc_set_clip_mask(draw_context->gc, icon_info->mask);
300 gdk_gc_set_clip_origin(
304 gdk_draw_drawable(draw_context->drawable,
310 properties->width, properties->height);
312 gdk_gc_set_clip_origin(draw_context->gc, 0, 0);
313 gdk_gc_set_clip_mask(draw_context->gc, NULL);
318 gboolean draw_line( void *hook_data, void *call_data)
320 PropertiesLine *properties = (PropertiesLine*)hook_data;
321 DrawContext *draw_context = (DrawContext*)call_data;
323 gdk_gc_set_foreground(draw_context->gc, &properties->color);
324 //gdk_gc_set_rgb_fg_color(draw_context->gc, &properties->color);
325 gdk_gc_set_line_attributes( draw_context->gc,
326 properties->line_width,
330 //g_critical("DRAWING LINE : x1: %i, y1: %i, x2:%i, y2:%i",
331 // draw_context->previous->middle->x,
332 // draw_context->previous->middle->y,
333 // draw_context->drawinfo.middle.x,
334 // draw_context->drawinfo.middle.y);
336 gint x_begin=0, x_end=0, y=0;
338 x_begin = draw_context->drawinfo.start.x;
339 x_end = draw_context->drawinfo.end.x;
341 switch(properties->y) {
343 y = draw_context->drawinfo.y.over;
346 y = draw_context->drawinfo.y.middle;
349 y = draw_context->drawinfo.y.under;
354 NULL, draw_context->drawable,
364 gboolean draw_arc( void *hook_data, void *call_data)
366 PropertiesArc *properties = (PropertiesArc*)hook_data;
367 DrawContext *draw_context = (DrawContext*)call_data;
369 gdk_gc_set_foreground(draw_context->gc, properties->color);
370 //gdk_gc_set_rgb_fg_color(draw_context->gc, properties->color);
374 gboolean enough_space = FALSE;
375 gint width = properties->size;
377 switch(properties->position.x) {
379 x = draw_context->drawinfo.start.x;
380 switch(properties->position.y) {
382 offset = &draw_context->drawinfo.start.offset.over;
383 x += draw_context->drawinfo.start.offset.over;
384 y = draw_context->drawinfo.y.over;
387 offset = &draw_context->drawinfo.start.offset.middle;
388 x += draw_context->drawinfo.start.offset.middle;
389 y = draw_context->drawinfo.y.middle;
392 offset = &draw_context->drawinfo.start.offset.under;
393 x += draw_context->drawinfo.start.offset.under;
394 y = draw_context->drawinfo.y.under;
397 /* verify if there is enough space to draw */
398 if(unlikely(x + width <= draw_context->drawinfo.end.x)) {
404 x = draw_context->drawinfo.end.x;
405 switch(properties->position.y) {
407 offset = &draw_context->drawinfo.end.offset.over;
408 x += draw_context->drawinfo.end.offset.over;
409 y = draw_context->drawinfo.y.over;
412 offset = &draw_context->drawinfo.end.offset.middle;
413 x += draw_context->drawinfo.end.offset.middle;
414 y = draw_context->drawinfo.y.middle;
417 offset = &draw_context->drawinfo.end.offset.under;
418 x += draw_context->drawinfo.end.offset.under;
419 y = draw_context->drawinfo.y.under;
422 /* verify if there is enough space to draw */
423 if(unlikely(x - width >= draw_context->drawinfo.start.x)) {
430 if(unlikely(enough_space))
431 gdk_draw_arc(draw_context->drawable, draw_context->gc,
435 properties->size, properties->size, 0, 360*64);
440 gboolean draw_bg( void *hook_data, void *call_data)
442 PropertiesBG *properties = (PropertiesBG*)hook_data;
443 DrawContext *draw_context = (DrawContext*)call_data;
445 gdk_gc_set_foreground(draw_context->gc, properties->color);
446 //gdk_gc_set_rgb_fg_color(draw_context->gc, properties->color);
448 //g_critical("DRAWING RECT : x: %i, y: %i, w:%i, h:%i, val1 :%i, val2:%i ",
449 // draw_context->previous->over->x,
450 // draw_context->previous->over->y,
451 // draw_context->drawinfo.over.x - draw_context->previous->over->x,
452 // draw_context->previous->under->y-draw_context->previous->over->y,
453 // draw_context->drawinfo.over.x,
454 // draw_context->previous->over->x);
455 gdk_draw_rectangle(draw_context->drawable, draw_context->gc,
457 draw_context->drawinfo.start.x,
458 draw_context->drawinfo.y.over,
459 draw_context->drawinfo.end.x - draw_context->drawinfo.start.x,
460 draw_context->drawinfo.y.under - draw_context->drawinfo.y.over);