| … | |
… | |
| 205 | |
205 | |
| 206 | It is called before lines are scrolled out (so rows 0 .. min ($lines - 1, |
206 | It is called before lines are scrolled out (so rows 0 .. min ($lines - 1, |
| 207 | $nrow - 1) represent the lines to be scrolled out). C<$saved> is the total |
207 | $nrow - 1) represent the lines to be scrolled out). C<$saved> is the total |
| 208 | number of lines that will be in the scrollback buffer. |
208 | number of lines that will be in the scrollback buffer. |
| 209 | |
209 | |
| 210 | =item on_tty_activity $term *NYI* |
|
|
| 211 | |
|
|
| 212 | Called whenever the program(s) running in the urxvt window send output. |
|
|
| 213 | |
|
|
| 214 | =item on_osc_seq $term, $string |
210 | =item on_osc_seq $term, $string |
| 215 | |
211 | |
| 216 | Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC = |
212 | Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC = |
| 217 | operating system command) is processed. Cursor position and other state |
213 | operating system command) is processed. Cursor position and other state |
| 218 | information is up-to-date when this happens. For interoperability, the |
214 | information is up-to-date when this happens. For interoperability, the |
| … | |
… | |
| 336 | newline. The module also overwrites the C<warn> builtin with a function |
332 | newline. The module also overwrites the C<warn> builtin with a function |
| 337 | that calls this function. |
333 | that calls this function. |
| 338 | |
334 | |
| 339 | Using this function has the advantage that its output ends up in the |
335 | Using this function has the advantage that its output ends up in the |
| 340 | correct place, e.g. on stderr of the connecting urxvtc client. |
336 | correct place, e.g. on stderr of the connecting urxvtc client. |
|
|
337 | |
|
|
338 | =item $is_safe = urxvt::safe |
|
|
339 | |
|
|
340 | Returns true when it is safe to do potentially unsafe things, such as |
|
|
341 | evaluating perl code specified by the user. This is true when urxvt was |
|
|
342 | started setuid or setgid. |
| 341 | |
343 | |
| 342 | =item $time = urxvt::NOW |
344 | =item $time = urxvt::NOW |
| 343 | |
345 | |
| 344 | Returns the "current time" (as per the event loop). |
346 | Returns the "current time" (as per the event loop). |
| 345 | |
347 | |
| … | |
… | |
| 443 | sub verbose { |
445 | sub verbose { |
| 444 | my ($level, $msg) = @_; |
446 | my ($level, $msg) = @_; |
| 445 | warn "$msg\n" if $level <= $verbosity; |
447 | warn "$msg\n" if $level <= $verbosity; |
| 446 | } |
448 | } |
| 447 | |
449 | |
| 448 | # find on_xxx subs in the package and register them |
|
|
| 449 | # as hooks |
|
|
| 450 | sub register_package($) { |
|
|
| 451 | my ($pkg) = @_; |
|
|
| 452 | |
|
|
| 453 | for my $htype (0.. $#HOOKNAME) { |
|
|
| 454 | my $name = $HOOKNAME[$htype]; |
|
|
| 455 | |
|
|
| 456 | my $ref = $pkg->can ("on_" . lc $name) |
|
|
| 457 | or next; |
|
|
| 458 | |
|
|
| 459 | $TERM->{_hook}[$htype]{$pkg} = $ref; |
|
|
| 460 | $hook_count[$htype]++ |
|
|
| 461 | or set_should_invoke $htype, 1; |
|
|
| 462 | } |
|
|
| 463 | } |
|
|
| 464 | |
|
|
| 465 | my $extension_pkg = "extension0000"; |
450 | my $extension_pkg = "extension0000"; |
| 466 | my %extension_pkg; |
451 | my %extension_pkg; |
| 467 | |
452 | |
| 468 | # load a single script into its own package, once only |
453 | # load a single script into its own package, once only |
| 469 | sub extension_package($) { |
454 | sub extension_package($) { |
| … | |
… | |
| 497 | my $htype = shift; |
482 | my $htype = shift; |
| 498 | |
483 | |
| 499 | if ($htype == 0) { # INIT |
484 | if ($htype == 0) { # INIT |
| 500 | my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl"); |
485 | my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl"); |
| 501 | |
486 | |
| 502 | my %want_ext; |
487 | my %ext_arg; |
| 503 | |
488 | |
| 504 | for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) { |
489 | for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) { |
| 505 | if ($_ eq "default") { |
490 | if ($_ eq "default") { |
| 506 | $want_ext{$_}++ for qw(selection option-popup selection-popup); |
491 | $ext_arg{$_} ||= [] for qw(selection option-popup selection-popup); |
| 507 | } elsif (/^-(.*)$/) { |
492 | } elsif (/^-(.*)$/) { |
| 508 | delete $want_ext{$1}; |
493 | delete $ext_arg{$1}; |
|
|
494 | } elsif (/^([^<]+)<(.*)>$/) { |
|
|
495 | push @{ $ext_arg{$1} }, $2; |
| 509 | } else { |
496 | } else { |
| 510 | $want_ext{$_}++; |
497 | $ext_arg{$_} ||= []; |
| 511 | } |
498 | } |
| 512 | } |
499 | } |
| 513 | |
500 | |
| 514 | for my $ext (keys %want_ext) { |
501 | while (my ($ext, $argv) = each %ext_arg) { |
| 515 | my @files = grep -f $_, map "$_/$ext", @dirs; |
502 | my @files = grep -f $_, map "$_/$ext", @dirs; |
| 516 | |
503 | |
| 517 | if (@files) { |
504 | if (@files) { |
| 518 | register_package extension_package $files[0]; |
505 | $TERM->register_package (extension_package $files[0], $argv); |
| 519 | } else { |
506 | } else { |
| 520 | warn "perl extension '$ext' not found in perl library search path\n"; |
507 | warn "perl extension '$ext' not found in perl library search path\n"; |
| 521 | } |
508 | } |
| 522 | } |
509 | } |
| 523 | |
510 | |
| … | |
… | |
| 532 | if $verbosity >= 10; |
519 | if $verbosity >= 10; |
| 533 | |
520 | |
| 534 | keys %$cb; |
521 | keys %$cb; |
| 535 | |
522 | |
| 536 | while (my ($pkg, $cb) = each %$cb) { |
523 | while (my ($pkg, $cb) = each %$cb) { |
| 537 | eval { |
524 | $retval = eval { $cb->($TERM->{_pkg}{$pkg}, @_) } |
| 538 | $retval = $cb->( |
|
|
| 539 | $TERM->{_pkg}{$pkg} ||= do { |
|
|
| 540 | my $proxy = bless { }, $pkg; |
|
|
| 541 | Scalar::Util::weaken ($proxy->{term} = $TERM); |
|
|
| 542 | $proxy |
|
|
| 543 | }, |
|
|
| 544 | @_, |
|
|
| 545 | ) and last; |
525 | and last; |
| 546 | }; |
526 | |
| 547 | if ($@) { |
527 | if ($@) { |
| 548 | $TERM->ungrab; # better to lose the grab than the session |
528 | $TERM->ungrab; # better to lose the grab than the session |
| 549 | warn $@; |
529 | warn $@; |
| 550 | } |
530 | } |
| 551 | } |
531 | } |
| … | |
… | |
| 672 | package urxvt::term; |
652 | package urxvt::term; |
| 673 | |
653 | |
| 674 | =head2 The C<urxvt::term> Class |
654 | =head2 The C<urxvt::term> Class |
| 675 | |
655 | |
| 676 | =over 4 |
656 | =over 4 |
|
|
657 | |
|
|
658 | =cut |
|
|
659 | |
|
|
660 | # find on_xxx subs in the package and register them |
|
|
661 | # as hooks |
|
|
662 | sub register_package { |
|
|
663 | my ($self, $pkg, $argv) = @_; |
|
|
664 | |
|
|
665 | my $proxy = bless { argv => $argv }, $pkg; |
|
|
666 | Scalar::Util::weaken ($proxy->{term} = $TERM); |
|
|
667 | |
|
|
668 | $self->{_pkg}{$pkg} = $proxy; |
|
|
669 | |
|
|
670 | for my $htype (0.. $#HOOKNAME) { |
|
|
671 | my $name = $HOOKNAME[$htype]; |
|
|
672 | |
|
|
673 | my $ref = $pkg->can ("on_" . lc $name) |
|
|
674 | or next; |
|
|
675 | |
|
|
676 | $self->{_hook}[$htype]{$pkg} = $ref; |
|
|
677 | $hook_count[$htype]++ |
|
|
678 | or urxvt::set_should_invoke $htype, 1; |
|
|
679 | } |
|
|
680 | } |
| 677 | |
681 | |
| 678 | =item $term->destroy |
682 | =item $term->destroy |
| 679 | |
683 | |
| 680 | Destroy the terminal object (close the window, free resources etc.). |
684 | Destroy the terminal object (close the window, free resources etc.). |
| 681 | |
685 | |
| … | |
… | |
| 915 | |
919 | |
| 916 | =item $lines_in_scrollback = $term->nsaved |
920 | =item $lines_in_scrollback = $term->nsaved |
| 917 | |
921 | |
| 918 | Return various integers describing terminal characteristics. |
922 | Return various integers describing terminal characteristics. |
| 919 | |
923 | |
|
|
924 | =item $lc_ctype = $term->locale |
|
|
925 | |
|
|
926 | Returns the LC_CTYPE category string used by this rxvt-unicode. |
|
|
927 | |
|
|
928 | =item $x_display = $term->display_id |
|
|
929 | |
|
|
930 | Return the DISPLAY used by rxvt-unicode. |
|
|
931 | |
| 920 | =item $modifiermask = $term->ModLevel3Mask |
932 | =item $modifiermask = $term->ModLevel3Mask |
| 921 | |
933 | |
| 922 | =item $modifiermask = $term->ModMetaMask |
934 | =item $modifiermask = $term->ModMetaMask |
| 923 | |
935 | |
| 924 | =item $modifiermask = $term->ModNumLockMask |
936 | =item $modifiermask = $term->ModNumLockMask |
| … | |
… | |
| 1100 | $offset / $self->{ncol} + $self->{beg}, |
1112 | $offset / $self->{ncol} + $self->{beg}, |
| 1101 | $offset % $self->{ncol} |
1113 | $offset % $self->{ncol} |
| 1102 | ) |
1114 | ) |
| 1103 | } |
1115 | } |
| 1104 | |
1116 | |
| 1105 | =item ($row, $col) = $line->coord_of ($offset) |
|
|
| 1106 | =item $text = $term->special_encode $string |
1117 | =item $text = $term->special_encode $string |
| 1107 | |
1118 | |
| 1108 | Converts a perl string into the special encoding used by rxvt-unicode, |
1119 | Converts a perl string into the special encoding used by rxvt-unicode, |
| 1109 | where one character corresponds to one screen cell. See |
1120 | where one character corresponds to one screen cell. See |
| 1110 | C<< $term->ROW_t >> for details. |
1121 | C<< $term->ROW_t >> for details. |
| … | |
… | |
| 1112 | =item $string = $term->special_decode $text |
1123 | =item $string = $term->special_decode $text |
| 1113 | |
1124 | |
| 1114 | Converts rxvt-unicodes text reprsentation into a perl string. See |
1125 | Converts rxvt-unicodes text reprsentation into a perl string. See |
| 1115 | C<< $term->ROW_t >> for details. |
1126 | C<< $term->ROW_t >> for details. |
| 1116 | |
1127 | |
|
|
1128 | =item $success = $term->grab_button ($button, $modifiermask) |
|
|
1129 | |
|
|
1130 | Registers a synchronous button grab. See the XGrabButton manpage. |
|
|
1131 | |
|
|
1132 | =item $success = $term->grab ($eventtime[, $sync]) |
|
|
1133 | |
|
|
1134 | Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or |
|
|
1135 | synchronous (C<$sync> is true). Also remembers the grab timestampe. |
|
|
1136 | |
|
|
1137 | =item $term->allow_events_async |
|
|
1138 | |
|
|
1139 | Calls XAllowEvents with AsyncBoth for the most recent grab. |
|
|
1140 | |
|
|
1141 | =item $term->allow_events_sync |
|
|
1142 | |
|
|
1143 | Calls XAllowEvents with SyncBoth for the most recent grab. |
|
|
1144 | |
|
|
1145 | =item $term->allow_events_replay |
|
|
1146 | |
|
|
1147 | Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most |
|
|
1148 | recent grab. |
|
|
1149 | |
|
|
1150 | =item $term->ungrab |
|
|
1151 | |
|
|
1152 | Calls XUngrab for the most recent grab. Is called automatically on |
|
|
1153 | evaluation errors, as it is better to lose the grab in the error case as |
|
|
1154 | the session. |
|
|
1155 | |
| 1117 | =back |
1156 | =back |
| 1118 | |
1157 | |
| 1119 | =cut |
1158 | =cut |
| 1120 | |
1159 | |
| 1121 | package urxvt::popup; |
1160 | package urxvt::popup; |
| … | |
… | |
| 1139 | } |
1178 | } |
| 1140 | |
1179 | |
| 1141 | sub add_separator { |
1180 | sub add_separator { |
| 1142 | my ($self, $sep) = @_; |
1181 | my ($self, $sep) = @_; |
| 1143 | |
1182 | |
| 1144 | $sep ||= "═"; |
1183 | $sep ||= "="; |
| 1145 | |
1184 | |
| 1146 | $self->add_item ({ |
1185 | $self->add_item ({ |
| 1147 | rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" }, |
1186 | rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" }, |
| 1148 | text => "", |
1187 | text => "", |
| 1149 | render => sub { $sep x $urxvt::TERM->ncol }, |
1188 | render => sub { $sep x $self->{term}->ncol }, |
| 1150 | activate => sub { }, |
1189 | activate => sub { }, |
| 1151 | }); |
1190 | }); |
| 1152 | } |
1191 | } |
| 1153 | |
1192 | |
| 1154 | sub add_title { |
1193 | sub add_title { |
| … | |
… | |
| 1162 | } |
1201 | } |
| 1163 | |
1202 | |
| 1164 | sub add_button { |
1203 | sub add_button { |
| 1165 | my ($self, $text, $cb) = @_; |
1204 | my ($self, $text, $cb) = @_; |
| 1166 | |
1205 | |
| 1167 | $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb}); |
1206 | $self->add_item ({ type => "button", text => $text, activate => $cb}); |
| 1168 | } |
1207 | } |
| 1169 | |
1208 | |
| 1170 | sub add_toggle { |
1209 | sub add_toggle { |
| 1171 | my ($self, $text, $cb, $value) = @_; |
1210 | my ($self, $text, $cb, $value) = @_; |
| 1172 | |
1211 | |
| … | |
… | |
| 1184 | sub show { |
1223 | sub show { |
| 1185 | my ($self) = @_; |
1224 | my ($self) = @_; |
| 1186 | |
1225 | |
| 1187 | local $urxvt::popup::self = $self; |
1226 | local $urxvt::popup::self = $self; |
| 1188 | |
1227 | |
|
|
1228 | local $ENV{LC_ALL} = $self->{term}->locale; |
|
|
1229 | |
| 1189 | urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0, |
1230 | urxvt->new ("--perl-lib" => "", "--perl-ext-common" => "", "-pty-fd" => -1, "-sl" => 0, "-b" => 0, |
| 1190 | "--transient-for" => $self->{term}->parent, |
1231 | "--transient-for" => $self->{term}->parent, |
|
|
1232 | "-display" => $self->{term}->display_id, |
| 1191 | "-pe" => "urxvt-popup") |
1233 | "-pe" => "urxvt-popup") |
| 1192 | or die "unable to create popup window\n"; |
1234 | or die "unable to create popup window\n"; |
| 1193 | } |
1235 | } |
| 1194 | |
1236 | |
| 1195 | sub DESTROY { |
1237 | sub DESTROY { |
