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.48 by root, Sat Jan 7 21:43:17 2006 UTC vs.
Revision 1.58 by root, Sun Jan 8 22:58:13 2006 UTC

37 37
38 @@RXVT_NAME@@ -pe <extensionname> 38 @@RXVT_NAME@@ -pe <extensionname>
39 39
40=over 4 40=over 4
41 41
42=item selection 42=item selection (enabled by default)
43 43
44Intelligent selection. This extension tries to be more intelligent when 44Intelligent selection. This extension tries to be more intelligent when
45the user extends selections (double-click). Right now, it tries to select 45the user extends selections (double-click). Right now, it tries to select
46urls and complete shell-quoted arguments, which is very convenient, too, 46urls and complete shell-quoted arguments, which is very convenient, too,
47if your F<ls> supports C<--quoting-style=shell>. 47if your F<ls> supports C<--quoting-style=shell>.
55Rot-13 the selection when activated. Used via keyboard trigger: 55Rot-13 the selection when activated. Used via keyboard trigger:
56 56
57 URxvt.keysym.C-M-r: perl:selection:rot13 57 URxvt.keysym.C-M-r: perl:selection:rot13
58 58
59=back 59=back
60
61=item option-popup (enabled by default)
62
63Binds a popup menu to Ctrl-Button3 that lets you toggle (some) options at
64runtime.
60 65
61=item digital-clock 66=item digital-clock
62 67
63Displays a digital clock using the built-in overlay. 68Displays a digital clock using the built-in overlay.
64 69
337 342
338=item urxvt::ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask, 343=item urxvt::ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask,
339Mod3Mask, Mod4Mask, Mod5Mask, Button1Mask, Button2Mask, Button3Mask, 344Mod3Mask, Mod4Mask, Mod5Mask, Button1Mask, Button2Mask, Button3Mask,
340Button4Mask, Button5Mask, AnyModifier 345Button4Mask, Button5Mask, AnyModifier
341 346
342Various constants for use in X events. 347Various constants for use in X calls and event processing.
343 348
344=back 349=back
345 350
346=head2 RENDITION 351=head2 RENDITION
347 352
402use utf8; 407use utf8;
403use strict; 408use strict;
404use Scalar::Util (); 409use Scalar::Util ();
405use List::Util (); 410use List::Util ();
406 411
412our $VERSION = 1;
407our $TERM; 413our $TERM;
408our @HOOKNAME; 414our @HOOKNAME;
415our %OPTION;
409our $LIBDIR; 416our $LIBDIR;
410 417
411BEGIN { 418BEGIN {
412 urxvt->bootstrap; 419 urxvt->bootstrap;
413 420
464 . "use base urxvt::term::proxy::;\n" 471 . "use base urxvt::term::proxy::;\n"
465 . "#line 1 \"$path\"\n{\n" 472 . "#line 1 \"$path\"\n{\n"
466 . (do { local $/; <$fh> }) 473 . (do { local $/; <$fh> })
467 . "\n};\n1"; 474 . "\n};\n1";
468 475
476 $source =~ /(.*)/s and $source = $1; # untaint
477
469 eval $source or die "$path: $@"; 478 eval $source or die "$path: $@";
470 479
471 $pkg 480 $pkg
472 } 481 }
473} 482}
479 local $TERM = shift; 488 local $TERM = shift;
480 my $htype = shift; 489 my $htype = shift;
481 490
482 if ($htype == 0) { # INIT 491 if ($htype == 0) { # INIT
483 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl"); 492 my @dirs = ((split /:/, $TERM->resource ("perl_lib")), "$LIBDIR/perl");
493
494 my %want_ext;
484 495
485 for my $ext (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) { 496 for (map { split /,/, $TERM->resource ("perl_ext_$_") } 1, 2) {
497 if ($_ eq "default") {
498 $want_ext{$_}++ for qw(selection option-popup);
499 } elsif (/^-(.*)$/) {
500 delete $want_ext{$1};
501 } else {
502 $want_ext{$_}++;
503 }
504 }
505
506 for my $ext (keys %want_ext) {
486 my @files = grep -f $_, map "$_/$ext", @dirs; 507 my @files = grep -f $_, map "$_/$ext", @dirs;
487 508
488 if (@files) { 509 if (@files) {
489 register_package extension_package $files[0]; 510 register_package extension_package $files[0];
490 } else { 511 } else {
491 warn "perl extension '$ext' not found in perl library search path\n"; 512 warn "perl extension '$ext' not found in perl library search path\n";
492 } 513 }
493 } 514 }
515
516 eval "#line 1 \"--perl-eval resource/argument\"\n" . $TERM->resource ("perl_eval");
517 warn $@ if $@;
494 } 518 }
495 519
496 $retval = undef; 520 $retval = undef;
497 521
498 if (my $cb = $TERM->{_hook}[$htype]) { 522 if (my $cb = $TERM->{_hook}[$htype]) {
510 $proxy 534 $proxy
511 }, 535 },
512 @_, 536 @_,
513 ) and last; 537 ) and last;
514 }; 538 };
515 warn $@ if $@;#d# 539 if ($@) {
540 $TERM->ungrab; # better to lose the grab than the session
541 warn $@;
542 }
516 } 543 }
517 } 544 }
518 545
519 if ($htype == 1) { # DESTROY 546 if ($htype == 1) { # DESTROY
520 # remove hooks if unused 547 # remove hooks if unused
533 } 560 }
534 561
535 $retval 562 $retval
536} 563}
537 564
565# urxvt::term::proxy
566
538sub urxvt::term::proxy::AUTOLOAD { 567sub urxvt::term::proxy::AUTOLOAD {
539 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/ 568 $urxvt::term::proxy::AUTOLOAD =~ /:([^:]+)$/
540 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable"; 569 or die "FATAL: \$AUTOLOAD '$urxvt::term::proxy::AUTOLOAD' unparsable";
541 570
542 eval qq{ 571 eval qq{
548 } or die "FATAL: unable to compile method forwarder: $@"; 577 } or die "FATAL: unable to compile method forwarder: $@";
549 578
550 goto &$urxvt::term::proxy::AUTOLOAD; 579 goto &$urxvt::term::proxy::AUTOLOAD;
551} 580}
552 581
582sub urxvt::term::proxy::DESTROY {
583 # nop
584}
585
586# urxvt::destroy_hook
587
553sub urxvt::destroy_hook::DESTROY { 588sub urxvt::destroy_hook::DESTROY {
554 ${$_[0]}->(); 589 ${$_[0]}->();
555} 590}
556 591
557sub urxvt::destroy_hook(&) { 592sub urxvt::destroy_hook(&) {
558 bless \shift, urxvt::destroy_hook:: 593 bless \shift, urxvt::destroy_hook::
559} 594}
560 595
596package urxvt::anyevent;
597
598=head2 The C<urxvt::anyevent> Class
599
600The sole purpose of this class is to deliver an interface to the
601C<AnyEvent> module - any module using it will work inside urxvt without
602further work. The only exception is that you cannot wait on condition
603variables, but non-blocking condvar use is ok. What this means is that you
604cannot use blocking APIs, but the non-blocking variant should work.
605
606=cut
607
608our $VERSION = 1;
609
610$INC{"urxvt/anyevent.pm"} = 1; # mark us as there
611push @AnyEvent::REGISTRY, [urxvt => urxvt::anyevent::];
612
613sub timer {
614 my ($class, %arg) = @_;
615
616 my $cb = $arg{cb};
617
618 urxvt::timer
619 ->new
620 ->start (urxvt::NOW + $arg{after})
621 ->cb (sub {
622 $_[0]->stop; # need to cancel manually
623 $cb->();
624 })
625}
626
627sub io {
628 my ($class, %arg) = @_;
629
630 my $cb = $arg{cb};
631
632 bless [$arg{fh}, urxvt::iow
633 ->new
634 ->fd (fileno $arg{fh})
635 ->events (($arg{poll} =~ /r/ ? 1 : 0)
636 | ($arg{poll} =~ /w/ ? 2 : 0))
637 ->start
638 ->cb (sub {
639 $cb->(($_[1] & 1 ? 'r' : '')
640 . ($_[1] & 2 ? 'w' : ''));
641 })],
642 urxvt::anyevent::
643}
644
645sub DESTROY {
646 $_[0][1]->stop;
647}
648
649sub condvar {
650 bless \my $flag, urxvt::anyevent::condvar::
651}
652
653sub urxvt::anyevent::condvar::broadcast {
654 ${$_[0]}++;
655}
656
657sub urxvt::anyevent::condvar::wait {
658 unless (${$_[0]}) {
659 require Carp;
660 Carp::croak ("AnyEvent->condvar blocking wait unsupported in urxvt, use a non-blocking API");
661 }
662}
663
664package urxvt::term;
665
561=head2 The C<urxvt::term> Class 666=head2 The C<urxvt::term> Class
562 667
563=over 4 668=over 4
564 669
565=item $term->destroy 670=item $term->destroy
566 671
567Destroy the terminal object (close the window, free resources etc.). 672Destroy the terminal object (close the window, free resources etc.).
673
674=item $isset = $term->option ($optval[, $set])
675
676Returns true if the option specified by C<$optval> is enabled, and
677optionally change it. All option values are stored by name in the hash
678C<%urxvt::OPTION>. Options not enabled in this binary are not in the hash.
679
680Here is a a likely non-exhaustive list of option names, please see the
681source file F</src/optinc.h> to see the actual list:
682
683 borderLess console cursorBlink cursorUnderline hold iconic insecure
684 intensityStyles jumpScroll loginShell mapAlert meta8 mouseWheelScrollPage
685 pastableTabs pointerBlank reverseVideo scrollBar scrollBar_floating
686 scrollBar_right scrollTtyKeypress scrollTtyOutput scrollWithBuffer
687 secondaryScreen secondaryScroll skipBuiltinGlyphs transparent
688 tripleclickwords utmpInhibit visualBell
568 689
569=item $value = $term->resource ($name[, $newval]) 690=item $value = $term->resource ($name[, $newval])
570 691
571Returns the current resource value associated with a given name and 692Returns the current resource value associated with a given name and
572optionally sets a new value. Setting values is most useful in the C<init> 693optionally sets a new value. Setting values is most useful in the C<init>
582 703
583Please note that resource strings will currently only be freed when the 704Please note that resource strings will currently only be freed when the
584terminal is destroyed, so changing options frequently will eat memory. 705terminal is destroyed, so changing options frequently will eat memory.
585 706
586Here is a a likely non-exhaustive list of resource names, not all of which 707Here is a a likely non-exhaustive list of resource names, not all of which
587are supported in every build, please see the source to see the actual 708are supported in every build, please see the source file F</src/rsinc.h>
588list: 709to see the actual list:
589 710
590 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont 711 answerbackstring backgroundPixmap backspace_key boldFont boldItalicFont
591 borderLess color cursorBlink cursorUnderline cutchars delete_key 712 borderLess color cursorBlink cursorUnderline cutchars delete_key
592 display_name embed ext_bwidth fade font geometry hold iconName 713 display_name embed ext_bwidth fade font geometry hold iconName
593 imFont imLocale inputMethod insecure int_bwidth intensityStyles 714 imFont imLocale inputMethod insecure int_bwidth intensityStyles
600 shade term_name title transparent transparent_all tripleclickwords 721 shade term_name title transparent transparent_all tripleclickwords
601 utmpInhibit visualBell 722 utmpInhibit visualBell
602 723
603=cut 724=cut
604 725
605sub urxvt::term::resource($$;$) { 726sub resource($$;$) {
606 my ($self, $name) = (shift, shift); 727 my ($self, $name) = (shift, shift);
607 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0); 728 unshift @_, $self, $name, ($name =~ s/\s*\+\s*(\d+)$// ? $1 : 0);
608 &urxvt::term::_resource 729 &urxvt::term::_resource
609} 730}
610 731
697C<$event> I<must> be the event causing the menu to pop up (a button event, 818C<$event> I<must> be the event causing the menu to pop up (a button event,
698currently). 819currently).
699 820
700=cut 821=cut
701 822
702sub urxvt::term::popup { 823sub popup {
703 my ($self, $event) = @_; 824 my ($self, $event) = @_;
704 825
705 $self->grab ($event->{time}, 1) 826 $self->grab ($event->{time}, 1)
706 or return; 827 or return;
707 828
897 1018
898=back 1019=back
899 1020
900=cut 1021=cut
901 1022
902sub urxvt::term::line { 1023sub line {
903 my ($self, $row) = @_; 1024 my ($self, $row) = @_;
904 1025
905 my $maxrow = $self->nrow - 1; 1026 my $maxrow = $self->nrow - 1;
906 1027
907 my ($beg, $end) = ($row, $row); 1028 my ($beg, $end) = ($row, $row);
985Converts rxvt-unicodes text reprsentation into a perl string. See 1106Converts rxvt-unicodes text reprsentation into a perl string. See
986C<< $term->ROW_t >> for details. 1107C<< $term->ROW_t >> for details.
987 1108
988=back 1109=back
989 1110
1111=cut
1112
1113package urxvt::popup;
1114
990=head2 The C<urxvt::popup> Class 1115=head2 The C<urxvt::popup> Class
991 1116
992=over 4 1117=over 4
993 1118
994=cut 1119=cut
995
996package urxvt::popup;
997 1120
998sub add_item { 1121sub add_item {
999 my ($self, $item) = @_; 1122 my ($self, $item) = @_;
1000 1123
1124 $item->{rend}{normal} = "\x1b[0;30;47m" unless exists $item->{rend}{normal};
1125 $item->{rend}{hover} = "\x1b[0;30;46m" unless exists $item->{rend}{hover};
1126 $item->{rend}{active} = "\x1b[m" unless exists $item->{rend}{active};
1127
1128 $item->{render} ||= sub { $_[0]{text} };
1129
1001 push @{ $self->{item} }, $item; 1130 push @{ $self->{item} }, $item;
1131}
1132
1133sub add_separator {
1134 my ($self, $sep) = @_;
1135
1136 $sep ||= "═";
1137
1138 $self->add_item ({
1139 rend => { normal => "\x1b[0;30;47m", hover => "\x1b[0;30;47m", active => "\x1b[0;30;47m" },
1140 text => "",
1141 render => sub { $sep x $urxvt::TERM->ncol },
1142 activate => sub { },
1143 });
1144}
1145
1146sub add_title {
1147 my ($self, $title) = @_;
1148
1149 $self->add_item ({
1150 rend => { normal => "\x1b[38;5;11;44m", hover => "\x1b[38;5;11;44m", active => "\x1b[38;5;11;44m" },
1151 text => $title,
1152 activate => sub { },
1153 });
1002} 1154}
1003 1155
1004sub add_button { 1156sub add_button {
1005 my ($self, $text, $cb) = @_; 1157 my ($self, $text, $cb) = @_;
1006 1158
1007 $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb, 1159 $self->add_item ({ type => "button", text => "[ $text ]", activate => $cb});
1008 render => sub { $_[0]{text} },
1009 });
1010} 1160}
1011 1161
1012sub add_toggle { 1162sub add_toggle {
1013 my ($self, $text, $cb, $value) = @_; 1163 my ($self, $text, $cb, $value) = @_;
1014 1164
1015 $self->add_item ({ type => "button", text => " $text", value => $value, 1165 my $item; $item = {
1166 type => "button",
1167 text => " $text",
1168 value => $value,
1016 render => sub { ($_[0]{value} ? "" : " ") . substr $_[0]{text}, 1 }, 1169 render => sub { ($_[0]{value} ? "* " : " ") . $text },
1017 activate => sub { $cb->($_[0]{value} = !$_[0]{value}); }, 1170 activate => sub { $cb->($_[0]{value} = !$_[0]{value}); },
1018 }); 1171 };
1172
1173 $self->add_item ($item);
1019} 1174}
1020 1175
1021sub show { 1176sub show {
1022 my ($self) = @_; 1177 my ($self) = @_;
1023 1178
1030} 1185}
1031 1186
1032sub DESTROY { 1187sub DESTROY {
1033 my ($self) = @_; 1188 my ($self) = @_;
1034 1189
1190 delete $self->{term}{_destroy}{$self};
1035 $self->{term}->ungrab; 1191 $self->{term}->ungrab;
1036} 1192}
1037 1193
1038=head2 The C<urxvt::timer> Class 1194=head2 The C<urxvt::timer> Class
1039 1195
1143This variable controls the verbosity level of the perl extension. Higher 1299This variable controls the verbosity level of the perl extension. Higher
1144numbers indicate more verbose output. 1300numbers indicate more verbose output.
1145 1301
1146=over 4 1302=over 4
1147 1303
1148=item =0 - only fatal messages 1304=item == 0 - fatal messages
1149 1305
1150=item =3 - script loading and management 1306=item >= 3 - script loading and management
1151 1307
1152=item =10 - all events received 1308=item >=10 - all events received
1153 1309
1154=back 1310=back
1155 1311
1156=head1 AUTHOR 1312=head1 AUTHOR
1157 1313

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines