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
  37 typedef enum _draw_color { COL_BLACK,
  38                            COL_WHITE,
  39                            COL_WAIT_FORK,
  40                            COL_WAIT_CPU,
  41                            COL_ZOMBIE,
  42                            COL_WAIT,
  43                            COL_RUN,
  44                            NUM_COLORS } draw_color;
  45
  46 extern GdkColor drawing_colors[NUM_COLORS];
  47
  48 /* This part of the viewer does :
  49  * Draw horizontal lines, getting graphic context as arg.
  50  * Copy region of the screen into another.
  51  * Modify the boundaries to reflect a scale change. (resize)
  52  * Refresh the physical screen with the pixmap
  53  * A helper function is provided here to convert from time to process
  54  * identifier to pixels and the contrary (will be useful for mouse selection).
  55  * Insert an empty square in the drawing, moving the bottom part.
  56  *
  57  * Note: The last point is exactly why it would not be so easy to add the
  58  * vertical line functionnality as in the original version of LTT. In order
  59  * to do so, we should keep all processes in the list for the duration of
  60  * all the trace instead of dynamically adding and removing them when we
  61  * scroll. Another possibility is to redraw all the visible area when a new
  62  * process is added to the list. The second solution seems more appropriate
  63  * to me.
  64  *
  65  *
  66  * The pixmap used has the width of the physical window, but the height
  67  * of the shown processes.
  68  */
  69
  70 typedef struct _Drawing_t Drawing_t;
  71
  72 struct _Drawing_t {
  73   GtkWidget *vbox;
  74   GtkWidget *drawing_area;
  75   //GtkWidget *scrolled_window;
  76   GtkWidget *hbox;
  77   GtkWidget *viewport;
  78   GtkWidget *scrollbar;
  79
  80   GtkWidget *ruler_hbox;
  81   GtkWidget *ruler;
  82   GtkWidget *padding;
  83   GdkPixmap *pixmap;
  84   ControlFlowData *control_flow_data;
  85
  86   PangoLayout *pango_layout;
  87
  88   gint      height, width, depth;
  89
  90   /* X coordinate of damaged region */
  91   gint      damage_begin, damage_end; /* damaged region to be exposed,
  92                                          updated per chunk */
  93   LttTime   last_start;
  94   GdkGC     *dotted_gc;
  95   GdkGC     *gc;
  96 };
  97
  98 Drawing_t *drawing_construct(ControlFlowData *control_flow_data);
  99 void drawing_destroy(Drawing_t *drawing);
 100
 101 GtkWidget *drawing_get_widget(Drawing_t *drawing);
 102 GtkWidget *drawing_get_drawing_area(Drawing_t *drawing);
 103
 104 void drawing_draw_line( Drawing_t *drawing,
 105       GdkPixmap *pixmap,
 106       guint x1, guint y1,
 107       guint x2, guint y2,
 108       GdkGC *GC);
 109
 110 //void drawing_copy( Drawing_t *drawing,
 111 //    guint xsrc, guint ysrc,
 112 //    guint xdest, guint ydest,
 113 //    guint width, guint height);
 114
 115 /* Clear the drawing : make it 1xwidth. */
 116 void drawing_clear(Drawing_t *drawing);
 117
 118 /* Insert a square corresponding to a new process in the list */
 119 void drawing_insert_square(Drawing_t *drawing,
 120         guint y,
 121         guint height);
 122
 123 /* Remove a square corresponding to a removed process in the list */
 124 void drawing_remove_square(Drawing_t *drawing,
 125         guint y,
 126         guint height);
 127
 128 void convert_pixels_to_time(
 129     gint width,
 130     guint x,
 131     LttTime window_time_begin,
 132     LttTime window_time_end,
 133     LttTime *time);
 134
 135 void convert_time_to_pixels(
 136     LttTime window_time_begin,
 137     LttTime window_time_end,
 138     LttTime time,
 139     gint width,
 140     guint *x);
 141
 142 void drawing_update_ruler(Drawing_t *drawing, TimeWindow *time_window);
 143
 144 void drawing_request_expose(EventsRequest *events_request,
 145                             LttvTracesetState *tss,
 146                             LttTime end_time);
 147
 148 void drawing_data_request_begin(EventsRequest *events_request,
 149                                 LttvTracesetState *tss);
 150 void drawing_chunk_begin(EventsRequest *events_request, LttvTracesetState *tss);
 151
 152 #endif // _DRAWING_H