7.2
- removed support for obsolete offix dnd protocol.
- added "tabbed" extension that provides a crude tabbed terminal.
+ - added "readline" extension that allows cursor positioning
+ via mouse clicks.
- fixed the automove-background extension to ignore coordinates
in non-synthetic events.
src/perl/automove-background
src/perl/mark-urls
src/perl/tabbed
+src/perl/readline
src/perl/example-refresh-hooks
src/perl/block-graphics-to-ascii
src/perl/digital-clock
<dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br />
</dt>
<dd>
-Pressing and releasing the Middle mouse button (or <strong>Shift-Insert</strong>) in
-an <strong>rxvt</strong> window causes the current text selection to be
-inserted as if it had been typed on the keyboard.
+Pressing and releasing the Middle mouse button in an <strong>rxvt</strong> window
+causes the value of the PRIMARY selection (Shift for CLIPBOARD) to be inserted
+as if it had been typed on the keyboard.
+<strong>Shift-Insert</strong> causes the value of the PRIMARY selection to be inserted too.
</dd>
<p></p></dl>
<p>
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
.\"
.\" Standard preamble:
.\" ========================================================================
the selection.
.IP "\fBInsertion\fR:" 4
.IX Item "Insertion:"
-Pressing and releasing the Middle mouse button (or \fBShift-Insert\fR) in
-an \fB@@RXVT_NAME@@\fR window causes the current text selection to be
-inserted as if it had been typed on the keyboard.
+Pressing and releasing the Middle mouse button in an \fB@@RXVT_NAME@@\fR window
+causes the value of the \s-1PRIMARY\s0 selection (Shift for \s-1CLIPBOARD\s0) to be inserted
+as if it had been typed on the keyboard.
+\&\fBShift-Insert\fR causes the value of the \s-1PRIMARY\s0 selection to be inserted too.
.SH "CHANGING FONTS"
.IX Header "CHANGING FONTS"
Changing fonts (or font sizes, respectively) via the keypad is not yet
removed from the selection.
Insertion:
- Pressing and releasing the Middle mouse button (or Shift-Insert) in
- an rxvt window causes the current text selection to be inserted as
- if it had been typed on the keyboard.
+ Pressing and releasing the Middle mouse button in an rxvt window
+ causes the value of the PRIMARY selection (Shift for CLIPBOARD) to
+ be inserted as if it had been typed on the keyboard. Shift-Insert
+ causes the value of the PRIMARY selection to be inserted too.
CHANGING FONTS
Changing fonts (or font sizes, respectively) via the keypad is not yet
<dd>
Binds a popup menu to Ctrl-Button3 that lets you convert the selection
text into various other formats/action (such as uri unescaping, perl
-evalution, web-browser starting etc.), depending on content.
+evaluation, web-browser starting etc.), depending on content.
</dd>
<dd>
<p>Other extensions can extend this popup menu by pushing a code reference
the message into vi commands to load the file.</p>
</dd>
<p></p>
+<dt><strong><a name="item_readline">readline</a></strong><br />
+</dt>
+<dd>
+A support package that tries to make editing with readline easier. At the
+moment, it reacts to clicking with the left mouse button by trying to
+move the text cursor to this position. It does so by generating as many
+cursor-left or cursor-right keypresses as required (the this only works
+for programs that correctly support wide characters).
+</dd>
+<dd>
+<p>It only works when clicking into the same line (possibly extended over
+multiple rows) as the text cursor and on the primary screen, to reduce the
+risk of misinterpreting. The normal selection isn't disabled, so quick
+successive clicks might interfere with selection creation in harmless
+ways.</p>
+</dd>
+<p></p>
<dt><strong><a name="item_tabbed">tabbed</a></strong><br />
</dt>
<dd>
button per tab.
</dd>
<dd>
-<p>Clicking a button will activate that tab. Pressing Shift-Left and
-Shift-Right will switch to the tab left or right of the current one.</p>
+<p>Clicking a button will activate that tab. Pressing <strong>Shift-Left</strong> and
+<strong>Shift-Right</strong> will switch to the tab left or right of the current one,
+while <strong>Shift-Down</strong> creates a new tab.</p>
</dd>
<p></p>
<dt><strong><a name="item_mark_2durls">mark-urls</a></strong><br />
<p></p>
<dt><strong><a name="item_on_configure_notify__24term_2c__24event">on_configure_notify $term, $event</a></strong><br />
</dt>
+<dt><strong><a name="item_on_property_notify__24term_2c__24event">on_property_notify $term, $event</a></strong><br />
+</dt>
<dt><strong><a name="item_on_key_press__24term_2c__24event_2c__24keysym_2c__">on_key_press $term, $event, $keysym, $octets</a></strong><br />
</dt>
<dt><strong><a name="item_on_key_release__24term_2c__24event_2c__24keysym">on_key_release $term, $event, $keysym</a></strong><br />
</dd>
<dd>
<p>The event is a hash with most values as named by Xlib (see the XEvent
-manpage), with the additional members <code>row</code> and <code>col</code>, which are the row
-and column under the mouse cursor.</p>
+manpage), with the additional members <code>row</code> and <code>col</code>, which are the
+(real, not screen-based) row and column under the mouse cursor.</p>
</dd>
<dd>
<p><code>on_key_press</code> additionally receives the string rxvt-unicode would
<code>on_add_lines</code> hook, though.</p>
</dd>
<p></p>
+<dt><strong><a name="item_scr_change_screen">$term->scr_change_screen ($screen)</a></strong><br />
+</dt>
+<dd>
+Switch to given screen - 0 primary, 1 secondary.
+</dd>
+<p></p>
<dt><strong><a name="item_cmd_parse">$term->cmd_parse ($octets)</a></strong><br />
</dt>
<dd>
AltGr), the meta key (often Alt) and the num lock key, if applicable.
</dd>
<p></p>
+<dt><strong><a name="item_current_screen">$screen = $term->current_screen</a></strong><br />
+</dt>
+<dd>
+Returns the currently displayed screen (0 primary, 1 secondary).
+</dd>
+<p></p>
<dt><strong><a name="item_view_start">$view_start = $term->view_start ([$newvalue])</a></strong><br />
</dt>
<dd>
automatically be updated.</p>
</dd>
<dd>
-<p><a href="#item__24text"><code>$text</code></a> is in a special encoding: tabs and wide characters that use more
-than one cell when displayed are padded with urxvt::NOCHAR characters
-(<code>chr 65535</code>). Characters with combining characters and other characters
-that do not fit into the normal tetx encoding will be replaced with
-characters in the private use area.</p>
+<p><a href="#item__24text"><code>$text</code></a> is in a special encoding: tabs and wide characters that use
+more than one cell when displayed are padded with <code>$urxvt::NOCHAR</code>
+characters. Characters with combining characters and other characters that
+do not fit into the normal tetx encoding will be replaced with characters
+in the private use area.</p>
</dd>
<dd>
<p>You have to obey this encoding when changing text. The advantage is
evaluation errors, as it is better to lose the grab in the error case as
the session.
</dd>
+<p></p>
+<dt><strong><a name="item_xinternatom">$atom = $term->XInternAtom ($atom_name[, $only_if_exists])</a></strong><br />
+</dt>
+<dt><strong><a name="item_xgetatomname">$atom_name = $term->XGetAtomName ($atom)</a></strong><br />
+</dt>
+<dt><strong><a name="item_xlistproperties">@atoms = $term->XListProperties ($window)</a></strong><br />
+</dt>
+<dt><strong><a name="item_xgetwindowproperty">($type,$format,$octets) = $term->XGetWindowProperty ($window, $property)</a></strong><br />
+</dt>
+<dt><strong><a name="item_xchangewindowproperty">$term->XChangeWindowProperty ($window, $property, $type, $format, $octets)</a></strong><br />
+</dt>
+<dt><strong><a name="item_xdeleteproperty">$term->XDeleteProperty ($window, $property)</a></strong><br />
+</dt>
+<dt><strong><a name="item_defaultrootwindow">$window = $term->DefaultRootWindow</a></strong><br />
+</dt>
+<dt><strong><a name="item_xreparentwindow">$term->XReparentWindow ($window, $parent, [$x, $y])</a></strong><br />
+</dt>
+<dt><strong><a name="item_xmapwindow">$term->XMapWindow ($window)</a></strong><br />
+</dt>
+<dt><strong><a name="item_xunmapwindow">$term->XUnmapWindow ($window)</a></strong><br />
+</dt>
+<dt><strong><a name="item_xmoveresizewindow">$term->XMoveResizeWindow ($window, $x, $y, $width, $height)</a></strong><br />
+</dt>
+<dt><strong><a name="item_xtranslatecoordinates">($x, $y, $child_window) = $term->XTranslateCoordinates ($src, $dst, $x, $y)</a></strong><br />
+</dt>
+<dt><strong><a name="item_xchangeinput">$term->XChangeInput ($window, $add_events[, $del_events])</a></strong><br />
+</dt>
+<dd>
+Various X or X-related functions. The <code>$term</code> object only serves as
+the source of the display, otherwise those functions map more-or-less
+directory onto the X functions of the same name.
+</dd>
<p></p></dl>
<p>
</p>
-.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14
+.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
.\"
.\" Standard preamble:
.\" ========================================================================
.IX Item "selection-popup (enabled by default)"
Binds a popup menu to Ctrl\-Button3 that lets you convert the selection
text into various other formats/action (such as uri unescaping, perl
-evalution, web-browser starting etc.), depending on content.
+evaluation, web-browser starting etc.), depending on content.
.Sp
Other extensions can extend this popup menu by pushing a code reference
onto \f(CW\*(C`@{ $term\-\*(C'\fR{selection_popup_hook} }>, that is called whenever the
The first line tells the selection code to treat the unchanging part of
every error message as a selection pattern, and the second line transforms
the message into vi commands to load the file.
+.IP "readline" 4
+.IX Item "readline"
+A support package that tries to make editing with readline easier. At the
+moment, it reacts to clicking with the left mouse button by trying to
+move the text cursor to this position. It does so by generating as many
+cursor-left or cursor-right keypresses as required (the this only works
+for programs that correctly support wide characters).
+.Sp
+It only works when clicking into the same line (possibly extended over
+multiple rows) as the text cursor and on the primary screen, to reduce the
+risk of misinterpreting. The normal selection isn't disabled, so quick
+successive clicks might interfere with selection creation in harmless
+ways.
.IP "tabbed" 4
.IX Item "tabbed"
This transforms the terminal into a tabbar with additional terminals, that
displays a \*(L"[\s-1NEW\s0]\*(R" button, which, when clicked, will add a new tab, followed by one
button per tab.
.Sp
-Clicking a button will activate that tab. Pressing Shift-Left and
-Shift-Right will switch to the tab left or right of the current one.
+Clicking a button will activate that tab. Pressing \fBShift-Left\fR and
+\&\fBShift-Right\fR will switch to the tab left or right of the current one,
+while \fBShift-Down\fR creates a new tab.
.IP "mark-urls" 4
.IX Item "mark-urls"
Uses per-line display filtering (\f(CW\*(C`on_line_update\*(C'\fR) to underline urls and
.el .IP "on_configure_notify \f(CW$term\fR, \f(CW$event\fR" 4
.IX Item "on_configure_notify $term, $event"
.PD 0
+.ie n .IP "on_property_notify $term\fR, \f(CW$event" 4
+.el .IP "on_property_notify \f(CW$term\fR, \f(CW$event\fR" 4
+.IX Item "on_property_notify $term, $event"
.ie n .IP "on_key_press $term\fR, \f(CW$event\fR, \f(CW$keysym\fR, \f(CW$octets" 4
.el .IP "on_key_press \f(CW$term\fR, \f(CW$event\fR, \f(CW$keysym\fR, \f(CW$octets\fR" 4
.IX Item "on_key_press $term, $event, $keysym, $octets"
the hook returns true, then the even will be ignored by rxvt\-unicode.
.Sp
The event is a hash with most values as named by Xlib (see the XEvent
-manpage), with the additional members \f(CW\*(C`row\*(C'\fR and \f(CW\*(C`col\*(C'\fR, which are the row
-and column under the mouse cursor.
+manpage), with the additional members \f(CW\*(C`row\*(C'\fR and \f(CW\*(C`col\*(C'\fR, which are the
+(real, not screen\-based) row and column under the mouse cursor.
.Sp
\&\f(CW\*(C`on_key_press\*(C'\fR additionally receives the string rxvt-unicode would
output, if any, in locale-specific encoding.
Normally its not a good idea to use this function, as programs might be
confused by changes in cursor position or scrolling. Its useful inside a
\&\f(CW\*(C`on_add_lines\*(C'\fR hook, though.
+.IP "$term\->scr_change_screen ($screen)" 4
+.IX Item "$term->scr_change_screen ($screen)"
+Switch to given screen \- 0 primary, 1 secondary.
.IP "$term\->cmd_parse ($octets)" 4
.IX Item "$term->cmd_parse ($octets)"
Similar to \f(CW\*(C`scr_add_lines\*(C'\fR, but the argument must be in the
.PD
Return the modifier masks corresponding to the \*(L"\s-1ISO\s0 Level 3 Shift\*(R" (often
AltGr), the meta key (often Alt) and the num lock key, if applicable.
+.ie n .IP "$screen = $term\->current_screen" 4
+.el .IP "$screen = \f(CW$term\fR\->current_screen" 4
+.IX Item "$screen = $term->current_screen"
+Returns the currently displayed screen (0 primary, 1 secondary).
.ie n .IP "$view_start = $term\->view_start ([$newvalue])" 4
.el .IP "$view_start = \f(CW$term\fR\->view_start ([$newvalue])" 4
.IX Item "$view_start = $term->view_start ([$newvalue])"
to replace only parts of a line. The font index in the rendition will
automatically be updated.
.Sp
-\&\f(CW$text\fR is in a special encoding: tabs and wide characters that use more
-than one cell when displayed are padded with urxvt::NOCHAR characters
-(\f(CW\*(C`chr 65535\*(C'\fR). Characters with combining characters and other characters
-that do not fit into the normal tetx encoding will be replaced with
-characters in the private use area.
+\&\f(CW$text\fR is in a special encoding: tabs and wide characters that use
+more than one cell when displayed are padded with \f(CW$urxvt::NOCHAR\fR
+characters. Characters with combining characters and other characters that
+do not fit into the normal tetx encoding will be replaced with characters
+in the private use area.
.Sp
You have to obey this encoding when changing text. The advantage is
that \f(CW\*(C`substr\*(C'\fR and similar functions work on screen cells and not on
Calls XUngrab for the most recent grab. Is called automatically on
evaluation errors, as it is better to lose the grab in the error case as
the session.
+.ie n .IP "$atom = $term\fR\->XInternAtom ($atom_name[, \f(CW$only_if_exists])" 4
+.el .IP "$atom = \f(CW$term\fR\->XInternAtom ($atom_name[, \f(CW$only_if_exists\fR])" 4
+.IX Item "$atom = $term->XInternAtom ($atom_name[, $only_if_exists])"
+.PD 0
+.ie n .IP "$atom_name = $term\->XGetAtomName ($atom)" 4
+.el .IP "$atom_name = \f(CW$term\fR\->XGetAtomName ($atom)" 4
+.IX Item "$atom_name = $term->XGetAtomName ($atom)"
+.ie n .IP "@atoms = $term\->XListProperties ($window)" 4
+.el .IP "@atoms = \f(CW$term\fR\->XListProperties ($window)" 4
+.IX Item "@atoms = $term->XListProperties ($window)"
+.ie n .IP "($type,$format,$octets) = $term\fR\->XGetWindowProperty ($window, \f(CW$property)" 4
+.el .IP "($type,$format,$octets) = \f(CW$term\fR\->XGetWindowProperty ($window, \f(CW$property\fR)" 4
+.IX Item "($type,$format,$octets) = $term->XGetWindowProperty ($window, $property)"
+.ie n .IP "$term\->XChangeWindowProperty ($window, $property\fR, \f(CW$type\fR, \f(CW$format\fR, \f(CW$octets)" 4
+.el .IP "$term\->XChangeWindowProperty ($window, \f(CW$property\fR, \f(CW$type\fR, \f(CW$format\fR, \f(CW$octets\fR)" 4
+.IX Item "$term->XChangeWindowProperty ($window, $property, $type, $format, $octets)"
+.ie n .IP "$term\->XDeleteProperty ($window, $property)" 4
+.el .IP "$term\->XDeleteProperty ($window, \f(CW$property\fR)" 4
+.IX Item "$term->XDeleteProperty ($window, $property)"
+.ie n .IP "$window = $term\->DefaultRootWindow" 4
+.el .IP "$window = \f(CW$term\fR\->DefaultRootWindow" 4
+.IX Item "$window = $term->DefaultRootWindow"
+.ie n .IP "$term\->XReparentWindow ($window, $parent\fR, [$x, \f(CW$y])" 4
+.el .IP "$term\->XReparentWindow ($window, \f(CW$parent\fR, [$x, \f(CW$y\fR])" 4
+.IX Item "$term->XReparentWindow ($window, $parent, [$x, $y])"
+.IP "$term\->XMapWindow ($window)" 4
+.IX Item "$term->XMapWindow ($window)"
+.IP "$term\->XUnmapWindow ($window)" 4
+.IX Item "$term->XUnmapWindow ($window)"
+.ie n .IP "$term\->XMoveResizeWindow ($window, $x\fR, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height)" 4
+.el .IP "$term\->XMoveResizeWindow ($window, \f(CW$x\fR, \f(CW$y\fR, \f(CW$width\fR, \f(CW$height\fR)" 4
+.IX Item "$term->XMoveResizeWindow ($window, $x, $y, $width, $height)"
+.ie n .IP "($x, $y\fR, \f(CW$child_window\fR) = \f(CW$term\fR\->XTranslateCoordinates ($src, \f(CW$dst\fR, \f(CW$x\fR, \f(CW$y)" 4
+.el .IP "($x, \f(CW$y\fR, \f(CW$child_window\fR) = \f(CW$term\fR\->XTranslateCoordinates ($src, \f(CW$dst\fR, \f(CW$x\fR, \f(CW$y\fR)" 4
+.IX Item "($x, $y, $child_window) = $term->XTranslateCoordinates ($src, $dst, $x, $y)"
+.ie n .IP "$term\->XChangeInput ($window, $add_events\fR[, \f(CW$del_events])" 4
+.el .IP "$term\->XChangeInput ($window, \f(CW$add_events\fR[, \f(CW$del_events\fR])" 4
+.IX Item "$term->XChangeInput ($window, $add_events[, $del_events])"
+.PD
+Various X or X\-related functions. The \f(CW$term\fR object only serves as
+the source of the display, otherwise those functions map more-or-less
+directory onto the X functions of the same name.
.ie n .Sh "The ""urxvt::popup"" Class"
.el .Sh "The \f(CWurxvt::popup\fP Class"
.IX Subsection "The urxvt::popup Class"
selection-popup (enabled by default)
Binds a popup menu to Ctrl-Button3 that lets you convert the
selection text into various other formats/action (such as uri
- unescaping, perl evalution, web-browser starting etc.), depending on
- content.
+ unescaping, perl evaluation, web-browser starting etc.), depending
+ on content.
Other extensions can extend this popup menu by pushing a code
reference onto "@{ $term-"{selection_popup_hook} }>, that is called
of every error message as a selection pattern, and the second line
transforms the message into vi commands to load the file.
+ readline
+ A support package that tries to make editing with readline easier.
+ At the moment, it reacts to clicking with the left mouse button by
+ trying to move the text cursor to this position. It does so by
+ generating as many cursor-left or cursor-right keypresses as
+ required (the this only works for programs that correctly support
+ wide characters).
+
+ It only works when clicking into the same line (possibly extended
+ over multiple rows) as the text cursor and on the primary screen, to
+ reduce the risk of misinterpreting. The normal selection isn't
+ disabled, so quick successive clicks might interfere with selection
+ creation in harmless ways.
+
tabbed
This transforms the terminal into a tabbar with additional
terminals, that is, it implements what is commonly refered to as
tab.
Clicking a button will activate that tab. Pressing Shift-Left and
- Shift-Right will switch to the tab left or right of the current one.
+ Shift-Right will switch to the tab left or right of the current one,
+ while Shift-Down creates a new tab.
mark-urls
Uses per-line display filtering ("on_line_update") to underline urls
rxvt-unicode does focus out processing.
on_configure_notify $term, $event
+ on_property_notify $term, $event
on_key_press $term, $event, $keysym, $octets
on_key_release $term, $event, $keysym
on_button_press $term, $event
The event is a hash with most values as named by Xlib (see the
XEvent manpage), with the additional members "row" and "col", which
- are the row and column under the mouse cursor.
+ are the (real, not screen-based) row and column under the mouse
+ cursor.
"on_key_press" additionally receives the string rxvt-unicode would
output, if any, in locale-specific encoding.
be confused by changes in cursor position or scrolling. Its useful
inside a "on_add_lines" hook, though.
+ $term->scr_change_screen ($screen)
+ Switch to given screen - 0 primary, 1 secondary.
+
$term->cmd_parse ($octets)
Similar to "scr_add_lines", but the argument must be in the
locale-specific encoding of the terminal and can contain command
(often AltGr), the meta key (often Alt) and the num lock key, if
applicable.
+ $screen = $term->current_screen
+ Returns the currently displayed screen (0 primary, 1 secondary).
+
$view_start = $term->view_start ([$newvalue])
Returns the row number of the topmost displayed line. Maximum value
is 0, which displays the normal terminal contents. Lower values
automatically be updated.
$text is in a special encoding: tabs and wide characters that use
- more than one cell when displayed are padded with urxvt::NOCHAR
- characters ("chr 65535"). Characters with combining characters and
- other characters that do not fit into the normal tetx encoding will
- be replaced with characters in the private use area.
+ more than one cell when displayed are padded with $urxvt::NOCHAR
+ characters. Characters with combining characters and other
+ characters that do not fit into the normal tetx encoding will be
+ replaced with characters in the private use area.
You have to obey this encoding when changing text. The advantage is
that "substr" and similar functions work on screen cells and not on
evaluation errors, as it is better to lose the grab in the error
case as the session.
+ $atom = $term->XInternAtom ($atom_name[, $only_if_exists])
+ $atom_name = $term->XGetAtomName ($atom)
+ @atoms = $term->XListProperties ($window)
+ ($type,$format,$octets) = $term->XGetWindowProperty ($window, $property)
+ $term->XChangeWindowProperty ($window, $property, $type, $format,
+ $octets)
+ $term->XDeleteProperty ($window, $property)
+ $window = $term->DefaultRootWindow
+ $term->XReparentWindow ($window, $parent, [$x, $y])
+ $term->XMapWindow ($window)
+ $term->XUnmapWindow ($window)
+ $term->XMoveResizeWindow ($window, $x, $y, $width, $height)
+ ($x, $y, $child_window) = $term->XTranslateCoordinates ($src, $dst, $x,
+ $y)
+ $term->XChangeInput ($window, $add_events[, $del_events])
+ Various X or X-related functions. The $term object only serves as
+ the source of the display, otherwise those functions map
+ more-or-less directory onto the X functions of the same name.
+
The "urxvt::popup" Class
$popup->add_title ($title)
Adds a non-clickable title to the popup.
codeset codeset_from_name (const char *name);
enum {
- ZERO_WIDTH_CHAR = 0x200b,
+ ZERO_WIDTH_CHAR = 0x200b,
REPLACEMENT_CHAR = 0xfffd,
- NOCHAR = 65535, // must be invalid in ANY codeset (!)
+ NOCHAR = 0xfffe, // must be invalid in ANY codeset (!)
};
struct rxvt_codeset_conv {
my $cur = $line->offset_of ($row, $col);
my $ofs = $line->offset_of ($event->{row}, $event->{col});
- if ($ofs >= 0 && $ofs < $line->l) {
+ if ($ofs >= 0 && $ofs < $line->l && !$self->current_screen) {
my $diff = $ofs - $cur;
+ my $move;
- $self->tt_write ($diff < 0 ? "\x1b[D" x -$diff
- : "\x1b[C" x $diff);
+ if ($diff < 0) {
+ ($ofs, $cur) = ($cur, $ofs);
+ $move = "\x1b[D";
+ } else {
+ $move = "\x1b[C";
+ }
+
+ my $skipped = substr $line->t, $cur, $ofs - $cur;
+ $skipped =~ s/$urxvt::NOCHAR//g;
+
+ $self->tt_write ($move x length $skipped);
}
()
am_pixmap_trans:1, /* transparency w/known root pixmap */
#endif
current_screen:1, /* primary or secondary */
- hate_those_clicks:1, /* a.k.a. keep mark position */
num_scr_allow:1,
bypass_keystate:1,
#ifdef CURSOR_BLINK
ModLevel3Mask = 0
ModMetaMask = 1
ModNumLockMask = 2
+ current_screen = 3
CODE:
switch (ix)
{
case 0: RETVAL = THIS->ModLevel3Mask; break;
case 1: RETVAL = THIS->ModMetaMask; break;
case 2: RETVAL = THIS->ModNumLockMask; break;
+ case 3: RETVAL = THIS->current_screen; break;
}
OUTPUT:
RETVAL
rxvt_term::scr_bell ()
void
+rxvt_term::scr_change_screen (int screen)
+
+void
rxvt_term::scr_add_lines (SV *string)
CODE:
{
every error message as a selection pattern, and the second line transforms
the message into vi commands to load the file.
+=item readline
+
+A support package that tries to make editing with readline easier. At the
+moment, it reacts to clicking with the left mouse button by trying to
+move the text cursor to this position. It does so by generating as many
+cursor-left or cursor-right keypresses as required (the this only works
+for programs that correctly support wide characters).
+
+It only works when clicking into the same line (possibly extended over
+multiple rows) as the text cursor and on the primary screen, to reduce the
+risk of misinterpreting. The normal selection isn't disabled, so quick
+successive clicks might interfere with selection creation in harmless
+ways.
+
=item tabbed
This transforms the terminal into a tabbar with additional terminals, that
our $RESCLASS;
our $RXVTNAME;
+our $NOCHAR = chr 0xfffe;
+
=head2 Variables in the C<urxvt> Package
=over 4
confused by changes in cursor position or scrolling. Its useful inside a
C<on_add_lines> hook, though.
+=item $term->scr_change_screen ($screen)
+
+Switch to given screen - 0 primary, 1 secondary.
+
=item $term->cmd_parse ($octets)
Similar to C<scr_add_lines>, but the argument must be in the
Return the modifier masks corresponding to the "ISO Level 3 Shift" (often
AltGr), the meta key (often Alt) and the num lock key, if applicable.
+=item $screen = $term->current_screen
+
+Returns the currently displayed screen (0 primary, 1 secondary).
+
=item $view_start = $term->view_start ([$newvalue])
Returns the row number of the topmost displayed line. Maximum value is
to replace only parts of a line. The font index in the rendition will
automatically be updated.
-C<$text> is in a special encoding: tabs and wide characters that use more
-than one cell when displayed are padded with urxvt::NOCHAR characters
-(C<chr 65535>). Characters with combining characters and other characters
-that do not fit into the normal tetx encoding will be replaced with
-characters in the private use area.
+C<$text> is in a special encoding: tabs and wide characters that use
+more than one cell when displayed are padded with C<$urxvt::NOCHAR>
+characters. Characters with combining characters and other characters that
+do not fit into the normal tetx encoding will be replaced with characters
+in the private use area.
You have to obey this encoding when changing text. The advantage is
that C<substr> and similar functions work on screen cells and not on
projects / dana / urxvt.git / commitdiff