1 #ifndef GTK_TEXT_BTREE_H
2 #define GTK_TEXT_BTREE_H
5 #define DEBUG_VALIDATION_AND_SCROLLING
8 #ifdef DEBUG_VALIDATION_AND_SCROLLING
14 #include <gtk/gtktextbuffer.h>
15 #include <gtk/gtktexttag.h>
16 #include <gtk/gtktextmark.h>
17 #include <gtk/gtktextchild.h>
18 #include <gtk/gtktextsegment.h>
19 #include <gtk/gtktextiter.h>
23 #endif /* __cplusplus */
25 GtkTextBTree *_gtk_text_btree_new (GtkTextTagTable *table,
26 GtkTextBuffer *buffer);
27 void _gtk_text_btree_ref (GtkTextBTree *tree);
28 void _gtk_text_btree_unref (GtkTextBTree *tree);
29 GtkTextBuffer *_gtk_text_btree_get_buffer (GtkTextBTree *tree);
32 guint _gtk_text_btree_get_chars_changed_stamp (GtkTextBTree *tree);
33 guint _gtk_text_btree_get_segments_changed_stamp (GtkTextBTree *tree);
34 void _gtk_text_btree_segments_changed (GtkTextBTree *tree);
36 gboolean _gtk_text_btree_is_end (GtkTextBTree *tree,
38 GtkTextLineSegment *seg,
42 /* Indexable segment mutation */
44 void _gtk_text_btree_delete (GtkTextIter *start,
46 void _gtk_text_btree_insert (GtkTextIter *iter,
49 void _gtk_text_btree_insert_pixbuf (GtkTextIter *iter,
52 void _gtk_text_btree_insert_child_anchor (GtkTextIter *iter,
53 GtkTextChildAnchor *anchor);
55 void _gtk_text_btree_unregister_child_anchor (GtkTextChildAnchor *anchor);
58 GtkTextLine *_gtk_text_btree_find_line_by_y (GtkTextBTree *tree,
62 gint _gtk_text_btree_find_line_top (GtkTextBTree *tree,
65 void _gtk_text_btree_add_view (GtkTextBTree *tree,
66 GtkTextLayout *layout);
67 void _gtk_text_btree_remove_view (GtkTextBTree *tree,
69 void _gtk_text_btree_invalidate_region (GtkTextBTree *tree,
70 const GtkTextIter *start,
71 const GtkTextIter *end);
72 void _gtk_text_btree_get_view_size (GtkTextBTree *tree,
76 gboolean _gtk_text_btree_is_valid (GtkTextBTree *tree,
78 gboolean _gtk_text_btree_validate (GtkTextBTree *tree,
84 void _gtk_text_btree_validate_line (GtkTextBTree *tree,
90 void _gtk_text_btree_tag (const GtkTextIter *start,
91 const GtkTextIter *end,
97 GtkTextLine * _gtk_text_btree_get_line (GtkTextBTree *tree,
99 gint *real_line_number);
100 GtkTextLine * _gtk_text_btree_get_line_no_last (GtkTextBTree *tree,
102 gint *real_line_number);
103 GtkTextLine * _gtk_text_btree_get_end_iter_line (GtkTextBTree *tree);
104 GtkTextLine * _gtk_text_btree_get_line_at_char (GtkTextBTree *tree,
106 gint *line_start_index,
107 gint *real_char_index);
108 GtkTextTag** _gtk_text_btree_get_tags (const GtkTextIter *iter,
110 gchar *_gtk_text_btree_get_text (const GtkTextIter *start,
111 const GtkTextIter *end,
112 gboolean include_hidden,
113 gboolean include_nonchars);
114 gint _gtk_text_btree_line_count (GtkTextBTree *tree);
115 gint _gtk_text_btree_char_count (GtkTextBTree *tree);
116 gboolean _gtk_text_btree_char_is_invisible (const GtkTextIter *iter);
120 /* Get iterators (these are implemented in gtktextiter.c) */
121 void _gtk_text_btree_get_iter_at_char (GtkTextBTree *tree,
124 void _gtk_text_btree_get_iter_at_line_char (GtkTextBTree *tree,
128 void _gtk_text_btree_get_iter_at_line_byte (GtkTextBTree *tree,
132 gboolean _gtk_text_btree_get_iter_from_string (GtkTextBTree *tree,
134 const gchar *string);
135 gboolean _gtk_text_btree_get_iter_at_mark_name (GtkTextBTree *tree,
137 const gchar *mark_name);
138 void _gtk_text_btree_get_iter_at_mark (GtkTextBTree *tree,
141 void _gtk_text_btree_get_end_iter (GtkTextBTree *tree,
143 void _gtk_text_btree_get_iter_at_line (GtkTextBTree *tree,
147 gboolean _gtk_text_btree_get_iter_at_first_toggle (GtkTextBTree *tree,
150 gboolean _gtk_text_btree_get_iter_at_last_toggle (GtkTextBTree *tree,
154 void _gtk_text_btree_get_iter_at_child_anchor (GtkTextBTree *tree,
156 GtkTextChildAnchor *anchor);
160 /* Manipulate marks */
161 GtkTextMark *_gtk_text_btree_set_mark (GtkTextBTree *tree,
162 GtkTextMark *existing_mark,
164 gboolean left_gravity,
165 const GtkTextIter *index,
166 gboolean should_exist);
167 void _gtk_text_btree_remove_mark_by_name (GtkTextBTree *tree,
169 void _gtk_text_btree_remove_mark (GtkTextBTree *tree,
170 GtkTextMark *segment);
171 gboolean _gtk_text_btree_get_selection_bounds (GtkTextBTree *tree,
174 void _gtk_text_btree_place_cursor (GtkTextBTree *tree,
175 const GtkTextIter *where);
176 gboolean _gtk_text_btree_mark_is_insert (GtkTextBTree *tree,
177 GtkTextMark *segment);
178 gboolean _gtk_text_btree_mark_is_selection_bound (GtkTextBTree *tree,
179 GtkTextMark *segment);
180 GtkTextMark *_gtk_text_btree_get_mark_by_name (GtkTextBTree *tree,
182 GtkTextLine * _gtk_text_btree_first_could_contain_tag (GtkTextBTree *tree,
184 GtkTextLine * _gtk_text_btree_last_could_contain_tag (GtkTextBTree *tree,
189 /* Chunk of data associated with a line; views can use this to store
190 info at the line. They should "subclass" the header struct here. */
191 struct _GtkTextLineData {
193 GtkTextLineData *next;
195 signed int width : 24;
196 guint valid : 8; /* Actually a boolean */
200 * The data structure below defines a single line of text (from newline
201 * to newline, not necessarily what appears on one line of the screen).
203 * You can consider this line a "paragraph" also
206 struct _GtkTextLine {
207 GtkTextBTreeNode *parent; /* Pointer to parent node containing
209 GtkTextLine *next; /* Next in linked list of lines with
210 * same parent node in B-tree. NULL
211 * means end of list. */
212 GtkTextLineSegment *segments; /* First in ordered list of segments
213 * that make up the line. */
214 GtkTextLineData *views; /* data stored here by views */
218 gint _gtk_text_line_get_number (GtkTextLine *line);
219 gboolean _gtk_text_line_char_has_tag (GtkTextLine *line,
223 gboolean _gtk_text_line_byte_has_tag (GtkTextLine *line,
227 gboolean _gtk_text_line_is_last (GtkTextLine *line,
229 gboolean _gtk_text_line_contains_end_iter (GtkTextLine *line,
231 GtkTextLine * _gtk_text_line_next (GtkTextLine *line);
232 GtkTextLine * _gtk_text_line_next_excluding_last (GtkTextLine *line);
233 GtkTextLine * _gtk_text_line_previous (GtkTextLine *line);
234 void _gtk_text_line_add_data (GtkTextLine *line,
235 GtkTextLineData *data);
236 gpointer _gtk_text_line_remove_data (GtkTextLine *line,
238 gpointer _gtk_text_line_get_data (GtkTextLine *line,
240 void _gtk_text_line_invalidate_wrap (GtkTextLine *line,
241 GtkTextLineData *ld);
242 gint _gtk_text_line_char_count (GtkTextLine *line);
243 gint _gtk_text_line_byte_count (GtkTextLine *line);
244 gint _gtk_text_line_char_index (GtkTextLine *line);
245 GtkTextLineSegment *_gtk_text_line_byte_to_segment (GtkTextLine *line,
248 GtkTextLineSegment *_gtk_text_line_char_to_segment (GtkTextLine *line,
251 gboolean _gtk_text_line_byte_locate (GtkTextLine *line,
253 GtkTextLineSegment **segment,
254 GtkTextLineSegment **any_segment,
255 gint *seg_byte_offset,
256 gint *line_byte_offset);
257 gboolean _gtk_text_line_char_locate (GtkTextLine *line,
259 GtkTextLineSegment **segment,
260 GtkTextLineSegment **any_segment,
261 gint *seg_char_offset,
262 gint *line_char_offset);
263 void _gtk_text_line_byte_to_char_offsets (GtkTextLine *line,
265 gint *line_char_offset,
266 gint *seg_char_offset);
267 void _gtk_text_line_char_to_byte_offsets (GtkTextLine *line,
269 gint *line_byte_offset,
270 gint *seg_byte_offset);
271 GtkTextLineSegment *_gtk_text_line_byte_to_any_segment (GtkTextLine *line,
274 GtkTextLineSegment *_gtk_text_line_char_to_any_segment (GtkTextLine *line,
277 gint _gtk_text_line_byte_to_char (GtkTextLine *line,
279 gint _gtk_text_line_char_to_byte (GtkTextLine *line,
281 GtkTextLine * _gtk_text_line_next_could_contain_tag (GtkTextLine *line,
284 GtkTextLine * _gtk_text_line_previous_could_contain_tag (GtkTextLine *line,
288 GtkTextLineData *_gtk_text_line_data_new (GtkTextLayout *layout,
292 void _gtk_text_btree_check (GtkTextBTree *tree);
293 void _gtk_text_btree_spew (GtkTextBTree *tree);
294 extern gboolean _gtk_text_view_debug_btree;
296 /* ignore, exported only for gtktextsegment.c */
297 void _gtk_toggle_segment_check_func (GtkTextLineSegment *segPtr,
299 void _gtk_change_node_toggle_count (GtkTextBTreeNode *node,
300 GtkTextTagInfo *info,
303 /* for gtktextmark.c */
304 void _gtk_text_btree_release_mark_segment (GtkTextBTree *tree,
305 GtkTextLineSegment *segment);
307 /* for coordination with the tag table */
308 void _gtk_text_btree_notify_will_remove_tag (GtkTextBTree *tree,
313 #endif /* __cplusplus */