ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.html
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.html (file contents):
Revision 1.83 by root, Wed Aug 1 18:38:15 2007 UTC vs.
Revision 1.84 by root, Sat Oct 27 12:09:02 2007 UTC

… …
4<head> 4<head>
5 <title>RXVT REFERENCE</title> 5 <title>RXVT REFERENCE</title>
6 <meta name="description" content="Pod documentation for RXVT REFERENCE" /> 6 <meta name="description" content="Pod documentation for RXVT REFERENCE" />
7 <meta name="inputfile" content="&lt;standard input&gt;" /> 7 <meta name="inputfile" content="&lt;standard input&gt;" />
8 <meta name="outputfile" content="&lt;standard output&gt;" /> 8 <meta name="outputfile" content="&lt;standard output&gt;" />
9 <meta name="created" content="Wed Aug 1 20:30:03 2007" /> 9 <meta name="created" content="Sat Oct 27 14:07:34 2007" />
10 <meta name="generator" content="Pod::Xhtml 1.57" /> 10 <meta name="generator" content="Pod::Xhtml 1.57" />
11<link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head> 11<link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head>
12<body> 12<body>
13<div class="pod"> 13<div class="pod">
14<!-- INDEX START --> 14<!-- INDEX START -->
… …
44<li><a href="#What_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></li> 44<li><a href="#What_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></li>
45<li><a href="#I_don_t_like_the_screen_colors_How_d">I don't like the screen colors. How do I change them?</a></li> 45<li><a href="#I_don_t_like_the_screen_colors_How_d">I don't like the screen colors. How do I change them?</a></li>
46<li><a href="#Why_do_some_characters_look_so_much_">Why do some characters look so much different than others?</a></li> 46<li><a href="#Why_do_some_characters_look_so_much_">Why do some characters look so much different than others?</a></li>
47<li><a href="#How_does_rxvt_unicode_choose_fonts">How does rxvt-unicode choose fonts?</a></li> 47<li><a href="#How_does_rxvt_unicode_choose_fonts">How does rxvt-unicode choose fonts?</a></li>
48<li><a href="#Why_do_some_chinese_characters_look_">Why do some chinese characters look so different than others?</a></li> 48<li><a href="#Why_do_some_chinese_characters_look_">Why do some chinese characters look so different than others?</a></li>
49<li><a href="#How_can_I_make_mplayer_display_video">How can I make mplayer display video correctly?</a></li>
49</ul> 50</ul>
50</li> 51</li>
51<li><a href="#Keyboard_Mouse_amp_User_Interaction">Keyboard, Mouse &amp; User Interaction</a> 52<li><a href="#Keyboard_Mouse_amp_User_Interaction">Keyboard, Mouse &amp; User Interaction</a>
52<ul><li><a href="#The_new_selection_selects_pieces_tha">The new selection selects pieces that are too big, how can I select single words?</a></li> 53<ul><li><a href="#The_new_selection_selects_pieces_tha">The new selection selects pieces that are too big, how can I select single words?</a></li>
53<li><a href="#I_don_t_like_the_new_selection_popup">I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?</a></li> 54<li><a href="#I_don_t_like_the_new_selection_popup">I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?</a></li>
… …
117<li><a href="#Priv66">Priv66</a></li> 118<li><a href="#Priv66">Priv66</a></li>
118<li><a href="#XTerm">XTerm</a> 119<li><a href="#XTerm">XTerm</a>
119<ul><li><a href="#XTerm_Operating_System_Commands">XTerm Operating System Commands</a></li> 120<ul><li><a href="#XTerm_Operating_System_Commands">XTerm Operating System Commands</a></li>
120</ul> 121</ul>
121</li> 122</li>
122<li><a href="#XPM">XPM</a></li> 123<li><a href="#BACKGROUND_IMAGE">BACKGROUND IMAGE</a></li>
123<li><a href="#Mouse">Mouse</a></li> 124<li><a href="#Mouse">Mouse</a></li>
124<li><a href="#Mouse_Reporting">Mouse Reporting</a></li> 125<li><a href="#Mouse_Reporting">Mouse Reporting</a></li>
125<li><a href="#KeyCodes">KeyCodes</a></li> 126<li><a href="#KeyCodes">KeyCodes</a></li>
126<li><a href="#Key_Codes">Key Codes</a></li> 127<li><a href="#Key_Codes">Key Codes</a></li>
127<li><a href="#CONFIGURE_OPTIONS">CONFIGURE OPTIONS</a></li> 128<li><a href="#CONFIGURE_OPTIONS">CONFIGURE OPTIONS</a></li>
… …
363<div id="Rendering_Font_amp_Look_and_Feel_Iss-2"> 364<div id="Rendering_Font_amp_Look_and_Feel_Iss-2">
364 365
365</div> 366</div>
366<h3 id="I_can_t_get_transparency_working_wha">I can't get transparency working, what am I doing wrong?</h3> 367<h3 id="I_can_t_get_transparency_working_wha">I can't get transparency working, what am I doing wrong?</h3>
367<div id="I_can_t_get_transparency_working_wha-2"> 368<div id="I_can_t_get_transparency_working_wha-2">
368<p>First of all, transparency isn't officially supported in rxvt-unicode, so 369<p>First of all, please address all transparency related issues to Sasha Vasko at
369you are mostly on your own. Do not bug the author about it (but you may 370sasha@aftercode.net and do not bug the author about it. Also, if you can't
370bug everybody else). Also, if you can't get it working consider it a rite 371get it working consider it a rite of passage: ... and you failed.</p>
371of passage: ... and you failed.</p>
372<p>Here are four ways to get transparency. <strong>Do</strong> read the manpage and option 372<p>Here are four ways to get transparency. <strong>Do</strong> read the manpage and option
373descriptions for the programs mentioned and rxvt-unicode. Really, do it!</p> 373descriptions for the programs mentioned and rxvt-unicode. Really, do it!</p>
374<p>1. Use inheritPixmap:</p> 374<p>1. Use inheritPixmap:</p>
375<pre> Esetroot wallpaper.jpg 375<pre> Esetroot wallpaper.jpg
376 urxvt -ip -tint red -sh 40 376 urxvt -ip -tint red -sh 40
… …
379<p>That works. If you think it doesn't, you lack transparency and tinting 379<p>That works. If you think it doesn't, you lack transparency and tinting
380support, or you are unable to read.</p> 380support, or you are unable to read.</p>
381<p>2. Use a simple pixmap and emulate pseudo-transparency. This enables you 381<p>2. Use a simple pixmap and emulate pseudo-transparency. This enables you
382to use effects other than tinting and shading: Just shade/tint/whatever 382to use effects other than tinting and shading: Just shade/tint/whatever
383your picture with gimp or any other tool:</p> 383your picture with gimp or any other tool:</p>
384<pre> convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 384<pre> convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
385 urxvt -pixmap background.xpm -pe automove-background 385 urxvt -pixmap background.jpg -pe automove-background
386 386
387</pre> 387</pre>
388<p>That works. If you think it doesn't, you lack XPM and Perl support, or you 388<p>That works. If you think it doesn't, you lack AfterImage and Perl support, or you
389are unable to read.</p> 389are unable to read.</p>
390<p>3. Use an ARGB visual:</p> 390<p>3. Use an ARGB visual:</p>
391<pre> urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 391<pre> urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
392 392
393</pre> 393</pre>
… …
604<p>In the future it might be possible to switch language preferences at 604<p>In the future it might be possible to switch language preferences at
605runtime (the internal data structure has no problem with using different 605runtime (the internal data structure has no problem with using different
606fonts for the same character at the same time, but no interface for this 606fonts for the same character at the same time, but no interface for this
607has been designed yet).</p> 607has been designed yet).</p>
608<p>Until then, you might get away with switching fonts at runtime (see <a href="#Can_I_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a> later in this document).</p> 608<p>Until then, you might get away with switching fonts at runtime (see <a href="#Can_I_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a> later in this document).</p>
609
610</div>
611<h3 id="How_can_I_make_mplayer_display_video">How can I make mplayer display video correctly?</h3>
612<div id="How_can_I_make_mplayer_display_video-2">
613<p>We are working on it, in the meantime, as a workaround, use something like:</p>
614<pre> urxvt -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
615
616
617
618
619</pre>
609 620
610</div> 621</div>
611<h2 id="Keyboard_Mouse_amp_User_Interaction">Keyboard, Mouse &amp; User Interaction</h2> 622<h2 id="Keyboard_Mouse_amp_User_Interaction">Keyboard, Mouse &amp; User Interaction</h2>
612<div id="Keyboard_Mouse_amp_User_Interaction_"> 623<div id="Keyboard_Mouse_amp_User_Interaction_">
613 624
… …
801 812
802</pre> 813</pre>
803<p>Rather than have rxvt-unicode try to accommodate all the various possible 814<p>Rather than have rxvt-unicode try to accommodate all the various possible
804keyboard mappings, it is better to use `xmodmap' to remap the keys as 815keyboard mappings, it is better to use `xmodmap' to remap the keys as
805required for your particular machine.</p> 816required for your particular machine.</p>
806
807
808
809 817
810 818
811 819
812 820
813 821
… …
1756 </dd> 1764 </dd>
1757 <dt><strong><code>Pm = 66</code></strong></dt> 1765 <dt><strong><code>Pm = 66</code></strong></dt>
1758<table><tr><td>h</td><td>Application Keypad (DECPAM) == ESC =</td></tr><tr><td>l</td><td>Normal Keypad (DECPNM) == ESC ></td></tr></table> <dt><strong><code>Pm = 67</code></strong></dt> 1766<table><tr><td>h</td><td>Application Keypad (DECPAM) == ESC =</td></tr><tr><td>l</td><td>Normal Keypad (DECPNM) == ESC ></td></tr></table> <dt><strong><code>Pm = 67</code></strong></dt>
1759<table><tr><td>h</td><td>Backspace key sends BS (DECBKM)</td></tr><tr><td>l</td><td>Backspace key sends DEL</td></tr></table> <dt><strong><code>Pm = 1000</code></strong> (X11 XTerm)</dt> 1767<table><tr><td>h</td><td>Backspace key sends BS (DECBKM)</td></tr><tr><td>l</td><td>Backspace key sends DEL</td></tr></table> <dt><strong><code>Pm = 1000</code></strong> (X11 XTerm)</dt>
1760<table><tr><td>h</td><td>Send Mouse X & Y on button press and release.</td></tr><tr><td>l</td><td>No mouse reporting.</td></tr></table> <dt><strong><code>Pm = 1001</code></strong> (X11 XTerm) <i>unimplemented</i></dt> 1768<table><tr><td>h</td><td>Send Mouse X & Y on button press and release.</td></tr><tr><td>l</td><td>No mouse reporting.</td></tr></table> <dt><strong><code>Pm = 1001</code></strong> (X11 XTerm) <i>unimplemented</i></dt>
1761<table><tr><td>h</td><td>Use Hilite Mouse Tracking.</td></tr><tr><td>l</td><td>No mouse reporting.</td></tr></table> <dt><strong><code>Pm = 1010</code></strong> (<strong>rxvt</strong>)</dt> 1769<table><tr><td>h</td><td>Use Hilite Mouse Tracking.</td></tr><tr><td>l</td><td>No mouse reporting.</td></tr></table> <dt><strong><code>Pm = 1002</code></strong> (X11 XTerm)</dt>
1770<table><tr><td>h</td><td>Send Mouse X & Y on button press and release, and motion with a button pressed.</td></tr><tr><td>l</td><td>No mouse reporting.</td></tr></table> <dt><strong><code>Pm = 1003</code></strong> (X11 XTerm)</dt>
1771<table><tr><td>h</td><td>Send Mouse X & Y on button press and release, and motion.</td></tr><tr><td>l</td><td>No mouse reporting.</td></tr></table> <dt><strong><code>Pm = 1010</code></strong> (<strong>rxvt</strong>)</dt>
1762<table><tr><td>h</td><td>Don't scroll to bottom on TTY output</td></tr><tr><td>l</td><td>Scroll to bottom on TTY output</td></tr></table> <dt><strong><code>Pm = 1011</code></strong> (<strong>rxvt</strong>)</dt> 1772<table><tr><td>h</td><td>Don't scroll to bottom on TTY output</td></tr><tr><td>l</td><td>Scroll to bottom on TTY output</td></tr></table> <dt><strong><code>Pm = 1011</code></strong> (<strong>rxvt</strong>)</dt>
1763<table><tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr><tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr></table> <dt><strong><code>Pm = 1021</code></strong> (<strong>rxvt</strong>)</dt> 1773<table><tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr><tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr></table> <dt><strong><code>Pm = 1021</code></strong> (<strong>rxvt</strong>)</dt>
1764<table><tr><td>h</td><td>Bold/italic implies high intensity (see option -is)</td></tr><tr><td>l</td><td>Font styles have no effect on intensity (Compile styles)</td></tr></table> <dt><strong><code>Pm = 1047</code></strong></dt> 1774<table><tr><td>h</td><td>Bold/italic implies high intensity (see option -is)</td></tr><tr><td>l</td><td>Font styles have no effect on intensity (Compile styles)</td></tr></table> <dt><strong><code>Pm = 1047</code></strong></dt>
1765<table><tr><td>h</td><td>Use Alternate Screen Buffer</td></tr><tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr></table> <dt><strong><code>Pm = 1048</code></strong></dt> 1775<table><tr><td>h</td><td>Use Alternate Screen Buffer</td></tr><tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr></table> <dt><strong><code>Pm = 1048</code></strong></dt>
1766<table><tr><td>h</td><td>Save cursor position</td></tr><tr><td>l</td><td>Restore cursor position</td></tr></table> <dt><strong><code>Pm = 1049</code></strong></dt> 1776<table><tr><td>h</td><td>Save cursor position</td></tr><tr><td>l</td><td>Restore cursor position</td></tr></table> <dt><strong><code>Pm = 1049</code></strong></dt>
… …
1777 <dt><strong><code>ESC ] Ps;Pt ST</code></strong></dt> 1787 <dt><strong><code>ESC ] Ps;Pt ST</code></strong></dt>
1778 <dd> 1788 <dd>
1779 <p>Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b, 1789 <p>Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b,
17800x5c), backwards compatible terminator BEL (0x07) is also accepted. any 17900x5c), backwards compatible terminator BEL (0x07) is also accepted. any
1781<strong>octet</strong> can be escaped by prefixing it with SYN (0x16, ^V).</p> 1791<strong>octet</strong> can be escaped by prefixing it with SYN (0x16, ^V).</p>
1782<table><tr><td>Ps = 0</td><td>Change Icon Name and Window Title to Pt</td></tr><tr><td>Ps = 1</td><td>Change Icon Name to Pt</td></tr><tr><td>Ps = 2</td><td>Change Window Title to Pt</td></tr><tr><td>Ps = 3</td><td>If Pt starts with a ?, query the (STRING) property of the window and return it. If Pt contains a =, set the named property to the given value, else delete the specified property.</td></tr><tr><td>Ps = 4</td><td>Pt is a semi-colon separated sequence of one or more semi-colon separated number/name pairs, where number is an index to a colour and name is the name of a colour. Each pair causes the numbered colour to be changed to name. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white</td></tr><tr><td>Ps = 10</td><td>Change colour of text foreground to Pt (NB: may change in future)</td></tr><tr><td>Ps = 11</td><td>Change colour of text background to Pt (NB: may change in future)</td></tr><tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr><tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr><tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr><tr><td>Ps = 18</td><td>Change colour of bold characters to Pt [deprecated, see 706]</td></tr><tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt [deprecated, see 707]</td></tr><tr><td>Ps = 20</td><td>Change background pixmap parameters (see section XPM) (Compile XPM).</td></tr><tr><td>Ps = 39</td><td>Change default foreground colour to Pt.</td></tr><tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr><tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr><tr><td>Ps = 50</td><td>Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n</td></tr><tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr><tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).</td></tr><tr><td>Ps = 702</td><td>Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST.</td></tr><tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr><tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr><tr><td>Ps = 706</td><td>Change colour of bold characters to Pt</td></tr><tr><td>Ps = 707</td><td>Change colour of underlined characters to Pt</td></tr><tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr><tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr><tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr><tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr><tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr><tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr><tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr></table> </dd> 1792<table><tr><td>Ps = 0</td><td>Change Icon Name and Window Title to Pt</td></tr><tr><td>Ps = 1</td><td>Change Icon Name to Pt</td></tr><tr><td>Ps = 2</td><td>Change Window Title to Pt</td></tr><tr><td>Ps = 3</td><td>If Pt starts with a ?, query the (STRING) property of the window and return it. If Pt contains a =, set the named property to the given value, else delete the specified property.</td></tr><tr><td>Ps = 4</td><td>Pt is a semi-colon separated sequence of one or more semi-colon separated number/name pairs, where number is an index to a colour and name is the name of a colour. Each pair causes the numbered colour to be changed to name. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white</td></tr><tr><td>Ps = 10</td><td>Change colour of text foreground to Pt (NB: may change in future)</td></tr><tr><td>Ps = 11</td><td>Change colour of text background to Pt (NB: may change in future)</td></tr><tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr><tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr><tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr><tr><td>Ps = 18</td><td>Change colour of bold characters to Pt [deprecated, see 706]</td></tr><tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt [deprecated, see 707]</td></tr><tr><td>Ps = 20</td><td>Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage).</td></tr><tr><td>Ps = 39</td><td>Change default foreground colour to Pt.</td></tr><tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr><tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr><tr><td>Ps = 50</td><td>Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n</td></tr><tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr><tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).</td></tr><tr><td>Ps = 702</td><td>Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST.</td></tr><tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr><tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr><tr><td>Ps = 706</td><td>Change colour of bold characters to Pt</td></tr><tr><td>Ps = 707</td><td>Change colour of underlined characters to Pt</td></tr><tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr><tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr><tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr><tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr><tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr><tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr><tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr></table> </dd>
1783</dl> 1793</dl>
1784 1794
1785</div> 1795</div>
1786<h1 id="XPM">XPM</h1><p><a href="#TOP" class="toplink">Top</a></p> 1796<h1 id="BACKGROUND_IMAGE">BACKGROUND IMAGE</h1><p><a href="#TOP" class="toplink">Top</a></p>
1787<div id="XPM_CONTENT"> 1797<div id="BACKGROUND_IMAGE_CONTENT">
1788<p>For the XPM XTerm escape sequence <strong><code>ESC ] 20 ; Pt ST</code></strong> then value 1798<p>For the BACGROUND IMAGE XTerm escape sequence <strong><code>ESC ] 20 ; Pt ST</code></strong> then value
1789of <strong><code>Pt</code></strong> can be the name of the background pixmap followed by a 1799of <strong><code>Pt</code></strong> can be the name of the background image file followed by a
1790sequence of scaling/positioning commands separated by semi-colons. The 1800sequence of scaling/positioning commands separated by semi-colons. The
1791scaling/positioning commands are as follows:</p> 1801scaling/positioning commands are as follows:</p>
1792<dl> 1802<dl>
1793 <dt>query scale/position</dt> 1803 <dt>query scale/position</dt>
1794 <dd> 1804 <dd>
… …
1819 <p><strong>0xH</strong> -&gt; <strong>H *= (H/100)</strong></p> 1829 <p><strong>0xH</strong> -&gt; <strong>H *= (H/100)</strong></p>
1820 </dd> 1830 </dd>
1821</dl> 1831</dl>
1822<p>For example:</p> 1832<p>For example:</p>
1823<dl> 1833<dl>
1824 <dt><strong>\E]20;funky\a</strong></dt> 1834 <dt><strong>\E]20;funky.jpg\a</strong></dt>
1825 <dd> 1835 <dd>
1826 <p>load <strong>funky.xpm</strong> as a tiled image</p> 1836 <p>load <strong>funky.jpg</strong> as a tiled image</p>
1827 </dd> 1837 </dd>
1828 <dt><strong>\E]20;mona;100\a</strong></dt> 1838 <dt><strong>\E]20;mona.jpg;100\a</strong></dt>
1829 <dd> 1839 <dd>
1830 <p>load <strong>mona.xpm</strong> with a scaling of 100%</p> 1840 <p>load <strong>mona.jpg</strong> with a scaling of 100%</p>
1831 </dd> 1841 </dd>
1832 <dt><strong>\E]20;;200;?\a</strong></dt> 1842 <dt><strong>\E]20;;200;?\a</strong></dt>
1833 <dd> 1843 <dd>
1834 <p>rescale the current pixmap to 200% and display the image geometry in 1844 <p>rescale the current pixmap to 200% and display the image geometry in
1835the title</p> 1845the title</p>
… …
1872</div> 1882</div>
1873<h1 id="CONFIGURE_OPTIONS">CONFIGURE OPTIONS</h1><p><a href="#TOP" class="toplink">Top</a></p> 1883<h1 id="CONFIGURE_OPTIONS">CONFIGURE OPTIONS</h1><p><a href="#TOP" class="toplink">Top</a></p>
1874<div id="CONFIGURE_OPTIONS_CONTENT"> 1884<div id="CONFIGURE_OPTIONS_CONTENT">
1875<p>General hint: if you get compile errors, then likely your configuration 1885<p>General hint: if you get compile errors, then likely your configuration
1876hasn't been tested well. Either try with <code>--enable-everything</code> or use 1886hasn't been tested well. Either try with <code>--enable-everything</code> or use
1877the default configuration (i.e. <code>--enable-xxx</code> or <code>--disable-xxx</code>). Of 1887the default configuration (i.e. no <code>--enable-xxx</code> or <code>--disable-xxx</code>
1878course, you should always report when a combination doesn't work, so it 1888switches). Of course, you should always report when a combination doesn't
1879can be fixed. Marc Lehmann &lt;rxvt@schmorp.de&gt;.</p> 1889work, so it can be fixed. Marc Lehmann &lt;rxvt@schmorp.de&gt;.</p>
1880<p>All</p> 1890<p>All</p>
1881<dl> 1891<dl>
1882 <dt>--enable-everything</dt> 1892 <dt>--enable-everything</dt>
1883 <dd> 1893 <dd>
1884 <p>Add (or remove) support for all non-multichoice options listed in &quot;./configure 1894 <p>Add (or remove) support for all non-multichoice options listed in &quot;./configure
… …
1976 <dd> 1986 <dd>
1977 <p>Write user and tty to lastlog file (used by programs like 1987 <p>Write user and tty to lastlog file (used by programs like
1978<cite>lastlogin</cite>) at start of rxvt execution. This option requires 1988<cite>lastlogin</cite>) at start of rxvt execution. This option requires
1979--enable-utmp to also be specified.</p> 1989--enable-utmp to also be specified.</p>
1980 </dd> 1990 </dd>
1981 <dt>--enable-xpm-background (default: on)</dt>
1982 <dd>
1983 <p>Add support for XPM background pixmaps.</p>
1984 </dd>
1985 <dt>--enable-afterimage (default: on)</dt> 1991 <dt>--enable-afterimage (default: on)</dt>
1986 <dd> 1992 <dd>
1987 <p>Add support for libAfterImage to be used for transparency and background 1993 <p>Add support for libAfterImage to be used for transparency and background
1988images. It adds support for many file formats including JPG, PNG, 1994images. It adds support for many file formats including JPG, PNG,
1989SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep image XML 1995SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep image XML
1990(<a href="http://www.afterstep.org/visualdoc.php?show=asimagexml">http://www.afterstep.org/visualdoc.php?show=asimagexml</a>).</p> 1996(<a href="http://www.afterstep.org/visualdoc.php?show=asimagexml">http://www.afterstep.org/visualdoc.php?show=asimagexml</a>).</p>
1991 <p>This option also adds such eye candy as blending an image over the root 1997 <p>This option also adds such eye candy as blending an image over the root
1992background, as well as dynamic scaling and bluring of background images.</p> 1998background, as well as dynamic scaling and bluring of background images.</p>
1993 <p>Note that with this option enabled, rxvt's memory footprint might 1999 <p>Note that with this option enabled, urxvt's memory footprint might
1994increase by a few megabytes even if no extra features are used (mostly due 2000increase by a few megabytes even if no extra features are used (mostly due
1995to third-party libraries used by libAI). Memory footprint may somewhat be 2001to third-party libraries used by libAI). Memory footprint may somewhat be
1996lowered if libAfterImage is configured without support for SVG.</p> 2002lowered if libAfterImage is configured without support for SVG.</p>
1997 </dd> 2003 </dd>
1998 <dt>--enable-transparency (default: on)</dt> 2004 <dt>--enable-transparency (default: on)</dt>
… …
2001transparency to the term.</p> 2007transparency to the term.</p>
2002 </dd> 2008 </dd>
2003 <dt>--enable-fading (default: on)</dt> 2009 <dt>--enable-fading (default: on)</dt>
2004 <dd> 2010 <dd>
2005 <p>Add support for fading the text when focus is lost.</p> 2011 <p>Add support for fading the text when focus is lost.</p>
2006 </dd>
2007 <dt>--enable-tinting (default: on)</dt>
2008 <dd>
2009 <p>Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>).</p>
2010 </dd> 2012 </dd>
2011 <dt>--enable-rxvt-scroll (default: on)</dt> 2013 <dt>--enable-rxvt-scroll (default: on)</dt>
2012 <dd> 2014 <dd>
2013 <p>Add support for the original rxvt scrollbar.</p> 2015 <p>Add support for the original rxvt scrollbar.</p>
2014 </dd> 2016 </dd>
… …
2089 2091
2090</pre> 2092</pre>
2091 </dd> 2093 </dd>
2092 <dt>--enable-iso14755 (default: on)</dt> 2094 <dt>--enable-iso14755 (default: on)</dt>
2093 <dd> 2095 <dd>
2094 <p>Enable extended ISO 14755 support (see rxvt(1), or 2096 <p>Enable extended ISO 14755 support (see urxvt(1), or
2095<cite>doc/rxvt.1.txt</cite>). Basic support (section 5.1) is enabled by 2097<cite>doc/rxvt.1.txt</cite>). Basic support (section 5.1) is enabled by
2096<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with 2098<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with
2097this switch.</p> 2099this switch.</p>
2098 </dd> 2100 </dd>
2099 <dt>--enable-keepscrolling (default: on)</dt> 2101 <dt>--enable-keepscrolling (default: on)</dt>
… …
2126 <dd> 2128 <dd>
2127 <p>Add support to have the pointer disappear when typing or inactive.</p> 2129 <p>Add support to have the pointer disappear when typing or inactive.</p>
2128 </dd> 2130 </dd>
2129 <dt>--enable-perl (default: on)</dt> 2131 <dt>--enable-perl (default: on)</dt>
2130 <dd> 2132 <dd>
2131 <p>Enable an embedded perl interpreter. See the <strong>rxvtperl(3)</strong> 2133 <p>Enable an embedded perl interpreter. See the <strong>urxvtperl(3)</strong>
2132manpage (<cite>doc/rxvtperl.txt</cite>) for more info on this feature, or the 2134manpage (<cite>doc/rxvtperl.txt</cite>) for more info on this feature, or the
2133files in <cite>src/perl-ext/</cite> for the extensions that are installed by 2135files in <cite>src/perl-ext/</cite> for the extensions that are installed by
2134default. The perl interpreter that is used can be specified via the 2136default. The perl interpreter that is used can be specified via the
2135<code>PERL</code> environment variable when running configure. Even when compiled 2137<code>PERL</code> environment variable when running configure. Even when compiled
2136in, perl will <i>not</i> be initialised when all extensions have been disabled 2138in, perl will <i>not</i> be initialised when all extensions have been disabled
… …
2158 </dd> 2160 </dd>
2159 <dt>--with-x</dt> 2161 <dt>--with-x</dt>
2160 <dd> 2162 <dd>
2161 <p>Use the X Window System (pretty much default, eh?).</p> 2163 <p>Use the X Window System (pretty much default, eh?).</p>
2162 </dd> 2164 </dd>
2163 <dt>--with-xpm-includes=DIR</dt>
2164 <dd>
2165 <p>Look for the XPM includes in DIR.</p>
2166 </dd>
2167 <dt>--with-xpm-library=DIR</dt>
2168 <dd>
2169 <p>Look for the XPM library in DIR.</p>
2170 </dd>
2171 <dt>--with-xpm</dt>
2172 <dd>
2173 <p>Not needed - define via --enable-xpm-background.</p>
2174 </dd>
2175</dl> 2165</dl>
2176 2166
2177</div> 2167</div>
2178<h1 id="AUTHORS">AUTHORS</h1><p><a href="#TOP" class="toplink">Top</a></p> 2168<h1 id="AUTHORS">AUTHORS</h1><p><a href="#TOP" class="toplink">Top</a></p>
2179<div id="AUTHORS_CONTENT"> 2169<div id="AUTHORS_CONTENT">

Diff Legend

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