[lttv.git] / ltt / branches / poly / include / lttv / gtkTraceSet.h

/*! \file gtkTraceSet.h
 * \brief API used by the graphical viewers to interact with their top window.
 * 
 * Main window (gui module) is the place to contain and display viewers. 
 * Viewers (lttv plugins) interacte with main window through this API and
 * events sent by gtk.
 * This header file should be included in each graphic module.
 * This library is used by graphical modules to interact with the
 * tracesetWindow.
 * 
 */

#include <gtk/gtk.h>
#include <ltt/ltt.h>
#include <lttv/hook.h>
#include <lttv/common.h>
#include <lttv/stats.h>

/**
 * Function to register a view constructor so that main window can generate
 * a toolbar item for the viewer in order to generate a new instance easily. 
 * It will be called by init function of the module.
 * @param ButtonPixmap image shown on the toolbar item.
 * @param tooltip tooltip of the toolbar item.
 * @param view_constructor constructor of the viewer. 
 */

void toolbar_item_reg(char ** pixmap, char *tooltip, lttv_constructor view_constructor);


/**
 * Function to unregister the viewer's constructor, release the space 
 * occupied by pixmap, tooltip and constructor of the viewer.
 * It will be called when a module is unloaded.
 * @param view_constructor constructor of the viewer which is used as 
 * a reference to find out where the pixmap and tooltip are.
 */

void toolbar_item_unreg(lttv_constructor view_constructor);


/**
 * Function to register a view constructor so that main window can generate
 * a menu item for the viewer in order to generate a new instance easily.
 * It will be called by init function of the module.
 * @param menu_path path of the menu item.
 * @param menu_text text of the menu item.
 * @param view_constructor constructor of the viewer. 
 */

void menu_item_reg(char *menu_path, char *menu_text, lttv_constructor view_constructor);


/**
 * Function to unregister the viewer's constructor, release the space 
 * occupied by menu_path, menu_text and constructor of the viewer.
 * It will be called when a module is unloaded.
 * @param view_constructor constructor of the viewer which is used as 
 * a reference to find out where the menu_path and menu_text are.
 */

void menu_item_unreg(lttv_constructor view_constructor);


/**
 * Update the status bar whenever something changed in the viewer.
 * @param main_win the main window the viewer belongs to.
 * @param info the message which will be shown in the status bar.
 */

void update_status(MainWindow *main_win, char *info);


/**
 * Function to get the current time window of the current tab.
 * It will be called by a viewer's hook function to update the 
 * time window of the viewer and also be called by the constructor
 * of the viewer.
 * @param main_win the main window the viewer belongs to.
 * @param time_interval a pointer where time interval will be stored.
 */

void get_time_window(MainWindow *main_win, TimeWindow *time_window);


/**
 * Function to set the time interval of the current tab.
 * It will be called by a viewer's signal handle associated with 
 * the move_slider signal
 * @param main_win the main window the viewer belongs to.
 * @param time_interval a pointer where time interval is stored.
 */

void set_time_window(MainWindow *main_win, TimeWindow *time_window);

/**
 * Function to get the current time/event of the current tab.
 * It will be called by a viewer's hook function to update the 
 * current time/event of the viewer.
 * @param main_win the main window the viewer belongs to.
 * @param time a pointer where time will be stored.
 */

void get_current_time(MainWindow *main_win, LttTime *time);


/**
 * Function to set the current time/event of the current tab.
 * It will be called by a viewer's signal handle associated with 
 * the button-release-event signal
 * @param main_win the main window the viewer belongs to.
 * @param time a pointer where time is stored.
 */

void set_current_time(MainWindow *main_win, LttTime *time);


/**
 * Function to get the traceset from the current tab.
 * It will be called by the constructor of the viewer and also be
 * called by a hook funtion of the viewer to update its traceset.
 * @param main_win the main window the viewer belongs to.
 * @param traceset a pointer to a traceset.
 */

//void get_traceset(MainWindow *main_win, Traceset *traceset);


/**
 * Function to get the filter of the current tab.
 * It will be called by the constructor of the viewer and also be
 * called by a hook funtion of the viewer to update its filter.
 * @param main_win, the main window the viewer belongs to.
 * @param filter, a pointer to a filter.
 */

//void get_filter(MainWindow *main_win, Filter *filter);


/**
 * Function to register a hook function for a viewer to set/update its
 * time interval.
 * It will be called by the constructor of the viewer.
 * @param hook hook function of the viewer. Takes a TimeInterval* as call_data.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void reg_update_time_window(LttvHook hook, gpointer hook_data,
			    MainWindow * main_win);


/**
 * Function to unregister a viewer's hook function which is used to 
 * set/update the time interval of the viewer.
 * It will be called by the destructor of the viewer.
 * @param hook hook function of the viewer. Takes a TimeInterval as call_data.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void unreg_update_time_window(LttvHook hook, gpointer hook_data,
			      MainWindow * main_win);


/**
 * Function to register a hook function for a viewer to set/update its 
 * traceset.
 * It will be called by the constructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void reg_update_traceset(LttvHook hook, gpointer hook_data,
		       MainWindow * main_win);


/**
 * Function to unregister a viewer's hook function which is used to 
 * set/update the traceset of the viewer.
 * It will be called by the destructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void unreg_update_traceset(LttvHook hook, gpointer hook_data,
			 MainWindow * main_win);


/**
 * Function to redraw each viewer belonging to the current tab 
 * @param main_win the main window the viewer belongs to.
 */

void update_traceset(MainWindow * main_win);


/**
 * Function to register a hook function for a viewer to set/update its 
 * filter.
 * It will be called by the constructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void reg_update_filter(LttvHook hook, gpointer hook_data, 
		     MainWindow *main_win);


/**
 * Function to unregister a viewer's hook function which is used to 
 * set/update the filter of the viewer.
 * It will be called by the destructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void unreg_update_filter(LttvHook hook,  gpointer hook_data,
		       MainWindow * main_win);


/**
 * Function to register a hook function for a viewer to set/update its 
 * current time.
 * It will be called by the constructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void reg_update_current_time(LttvHook hook, gpointer hook_data, 
			  MainWindow *main_win);


/**
 * Function to unregister a viewer's hook function which is used to 
 * set/update the current time of the viewer.
 * It will be called by the destructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void unreg_update_current_time(LttvHook hook, gpointer hook_data,
			    MainWindow * main_win);


/**
 * Function to register a hook function for a viewer to show 
 *the content of the viewer.
 * It will be called by the constructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void reg_show_viewer(LttvHook hook, gpointer hook_data, 
		     MainWindow *main_win);


/**
 * Function to unregister a viewer's hook function which is used to 
 * show the content of the viewer..
 * It will be called by the destructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void unreg_show_viewer(LttvHook hook, gpointer hook_data,
		       MainWindow * main_win);


/**
 * Function to show each viewer in the current tab.
 * It will be called by main window after it called process_traceset 
 * @param main_win the main window the viewer belongs to.
 */

void show_viewer(MainWindow *main_win);


/**
 * Function to set the focused pane (viewer).
 * It will be called by a viewer's signal handle associated with 
 * the grab_focus signal
 * @param main_win the main window the viewer belongs to.
 * @param paned a pointer to a pane where the viewer is contained.
 */

void set_focused_pane(MainWindow *main_win, gpointer paned);


/**
 * Function to register a hook function for a viewer to set/update the 
 * dividor of the hpane.
 * It will be called by the constructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void reg_update_dividor(LttvHook hook, gpointer hook_data, 
		      MainWindow *main_win);


/**
 * Function to unregister a viewer's hook function which is used to 
 * set/update hpane's dividor of the viewer.
 * It will be called by the destructor of the viewer.
 * @param hook hook function of the viewer.
 * @param hook_data hook data associated with the hook function.
 * @param main_win the main window the viewer belongs to.
 */

void unreg_update_dividor(LttvHook hook, gpointer hook_data, 
			MainWindow *main_win);


/**
 * Function to set the position of the hpane's dividor (viewer).
 * It will be called by a viewer's signal handle associated with 
 * the motion_notify_event event/signal
 * @param main_win the main window the viewer belongs to.
 * @param position position of the hpane's dividor.
 */

void set_hpane_dividor(MainWindow *main_win, gint position);


/**
 * Function to process traceset. It will call lttv_process_trace, 
 * each view will call this api to get events.
 * @param main_win the main window the viewer belongs to.
 * @param start the start time of the first event to be processed.
 * @param end the end time of the last event to be processed.
 */

void process_traceset_api(MainWindow *main_win, LttTime start, 
			  LttTime end, unsigned maxNumEvents);


/**
 * Function to add hooks into the context of a traceset,
 * before reading events from traceset, viewer will call this api to
 * register hooks
 * @param main_win the main window the viewer belongs to.
 * @param LttvHooks hooks to be registered.
 */

void context_add_hooks_api(MainWindow *main_win ,
			   LttvHooks *before_traceset, 
			   LttvHooks *after_traceset,
			   LttvHooks *check_trace, 
			   LttvHooks *before_trace, 
			   LttvHooks *after_trace, 
			   LttvHooks *check_tracefile,
			   LttvHooks *before_tracefile,
			   LttvHooks *after_tracefile,
			   LttvHooks *check_event, 
			   LttvHooks *before_event, 
			   LttvHooks *after_event);


/**
 * Function to remove hooks from the context of a traceset,
 * before reading events from traceset, viewer will call this api to
 * unregister hooks
 * @param main_win the main window the viewer belongs to.
 * @param LttvHooks hooks to be registered.
 */

void context_remove_hooks_api(MainWindow *main_win ,
			      LttvHooks *before_traceset, 
			      LttvHooks *after_traceset,
			      LttvHooks *check_trace, 
			      LttvHooks *before_trace, 
			      LttvHooks *after_trace, 
			      LttvHooks *check_tracefile,
			      LttvHooks *before_tracefile,
			      LttvHooks *after_tracefile,
			      LttvHooks *check_event, 
			      LttvHooks *before_event, 
			      LttvHooks *after_event);


/**
 * Function to get the life span of the traceset
 * @param main_win the main window the viewer belongs to.
 * @param start start time of the traceset.
 * @param end end time of the traceset.
 */

void get_traceset_time_span(MainWindow *main_win, TimeInterval *time_span);


/**
 * Function to add/remove event hooks for state 
 * @param main_win the main window the viewer belongs to.
 */

void state_add_event_hooks_api(MainWindow *main_win );
void state_remove_event_hooks_api(MainWindow *main_win );


/**
 * Function to add/remove event hooks for stats 
 * @param main_win the main window the viewer belongs to.
 */

void stats_add_event_hooks_api(MainWindow *main_win );
void stats_remove_event_hooks_api(MainWindow *main_win );


/**
 * Function to get the stats of the traceset 
 * @param main_win the main window the viewer belongs to.
 */

LttvTracesetStats* get_traceset_stats_api(MainWindow *main_win);

LttvTracesetContext* get_traceset_context(MainWindow *main_win);
Commit	Line	Data
	1	/*! \file gtkTraceSet.h
	2	* \brief API used by the graphical viewers to interact with their top window.
	3	*
	4	* Main window (gui module) is the place to contain and display viewers.
	5	* Viewers (lttv plugins) interacte with main window through this API and
	6	* events sent by gtk.
	7	* This header file should be included in each graphic module.
	8	* This library is used by graphical modules to interact with the
	9	* tracesetWindow.
	10	*
	11	*/
	12
	13	#include <gtk/gtk.h>
	14	#include <ltt/ltt.h>
	15	#include <lttv/hook.h>
	16	#include <lttv/common.h>
	17	#include <lttv/stats.h>
	18
	19	/**
	20	* Function to register a view constructor so that main window can generate
	21	* a toolbar item for the viewer in order to generate a new instance easily.
	22	* It will be called by init function of the module.
	23	* @param ButtonPixmap image shown on the toolbar item.
	24	* @param tooltip tooltip of the toolbar item.
	25	* @param view_constructor constructor of the viewer.
	26	*/
	27
	28	void toolbar_item_reg(char ** pixmap, char *tooltip, lttv_constructor view_constructor);
	29
	30
	31	/**
	32	* Function to unregister the viewer's constructor, release the space
	33	* occupied by pixmap, tooltip and constructor of the viewer.
	34	* It will be called when a module is unloaded.
	35	* @param view_constructor constructor of the viewer which is used as
	36	* a reference to find out where the pixmap and tooltip are.
	37	*/
	38
	39	void toolbar_item_unreg(lttv_constructor view_constructor);
	40
	41
	42	/**
	43	* Function to register a view constructor so that main window can generate
	44	* a menu item for the viewer in order to generate a new instance easily.
	45	* It will be called by init function of the module.
	46	* @param menu_path path of the menu item.
	47	* @param menu_text text of the menu item.
	48	* @param view_constructor constructor of the viewer.
	49	*/
	50
	51	void menu_item_reg(char menu_path, char menu_text, lttv_constructor view_constructor);
	52
	53
	54	/**
	55	* Function to unregister the viewer's constructor, release the space
	56	* occupied by menu_path, menu_text and constructor of the viewer.
	57	* It will be called when a module is unloaded.
	58	* @param view_constructor constructor of the viewer which is used as
	59	* a reference to find out where the menu_path and menu_text are.
	60	*/
	61
	62	void menu_item_unreg(lttv_constructor view_constructor);
	63
	64
	65	/**
	66	* Update the status bar whenever something changed in the viewer.
	67	* @param main_win the main window the viewer belongs to.
	68	* @param info the message which will be shown in the status bar.
	69	*/
	70
	71	void update_status(MainWindow main_win, char info);
	72
	73
	74	/**
	75	* Function to get the current time window of the current tab.
	76	* It will be called by a viewer's hook function to update the
	77	* time window of the viewer and also be called by the constructor
	78	* of the viewer.
	79	* @param main_win the main window the viewer belongs to.
	80	* @param time_interval a pointer where time interval will be stored.
	81	*/
	82
	83	void get_time_window(MainWindow main_win, TimeWindow time_window);
	84
	85
	86	/**
	87	* Function to set the time interval of the current tab.
	88	* It will be called by a viewer's signal handle associated with
	89	* the move_slider signal
	90	* @param main_win the main window the viewer belongs to.
	91	* @param time_interval a pointer where time interval is stored.
	92	*/
	93
	94	void set_time_window(MainWindow main_win, TimeWindow time_window);
	95
	96	/**
	97	* Function to get the current time/event of the current tab.
	98	* It will be called by a viewer's hook function to update the
	99	* current time/event of the viewer.
	100	* @param main_win the main window the viewer belongs to.
	101	* @param time a pointer where time will be stored.
	102	*/
	103
	104	void get_current_time(MainWindow main_win, LttTime time);
	105
	106
	107	/**
	108	* Function to set the current time/event of the current tab.
	109	* It will be called by a viewer's signal handle associated with
	110	* the button-release-event signal
	111	* @param main_win the main window the viewer belongs to.
	112	* @param time a pointer where time is stored.
	113	*/
	114
	115	void set_current_time(MainWindow main_win, LttTime time);
	116
	117
	118	/**
	119	* Function to get the traceset from the current tab.
	120	* It will be called by the constructor of the viewer and also be
	121	* called by a hook funtion of the viewer to update its traceset.
	122	* @param main_win the main window the viewer belongs to.
	123	* @param traceset a pointer to a traceset.
	124	*/
	125
	126	//void get_traceset(MainWindow main_win, Traceset traceset);
	127
	128
	129	/**
	130	* Function to get the filter of the current tab.
	131	* It will be called by the constructor of the viewer and also be
	132	* called by a hook funtion of the viewer to update its filter.
	133	* @param main_win, the main window the viewer belongs to.
	134	* @param filter, a pointer to a filter.
	135	*/
	136
	137	//void get_filter(MainWindow main_win, Filter filter);
	138
	139
	140	/**
	141	* Function to register a hook function for a viewer to set/update its
	142	* time interval.
	143	* It will be called by the constructor of the viewer.
	144	* @param hook hook function of the viewer. Takes a TimeInterval* as call_data.
	145	* @param hook_data hook data associated with the hook function.
	146	* @param main_win the main window the viewer belongs to.
	147	*/
	148
	149	void reg_update_time_window(LttvHook hook, gpointer hook_data,
	150	MainWindow * main_win);
	151
	152
	153	/**
	154	* Function to unregister a viewer's hook function which is used to
	155	* set/update the time interval of the viewer.
	156	* It will be called by the destructor of the viewer.
	157	* @param hook hook function of the viewer. Takes a TimeInterval as call_data.
	158	* @param hook_data hook data associated with the hook function.
	159	* @param main_win the main window the viewer belongs to.
	160	*/
	161
	162	void unreg_update_time_window(LttvHook hook, gpointer hook_data,
	163	MainWindow * main_win);
	164
	165
	166	/**
	167	* Function to register a hook function for a viewer to set/update its
	168	* traceset.
	169	* It will be called by the constructor of the viewer.
	170	* @param hook hook function of the viewer.
	171	* @param hook_data hook data associated with the hook function.
	172	* @param main_win the main window the viewer belongs to.
	173	*/
	174
	175	void reg_update_traceset(LttvHook hook, gpointer hook_data,
	176	MainWindow * main_win);
	177
	178
	179	/**
	180	* Function to unregister a viewer's hook function which is used to
	181	* set/update the traceset of the viewer.
	182	* It will be called by the destructor of the viewer.
	183	* @param hook hook function of the viewer.
	184	* @param hook_data hook data associated with the hook function.
	185	* @param main_win the main window the viewer belongs to.
	186	*/
	187
	188	void unreg_update_traceset(LttvHook hook, gpointer hook_data,
	189	MainWindow * main_win);
	190
	191
	192	/**
	193	* Function to redraw each viewer belonging to the current tab
	194	* @param main_win the main window the viewer belongs to.
	195	*/
	196
	197	void update_traceset(MainWindow * main_win);
	198
	199
	200	/**
	201	* Function to register a hook function for a viewer to set/update its
	202	* filter.
	203	* It will be called by the constructor of the viewer.
	204	* @param hook hook function of the viewer.
	205	* @param hook_data hook data associated with the hook function.
	206	* @param main_win the main window the viewer belongs to.
	207	*/
	208
	209	void reg_update_filter(LttvHook hook, gpointer hook_data,
	210	MainWindow *main_win);
	211
	212
	213	/**
	214	* Function to unregister a viewer's hook function which is used to
	215	* set/update the filter of the viewer.
	216	* It will be called by the destructor of the viewer.
	217	* @param hook hook function of the viewer.
	218	* @param hook_data hook data associated with the hook function.
	219	* @param main_win the main window the viewer belongs to.
	220	*/
	221
	222	void unreg_update_filter(LttvHook hook, gpointer hook_data,
	223	MainWindow * main_win);
	224
	225
	226	/**
	227	* Function to register a hook function for a viewer to set/update its
	228	* current time.
	229	* It will be called by the constructor of the viewer.
	230	* @param hook hook function of the viewer.
	231	* @param hook_data hook data associated with the hook function.
	232	* @param main_win the main window the viewer belongs to.
	233	*/
	234
	235	void reg_update_current_time(LttvHook hook, gpointer hook_data,
	236	MainWindow *main_win);
	237
	238
	239	/**
	240	* Function to unregister a viewer's hook function which is used to
	241	* set/update the current time of the viewer.
	242	* It will be called by the destructor of the viewer.
	243	* @param hook hook function of the viewer.
	244	* @param hook_data hook data associated with the hook function.
	245	* @param main_win the main window the viewer belongs to.
	246	*/
	247
	248	void unreg_update_current_time(LttvHook hook, gpointer hook_data,
	249	MainWindow * main_win);
	250
	251
	252	/**
	253	* Function to register a hook function for a viewer to show
	254	*the content of the viewer.
	255	* It will be called by the constructor of the viewer.
	256	* @param hook hook function of the viewer.
	257	* @param hook_data hook data associated with the hook function.
	258	* @param main_win the main window the viewer belongs to.
	259	*/
	260
	261	void reg_show_viewer(LttvHook hook, gpointer hook_data,
	262	MainWindow *main_win);
	263
	264
	265	/**
	266	* Function to unregister a viewer's hook function which is used to
	267	* show the content of the viewer..
	268	* It will be called by the destructor of the viewer.
	269	* @param hook hook function of the viewer.
	270	* @param hook_data hook data associated with the hook function.
	271	* @param main_win the main window the viewer belongs to.
	272	*/
	273
	274	void unreg_show_viewer(LttvHook hook, gpointer hook_data,
	275	MainWindow * main_win);
	276
	277
	278	/**
	279	* Function to show each viewer in the current tab.
	280	* It will be called by main window after it called process_traceset
	281	* @param main_win the main window the viewer belongs to.
	282	*/
	283
	284	void show_viewer(MainWindow *main_win);
	285
	286
	287	/**
	288	* Function to set the focused pane (viewer).
	289	* It will be called by a viewer's signal handle associated with
	290	* the grab_focus signal
	291	* @param main_win the main window the viewer belongs to.
	292	* @param paned a pointer to a pane where the viewer is contained.
	293	*/
	294
	295	void set_focused_pane(MainWindow *main_win, gpointer paned);
	296
	297
	298	/**
	299	* Function to register a hook function for a viewer to set/update the
	300	* dividor of the hpane.
	301	* It will be called by the constructor of the viewer.
	302	* @param hook hook function of the viewer.
	303	* @param hook_data hook data associated with the hook function.
	304	* @param main_win the main window the viewer belongs to.
	305	*/
	306
	307	void reg_update_dividor(LttvHook hook, gpointer hook_data,
	308	MainWindow *main_win);
	309
	310
	311	/**
	312	* Function to unregister a viewer's hook function which is used to
	313	* set/update hpane's dividor of the viewer.
	314	* It will be called by the destructor of the viewer.
	315	* @param hook hook function of the viewer.
	316	* @param hook_data hook data associated with the hook function.
	317	* @param main_win the main window the viewer belongs to.
	318	*/
	319
	320	void unreg_update_dividor(LttvHook hook, gpointer hook_data,
	321	MainWindow *main_win);
	322
	323
	324	/**
	325	* Function to set the position of the hpane's dividor (viewer).
	326	* It will be called by a viewer's signal handle associated with
	327	* the motion_notify_event event/signal
	328	* @param main_win the main window the viewer belongs to.
	329	* @param position position of the hpane's dividor.
	330	*/
	331
	332	void set_hpane_dividor(MainWindow *main_win, gint position);
	333
	334
	335	/**
	336	* Function to process traceset. It will call lttv_process_trace,
	337	* each view will call this api to get events.
	338	* @param main_win the main window the viewer belongs to.
	339	* @param start the start time of the first event to be processed.
	340	* @param end the end time of the last event to be processed.
	341	*/
	342
	343	void process_traceset_api(MainWindow *main_win, LttTime start,
	344	LttTime end, unsigned maxNumEvents);
	345
	346
	347	/**
	348	* Function to add hooks into the context of a traceset,
	349	* before reading events from traceset, viewer will call this api to
	350	* register hooks
	351	* @param main_win the main window the viewer belongs to.
	352	* @param LttvHooks hooks to be registered.
	353	*/
	354
	355	void context_add_hooks_api(MainWindow *main_win ,
	356	LttvHooks *before_traceset,
	357	LttvHooks *after_traceset,
	358	LttvHooks *check_trace,
	359	LttvHooks *before_trace,
	360	LttvHooks *after_trace,
	361	LttvHooks *check_tracefile,
	362	LttvHooks *before_tracefile,
	363	LttvHooks *after_tracefile,
	364	LttvHooks *check_event,
	365	LttvHooks *before_event,
	366	LttvHooks *after_event);
	367
	368
	369	/**
	370	* Function to remove hooks from the context of a traceset,
	371	* before reading events from traceset, viewer will call this api to
	372	* unregister hooks
	373	* @param main_win the main window the viewer belongs to.
	374	* @param LttvHooks hooks to be registered.
	375	*/
	376
	377	void context_remove_hooks_api(MainWindow *main_win ,
	378	LttvHooks *before_traceset,
	379	LttvHooks *after_traceset,
	380	LttvHooks *check_trace,
	381	LttvHooks *before_trace,
	382	LttvHooks *after_trace,
	383	LttvHooks *check_tracefile,
	384	LttvHooks *before_tracefile,
	385	LttvHooks *after_tracefile,
	386	LttvHooks *check_event,
	387	LttvHooks *before_event,
	388	LttvHooks *after_event);
	389
	390
	391	/**
	392	* Function to get the life span of the traceset
	393	* @param main_win the main window the viewer belongs to.
	394	* @param start start time of the traceset.
	395	* @param end end time of the traceset.
	396	*/
	397
	398	void get_traceset_time_span(MainWindow main_win, TimeInterval time_span);
	399
	400
	401	/**
	402	* Function to add/remove event hooks for state
	403	* @param main_win the main window the viewer belongs to.
	404	*/
	405
	406	void state_add_event_hooks_api(MainWindow *main_win );
	407	void state_remove_event_hooks_api(MainWindow *main_win );
	408
	409
	410	/**
	411	* Function to add/remove event hooks for stats
	412	* @param main_win the main window the viewer belongs to.
	413	*/
	414
	415	void stats_add_event_hooks_api(MainWindow *main_win );
	416	void stats_remove_event_hooks_api(MainWindow *main_win );
	417
	418
	419	/**
	420	* Function to get the stats of the traceset
	421	* @param main_win the main window the viewer belongs to.
	422	*/
	423
	424	LttvTracesetStats* get_traceset_stats_api(MainWindow *main_win);
	425
	426	LttvTracesetContext* get_traceset_context(MainWindow *main_win);