libchimara/pager.c

   1 #include <gdk/gdkkeysyms.h>
   2
   3 #include "pager.h"
   4
   5 /* Helper function: move the pager to the last visible position in the buffer,
   6  and return the distance between the pager and the end of the buffer in buffer
   7  coordinates */
   8 static void
   9 move_pager_and_get_scroll_distance(GtkTextView *textview, gint *view_height, gint *scroll_distance, gboolean move )
  10 {
  11         GdkRectangle pagerpos, endpos, visiblerect;
  12         GtkTextIter oldpager, newpager, end;
  13         GtkTextBuffer *buffer = gtk_text_view_get_buffer(textview);
  14         GtkTextMark *pager = gtk_text_buffer_get_mark(buffer, "pager_position");
  15
  16         /* Get an iter at the lower right corner of the visible part of the buffer */
  17         gtk_text_view_get_visible_rect(textview, &visiblerect);
  18         gtk_text_view_get_iter_at_location(
  19                 textview,
  20                 &newpager,
  21                 visiblerect.x + visiblerect.width,
  22                 visiblerect.y + visiblerect.height
  23         );
  24         gtk_text_buffer_get_iter_at_mark(buffer, &oldpager, pager);
  25
  26         if(move)
  27                 gtk_text_buffer_move_mark(buffer, pager, &newpager);
  28
  29         /* Get the buffer coordinates of the pager and the end iter */
  30         gtk_text_buffer_get_end_iter(buffer, &end);
  31         gtk_text_buffer_get_iter_at_mark(buffer, &newpager, pager);
  32         gtk_text_view_get_iter_location(textview, &newpager, &pagerpos);
  33         gtk_text_view_get_iter_location(textview, &end, &endpos);
  34
  35         /*
  36         g_printerr("View height = %d\n", visiblerect.height);
  37         g_printerr("End - Pager = %d\n", endpos.y - pagerpos.y);
  38         */
  39
  40         *view_height = visiblerect.height;
  41         *scroll_distance = endpos.y - pagerpos.y;
  42 }
  43
  44 /* Helper function: turn on paging for this textview */
  45 static void
  46 start_paging(winid_t win)
  47 {
  48         win->currently_paging = TRUE;
  49         g_signal_handler_unblock(win->widget, win->pager_expose_handler);
  50         g_signal_handler_unblock(win->widget, win->pager_keypress_handler);
  51 }
  52
  53 /* Helper function: turn off paging for this textview */
  54 static void
  55 stop_paging(winid_t win)
  56 {
  57         win->currently_paging = FALSE;
  58         g_signal_handler_block(win->widget, win->pager_expose_handler);
  59         g_signal_handler_block(win->widget, win->pager_keypress_handler);
  60 }
  61
  62 /* When the user scrolls up in a textbuffer, start paging. */
  63 void
  64 pager_after_adjustment_changed(GtkAdjustment *adj, winid_t win)
  65 {
  66         /* Move the pager, etc. */
  67         gint scroll_distance, view_height;
  68         move_pager_and_get_scroll_distance( GTK_TEXT_VIEW(win->widget), &view_height, &scroll_distance, TRUE );
  69
  70         if(scroll_distance > 0 && !win->currently_paging)
  71                 start_paging(win);
  72         else if(scroll_distance == 0 && win->currently_paging)
  73                 stop_paging(win);
  74
  75         /* Refresh the widget so that any extra "more" prompts disappear */
  76         gtk_widget_queue_draw(win->widget);
  77 }
  78
  79 /* Handle key press events in the textview while paging is active */
  80 gboolean
  81 pager_on_key_press_event(GtkTextView *textview, GdkEventKey *event, winid_t win)
  82 {
  83         GtkAdjustment *adj = gtk_scrolled_window_get_vadjustment( GTK_SCROLLED_WINDOW(win->frame) );
  84         gdouble step_increment, page_size, upper, lower, value;
  85         g_object_get(adj,
  86                 "page-size", &page_size,
  87                 "step-increment", &step_increment,
  88                 "upper", &upper,
  89                 "lower", &lower,
  90                 "value", &value,
  91                 NULL);
  92
  93         switch (event->keyval) {
  94                 case GDK_space: case GDK_KP_Space: case GDK_Page_Down: case GDK_KP_Page_Down:
  95                         gtk_adjustment_set_value(adj, CLAMP(value + page_size, lower, upper - page_size));
  96                         return TRUE;
  97                 case GDK_Page_Up: case GDK_KP_Page_Up:
  98                         gtk_adjustment_set_value(adj, CLAMP(value - page_size, lower, upper - page_size));
  99                         return TRUE;
 100                 case GDK_Return: case GDK_KP_Enter:
 101                         gtk_adjustment_set_value(adj, CLAMP(value + step_increment, lower, upper - page_size));
 102                         return TRUE;
 103                         /* don't handle "up" and "down", they're used for input history */
 104         }
 105
 106         return FALSE; /* if the key wasn't handled here, pass it to other handlers */
 107 }
 108
 109 /* Draw the "more" prompt on top of the buffer, after the regular expose event has run */
 110 gboolean
 111 pager_on_expose(GtkTextView *textview, GdkEventExpose *event, winid_t win)
 112 {
 113         /* Calculate the position of the 'more' tag */
 114         gint promptwidth, promptheight;
 115         pango_layout_get_pixel_size(win->pager_layout, &promptwidth, &promptheight);
 116
 117         gint winx, winy, winwidth, winheight;
 118         gdk_window_get_position(event->window, &winx, &winy);
 119         gdk_drawable_get_size(GDK_DRAWABLE(event->window), &winwidth, &winheight);
 120
 121         /* Draw the 'more' tag */
 122         GdkGC *context = gdk_gc_new(GDK_DRAWABLE(event->window));
 123         gdk_draw_layout(event->window, context,
 124                 winx + winwidth - promptwidth,
 125                 winy + winheight - promptheight,
 126                 win->pager_layout);
 127
 128         return FALSE; /* Propagate event further */
 129 }
 130
 131 /* Check whether paging should be done. This function is called after the
 132  * textview has finished validating text positions. */
 133 void pager_after_size_request(GtkTextView *textview, GtkRequisition
 134                 *requisition, winid_t win) {
 135         /* Move the pager to the last visible character in the buffer */
 136         gint view_height, scroll_distance; move_pager_and_get_scroll_distance(
 137                         GTK_TEXT_VIEW(win->widget), &view_height, &scroll_distance, FALSE
 138                         );
 139
 140         if(view_height <= 1)
 141                 /* Paging is unusable when window is too small */
 142                 return;
 143
 144         /* Scroll past text already read by user. This is automatic scrolling, so disable the pager_ajustment_handler
 145          * first, that acts on the belief the scolling is performed by the user. */
 146         GtkAdjustment *adj = gtk_scrolled_window_get_vadjustment(GTK_SCROLLED_WINDOW(win->frame));
 147         g_signal_handler_block(adj, win->pager_adjustment_handler);
 148         GtkTextBuffer *buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(win->widget));
 149         GtkTextMark *pager_position = gtk_text_buffer_get_mark(buffer, "pager_position");
 150         gtk_text_view_scroll_to_mark(GTK_TEXT_VIEW(win->widget), pager_position, 0.0, TRUE, 0.0, 0.0);
 151         g_signal_handler_unblock(adj, win->pager_adjustment_handler);
 152
 153         if(!win->currently_paging) {
 154                 if(scroll_distance > view_height) {
 155                         start_paging(win);
 156                         /* Seriously... */
 157                         /* COMPAT: */
 158 #if GTK_CHECK_VERSION(2,14,0)
 159                         gdk_window_invalidate_rect(gtk_widget_get_window(win->widget), NULL, TRUE);
 160 #else
 161                         gdk_window_invalidate_rect(win->widget->window, NULL, TRUE);
 162 #endif
 163                 }
 164         }
 165 }
 166
 167 void
 168 pager_update(winid_t win)
 169 {
 170         GtkTextIter input_iter;
 171         GtkTextBuffer *buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(win->widget));
 172         GtkTextMark *input_position = gtk_text_buffer_get_mark(buffer, "input_position");
 173         GtkTextMark *pager_position = gtk_text_buffer_get_mark(buffer, "pager_position");
 174         gtk_text_buffer_get_iter_at_mark(buffer, &input_iter, input_position);
 175         gtk_text_buffer_move_mark(buffer, pager_position, &input_iter);
 176 }