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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines