… | |
… | |
25 | Scripts are compiled in a 'use strict' and 'use utf8' environment, and |
25 | Scripts are compiled in a 'use strict' and 'use utf8' environment, and |
26 | thus must be encoded as UTF-8. |
26 | thus must be encoded as UTF-8. |
27 | |
27 | |
28 | Each script will only ever be loaded once, even in @@RXVT_NAME@@d, where |
28 | Each script will only ever be loaded once, even in @@RXVT_NAME@@d, where |
29 | scripts will be shared (but not enabled) for all terminals. |
29 | scripts will be shared (but not enabled) for all terminals. |
|
|
30 | |
|
|
31 | You can disable the embedded perl interpreter by setting both "perl-ext" |
|
|
32 | and "perl-ext-common" resources to the empty string. |
30 | |
33 | |
31 | =head1 PREPACKAGED EXTENSIONS |
34 | =head1 PREPACKAGED EXTENSIONS |
32 | |
35 | |
33 | This section describes the extensions delivered with this release. You can |
36 | This section describes the extensions delivered with this release. You can |
34 | find them in F<@@RXVT_LIBDIR@@/urxvt/perl/>. |
37 | find them in F<@@RXVT_LIBDIR@@/urxvt/perl/>. |
… | |
… | |
240 | URxvt.tabbed.tab-bg: <colour-index, default 1> |
243 | URxvt.tabbed.tab-bg: <colour-index, default 1> |
241 | |
244 | |
242 | See I<COLOR AND GRAPHICS> in the @@RXVT_NAME@@(1) manpage for valid |
245 | See I<COLOR AND GRAPHICS> in the @@RXVT_NAME@@(1) manpage for valid |
243 | indices. |
246 | indices. |
244 | |
247 | |
245 | =item mark-urls |
248 | =item matcher |
246 | |
249 | |
247 | Uses per-line display filtering (C<on_line_update>) to underline urls and |
250 | Uses per-line display filtering (C<on_line_update>) to underline text |
248 | make them clickable. When middle-clicked, the program specified in the |
251 | matching a certain pattern and make it clickable. When clicked with the |
249 | resource C<urlLauncher> (default C<x-www-browser>) will be started with |
252 | mouse button specified in the C<matcher.button> resource (default 2, or |
250 | the URL as first argument. |
253 | middle), the program specified in the C<matcher.launcher> resource |
|
|
254 | (default, the C<urlLauncher> resource, C<sensible-browser>) will be started |
|
|
255 | with the matched text as first argument. The default configuration is |
|
|
256 | suitable for matching URLs and launching a web browser, like the |
|
|
257 | former "mark-urls" extension. |
|
|
258 | |
|
|
259 | The default pattern to match URLs can be overridden with the |
|
|
260 | C<matcher.pattern.0> resource, and additional patterns can be specified |
|
|
261 | with numbered patterns, in a manner similar to the "selection" extension. |
|
|
262 | The launcher can also be overridden on a per-pattern basis. |
|
|
263 | |
|
|
264 | Example configuration: |
|
|
265 | |
|
|
266 | URxvt.perl-ext: default,matcher |
|
|
267 | URxvt.urlLauncher: sensible-browser |
|
|
268 | URxvt.keysym.C-Delete: perl:matcher |
|
|
269 | URxvt.matcher.button: 1 |
|
|
270 | URxvt.matcher.pattern.1: \\bwww\\.[\\w-]+\\.[\\w./?&@#-]*[\\w/-] |
|
|
271 | URxvt.matcher.pattern.2: \\B(/\\S+?):(\\d+)(?=:|$) |
|
|
272 | URxvt.matcher.launcher.2: gvim +$2 $1 |
251 | |
273 | |
252 | =item xim-onthespot |
274 | =item xim-onthespot |
253 | |
275 | |
254 | This (experimental) perl extension implements OnTheSpot editing. It does |
276 | This (experimental) perl extension implements OnTheSpot editing. It does |
255 | not work perfectly, and some input methods don't seem to work well with |
277 | not work perfectly, and some input methods don't seem to work well with |
… | |
… | |
287 | same effect as pseudo transparency with a custom pixmap. No scaling is |
309 | same effect as pseudo transparency with a custom pixmap. No scaling is |
288 | supported in this mode. Example: |
310 | supported in this mode. Example: |
289 | |
311 | |
290 | @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background |
312 | @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background |
291 | |
313 | |
|
|
314 | L<http://wiki.archlinux.org/index.php/Perl_Background_Rotation/Extensions> |
|
|
315 | shows how this extension can be used to implement an automatically blurred |
|
|
316 | transparent background. |
|
|
317 | |
292 | =item block-graphics-to-ascii |
318 | =item block-graphics-to-ascii |
293 | |
319 | |
294 | A not very useful example of filtering all text output to the terminal |
320 | A not very useful example of filtering all text output to the terminal |
295 | by replacing all line-drawing characters (U+2500 .. U+259F) by a |
321 | by replacing all line-drawing characters (U+2500 .. U+259F) by a |
296 | similar-looking ascii character. |
322 | similar-looking ascii character. |
… | |
… | |
345 | After a successful upload the selection will be replaced by the text given |
371 | After a successful upload the selection will be replaced by the text given |
346 | in the C<selection-pastebin-url> resource (again, the % is the placeholder |
372 | in the C<selection-pastebin-url> resource (again, the % is the placeholder |
347 | for the filename): |
373 | for the filename): |
348 | |
374 | |
349 | URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/% |
375 | URxvt.selection-pastebin.url: http://www.ta-sa.org/files/txt/% |
|
|
376 | |
|
|
377 | I<Note to xrdb users:> xrdb uses the C preprocessor, which might interpret |
|
|
378 | the double C</> characters as comment start. Use C<\057\057> instead, |
|
|
379 | which works regardless of wether xrdb is used to parse the resource file |
|
|
380 | or not. |
350 | |
381 | |
351 | =item example-refresh-hooks |
382 | =item example-refresh-hooks |
352 | |
383 | |
353 | Displays a very simple digital clock in the upper right corner of the |
384 | Displays a very simple digital clock in the upper right corner of the |
354 | window. Illustrates overwriting the refresh callbacks to create your own |
385 | window. Illustrates overwriting the refresh callbacks to create your own |
… | |
… | |
967 | |
998 | |
968 | sub SET_COLOR($$$) { |
999 | sub SET_COLOR($$$) { |
969 | SET_BGCOLOR (SET_FGCOLOR ($_[0], $_[1]), $_[2]) |
1000 | SET_BGCOLOR (SET_FGCOLOR ($_[0], $_[1]), $_[2]) |
970 | } |
1001 | } |
971 | |
1002 | |
|
|
1003 | sub rend2mask { |
|
|
1004 | no strict 'refs'; |
|
|
1005 | my ($str, $mask) = (@_, 0); |
|
|
1006 | my %color = ( fg => undef, bg => undef ); |
|
|
1007 | my @failed; |
|
|
1008 | for my $spec ( split /\s+/, $str ) { |
|
|
1009 | if ( $spec =~ /^([fb]g)[_:-]?(\d+)/i ) { |
|
|
1010 | $color{lc($1)} = $2; |
|
|
1011 | } else { |
|
|
1012 | my $neg = $spec =~ s/^[-^]//; |
|
|
1013 | unless ( exists &{"RS_$spec"} ) { |
|
|
1014 | push @failed, $spec; |
|
|
1015 | next; |
|
|
1016 | } |
|
|
1017 | my $cur = &{"RS_$spec"}; |
|
|
1018 | if ( $neg ) { |
|
|
1019 | $mask &= ~$cur; |
|
|
1020 | } else { |
|
|
1021 | $mask |= $cur; |
|
|
1022 | } |
|
|
1023 | } |
|
|
1024 | } |
|
|
1025 | ($mask, @color{qw(fg bg)}, \@failed) |
|
|
1026 | } |
|
|
1027 | |
972 | # urxvt::term::extension |
1028 | # urxvt::term::extension |
973 | |
1029 | |
974 | package urxvt::term::extension; |
1030 | package urxvt::term::extension; |
975 | |
1031 | |
976 | sub enable { |
1032 | sub enable { |
… | |
… | |
1087 | sub DESTROY { |
1143 | sub DESTROY { |
1088 | $_[0][1]->stop; |
1144 | $_[0][1]->stop; |
1089 | } |
1145 | } |
1090 | |
1146 | |
1091 | sub condvar { |
1147 | sub condvar { |
1092 | bless \my $flag, urxvt::anyevent::condvar:: |
1148 | bless \my $flag, urxvt::anyevent:: |
1093 | } |
1149 | } |
1094 | |
1150 | |
1095 | sub urxvt::anyevent::condvar::broadcast { |
1151 | sub broadcast { |
1096 | ${$_[0]}++; |
1152 | ${$_[0]}++; |
1097 | } |
1153 | } |
1098 | |
1154 | |
1099 | sub urxvt::anyevent::condvar::wait { |
1155 | sub wait { |
1100 | unless (${$_[0]}) { |
1156 | unless (${$_[0]}) { |
1101 | Carp::croak "AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API"; |
1157 | Carp::croak "AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API"; |
1102 | } |
1158 | } |
|
|
1159 | } |
|
|
1160 | |
|
|
1161 | sub one_event { |
|
|
1162 | Carp::croak "AnyEvent->one_event blocking wait unsupported in urxvt, use a non-blocking API"; |
1103 | } |
1163 | } |
1104 | |
1164 | |
1105 | package urxvt::term; |
1165 | package urxvt::term; |
1106 | |
1166 | |
1107 | =head2 The C<urxvt::term> Class |
1167 | =head2 The C<urxvt::term> Class |
… | |
… | |
1927 | |
1987 | |
1928 | =cut |
1988 | =cut |
1929 | |
1989 | |
1930 | package urxvt::watcher; |
1990 | package urxvt::watcher; |
1931 | |
1991 | |
1932 | @urxvt::timer::ISA = __PACKAGE__; |
|
|
1933 | @urxvt::iow::ISA = __PACKAGE__; |
|
|
1934 | @urxvt::pw::ISA = __PACKAGE__; |
|
|
1935 | @urxvt::iw::ISA = __PACKAGE__; |
|
|
1936 | |
|
|
1937 | =head2 The C<urxvt::timer> Class |
1992 | =head2 The C<urxvt::timer> Class |
1938 | |
1993 | |
1939 | This class implements timer watchers/events. Time is represented as a |
1994 | This class implements timer watchers/events. Time is represented as a |
1940 | fractional number of seconds since the epoch. Example: |
1995 | fractional number of seconds since the epoch. Example: |
1941 | |
1996 | |
… | |
… | |
2126 | http://software.schmorp.de/pkg/rxvt-unicode |
2181 | http://software.schmorp.de/pkg/rxvt-unicode |
2127 | |
2182 | |
2128 | =cut |
2183 | =cut |
2129 | |
2184 | |
2130 | 1 |
2185 | 1 |
|
|
2186 | |
|
|
2187 | # vim: sw=3: |