ltt/branches/poly/lttv/modules/gui/controlflow/drawing.h

   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 _DRAWING_H
  21 #define _DRAWING_H
  22
  23 #include <glib.h>
  24 #include <gdk/gdk.h>
  25 #include <gtk/gtk.h>
  26 #include <ltt/ltt.h>
  27 #include <lttv/tracecontext.h>
  28 #include <lttv/state.h>
  29 #include <lttvwindow/lttvwindow.h>
  30 #include "cfv.h"
  31 #include "drawitem.h"
  32
  33
  34 #define SAFETY 50 // safety pixels at right and bottom of pixmap buffer
  35
  36 /* This part of the viewer does :
  37  * Draw horizontal lines, getting graphic context as arg.
  38  * Copy region of the screen into another.
  39  * Modify the boundaries to reflect a scale change. (resize)
  40  * Refresh the physical screen with the pixmap
  41  * A helper function is provided here to convert from time to process
  42  * identifier to pixels and the contrary (will be useful for mouse selection).
  43  * Insert an empty square in the drawing, moving the bottom part.
  44  *
  45  * Note: The last point is exactly why it would not be so easy to add the
  46  * vertical line functionnality as in the original version of LTT. In order
  47  * to do so, we should keep all processes in the list for the duration of
  48  * all the trace instead of dynamically adding and removing them when we
  49  * scroll. Another possibility is to redraw all the visible area when a new
  50  * process is added to the list. The second solution seems more appropriate
  51  * to me.
  52  *
  53  *
  54  * The pixmap used has the width of the physical window, but the height
  55  * of the shown processes.
  56  */
  57
  58 typedef struct _Drawing_t Drawing_t;
  59
  60 struct _Drawing_t {
  61   GtkWidget *vbox;
  62   GtkWidget *drawing_area;
  63   GtkWidget *ruler;
  64   GdkPixmap *pixmap;
  65   ControlFlowData *control_flow_data;
  66
  67   PangoLayout *pango_layout;
  68
  69   gint      height, width, depth;
  70
  71   /* X coordinate of damaged region */
  72   gint      damage_begin, damage_end;
  73   LttTime   last_start;
  74   GdkGC     *dotted_gc;
  75 };
  76
  77 Drawing_t *drawing_construct(ControlFlowData *control_flow_data);
  78 void drawing_destroy(Drawing_t *drawing);
  79
  80 GtkWidget *drawing_get_widget(Drawing_t *drawing);
  81 GtkWidget *drawing_get_drawing_area(Drawing_t *drawing);
  82
  83 void drawing_draw_line( Drawing_t *drawing,
  84       GdkPixmap *pixmap,
  85       guint x1, guint y1,
  86       guint x2, guint y2,
  87       GdkGC *GC);
  88
  89 //void drawing_copy( Drawing_t *drawing,
  90 //    guint xsrc, guint ysrc,
  91 //    guint xdest, guint ydest,
  92 //    guint width, guint height);
  93
  94 /* Insert a square corresponding to a new process in the list */
  95 void drawing_insert_square(Drawing_t *drawing,
  96         guint y,
  97         guint height);
  98
  99 /* Remove a square corresponding to a removed process in the list */
 100 void drawing_remove_square(Drawing_t *drawing,
 101         guint y,
 102         guint height);
 103
 104
 105 void convert_pixels_to_time(
 106     gint width,
 107     guint x,
 108     LttTime window_time_begin,
 109     LttTime window_time_end,
 110     LttTime *time);
 111
 112 void convert_time_to_pixels(
 113     LttTime window_time_begin,
 114     LttTime window_time_end,
 115     LttTime time,
 116     gint width,
 117     guint *x);
 118
 119 void drawing_update_ruler(Drawing_t *drawing, TimeWindow *time_window);
 120
 121 void drawing_data_request_end(EventsRequest *events_request, LttvTracesetState *tss);
 122
 123
 124 #endif // _DRAWING_H