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.54 by root, Sun Jan 8 01:59:29 2006 UTC vs.
Revision 1.61 by root, Mon Jan 9 01:36:56 2006 UTC

58 58
59=back 59=back
60 60
61=item option-popup (enabled by default) 61=item option-popup (enabled by default)
62 62
63Binds a popup menu to Ctrl-Button3 that lets you toggle (some) options at 63Binds a popup menu to Ctrl-Button2 that lets you toggle (some) options at
64runtime. 64runtime.
65
66=item selection-popup (enabled by default)
67
68Binds a popup menu to Ctrl-Button3 that lets you convert the selection
69text into various other formats/action.
65 70
66=item digital-clock 71=item digital-clock
67 72
68Displays a digital clock using the built-in overlay. 73Displays a digital clock using the built-in overlay.
69 74
200 205
201It is called before lines are scrolled out (so rows 0 .. min ($lines - 1, 206It is called before lines are scrolled out (so rows 0 .. min ($lines - 1,
202$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
203number of lines that will be in the scrollback buffer. 208number of lines that will be in the scrollback buffer.
204 209
205=item on_tty_activity $term *NYI*
206
207Called whenever the program(s) running in the urxvt window send output.
208
209=item on_osc_seq $term, $string 210=item on_osc_seq $term, $string
210 211
211Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC = 212Called whenever the B<ESC ] 777 ; string ST> command sequence (OSC =
212operating system command) is processed. Cursor position and other state 213operating system command) is processed. Cursor position and other state
213information is up-to-date when this happens. For interoperability, the 214information is up-to-date when this happens. For interoperability, the
342 343
343=item urxvt::ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask, 344=item urxvt::ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask,
344Mod3Mask, Mod4Mask, Mod5Mask, Button1Mask, Button2Mask, Button3Mask, 345Mod3Mask, Mod4Mask, Mod5Mask, Button1Mask, Button2Mask, Button3Mask,
345Button4Mask, Button5Mask, AnyModifier 346Button4Mask, Button5Mask, AnyModifier
346 347
347Various constants for use in X events. 348Various constants for use in X calls and event processing.
348 349
349=back 350=back
350 351
351=head2 RENDITION 352=head2 RENDITION
352 353
407use utf8; 408use utf8;
408use strict; 409use strict;
409use Scalar::Util (); 410use Scalar::Util ();
410use List::Util (); 411use List::Util ();
411 412
413our $VERSION = 1;
412our $TERM; 414our $TERM;
413our @HOOKNAME; 415our @HOOKNAME;
414our %OPTION; 416our %OPTION;
415our $LIBDIR; 417our $LIBDIR;
416 418
422 my $msg = join "", @_; 424 my $msg = join "", @_;
423 $msg .= "\n" 425 $msg .= "\n"
424 unless $msg =~ /\n$/; 426 unless $msg =~ /\n$/;
425 urxvt::warn ($msg); 427 urxvt::warn ($msg);
426 }; 428 };
429
430 delete $ENV{IFS};
431 delete $ENV{CDPATH};
432 delete $ENV{BASH_ENV};
433 $ENV{PATH} = "/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin:/usr/local/sbin:/opt/bin:/opt/sbin";
427} 434}
428 435
429my @hook_count; 436my @hook_count;
430my $verbosity = $ENV{URXVT_PERL_VERBOSITY}; 437my $verbosity = $ENV{URXVT_PERL_VERBOSITY};
431 438
464 verbose 3, "loading extension '$path' into package '$pkg'"; 471 verbose 3, "loading extension '$path' into package '$pkg'";
465 472
466 open my $fh, "<:raw", $path 473 open my $fh, "<:raw", $path
467 or die "$path: $!"; 474 or die "$path: $!";
468 475
469 my $source = "package $pkg; use strict; use utf8;\n" 476 my $source = untaint "package $pkg; use strict; use utf8;\n"
470 . "use base urxvt::term::proxy::;\n" 477 . "use base urxvt::term::proxy::;\n"
471 . "#line 1 \"$path\"\n{\n" 478 . "#line 1 \"$path\"\n{\n"
472 . (do { local $/; <$fh> }) 479 . (do { local $/; <$fh> })
473 . "\n};\n1"; 480 . "\n};\n1";
474 481
490 497
491 my %want_ext; 498 my %want_ext;
492 499
493 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) { 500 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
494 if ($_ eq "default") { 501 if ($_ eq "default") {
495 $want_ext{$_}++ for qw(selection option-popup); 502 $want_ext{$_}++ for qw(selection option-popup selection-popup);
496 } elsif (/^-(.*)$/) { 503 } elsif (/^-(.*)$/) {
497 delete $want_ext{$1}; 504 delete $want_ext{$1};
498 } else { 505 } else {
499 $want_ext{$_}++; 506 $want_ext{$_}++;
500 } 507 }
507 register_package extension_package $files[0]; 514 register_package extension_package $files[0];
508 } else { 515 } else {
509 warn "perl extension '$ext' not found in perl library search path\n"; 516 warn "perl extension '$ext' not found in perl library search path\n";
510 } 517 }
511 } 518 }
519
520 eval "#line 1 \"--perl-eval resource/argument\"\n" . $TERM->resource ("perl_eval");
521 warn $@ if $@;
512 } 522 }
513 523
514 $retval = undef; 524 $retval = undef;
515 525
516 if (my $cb = $TERM->{_hook}[$htype]) { 526 if (my $cb = $TERM->{_hook}[$htype]) {
528 $proxy 538 $proxy
529 }, 539 },
530 @_, 540 @_,
531 ) and last; 541 ) and last;
532 }; 542 };
533 warn $@ if $@;#d# 543 if ($@) {
544 $TERM->ungrab; # better to lose the grab than the session
545 warn $@;
546 }
534 } 547 }
535 } 548 }
536 549
537 if ($htype == 1) { # DESTROY 550 if ($htype == 1) { # DESTROY
538 # remove hooks if unused 551 # remove hooks if unused
551 } 564 }
552 565
553 $retval 566 $retval
554} 567}
555 568
569# urxvt::term::proxy
570
556sub urxvt::term::proxy::AUTOLOAD { 571sub urxvt::term::proxy::AUTOLOAD {
557 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/ 572 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/
558 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable"; 573 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable";
559 574
560 eval qq{ 575 eval qq{
566 } or die "FATAL: unable to compile method forwarder: $@"; 581 } or die "FATAL: unable to compile method forwarder: $@";
567 582
568 goto &$urxvt::term::proxy::AUTOLOAD; 583 goto &$urxvt::term::proxy::AUTOLOAD;
569} 584}
570 585
586sub urxvt::term::proxy::DESTROY {
587 # nop
588}
589
590# urxvt::destroy_hook
591
571sub urxvt::destroy_hook::DESTROY { 592sub urxvt::destroy_hook::DESTROY {
572 ${$_[0]}->(); 593 ${$_[0]}->();
573} 594}
574 595
575sub urxvt::destroy_hook(&) { 596sub urxvt::destroy_hook(&) {
576 bless \shift, urxvt::destroy_hook:: 597 bless \shift, urxvt::destroy_hook::
577} 598}
599
600package urxvt::anyevent;
601
602=head2 The C<urxvt::anyevent> Class
603
604The sole purpose of this class is to deliver an interface to the
605C<AnyEvent> module - any module using it will work inside urxvt without
606further work. The only exception is that you cannot wait on condition
607variables, but non-blocking condvar use is ok. What this means is that you
608cannot use blocking APIs, but the non-blocking variant should work.
609
610=cut
611
612our $VERSION = 1;
613
614$INC{"urxvt/anyevent.pm"} = 1; # mark us as there
615push @AnyEvent::REGISTRY, [urxvt => urxvt::anyevent::];
616
617sub timer {
618 my ($class, %arg) = @_;
619
620 my $cb = $arg{cb};
621
622 urxvt::timer
623 ->new
624 ->start (urxvt::NOW + $arg{after})
625 ->cb (sub {
626 $_[0]->stop; # need to cancel manually
627 $cb->();
628 })
629}
630
631sub io {
632 my ($class, %arg) = @_;
633
634 my $cb = $arg{cb};
635
636 bless [$arg{fh}, urxvt::iow
637 ->new
638 ->fd (fileno $arg{fh})
639 ->events (($arg{poll} =~ /r/ ? 1 : 0)
640 | ($arg{poll} =~ /w/ ? 2 : 0))
641 ->start
642 ->cb (sub {
643 $cb->(($_[1] & 1 ? 'r' : '')
644 . ($_[1] & 2 ? 'w' : ''));
645 })],
646 urxvt::anyevent::
647}
648
649sub DESTROY {
650 $_[0][1]->stop;
651}
652
653sub condvar {
654 bless \my $flag, urxvt::anyevent::condvar::
655}
656
657sub urxvt::anyevent::condvar::broadcast {
658 ${$_[0]}++;
659}
660
661sub urxvt::anyevent::condvar::wait {
662 unless (${$_[0]}) {
663 require Carp;
664 Carp::croak ("AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API");
665 }
666}
667
668package urxvt::term;
578 669
579=head2 The C<urxvt::term> Class 670=head2 The C<urxvt::term> Class
580 671
581=over 4 672=over 4
582 673
634 shade term_name title transparent transparent_all tripleclickwords 725 shade term_name title transparent transparent_all tripleclickwords
635 utmpInhibit visualBell 726 utmpInhibit visualBell
636 727
637=cut 728=cut
638 729
639sub urxvt::term::resource($$;$) { 730sub resource($$;$) {
640 my ($self, $name) = (shift, shift); 731 my ($self, $name) = (shift, shift);
641 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0); 732 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0);
642 &urxvt::term::_resource 733 &urxvt::term::_resource
643} 734}
644 735
731C<$event> I<must> be the event causing the menu to pop up (a button event, 822C<$event> I<must> be the event causing the menu to pop up (a button event,
732currently). 823currently).
733 824
734=cut 825=cut
735 826
736sub urxvt::term::popup { 827sub popup {
737 my ($self, $event) = @_; 828 my ($self, $event) = @_;
738 829
739 $self->grab ($event->{time}, 1) 830 $self->grab ($event->{time}, 1)
740 or return; 831 or return;
741 832
931 1022
932=back 1023=back
933 1024
934=cut 1025=cut
935 1026
936sub urxvt::term::line { 1027sub line {
937 my ($self, $row) = @_; 1028 my ($self, $row) = @_;
938 1029
939 my $maxrow = $self->nrow - 1; 1030 my $maxrow = $self->nrow - 1;
940 1031
941 my ($beg, $end) = ($row, $row); 1032 my ($beg, $end) = ($row, $row);
1005 $offset / $self->{ncol} + $self->{beg}, 1096 $offset / $self->{ncol} + $self->{beg},
1006 $offset % $self->{ncol} 1097 $offset % $self->{ncol}
1007 ) 1098 )
1008} 1099}
1009 1100
1010=item ($row, $col) = $line->coord_of ($offset)
1011=item $text = $term->special_encode $string 1101=item $text = $term->special_encode $string
1012 1102
1013Converts a perl string into the special encoding used by rxvt-unicode, 1103Converts a perl string into the special encoding used by rxvt-unicode,
1014where one character corresponds to one screen cell. See 1104where one character corresponds to one screen cell. See
1015C<< $term->ROW_t >> for details. 1105C<< $term->ROW_t >> for details.
1017=item $string = $term->special_decode $text 1107=item $string = $term->special_decode $text
1018 1108
1019Converts rxvt-unicodes text reprsentation into a perl string. See 1109Converts rxvt-unicodes text reprsentation into a perl string. See
1020C<< $term->ROW_t >> for details. 1110C<< $term->ROW_t >> for details.
1021 1111
1112=item $success = $term->grab_button ($button, $modifiermask)
1113
1114Registers a synchronous button grab. See XGrabButton.
1115
1116=item $success = $term->grab ($eventtime[, $sync])
1117
1118Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
1119synchronous (C<$sync> is true). Also remembers the grab timestampe.
1120
1121=item $term->allow_events_async
1122
1123Calls XAllowEvents with AsyncBoth for the most recent grab.
1124
1125=item $term->allow_events_sync
1126
1127Calls XAllowEvents with SyncBoth for the most recent grab.
1128
1129=item $term->allow_events_replay
1130
1131Calls XAllowEvents with both ReplayPointer and ReplayKeyboard for the most
1132recent grab.
1133
1134=item $term->ungrab
1135
1136Calls XUngrab for the most recent grab. Is called automatically on
1137evaluation errors, as it is better to lose the grab in the error case as
1138the session.
1139
1022=back 1140=back
1023 1141
1142=cut
1143
1144package urxvt::popup;
1145
1024=head2 The C<urxvt::popup> Class 1146=head2 The C<urxvt::popup> Class
1025 1147
1026=over 4 1148=over 4
1027 1149
1028=cut 1150=cut
1029
1030package urxvt::popup;
1031 1151
1032sub add_item { 1152sub add_item {
1033 my ($self, $item) = @_; 1153 my ($self, $item) = @_;
1034 1154
1035 $item->{rend}{normal} = "\x1b[0;30;47m" unless exists $item->{rend}{normal}; 1155 $item->{rend}{normal} = "\x1b[0;30;47m" unless exists $item->{rend}{normal};
1075 1195
1076 my $item; $item = { 1196 my $item; $item = {
1077 type => "button", 1197 type => "button",
1078 text => " $text", 1198 text => " $text",
1079 value => $value, 1199 value => $value,
1080 render => sub { ($item->{value} ? "* " : " ") . $text }, 1200 render => sub { ($_[0]{value} ? "* " : " ") . $text },
1081 activate => sub { $cb->($item->{value} = !$item->{value}); }, 1201 activate => sub { $cb->($_[0]{value} = !$_[0]{value}); },
1082 }; 1202 };
1083 1203
1084 $self->add_item ($item); 1204 $self->add_item ($item);
1085} 1205}
1086 1206
1096} 1216}
1097 1217
1098sub DESTROY { 1218sub DESTROY {
1099 my ($self) = @_; 1219 my ($self) = @_;
1100 1220
1221 delete $self->{term}{_destroy}{$self};
1101 $self->{term}->ungrab; 1222 $self->{term}->ungrab;
1102} 1223}
1103 1224
1104=head2 The C<urxvt::timer> Class 1225=head2 The C<urxvt::timer> Class
1105 1226
1209This variable controls the verbosity level of the perl extension. Higher 1330This variable controls the verbosity level of the perl extension. Higher
1210numbers indicate more verbose output. 1331numbers indicate more verbose output.
1211 1332
1212=over 4 1333=over 4
1213 1334
1214=item =0 - only fatal messages 1335=item == 0 - fatal messages
1215 1336
1216=item =3 - script loading and management 1337=item >= 3 - script loading and management
1217 1338
1218=item =10 - all events received 1339=item >=10 - all events received
1219 1340
1220=back 1341=back
1221 1342
1222=head1 AUTHOR 1343=head1 AUTHOR
1223 1344

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines