[lttv.git] / ltt / branches / poly / lttv / modules / guiControlFlow / Draw_Item.h

#ifndef _DRAW_ITEM_H
#define _DRAW_ITEM_H

typedef struct _DrawContext DrawContext;
typedef struct _DrawInfo DrawInfo;
typedef struct _ItemInfo ItemInfo;

typedef struct _DrawOperation DrawOperation;


typedef struct _PropertiesText PropertiesText;
typedef struct _PropertiesIcon PropertiesIcon;
typedef struct _PropertiesLine PropertiesLine;
typedef struct _PropertiesArc PropertiesArc;
typedef struct _PropertiesBG PropertiesBG;


void draw_item(	GdkDrawable *drawable,
		gint x,
		gint y,
		LttvTraceState *ts,
		LttvTracefileState *tfs,
		LttvIAttribute *attributes);

/*
 * The tree of attributes used to store drawing operations goes like this :
 *
 * event_types/
 *   "facility-event_type"
 * cpus/
 *   "cpu name"
 * mode_types/
 *   "execution mode"/
 *     submodes/
 *       "submode"
 * process_states/
 *   "state name"
 * 
 * So if, for example, we want to add a hook to get called each time we
 * receive an event that is in state LTTV_STATE_SYSCALL, we put the
 * pointer to the GArray of DrawOperation in
 * process_states/ "name associated with LTTV_STATE_SYSCALL"
 */

/* 
 * The add_operation has to do a quick sort by priority to keep the operations
 * in the right order.
 */
void add_operation(	LttvIAttribute *attributes,
			gchar *pathname,
			DrawOperation *Operation);

/* 
 * The del_operation seeks the array present at pathname (if any) and
 * removes the DrawOperation if present. It returns 0 on success, -1
 * if it fails.
 */
gint del_operation(	LttvIAttribute *attributes,
			gchar *pathname,
			DrawOperation *Operation);

/* 
 * The clean_operations removes all operations present at a pathname.
 * returns 0 on success, -1 if it fails.
 */
gint clean_operations(	LttvIAttribute *attributes,
			gchar *pathname );


/* 
 * The list_operations gives a pointer to the operation array associated
 * with the pathname. It will be NULL if no operation is present.
 */
void list_operations(	LttvIAttribute *attributes,
			gchar *pathname,
			GArray **Operation);


/*
 * exec_operation executes the operations if present in the attributes, or
 * do nothing if not present.
 */
void exec_operations(	LttvIAttribute *attributes,
			gchar *pathname);


/*
 * Functions to create Properties structures.
 */

PropertiesText *properties_text_create(
	GdkColor	*foreground,
	GdkColor	*background,
	gint		size,
	gchar		*Text,
	RelPos		position);

PropertiesIcon *properties_icon_create(
	gchar		*icon_name,
	gint		width,
	gint		height,
	RelPos		position),

PropertiesLine *properties_line_create(
	GdkColor	*color,
	gint		line_width,
	GdkLineStyle	style,
	RelPos		position),

PropertiesArc *properties_arc_create(
	GdkColor	*color,
	gint		size,
	gboolean	filled,
	RelPos		position),

PropertiesBG *properties_bg_create(
	GdkColor	*color);


/*
 * Here follow the prototypes of the hook functions used to draw the
 * different items.
 */

gboolean draw_text( void *hook_data, void *call_data);
gboolean draw_icon( void *hook_data, void *call_data);
gboolean draw_line( void *hook_data, void *call_data);
gboolean draw_arc( void *hook_data, void *call_data);
gboolean draw_bg( void *hook_data, void *call_data);


#endif // _DRAW_ITEM_H
Commit	Line	Data
b782dd11	1	#ifndef _DRAW_ITEM_H
	2	#define _DRAW_ITEM_H
	3
	4	typedef struct _DrawContext DrawContext;
	5	typedef struct _DrawInfo DrawInfo;
	6	typedef struct _ItemInfo ItemInfo;
	7
	8	typedef struct _DrawOperation DrawOperation;
	9
	10
	11	typedef struct _PropertiesText PropertiesText;
	12	typedef struct _PropertiesIcon PropertiesIcon;
	13	typedef struct _PropertiesLine PropertiesLine;
	14	typedef struct _PropertiesArc PropertiesArc;
	15	typedef struct _PropertiesBG PropertiesBG;
	16
	17
4c69e0cc	18	void draw_item( GdkDrawable *drawable,
b782dd11	19	gint x,
	20	gint y,
	21	LttvTraceState *ts,
	22	LttvTracefileState *tfs,
	23	LttvIAttribute *attributes);
	24
	25	/*
	26	* The tree of attributes used to store drawing operations goes like this :
	27	*
	28	* event_types/
	29	* "facility-event_type"
	30	* cpus/
	31	* "cpu name"
	32	* mode_types/
	33	* "execution mode"/
	34	* submodes/
	35	* "submode"
	36	* process_states/
	37	* "state name"
	38	*
	39	* So if, for example, we want to add a hook to get called each time we
	40	* receive an event that is in state LTTV_STATE_SYSCALL, we put the
	41	* pointer to the GArray of DrawOperation in
	42	* process_states/ "name associated with LTTV_STATE_SYSCALL"
	43	*/
	44
	45	/*
4c69e0cc	46	* The add_operation has to do a quick sort by priority to keep the operations
b782dd11	47	* in the right order.
b782dd11	48	*/
4c69e0cc	49	void add_operation( LttvIAttribute *attributes,
b782dd11	50	gchar *pathname,
	51	DrawOperation *Operation);
	52
	53	/*
4c69e0cc	54	* The del_operation seeks the array present at pathname (if any) and
b782dd11	55	* removes the DrawOperation if present. It returns 0 on success, -1
	56	* if it fails.
	57	*/
4c69e0cc	58	gint del_operation( LttvIAttribute *attributes,
b782dd11	59	gchar *pathname,
	60	DrawOperation *Operation);
	61
	62	/*
4c69e0cc	63	* The clean_operations removes all operations present at a pathname.
b782dd11	64	* returns 0 on success, -1 if it fails.
b782dd11	65	*/
4c69e0cc	66	gint clean_operations( LttvIAttribute *attributes,
b782dd11	67	gchar *pathname );
	68
	69
	70	/*
4c69e0cc	71	* The list_operations gives a pointer to the operation array associated
b782dd11	72	* with the pathname. It will be NULL if no operation is present.
b782dd11	73	*/
4c69e0cc	74	void list_operations( LttvIAttribute *attributes,
b782dd11	75	gchar *pathname,
	76	GArray **Operation);
	77
	78
	79
	80	/*
4c69e0cc	81	* exec_operation executes the operations if present in the attributes, or
b782dd11	82	* do nothing if not present.
b782dd11	83	*/
4c69e0cc	84	void exec_operations( LttvIAttribute *attributes,
b782dd11	85	gchar *pathname);
	86
	87
	88	/*
	89	* Functions to create Properties structures.
	90	*/
	91
	92	PropertiesText *properties_text_create(
	93	GdkColor *foreground,
	94	GdkColor *background,
	95	gint size,
	96	gchar *Text,
	97	RelPos position);
	98
	99	PropertiesIcon *properties_icon_create(
	100	gchar *icon_name,
	101	gint width,
	102	gint height,
	103	RelPos position),
	104
	105	PropertiesLine *properties_line_create(
	106	GdkColor *color,
	107	gint line_width,
	108	GdkLineStyle style,
	109	RelPos position),
	110
	111	PropertiesArc *properties_arc_create(
	112	GdkColor *color,
	113	gint size,
	114	gboolean filled,
	115	RelPos position),
	116
	117	PropertiesBG *properties_bg_create(
	118	GdkColor *color);
	119
	120
	121
	122
	123	/*
	124	* Here follow the prototypes of the hook functions used to draw the
	125	* different items.
	126	*/
	127
4c69e0cc	128	gboolean draw_text( void hook_data, void call_data);
	129	gboolean draw_icon( void hook_data, void call_data);
	130	gboolean draw_line( void hook_data, void call_data);
	131	gboolean draw_arc( void hook_data, void call_data);
	132	gboolean draw_bg( void hook_data, void call_data);
b782dd11	133
	134
	135	#endif // _DRAW_ITEM_H