2 * Definitions for GTK+ packet display structures and routines
6 * Wireshark - Network traffic analyzer
7 * By Gerald Combs <gerald@wireshark.org>
8 * Copyright 1998 Gerald Combs
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public License
12 * as published by the Free Software Foundation; either version 2
13 * of the License, or (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25 #ifndef __GTKPACKET_H__
26 #define __GTKPACKET_H__
29 * Packet tree and details panes.
30 * @ingroup main_window_group
33 /** Create byte views in the main window.
35 void add_main_byte_views(epan_dissect_t *edt);
37 /** Display the protocol tree in the main window.
39 void main_proto_tree_draw(proto_tree *protocol_tree);
41 /** Clear the hex dump and protocol tree panes.
43 void clear_tree_and_hex_views(void);
46 /** Get the current text notebook page of the packet details notebook.
48 * @param nb_ptr the notebook widget
49 * @return the notebook page
51 extern GtkWidget *get_notebook_bv_ptr(GtkWidget *nb_ptr);
54 * Get the data and length for a byte view, given the byte view page widget.
56 * @param byte_view the byte view to look at
57 * @param data_len set "*data_len" to the length
58 * @return the pointer, or NULL on error
60 extern const guint8 *get_byte_view_data_and_length(GtkWidget *byte_view,
63 /** Set the current text page of the notebook to the window that
64 * refers to a particular tvbuff.
66 * @param nb_ptr the byte view notebook
67 * @param tvb the tvbuff to look at
69 extern void set_notebook_page(GtkWidget *nb_ptr, tvbuff_t *tvb);
71 /** Redraw a given byte view window.
73 * @param nb_ptr the byte view notebook
74 * @param fd selected frame
75 * @param finfo selected field_info
77 extern void redraw_packet_bytes(GtkWidget *nb_ptr, frame_data *fd, field_info *finfo);
79 /** Redraw all byte view windows. */
80 extern void redraw_packet_bytes_all(void);
82 /** Create a new byte view (packet details pane).
84 * @return the new byte view
86 extern GtkWidget *byte_view_new(void);
88 /** Clear and fill all the byte view notebook tabs.
90 * @param edt current dissections
91 * @param tree_view the corresponding packet tree
92 * @param nb_ptr the byte view notebook
94 extern void add_byte_views(epan_dissect_t *edt, GtkWidget *tree_view,
97 /** Gdk button click appeared, select the byte view from that position.
99 * @param widget the byte view
100 * @param event the button event clicked
101 * @return TRUE if could be selected
103 extern gboolean byte_view_select(GtkWidget *widget, GdkEventButton *event);
105 /** This highlights the field in the proto tree that is at position byte
107 * @param tvb the current tvbuff
108 * @param byte the byte offset within the packet to highlight
109 * @param tree_view the current tree_view
110 * @param tree the current tree
111 * @return TRUE if highlighting was successful
114 highlight_field(tvbuff_t *tvb, gint byte, GtkTreeView *tree_view,
117 /** Callback for "Export Selected Packet Bytes" operation.
122 extern void savehex_cb(GtkWidget * w, gpointer data);
124 /** Format of packet data to copy to clipboard.
125 * Lower nibble holds data type, next nibble holds flags.
128 CD_ALLINFO, /* All information - columated hex with text in separate column */
129 CD_TEXTONLY, /* Printable characters */
130 CD_HEX, /* Hex, space separated, no linebreaks */
131 CD_HEXCOLUMNS, /* Like "All Information" but with no ASCII */
132 CD_BINARY, /* Raw binary octets */
134 CD_TYPEMASK = 0x0000FFFF, /* Mask for extracting type */
135 CD_FLAGSMASK = 0xFFFF0000, /* Mask for extracting flags */
137 CD_FLAGS_SELECTEDONLY = 0x00010000 /* Copy only selected bytes */
141 /** Callback for "Copy packet bytes to clipboard" operation.
146 extern void copy_hex_cb(GtkWidget * w, gpointer data, copy_data_type data_type);
148 /** Redraw a given byte view window.
150 * @param bv the byte view
151 * @param pd the packet data
152 * @param fd the current fame
153 * @param finfo the current field info
154 * @param len the byte view length
156 extern void packet_hex_print(GtkWidget *bv, const guint8 *pd, frame_data *fd,
157 field_info *finfo, guint len);
160 * Redraw the text using the saved information. Usually called if
161 * the preferences have changed.
163 * @param bv the byte view
165 extern void packet_hex_reprint(GtkWidget *bv);
167 /** Set a new font for all protocol trees.
169 * @param font the new font
171 extern void set_ptree_font_all(PangoFontDescription *font);
173 /** Find field in tree view by field_info.
175 * @param tree_view the tree view to look at
176 * @param finfo the field info the look for
177 * @return the path to the field
179 extern GtkTreePath *tree_find_by_field_info(GtkTreeView *tree_view, field_info *finfo);
181 /** Create a new tree view (packet details).
183 * @param prefs current preferences
184 * @param tree_view_p fill in the new tree view
185 * @return the new scrolled window (parent of the tree view)
187 extern GtkWidget * main_tree_view_new(e_prefs *prefs, GtkWidget **tree_view_p);
189 /** Clear and redraw the whole tree view.
191 * @param protocol_tree the currently dissected protocol tree
192 * @param tree_view the tree view to redraw
194 extern void proto_tree_draw(proto_tree *protocol_tree, GtkWidget *tree_view);
196 /** Expand the whole tree view.
198 * @param protocol_tree the currently dissected protocol tree
199 * @param tree_view the tree view to redraw
201 extern void expand_all_tree(proto_tree *protocol_tree, GtkWidget *tree_view);
203 /** Collapse the whole tree view.
205 * @param protocol_tree the currently dissected protocol tree
206 * @param tree_view the tree view to redraw
208 extern void collapse_all_tree(proto_tree *protocol_tree, GtkWidget *tree_view);
210 /** Gdk button click appeared, select the byte view from that position.
212 * @param widget the tree view
213 * @param event the button event clicked
214 * @return TRUE if could be selected
216 extern gboolean tree_view_select(GtkWidget *widget, GdkEventButton *event);
218 /** Set the selection mode of all packet tree windows.
220 * @param val GTK_SELECTION_SINGLE if TRUE, GTK_SELECTION_BROWSE if FALSE
222 extern void set_ptree_sel_browse_all(gboolean val);
228 extern void select_bytes_view (GtkWidget *widget, gpointer data, gint view);
230 /** init the expert colors */
231 extern void proto_draw_colors_init(void);
233 /** the expert colors */
234 extern GdkColor expert_color_chat;
235 extern GdkColor expert_color_note;
236 extern GdkColor expert_color_warn;
237 extern GdkColor expert_color_error;
238 extern GdkColor expert_color_foreground;
240 /* string representation of expert colors */
241 extern gchar *expert_color_chat_str;
242 extern gchar *expert_color_note_str;
243 extern gchar *expert_color_warn_str;
244 extern gchar *expert_color_error_str;
245 extern gchar *expert_color_foreground_str;