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.172 by root, Fri Oct 10 00:21:15 2008 UTC vs.
Revision 1.180 by root, Sat Dec 26 09:42:16 2009 UTC

303extension will actually grab a physical key just for this function. 303extension will actually grab a physical key just for this function.
304 304
305If you want a quake-like animation, tell your window manager to do so 305If you want a quake-like animation, tell your window manager to do so
306(fvwm can do it). 306(fvwm can do it).
307 307
308=item overlay-osc
309
310This extension implements some OSC commands to display timed popups on the
311screen - useful for status displays from within scripts. You have to read
312the sources for more info.
313
308=item block-graphics-to-ascii 314=item block-graphics-to-ascii
309 315
310A not very useful example of filtering all text output to the terminal 316A not very useful example of filtering all text output to the terminal
311by replacing all line-drawing characters (U+2500 .. U+259F) by a 317by replacing all line-drawing characters (U+2500 .. U+259F) by a
312similar-looking ascii character. 318similar-looking ascii character.
366 372
367I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret 373I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret
368the double C</> characters as comment start. Use C<\057\057> instead, 374the double C</> characters as comment start. Use C<\057\057> instead,
369which works regardless of wether xrdb is used to parse the resource file 375which works regardless of wether xrdb is used to parse the resource file
370or not. 376or not.
377
378=item macosx-pastebin and macosx-pastebin-native
379
380These two modules implement an extended clipboard for Mac OS X. They are
381used like this:
382
383 URxvt.perl-ext-common: default,macosx-clipboard
384 URxvt.keysym.M-c: perl:macosx-clipboard:copy
385 URxvt.keysym.M-v: perl:macosx-clipboard:paste
386
387The difference between them is that the native variant requires a
388perl from apple's devkit or so, and C<maxosx-pastebin> requires the
389C<Mac::Pasteboard> module, works with other perls, has fewer bugs, is
390simpler etc. etc.
371 391
372=item example-refresh-hooks 392=item example-refresh-hooks
373 393
374Displays a very simple digital clock in the upper right corner of the 394Displays a very simple digital clock in the upper right corner of the
375window. Illustrates overwriting the refresh callbacks to create your own 395window. Illustrates overwriting the refresh callbacks to create your own
1104is that you cannot use blocking APIs, but the non-blocking variant should 1124is that you cannot use blocking APIs, but the non-blocking variant should
1105work. 1125work.
1106 1126
1107=cut 1127=cut
1108 1128
1109our $VERSION = '3.4'; 1129our $VERSION = '5.23';
1110 1130
1111$INC{"urxvt/anyevent.pm"} = 1; # mark us as there 1131$INC{"urxvt/anyevent.pm"} = 1; # mark us as there
1112push @AnyEvent::REGISTRY, [urxvt => urxvt::anyevent::]; 1132push @AnyEvent::REGISTRY, [urxvt => urxvt::anyevent::];
1113 1133
1114sub timer { 1134sub timer {
1116 1136
1117 my $cb = $arg{cb}; 1137 my $cb = $arg{cb};
1118 1138
1119 urxvt::timer 1139 urxvt::timer
1120 ->new 1140 ->new
1121 ->start (urxvt::NOW + $arg{after}) 1141 ->after ($arg{after}, $arg{interval})
1122 ->cb (sub { 1142 ->cb ($arg{interval} ? $cb : sub {
1123 $_[0]->stop; # need to cancel manually 1143 $_[0]->stop; # need to cancel manually
1124 $cb->(); 1144 $cb->();
1125 }) 1145 })
1126} 1146}
1127 1147
1128sub io { 1148sub io {
1129 my ($class, %arg) = @_; 1149 my ($class, %arg) = @_;
1130 1150
1131 my $cb = $arg{cb}; 1151 my $cb = $arg{cb};
1152 my $fd = fileno $arg{fh};
1153 defined $fd or $fd = $arg{fh};
1132 1154
1133 bless [$arg{fh}, urxvt::iow 1155 bless [$arg{fh}, urxvt::iow
1134 ->new 1156 ->new
1135 ->fd (fileno $arg{fh}) 1157 ->fd ($fd)
1136 ->events (($arg{poll} =~ /r/ ? 1 : 0) 1158 ->events (($arg{poll} =~ /r/ ? 1 : 0)
1137 | ($arg{poll} =~ /w/ ? 2 : 0)) 1159 | ($arg{poll} =~ /w/ ? 2 : 0))
1138 ->start 1160 ->start
1139 ->cb (sub { 1161 ->cb ($cb)
1140 $cb->(($_[1] & 1 ? 'r' : '')
1141 . ($_[1] & 2 ? 'w' : ''));
1142 })],
1143 urxvt::anyevent:: 1162 ], urxvt::anyevent::
1163}
1164
1165sub idle {
1166 my ($class, %arg) = @_;
1167
1168 my $cb = $arg{cb};
1169
1170 urxvt::iw
1171 ->new
1172 ->start
1173 ->cb ($cb)
1174}
1175
1176sub child {
1177 my ($class, %arg) = @_;
1178
1179 my $cb = $arg{cb};
1180
1181 urxvt::pw
1182 ->new
1183 ->start ($arg{pid})
1184 ->cb (sub {
1185 $_[0]->stop; # need to cancel manually
1186 $cb->($_[0]->rpid, $_[0]->rstatus);
1187 })
1144} 1188}
1145 1189
1146sub DESTROY { 1190sub DESTROY {
1147 $_[0][1]->stop; 1191 $_[0][1]->stop;
1148} 1192}
1278 1322
1279 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont 1323 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont
1280 borderLess chdir color cursorBlink cursorUnderline cutchars delete_key 1324 borderLess chdir color cursorBlink cursorUnderline cutchars delete_key
1281 display_name embed ext_bwidth fade font geometry hold iconName 1325 display_name embed ext_bwidth fade font geometry hold iconName
1282 imFont imLocale inputMethod insecure int_bwidth intensityStyles 1326 imFont imLocale inputMethod insecure int_bwidth intensityStyles
1283 italicFont jumpScroll lineSpace loginShell mapAlert meta8 modifier 1327 italicFont jumpScroll lineSpace letterSpace loginShell mapAlert meta8
1284 mouseWheelScrollPage name override_redirect pastableTabs path perl_eval 1328 modifier mouseWheelScrollPage name override_redirect pastableTabs path
1285 perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay 1329 perl_eval perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay
1286 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar 1330 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar
1287 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness 1331 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness
1288 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle 1332 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle
1289 secondaryScreen secondaryScroll shade term_name title 1333 secondaryScreen secondaryScroll shade term_name title
1290 transient_for transparent transparent_all tripleclickwords utmpInhibit 1334 transient_for transparent transparent_all tripleclickwords utmpInhibit
1328 1372
1329=item ($row, $col) = $term->selection_beg ([$row, $col]) 1373=item ($row, $col) = $term->selection_beg ([$row, $col])
1330 1374
1331=item ($row, $col) = $term->selection_end ([$row, $col]) 1375=item ($row, $col) = $term->selection_end ([$row, $col])
1332 1376
1333Return the current values of the selection mark, begin or end positions, 1377Return the current values of the selection mark, begin or end positions.
1334and optionally set them to new values. 1378
1379When arguments are given, then the selection coordinates are set to
1380C<$row> and C<$col>, and the selection screen is set to the current
1381screen.
1382
1383=item $screen = $term->selection_screen ([$screen])
1384
1385Returns the current selection screen, and then optionally sets it.
1335 1386
1336=item $term->selection_make ($eventtime[, $rectangular]) 1387=item $term->selection_make ($eventtime[, $rectangular])
1337 1388
1338Tries to make a selection as set by C<selection_beg> and 1389Tries to make a selection as set by C<selection_beg> and
1339C<selection_end>. If C<$rectangular> is true (default: false), a 1390C<selection_end>. If C<$rectangular> is true (default: false), a
2009 2060
2010=item $timer = $timer->cb (sub { my ($timer) = @_; ... }) 2061=item $timer = $timer->cb (sub { my ($timer) = @_; ... })
2011 2062
2012Set the callback to be called when the timer triggers. 2063Set the callback to be called when the timer triggers.
2013 2064
2014=item $tstamp = $timer->at
2015
2016Return the time this watcher will fire next.
2017
2018=item $timer = $timer->set ($tstamp) 2065=item $timer = $timer->set ($tstamp[, $interval])
2019 2066
2020Set the time the event is generated to $tstamp. 2067Set the time the event is generated to $tstamp (and optionally specifies a
2068new $interval).
2021 2069
2022=item $timer = $timer->interval ($interval) 2070=item $timer = $timer->interval ($interval)
2023 2071
2024Normally (and when C<$interval> is C<0>), the timer will automatically 2072By default (and when C<$interval> is C<0>), the timer will automatically
2025stop after it has fired once. If C<$interval> is non-zero, then the timer 2073stop after it has fired once. If C<$interval> is non-zero, then the timer
2026is automatically rescheduled at the given intervals. 2074is automatically rescheduled at the given intervals.
2027 2075
2028=item $timer = $timer->start 2076=item $timer = $timer->start
2029 2077
2030Start the timer. 2078Start the timer.
2031 2079
2032=item $timer = $timer->start ($tstamp) 2080=item $timer = $timer->start ($tstamp[, $interval])
2033 2081
2034Set the event trigger time to C<$tstamp> and start the timer. 2082Set the event trigger time to C<$tstamp> and start the timer. Optionally
2083also replaces the interval.
2035 2084
2036=item $timer = $timer->after ($delay) 2085=item $timer = $timer->after ($delay[, $interval])
2037 2086
2038Like C<start>, but sets the expiry timer to c<urxvt::NOW + $delay>. 2087Like C<start>, but sets the expiry timer to c<urxvt::NOW + $delay>.
2039 2088
2040=item $timer = $timer->stop 2089=item $timer = $timer->stop
2041 2090

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines