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.171 by root, Fri Oct 10 00:11:44 2008 UTC vs.
Revision 1.178 by root, Sat Dec 26 09:02:42 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})
1122 ->cb (sub { 1142 ->interval ($arg{interval})
1143 ->start
1144 ->cb ($argv{interval} ? $cb : sub {
1123 $_[0]->stop; # need to cancel manually 1145 $_[0]->stop; # need to cancel manually
1124 $cb->(); 1146 $cb->();
1125 }) 1147 })
1126} 1148}
1127 1149
1128sub io { 1150sub io {
1129 my ($class, %arg) = @_; 1151 my ($class, %arg) = @_;
1130 1152
1131 my $cb = $arg{cb}; 1153 my $cb = $arg{cb};
1154 my $fd = fileno $arg{fh};
1155 defined $fd or $fd = $arg{fh};
1132 1156
1133 bless [$arg{fh}, urxvt::iow 1157 bless [$arg{fh}, urxvt::iow
1134 ->new 1158 ->new
1135 ->fd (fileno $arg{fh}) 1159 ->fd ($fd)
1136 ->events (($arg{poll} =~ /r/ ? 1 : 0) 1160 ->events (($arg{poll} =~ /r/ ? 1 : 0)
1137 | ($arg{poll} =~ /w/ ? 2 : 0)) 1161 | ($arg{poll} =~ /w/ ? 2 : 0))
1138 ->start 1162 ->start
1139 ->cb (sub { 1163 ->cb ($cb)
1140 $cb->(($_[1] & 1 ? 'r' : '')
1141 . ($_[1] & 2 ? 'w' : ''));
1142 })],
1143 urxvt::anyevent:: 1164 ], urxvt::anyevent::
1165}
1166
1167sub idle {
1168 my ($class, %arg) = @_;
1169
1170 my $cb = $arg{cb};
1171
1172 urxvt::iw
1173 ->new
1174 ->start
1175 ->cb ($cb)
1176}
1177
1178sub child {
1179 my ($class, %arg) = @_;
1180
1181 my $cb = $arg{cb};
1182
1183 urxvt::pw
1184 ->new
1185 ->start ($arg{pid})
1186 ->cb (sub {
1187 $_[0]->stop; # need to cancel manually
1188 $cb->($_[0]->rpid, $_[0]->rstatus);
1189 })
1144} 1190}
1145 1191
1146sub DESTROY { 1192sub DESTROY {
1147 $_[0][1]->stop; 1193 $_[0][1]->stop;
1148} 1194}
1278 1324
1279 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont 1325 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont
1280 borderLess chdir color cursorBlink cursorUnderline cutchars delete_key 1326 borderLess chdir color cursorBlink cursorUnderline cutchars delete_key
1281 display_name embed ext_bwidth fade font geometry hold iconName 1327 display_name embed ext_bwidth fade font geometry hold iconName
1282 imFont imLocale inputMethod insecure int_bwidth intensityStyles 1328 imFont imLocale inputMethod insecure int_bwidth intensityStyles
1283 italicFont jumpScroll lineSpace loginShell mapAlert meta8 modifier 1329 italicFont jumpScroll lineSpace letterSpace loginShell mapAlert meta8
1284 mouseWheelScrollPage name override_redirect pastableTabs path perl_eval 1330 modifier mouseWheelScrollPage name override_redirect pastableTabs path
1285 perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay 1331 perl_eval perl_ext_1 perl_ext_2 perl_lib pointerBlank pointerBlankDelay
1286 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar 1332 preeditType print_pipe pty_fd reverseVideo saveLines scrollBar
1287 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness 1333 scrollBar_align scrollBar_floating scrollBar_right scrollBar_thickness
1288 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle 1334 scrollTtyKeypress scrollTtyOutput scrollWithBuffer scrollstyle
1289 secondaryScreen secondaryScroll shade term_name title 1335 secondaryScreen secondaryScroll shade term_name title
1290 transient_for transparent transparent_all tripleclickwords utmpInhibit 1336 transient_for transparent transparent_all tripleclickwords utmpInhibit
1386 1432
1387The methods currently supported on C<urxvt::overlay> objects are: 1433The methods currently supported on C<urxvt::overlay> objects are:
1388 1434
1389=over 4 1435=over 4
1390 1436
1391=item $overlay->set ($x, $y, $text, $rend) 1437=item $overlay->set ($x, $y, $text[, $rend])
1392 1438
1393Similar to C<< $term->ROW_t >> and C<< $term->ROW_r >> in that it puts 1439Similar to C<< $term->ROW_t >> and C<< $term->ROW_r >> in that it puts
1394text in rxvt-unicode's special encoding and an array of rendition values 1440text in rxvt-unicode's special encoding and an array of rendition values
1395at a specific position inside the overlay. 1441at a specific position inside the overlay.
1442
1443If C<$rend> is missing, then the rendition will not be changed.
1396 1444
1397=item $overlay->hide 1445=item $overlay->hide
1398 1446
1399If visible, hide the overlay, but do not destroy it. 1447If visible, hide the overlay, but do not destroy it.
1400 1448

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines