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.201 by sf-exg, Tue Nov 29 19:20:18 2011 UTC vs.
Revision 1.210 by root, Wed Jun 6 11:46:11 2012 UTC

… …
446=item $octets 446=item $octets
447 447
448Either binary data or - more common - a text string encoded in a 448Either binary data or - more common - a text string encoded in a
449locale-specific way. 449locale-specific way.
450 450
451=item $keysym
452
453an integer that is a valid X11 keysym code. You can convert a string
454into a keysym and viceversa by using C<XStringToKeysym> and
455C<XKeysymToString>.
456
451=back 457=back
452 458
453=head2 Extension Objects 459=head2 Extension Objects
454 460
455Every perl extension is a perl class. A separate perl object is created 461Every perl extension is a perl class. A separate perl object is created
… …
665a C<perl:string> action bound to a key, see description of the B<keysym> 671a C<perl:string> action bound to a key, see description of the B<keysym>
666resource in the @@RXVT_NAME@@(1) manpage). 672resource in the @@RXVT_NAME@@(1) manpage).
667 673
668The event is simply the action string. This interface is assumed to change 674The event is simply the action string. This interface is assumed to change
669slightly in the future. 675slightly in the future.
676
677=item on_register_command $term, $keysym, $modifiermask, $string
678
679Called after parsing a keysym resource but before registering the
680associated binding. If this hook returns TRUE the binding is not
681registered. It can be used to modify a binding by calling
682C<register_command>.
670 683
671=item on_resize_all_windows $term, $new_width, $new_height 684=item on_resize_all_windows $term, $new_width, $new_height
672 685
673Called just after the new window size has been calculated, but before 686Called just after the new window size has been calculated, but before
674windows are actually being resized or hints are being set. If this hook 687windows are actually being resized or hints are being set. If this hook
… …
930 }; 943 };
931} 944}
932 945
933no warnings 'utf8'; 946no warnings 'utf8';
934 947
948sub parse_resource {
949 my ($term, $name, $isarg, $longopt, $flag, $value) = @_;
950
951 $term->scan_meta;
952
953 warn "resourece<@_>\n";#d#
954
955 my $r = $term->{meta}{resource};
956 while (my ($pattern, $v) = each %$r) {
957 $name =~ y/-/./ if $isarg;
958
959 if (
960 $pattern =~ s/\*$//
961 ? $pattern eq substr $name, 0, length $pattern
962 : $pattern eq $name
963 ) {
964 $name = "$urxvt::RESCLASS.$name";
965 warn "set option <$name=$value>\n";#d#
966 #TODO: queue $v->[0] for loading
967 if ($v->[1] eq "boolean") {
968 $term->put_option_db ($name, $flag ? "true" : "false");
969 return 1;
970 } else {
971 $term->put_option_db ($name, $value);
972 return 1 + 2;
973 }
974 }
975 }
976
977 0
978}
979
980sub usage {
981 my ($term, $usage_type) = @_;
982
983 $term->scan_meta;
984
985 my $r = $term->{meta}{resource};
986
987 for my $pattern (sort keys %$r) {
988 my ($ext, $type, $desc) = @{ $r->{$pattern} };
989
990 $desc .= " (-pe $ext)";
991
992 if ($usage_type == 1) {
993 $pattern =~ y/./-/;
994 $pattern =~ s/\*/.../g;
995
996 if ($type eq "boolean") {
997 urxvt::log sprintf " -%-30s %s\n", "/+$pattern", $desc;
998 } else {
999 urxvt::log sprintf " -%-30s %s\n", "$pattern $type", $desc;
1000 }
1001 } else {
1002 urxvt::log sprintf " %-31s %s\n", "$pattern:", $type;
1003 }
1004 }
1005}
1006
935my $verbosity = $ENV{URXVT_PERL_VERBOSITY}; 1007my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
936 1008
937sub verbose { 1009sub verbose {
938 my ($level, $msg) = @_; 1010 my ($level, $msg) = @_;
939 warn "$msg\n" if $level <= $verbosity; 1011 warn "$msg\n" if $level <= $verbosity;
… …
975sub invoke { 1047sub invoke {
976 local $TERM = shift; 1048 local $TERM = shift;
977 my $htype = shift; 1049 my $htype = shift;
978 1050
979 if ($htype == 0) { # INIT 1051 if ($htype == 0) { # INIT
980 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$ENV{HOME}/.urxvt/ext", "$LIBDIR/perl"); 1052 my @dirs = $TERM->perl_libdirs;
981 1053
982 my %ext_arg; 1054 my %ext_arg;
983 1055
984 { 1056 {
985 my @init = @TERM_INIT; 1057 my @init = @TERM_INIT;
… …
1146=head2 The C<urxvt::anyevent> Class 1218=head2 The C<urxvt::anyevent> Class
1147 1219
1148The sole purpose of this class is to deliver an interface to the 1220The sole purpose of this class is to deliver an interface to the
1149C<AnyEvent> module - any module using it will work inside urxvt without 1221C<AnyEvent> module - any module using it will work inside urxvt without
1150further programming. The only exception is that you cannot wait on 1222further programming. The only exception is that you cannot wait on
1151condition variables, but non-blocking condvar use is ok. What this means 1223condition variables, but non-blocking condvar use is ok.
1152is that you cannot use blocking APIs, but the non-blocking variant should 1224
1153work. 1225In practical terms this means is that you cannot use blocking APIs, but
1226the non-blocking variant should work.
1154 1227
1155=cut 1228=cut
1156 1229
1157our $VERSION = '5.23'; 1230our $VERSION = '5.23';
1158 1231
… …
1252 $self->{_pkg}{$pkg} = $proxy; 1325 $self->{_pkg}{$pkg} = $proxy;
1253 1326
1254 for my $name (@HOOKNAME) { 1327 for my $name (@HOOKNAME) {
1255 if (my $ref = $pkg->can ("on_" . lc $name)) { 1328 if (my $ref = $pkg->can ("on_" . lc $name)) {
1256 $proxy->enable ($name => $ref); 1329 $proxy->enable ($name => $ref);
1330 }
1331 }
1332}
1333
1334sub perl_libdirs {
1335 map { split /:/ }
1336 $_[0]->resource ("perl_lib"),
1337 $ENV{URXVT_PERL_LIB},
1338 "$ENV{HOME}/.urxvt/ext",
1339 "$LIBDIR/perl"
1340}
1341
1342sub scan_meta {
1343 my ($self) = @_;
1344 my @libdirs = perl_libdirs $self;
1345
1346 return if $self->{meta_libdirs} eq join "\x00", @libdirs;
1347
1348 my %meta;
1349
1350 $self->{meta_libdirs} = join "\x00", @libdirs;
1351 $self->{meta} = \%meta;
1352
1353 for my $dir (reverse @libdirs) {
1354 opendir my $fh, $dir
1355 or next;
1356 for my $ext (readdir $fh) {
1357 $ext ne "."
1358 and $ext ne ".."
1359 and open my $fh, "<", "$dir/$ext"
1360 or next;
1361
1362 while (<$fh>) {
1363 if (/^#:META:X_RESOURCE:(.*)/) {
1364 my ($pattern, $type, $desc) = split /:/, $1;
1365 $pattern =~ s/^%\./$ext./g; # $$ in pattern == extension name
1366 if ($pattern =~ /[^a-zA-Z\*\.]/) {
1367 warn "$dir/$ext: meta resource '$pattern' contains illegal characters (not alphanumeric nor . nor *)\n";
1368 } else {
1369 $meta{resource}{$pattern} = [$ext, $type, $desc];
1370 }
1371 } elsif (/^\s*(?:#|$)/) {
1372 # skip other comments and empty lines
1373 } else {
1374 last; # stop parsing on first non-empty non-comment line
1375 }
1376 }
1257 } 1377 }
1258 } 1378 }
1259} 1379}
1260 1380
1261=item $term = new urxvt::term $envhashref, $rxvtname, [arg...] 1381=item $term = new urxvt::term $envhashref, $rxvtname, [arg...]
… …
1387=item $success = $term->parse_keysym ($key, $octets) 1507=item $success = $term->parse_keysym ($key, $octets)
1388 1508
1389Adds a key binding exactly as specified via a resource. See the 1509Adds a key binding exactly as specified via a resource. See the
1390C<keysym> resource in the @@RXVT_NAME@@(1) manpage. 1510C<keysym> resource in the @@RXVT_NAME@@(1) manpage.
1391 1511
1512=item $term->register_command ($keysym, $modifiermask, $string)
1513
1514Adds a key binding. This is a lower level api compared to
1515C<parse_keysym>, as it expects a parsed key description, and can be
1516used only inside either the C<on_init> hook, to add a binding, or the
1517C<on_register_command> hook, to modify a parsed binding.
1518
1392=item $rend = $term->rstyle ([$new_rstyle]) 1519=item $rend = $term->rstyle ([$new_rstyle])
1393 1520
1394Return and optionally change the current rendition. Text that is output by 1521Return and optionally change the current rendition. Text that is output by
1395the terminal application will use this style. 1522the terminal application will use this style.
1396 1523
… …
1608 1735
1609Adds the specified events to the vt event mask. Useful e.g. when you want 1736Adds the specified events to the vt event mask. Useful e.g. when you want
1610to receive pointer events all the times: 1737to receive pointer events all the times:
1611 1738
1612 $term->vt_emask_add (urxvt::PointerMotionMask); 1739 $term->vt_emask_add (urxvt::PointerMotionMask);
1740
1741=item $term->set_urgency ($set)
1742
1743Enable/disable the urgency hint on the toplevel window.
1613 1744
1614=item $term->focus_in 1745=item $term->focus_in
1615 1746
1616=item $term->focus_out 1747=item $term->focus_out
1617 1748
… …
1933=item $term->XMoveResizeWindow ($window, $x, $y, $width, $height) 2064=item $term->XMoveResizeWindow ($window, $x, $y, $width, $height)
1934 2065
1935=item ($x, $y, $child_window) = $term->XTranslateCoordinates ($src, $dst, $x, $y) 2066=item ($x, $y, $child_window) = $term->XTranslateCoordinates ($src, $dst, $x, $y)
1936 2067
1937=item $term->XChangeInput ($window, $add_events[, $del_events]) 2068=item $term->XChangeInput ($window, $add_events[, $del_events])
2069
2070=item $keysym = $term->XStringToKeysym ($string)
2071
2072=item $string = $term->XKeysymToString ($keysym)
1938 2073
1939Various X or X-related functions. The C<$term> object only serves as 2074Various X or X-related functions. The C<$term> object only serves as
1940the source of the display, otherwise those functions map more-or-less 2075the source of the display, otherwise those functions map more-or-less
1941directly onto the X functions of the same name. 2076directly onto the X functions of the same name.
1942 2077

Diff Legend

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