ltt/branches/poly/lttv/modules/gui/controlflow/processlist.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
  21 #ifndef _PROCESS_LIST_H
  22 #define _PROCESS_LIST_H
  23
  24 #include <gtk/gtk.h>
  25 #include <lttv/state.h>
  26 #include <ltt/ltt.h>
  27
  28 #include "drawitem.h"
  29
  30 /* The process list
  31  *
  32  * Tasks :
  33  * Create a process list
  34  * contains the data for the process list
  35  * tells the height of the process list widget
  36  * provides methods to add/remove process from the list
  37  *  note : the sync with drawing is left to the caller.
  38  * provides helper function to convert a process unique identifier to
  39  *  pixels (in height).
  40  *
  41  * //FIXME : connect the scrolled window adjustment with the list.
  42  */
  43
  44 typedef struct _ProcessInfo {
  45
  46   guint pid;
  47   LttTime birth;
  48
  49 } ProcessInfo;
  50
  51 typedef struct _HashedProcessData {
  52
  53   GtkTreeRowReference *row_ref;
  54   DrawContext *draw_context;
  55
  56 } HashedProcessData;
  57
  58 struct _ProcessList {
  59
  60   GtkWidget *process_list_widget;
  61   GtkListStore *list_store;
  62
  63   /* A hash table by PID to speed up process position find in the list */
  64   GHashTable *process_hash;
  65
  66   guint number_of_process;
  67 };
  68
  69
  70 typedef struct _ProcessList ProcessList;
  71
  72 ProcessList *processlist_construct(void);
  73 void processlist_destroy(ProcessList *process_list);
  74 GtkWidget *processlist_get_widget(ProcessList *process_list);
  75
  76 // out : success (0) and height
  77 int processlist_add(ProcessList *process_list, guint pid, LttTime *birth,
  78     gchar *name, guint *height, HashedProcessData **hashed_process_data);
  79 // out : success (0) and height
  80 int processlist_remove(ProcessList *process_list, guint pid, LttTime *birth);
  81
  82 guint processlist_get_height(ProcessList *process_list);
  83
  84 // Returns 0 on success
  85 gint processlist_get_process_pixels(ProcessList *process_list,
  86         guint pid, LttTime *birth,
  87         guint *y, guint *height,
  88         HashedProcessData **hashed_process_data);
  89
  90 gint processlist_get_pixels_from_data(  ProcessList *process_list,
  91           ProcessInfo *process_info,
  92           HashedProcessData *hashed_process_data,
  93           guint *y,
  94           guint *height);
  95
  96 #endif // _PROCESS_LIST_H