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.130 by root, Wed Jan 25 15:32:48 2006 UTC vs.
Revision 1.132 by root, Mon Feb 6 05:40:15 2006 UTC

… …
205 205
206Clicking a button will activate that tab. Pressing B<Shift-Left> and 206Clicking a button will activate that tab. Pressing B<Shift-Left> and
207B<Shift-Right> will switch to the tab left or right of the current one, 207B<Shift-Right> will switch to the tab left or right of the current one,
208while B<Shift-Down> creates a new tab. 208while B<Shift-Down> creates a new tab.
209 209
210The tabbar itself can be configured similarly to a normal terminal, but
211with a resource class of C<URxvt.tabbed>. In addition, it supports the
212following four resources (shown with defaults):
213
214 URxvt.tabbed.tabbar-fg: <colour-index, default 3>
215 URxvt.tabbed.tabbar-bg: <colour-index, default 0>
216 URxvt.tabbed.tab-fg: <colour-index, default 0>
217 URxvt.tabbed.tab-bg: <colour-index, default 1>
218
219See I<COLOR AND GRAPHICS> in the @@RXVT_NAME@@(1) manpage for valid
220indices.
221
210=item mark-urls 222=item mark-urls
211 223
212Uses per-line display filtering (C<on_line_update>) to underline urls and 224Uses per-line display filtering (C<on_line_update>) to underline urls and
213make them clickable. When middle-clicked, the program specified in the 225make them clickable. When middle-clicked, the program specified in the
214resource C<urlLauncher> (default C<x-www-browser>) will be started with 226resource C<urlLauncher> (default C<x-www-browser>) will be started with
… …
667Using this function has the advantage that its output ends up in the 679Using this function has the advantage that its output ends up in the
668correct place, e.g. on stderr of the connecting urxvtc client. 680correct place, e.g. on stderr of the connecting urxvtc client.
669 681
670Messages have a size limit of 1023 bytes currently. 682Messages have a size limit of 1023 bytes currently.
671 683
684=item @terms = urxvt::termlist
685
686Returns all urxvt::term objects that exist in this process, regardless of
687wether they are started, being destroyed etc., so be careful. Only term
688objects that have perl extensions attached will be returned (because there
689is no urxvt::term objet associated with others).
690
672=item $time = urxvt::NOW 691=item $time = urxvt::NOW
673 692
674Returns the "current time" (as per the event loop). 693Returns the "current time" (as per the event loop).
675 694
676=item urxvt::CurrentTime 695=item urxvt::CurrentTime
… …
733Return the foreground/background colour index, respectively. 752Return the foreground/background colour index, respectively.
734 753
735=item $rend = urxvt::SET_FGCOLOR $rend, $new_colour 754=item $rend = urxvt::SET_FGCOLOR $rend, $new_colour
736 755
737=item $rend = urxvt::SET_BGCOLOR $rend, $new_colour 756=item $rend = urxvt::SET_BGCOLOR $rend, $new_colour
757
758=item $rend = urxvt::SET_COLOR $rend, $new_fg, $new_bg
738 759
739Replace the foreground/background colour in the rendition mask with the 760Replace the foreground/background colour in the rendition mask with the
740specified one. 761specified one.
741 762
742=item $value = urxvt::GET_CUSTOM $rend 763=item $value = urxvt::GET_CUSTOM $rend
… …
880 } 901 }
881 902
882 $retval 903 $retval
883} 904}
884 905
906sub SET_COLOR($$$) {
907 SET_BGCOLOR (SET_FGCOLOR ($_[0], $_[1]), $_[2])
908}
909
885# urxvt::term::extension 910# urxvt::term::extension
886 911
887package urxvt::term::extension; 912package urxvt::term::extension;
888 913
889sub enable { 914sub enable {
… …
1056hash which defines the environment of the new terminal. 1081hash which defines the environment of the new terminal.
1057 1082
1058Croaks (and probably outputs an error message) if the new instance 1083Croaks (and probably outputs an error message) if the new instance
1059couldn't be created. Returns C<undef> if the new instance didn't 1084couldn't be created. Returns C<undef> if the new instance didn't
1060initialise perl, and the terminal object otherwise. The C<init> and 1085initialise perl, and the terminal object otherwise. The C<init> and
1061C<start> hooks will be called during this call. 1086C<start> hooks will be called before this call returns, and are free to
1087refer to global data (which is race free).
1062 1088
1063=cut 1089=cut
1064 1090
1065sub new { 1091sub new {
1066 my ($class, $env, @args) = @_; 1092 my ($class, $env, @args) = @_;
1067 1093
1094 $env or Carp::croak "environment hash missing in call to urxvt::term->new";
1095 @args or Carp::croak "name argument missing in call to urxvt::term->new";
1096
1068 _new ([ map "$_=$env->{$_}", keys %$env ], @args); 1097 _new ([ map "$_=$env->{$_}", keys %$env ], \@args);
1069} 1098}
1070 1099
1071=item $term->destroy 1100=item $term->destroy
1072 1101
1073Destroy the terminal object (close the window, free resources 1102Destroy the terminal object (close the window, free resources
… …
1373Adds the specified events to the vt event mask. Useful e.g. when you want 1402Adds the specified events to the vt event mask. Useful e.g. when you want
1374to receive pointer events all the times: 1403to receive pointer events all the times:
1375 1404
1376 $term->vt_emask_add (urxvt::PointerMotionMask); 1405 $term->vt_emask_add (urxvt::PointerMotionMask);
1377 1406
1407=item $term->focus_in
1408
1409=item $term->focus_out
1410
1411=item $term->key_press ($state, $keycode[, $time])
1412
1413=item $term->key_release ($state, $keycode[, $time])
1414
1415Deliver various fake events to to terminal.
1416
1378=item $window_width = $term->width 1417=item $window_width = $term->width
1379 1418
1380=item $window_height = $term->height 1419=item $window_height = $term->height
1381 1420
1382=item $font_width = $term->fwidth 1421=item $font_width = $term->fwidth
… …
1627=item $string = $term->special_decode $text 1666=item $string = $term->special_decode $text
1628 1667
1629Converts rxvt-unicodes text reprsentation into a perl string. See 1668Converts rxvt-unicodes text reprsentation into a perl string. See
1630C<< $term->ROW_t >> for details. 1669C<< $term->ROW_t >> for details.
1631 1670
1632=item $success = $term->grab_button ($button, $modifiermask) 1671=item $success = $term->grab_button ($button, $modifiermask[, $window = $term->vt])
1633 1672
1673=item $term->ungrab_button ($button, $modifiermask[, $window = $term->vt])
1674
1634Registers a synchronous button grab. See the XGrabButton manpage. 1675Register/unregister a synchronous button grab. See the XGrabButton
1676manpage.
1635 1677
1636=item $success = $term->grab ($eventtime[, $sync]) 1678=item $success = $term->grab ($eventtime[, $sync])
1637 1679
1638Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or 1680Calls XGrabPointer and XGrabKeyboard in asynchronous (default) or
1639synchronous (C<$sync> is true). Also remembers the grab timestampe. 1681synchronous (C<$sync> is true). Also remembers the grab timestampe.

Diff Legend

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