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 *scrolled_window;
  64   GtkWidget *hbox;
  65   GtkWidget *viewport;
  66   GtkWidget *scrollbar;
  67
  68   GtkWidget *ruler_hbox;
  69   GtkWidget *ruler;
  70   GtkWidget *padding;
  71   GdkPixmap *pixmap;
  72   ControlFlowData *control_flow_data;
  73
  74   PangoLayout *pango_layout;
  75
  76   gint      height, width, depth;
  77
  78   /* X coordinate of damaged region */
  79   gint      damage_begin, damage_end;
  80   LttTime   last_start;
  81   GdkGC     *dotted_gc;
  82   GdkGC     *gc;
  83 };
  84
  85 Drawing_t *drawing_construct(ControlFlowData *control_flow_data);
  86 void drawing_destroy(Drawing_t *drawing);
  87
  88 GtkWidget *drawing_get_widget(Drawing_t *drawing);
  89 GtkWidget *drawing_get_drawing_area(Drawing_t *drawing);
  90
  91 void drawing_draw_line( Drawing_t *drawing,
  92       GdkPixmap *pixmap,
  93       guint x1, guint y1,
  94       guint x2, guint y2,
  95       GdkGC *GC);
  96
  97 //void drawing_copy( Drawing_t *drawing,
  98 //    guint xsrc, guint ysrc,
  99 //    guint xdest, guint ydest,
 100 //    guint width, guint height);
 101
 102 /* Clear the drawing : make it 1xwidth. */
 103 void drawing_clear(Drawing_t *drawing);
 104
 105 /* Insert a square corresponding to a new process in the list */
 106 void drawing_insert_square(Drawing_t *drawing,
 107         guint y,
 108         guint height);
 109
 110 /* Remove a square corresponding to a removed process in the list */
 111 void drawing_remove_square(Drawing_t *drawing,
 112         guint y,
 113         guint height);
 114
 115 void convert_pixels_to_time(
 116     gint width,
 117     guint x,
 118     LttTime window_time_begin,
 119     LttTime window_time_end,
 120     LttTime *time);
 121
 122 void convert_time_to_pixels(
 123     LttTime window_time_begin,
 124     LttTime window_time_end,
 125     LttTime time,
 126     gint width,
 127     guint *x);
 128
 129 void drawing_update_ruler(Drawing_t *drawing, TimeWindow *time_window);
 130
 131 void drawing_request_expose(EventsRequest *events_request,
 132                             LttvTracesetState *tss,
 133                             LttTime end_time);
 134
 135 void drawing_data_request_begin(EventsRequest *events_request,
 136                                 LttvTracesetState *tss);
 137 void drawing_chunk_begin(EventsRequest *events_request, LttvTracesetState *tss);
 138
 139 #endif // _DRAWING_H