ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/src/urxvt.pm
(Generate patch)

Comparing rxvt-unicode/src/urxvt.pm (file contents):
Revision 1.34 by root, Fri Jan 6 01:16:58 2006 UTC vs.
Revision 1.35 by root, Fri Jan 6 01:27:27 2006 UTC

… …
60 60
61=item digital-clock 61=item digital-clock
62 62
63Displays a digital clock using the built-in overlay. 63Displays a digital clock using the built-in overlay.
64 64
65=item mark-urls
66
67Uses per-line filtering (C<on_line_update>) to underline urls.
68
65=item example-refresh-hooks 69=item example-refresh-hooks
66 70
67Displays a very simple digital clock in the upper right corner of the 71Displays a very simple digital clock in the upper right corner of the
68window. Illustrates overwriting the refresh callbacks to create your own 72window. Illustrates overwriting the refresh callbacks to create your own
69overlays or changes. 73overlays or changes.
70 74
71=item mark-urls 75=item example-filter-input
72 76
73A not very useful example of filtering all text output to the terminal, by 77A not very useful example of filtering all text output to the terminal, by
74underlining all urls that matches a certain regex (i.e. some urls :). It 78underlining all urls that matches a certain regex (i.e. some urls :). It
75is not very useful because urls that are output in multiple steps (e.g. 79is not very useful because urls that are output in multiple steps (e.g.
76when typing them) do not get marked. 80when typing them) do not get marked.
… …
222Called whenever text is about to be output, with the text as argument. You 226Called whenever text is about to be output, with the text as argument. You
223can filter/change and output the text yourself by returning a true value 227can filter/change and output the text yourself by returning a true value
224and calling C<< $term->scr_add_lines >> yourself. Please note that this 228and calling C<< $term->scr_add_lines >> yourself. Please note that this
225might be very slow, however, as your hook is called for B<all> text being 229might be very slow, however, as your hook is called for B<all> text being
226output. 230output.
231
232=item on_line_update $term, $row
233
234Called whenever a line was updated or changed. Can be used to filter
235screen output (e.g. underline urls or other useless stuff). Only lines
236that are being shown will be filtered, and, due to performance reasons,
237not always immediately.
238
239The row number is always the topmost row of the line if the line spans
240multiple rows.
241
242Please note that, if you change the line, then the hook might get called
243later with the already-modified line (e.g. if unrelated parts change), so
244you cannot just toggle rendition bits, but only set them.
227 245
228=item on_refresh_begin $term 246=item on_refresh_begin $term
229 247
230Called just before the screen gets redrawn. Can be used for overlay 248Called just before the screen gets redrawn. Can be used for overlay
231or similar effects by modify terminal contents in refresh_begin, and 249or similar effects by modify terminal contents in refresh_begin, and
… …
735about the logical line that row C<$row_number> is part of. It supports the 753about the logical line that row C<$row_number> is part of. It supports the
736following methods: 754following methods:
737 755
738=over 4 756=over 4
739 757
740=item $text = $line->t 758=item $text = $line->t ([$new_text])
741 759
742Returns the full text of the line, similar to C<ROW_t> 760Returns or replaces the full text of the line, similar to C<ROW_t>
743 761
744=item $rend = $line->r 762=item $rend = $line->r ([$new_rend])
745 763
746Returns the full rendition array of the line, similar to C<ROW_r> 764Returns or replaces the full rendition array of the line, similar to C<ROW_r>
747 765
748=item $length = $line->l 766=item $length = $line->l
749 767
750Returns the length of the line in cells, similar to C<ROW_l>. 768Returns the length of the line in cells, similar to C<ROW_l>.
751 769

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines