You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1281 lines
37 KiB
1281 lines
37 KiB
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN"> |
|
<!-- |
|
don't use Netscape to edit this file, since it has some stange ideas of |
|
formatting that makes later global/change/replace difficult, |
|
but it is okay for making the text version of this document |
|
--> |
|
<HTML> |
|
<HEAD> |
|
<TITLE> |
|
Rxvt Technical Reference |
|
</TITLE> |
|
<META NAME="Author" CONTENT="mj olesen <olesen@me.queensu.ca>"> |
|
<META NAME="Description" CONTENT="Documentation of VT, XTerm, and other escape sequences used by rxvt."> |
|
</HEAD> |
|
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#0000FF" VLINK="#0000FF" ALINK="#FF0000"> |
|
<HR> |
|
<CENTER> |
|
<H1><A NAME="Top">Rxvt Technical Reference</A></H1> |
|
Reworked from XTerm documentation and other sources<BR> |
|
<P> |
|
<A TARGET="_top" HREF="refer.html">[No]</A> |
|
<A TARGET="_top" HREF="refer-frame.html">Frames</A> |
|
<HR> |
|
</CENTER> |
|
<UL> |
|
<LI><A HREF="#Definitions">Definitions</A></LI> |
|
<LI><A HREF="#Values">Values</A></LI> |
|
<LI><A HREF="#Sequences">Escape Sequences</A></LI> |
|
<LI><A HREF="#CSI">CSI (Code Sequence Introducer) Sequences</A></LI> |
|
<LI><A HREF="#PrivateModes">DEC Private Modes</A></LI> |
|
<LI><A HREF="#XTerm">XTerm Escape Sequences</A></LI> |
|
<LI><A HREF="#menuBar">menuBar</A></LI> |
|
<LI><A HREF="#XPM">XPM</A></LI> |
|
<LI><A HREF="#Mouse">Mouse Reporting</A></LI> |
|
<LI><A HREF="#Graphics">Special Graphics Mode</A></LI> |
|
<LI><A HREF="#KeyCodes">Key Codes</A></LI> |
|
</UL> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="Definitions">Definitions</A></H2> |
|
<P> |
|
|
|
<DL><DT><B><TT>c</TT></B></DT><DD>The literal character c.</DD></DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>C</TT></B></DT><DD>A single (required) character.</DD></DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>Ps</TT></B></DT> |
|
<DD>A single (usually optional) numeric parameter, |
|
composed of one or more digits.</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>Pm</TT></B></DT> |
|
<DD>A multiple numeric parameter composed of any number of single numeric |
|
parameters, separated by ; character(s).</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>Pt</TT></B></DT> |
|
<DD>A text parameter composed of printable characters.</DD> |
|
</DL> |
|
<P> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="Values">Values</A></H2> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ENQ</TT></B></DT> |
|
<DD>Enquiry (Ctrl-E) = Send Device Attributes (DA)<BR> |
|
request attributes from terminal |
|
== <A HREF="#ESC[Psc"><B><TT>ESC[c</TT></B></A> |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>BEL</TT></B></DT><DD>Bell (Ctrl-G)</DD></DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>BS</TT></B></DT><DD>Backspace (Ctrl-H)</DD></DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>TAB</TT></B></DT><DD>Horizontal Tab (HT) (Ctrl-I)</DD></DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>LF</TT></B></DT><DD>Line Feed or New Line (NL) (Ctrl-J)</DD></DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>VT</TT></B></DT> |
|
<DD>Vertical Tab (Ctrl-K) same as <B><TT>LF</TT></B></DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>FF</TT></B></DT> |
|
<DD>Form Feed or New Page (NP) (Ctrl-L) same as <B><TT>LF</TT></B></DD> |
|
</DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>CR</TT></B></DT><DD>Carriage Return (Ctrl-M)</DD></DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>SO</TT></B></DT> |
|
<DD>Shift Out (Ctrl-N), invokes the G1 character set<BR> |
|
Switch to Alternate Character Set</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>SI</TT></B></DT> |
|
<DD>Shift In (Ctrl-O), invokes the G0 character set (the default)<BR> |
|
Switch to Standard Character Set</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>SPC</TT></B></DT><DD>Space Character</DD></DL> |
|
<P> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="Sequences">Escape Sequences</A></H2> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC # 8</TT></B></DT> |
|
<DD>DEC Screen Alignment Test (DECALN)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT> |
|
ESC 7<BR> |
|
ESC 8 |
|
</TT></B></DT> |
|
<DD> |
|
Save Cursor (SC)<BR> |
|
Restore Cursor (RC) |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<A NAME="ESC="></A> |
|
<DT><B><TT> |
|
ESC =<BR> |
|
ESC > |
|
</TT></B></DT> |
|
<DD> |
|
Application Keypad (SMKX) == |
|
<A HREF="#Priv66"><B><TT>ESC[?66h</TT></B></A><BR> |
|
Normal Keypad (RMKX) == |
|
<A HREF="#Priv66"><B><TT>ESC[?66l</TT></B></A> |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<B>Note:</B> |
|
If the numeric keypad is activated, eg, <B>Num_Lock</B> has been pressed, |
|
numbers or control functions are generated by the numeric keypad (see |
|
<A HREF="#KeyCodes">Key Codes</A>) |
|
<P> |
|
|
|
<DL><DT><B><TT>ESC D</TT></B></DT><DD>Index (IND)</DD></DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>ESC E</TT></B></DT><DD>Next Line (NEL)</DD></DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>ESC H</TT></B></DT><DD>Tab Set (HTS)</DD></DL> |
|
<P> |
|
|
|
<DL><DT><B><TT>ESC M</TT></B></DT><DD>Reverse Index (RI)</DD></DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC N</TT></B></DT> |
|
<DD>Single Shift Select of G2 Character Set (SS2): affects next character only |
|
<B><U>unimplemented</B></U> |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC O</TT></B></DT> |
|
<DD>Single Shift Select of G3 Character Set (SS3): affects next character only |
|
<B><U>unimplemented</U></B> |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC Z</TT></B></DT> |
|
<DD>Obsolete form of <A HREF="#ESC[Psc"><B><TT>ESC[c</TT></B></A><BR> |
|
returns: <B><TT>ESC[?1;2C</TT></B> (<B><U>rxvt compile-time option</U></B>) |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC c</TT></B></DT> |
|
<DD>Full Reset (RIS)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC n</TT></B></DT> |
|
<DD>Invoke the G2 Character Set (LS2)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC o</TT></B></DT> |
|
<DD>Invoke the G3 Character Set (LS3)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT> |
|
ESC ( C<BR> |
|
ESC ) C<BR> |
|
ESC * C<BR> |
|
ESC + C<BR> |
|
ESC $ C |
|
</TT></B></DT> |
|
<DD> |
|
Designate G0 Character Set (ISO 2022)<BR> |
|
Designate G1 Character Set (ISO 2022)<BR> |
|
Designate G2 Character Set (ISO 2022)<BR> |
|
Designate G3 Character Set (ISO 2022)<BR> |
|
Designate Kanji Character Set<BR> |
|
<EM>where</EM> <B><TT>C</TT></B> is<BR> |
|
<UL> |
|
<B><TT>C = 0</TT></B> : DEC Special Character and Line Drawing Set<BR> |
|
<B><TT>C = A</TT></B> : United Kingdom (UK)<BR> |
|
<B><TT>C = B</TT></B> : United States (USASCII)<BR> |
|
<B><TT>C = <</TT></B> : Multinational character set <B><U>unimplemented</U></B><BR> |
|
<B><TT>C = 5</TT></B> : Finnish character set <B><U>unimplemented</U></B><BR> |
|
<B><TT>C = C</TT></B> : Finnish character set <B><U>unimplemented</U></B><BR> |
|
<B><TT>C = K</TT></B> : German character set <B><U>unimplemented</U></B> |
|
</UL> |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="CSI">CSI (Code Sequence Introducer) Sequences</A></H2> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps @</TT></B></DT> |
|
<DD>Insert <B><TT>Ps</TT></B> (Blank) Character(s) [default: 1] (ICH)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<A NAME="ESC[PsA"></A> |
|
<DT><B><TT>ESC [ Ps A</TT></B></DT> |
|
<DD>Cursor Up <B><TT>Ps</TT></B> Times [default: 1] (CUU)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps B</TT></B></DT> |
|
<DD>Cursor Down <B><TT>Ps</TT></B> Times [default: 1] (CUD) |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<A NAME="ESC[PsC"></A> |
|
<DT><B><TT>ESC [ Ps C</TT></B></DT> |
|
<DD>Cursor Forward <B><TT>Ps</TT></B> Times [default: 1] (CUF)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps D</TT></B></DT> |
|
<DD>Cursor |
|
Backward <B><TT>Ps</TT></B> Times [default: 1] (CUB)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps E</TT></B></DT> |
|
<DD>Cursor Down <B><TT>Ps</TT></B> Times [default: 1] and to first column</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps F</TT></B></DT> |
|
<DD>Cursor Up <B><TT>Ps</TT></B> Times [default: 1] and to first column</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<A NAME="ESC[PsG"></A> |
|
<DT><B><TT>ESC [ Ps G</TT></B></DT> |
|
<DD>Cursor to Column <B><TT>Ps</TT></B> (HPA)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps;Ps H</TT></B></DT> |
|
<DD>Cursor Position [row;column] [default: 1;1] (CUP)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps I</TT></B></DT> |
|
<DD>Move forward <B><TT>Ps</TT></B> tab stops [default: 1]</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps J</TT></B></DT> |
|
<DD>Erase in Display (ED)<BR> |
|
<B><TT>Ps = 0</TT></B> : Clear Below (default)<BR> |
|
<B><TT>Ps = 1</TT></B> : Clear Above<BR> |
|
<B><TT>Ps = 2</TT></B> : Clear All</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps K</TT></B></DT> |
|
<DD>Erase in Line (EL)<BR> |
|
<B><TT>Ps = 0</TT></B> : Clear to Right (default)<BR> |
|
<B><TT>Ps = 1</TT></B> : Clear to Left (EL1)<BR> |
|
<B><TT>Ps = 2</TT></B> : Clear All</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps L</TT></B></DT> |
|
<DD>Insert <B><TT>Ps</TT></B> Line(s) [default: 1] (IL)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps M</TT></B></DT> |
|
<DD>Delete <B><TT>Ps</TT></B> Line(s) [default: 1] (DL)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps P</TT></B></DT> |
|
<DD>Delete <B><TT>Ps</TT></B> Character(s) |
|
[default: 1] (DCH)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps;Ps;Ps;Ps;Ps T</TT></B></DT> |
|
<DD>Initiate <A HREF="#Mouse">hilite mouse tracking</A>. |
|
<B><U>unimplemented</U></B><BR> |
|
Parameters are [func;startx;starty;firstrow;lastrow].</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps W</TT></B></DT> |
|
<DD>Tabulator functions<BR> |
|
<B><TT>Ps = 0</TT></B> : Tab Set (HTS)<BR> |
|
<B><TT>Ps = 2</TT></B> : Tab Clear (TBC), Clear Current Column (default)<BR> |
|
<B><TT>Ps = 5</TT></B> : Tab Clear (TBC), Clear All</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps X</TT></B></DT> |
|
<DD>Erase <B><TT>Ps</TT></B> Character(s) [default: 1] (ECH)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps Z</TT></B></DT> |
|
<DD>Move backward <B><TT>Ps</TT></B> [default: 1] tab stops</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps '</TT></B></DT> |
|
<DD>== <A HREF="#ESC[PsG"><B><TT>ESC [ Ps G</TT></B></A></DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps a</TT></B></DT> |
|
<DD>== <A HREF="#ESC[PsC"><B><TT>ESC [ Ps C</TT></B></A></DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<A NAME="ESC[Psc"></A> |
|
<DT><B><TT>ESC [ Ps c</TT></B></DT> |
|
<DD>Send Device Attributes (DA)<BR> |
|
<B><TT>Ps = 0</TT></B> (or omitted) : request attributes from terminal<BR> |
|
returns: <B><TT>ESC[?1;2c</TT></B> (``I am a VT100 with Advanced Video Option'')</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps d</TT></B></DT> |
|
<DD>Cursor to Line <B><TT>Ps</TT></B> (VPA)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps e</TT></B></DT> |
|
<DD>== <A HREF="#ESC[PsA"><B><TT>ESC [ Ps A</TT></B></A></DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps;Ps f</TT></B></DT> |
|
<DD>Horizontal and Vertical Position [row;column] (HVP)<BR> |
|
[default: 1;1]</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps g</TT></B></DT> |
|
<DD>Tab Clear (TBC)<BR> |
|
<B><TT>Ps = 0</TT></B> : Clear Current Column (default)<BR> |
|
<B><TT>Ps = 3</TT></B> : Clear All (TBC) |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps i</TT></B></DT> |
|
<DD>Printing<BR> |
|
<B><TT>Ps = 4</TT></B> : disable transparent print mode (MC4)<BR> |
|
<B><TT>Ps = 5</TT></B> : enable transparent print mode (MC5) |
|
<B><U>unimplemented</U></B> |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT> |
|
ESC [ Pm h<BR> |
|
ESC [ Pm l |
|
</TT></B> |
|
<DD>Set Mode (SM)<BR> |
|
Reset Mode (RM)</DD> |
|
<DT><B><TT>Ps = 4</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Insert Mode (SMIR)<BR> |
|
<B><TT>l</TT></B> : Replace Mode (RMIR) |
|
</DD> |
|
<DT><B><TT>Ps = 20</TT></B> <B><U>unimplemented</U></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Automatic Newline (LNM)<BR> |
|
<B><TT>l</TT></B> : Normal Linefeed (LNM) |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Pm m</TT></B></DT> |
|
<DD>Character Attributes (SGR) </BR> |
|
<B><TT>Ps = 0</TT></B> : Normal (default)<BR> |
|
<B><TT>Ps = 1 / 22</TT></B> : On / Off Bold (bright fg)<BR> |
|
<B><TT>Ps = 4 / 24</TT></B> : On / Off Underline<BR> |
|
<B><TT>Ps = 5 / 25</TT></B> : On / Off Blink (bright bg)<BR> |
|
<B><TT>Ps = 7 / 27</TT></B> : On / Off Inverse<BR> |
|
<B><TT>Ps = 30 / 40</TT></B> : fg / bg Black<BR> |
|
<B><TT>Ps = 31 / 41</TT></B> : fg / bg Red<BR> |
|
<B><TT>Ps = 32 / 42</TT></B> : fg / bg Green<BR> |
|
<B><TT>Ps = 33 / 43</TT></B> : fg / bg Yellow<BR> |
|
<B><TT>Ps = 34 / 44</TT></B> : fg / bg Blue<BR> |
|
<B><TT>Ps = 35 / 45</TT></B> : fg / bg Magenta<BR> |
|
<B><TT>Ps = 36 / 46</TT></B> : fg / bg Cyan<BR> |
|
<B><TT>Ps = 37 / 47</TT></B> : fg / bg White<BR> |
|
<B><TT>Ps = 39 / 49</TT></B> : fg / bg Default</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps n</TT></B></DT> |
|
<DD>Device Status Report (DSR)<BR> |
|
<B><TT>Ps = 5</TT></B> : Status Report <B><TT>ESC [ 0 n</TT></B> (``OK'')<BR> |
|
<B><TT>Ps = 6</TT></B> : Report Cursor Position (CPR) [row;column] as |
|
<B><TT>ESC [ r ; c R</TT></B><BR> |
|
<B><TT>Ps = 7</TT></B> : Request Display Name<BR> |
|
<B><TT>Ps = 8</TT></B> : Request Version Number (place in window title) |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps;Ps r</TT></B></DT> |
|
<DD>Set Scrolling Region [top;bottom]<BR> |
|
[default: full size of window] (CSR)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ Ps x</TT></B></DT> |
|
<DD>Request Terminal Parameters (DECREQTPARM) |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="PrivateModes">DEC Private Modes</A></H2> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ ? Pm h</TT></B></DT> |
|
<DD>DEC Private Mode Set (DECSET)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ ? Pm l</TT></B></DT> |
|
<DD>DEC Private Mode Reset (DECRST)</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ ? Pm r</TT></B></DT> |
|
<DD>Restore previously saved DEC Private Mode Values.</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ ? Pm s</TT></B></DT> |
|
<DD>Save DEC Private Mode Values.</DD> |
|
</DL> |
|
|
|
<P> |
|
<DL> |
|
<DT><B><TT>ESC [ ? Pm t</TT></B></DT> |
|
<DD>Toggle DEC Private Mode Values (rxvt extension).</DD> |
|
</DL> |
|
<P> |
|
|
|
<EM>where</EM> |
|
<P> |
|
|
|
<DL> |
|
<DD> |
|
<DT><B><TT>Ps = 1</TT></B> (DECCKM)</DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Application Cursor Keys<BR> |
|
<B><TT>l</TT></B> : Normal Cursor Keys |
|
</DD> |
|
<DT><B><TT>Ps = 2</TT></B> <B><U>unimplemented</U></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Designate USASCII for character sets G0-G3. |
|
</DD> |
|
<DT><B><TT>Ps = 3</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : 132 Column Mode (DECCOLM)<BR> |
|
<B><TT>l</TT></B> : 80 Column Mode (DECCOLM) |
|
</DD> |
|
<DT><B><TT>Ps = 4</TT></B> <B><U>unimplemented</U></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Smooth (Slow) Scroll (DECSCLM)<BR> |
|
<B><TT>l</TT></B> : Jump (Fast) Scroll (DECSCLM) |
|
</DD> |
|
<DT><B><TT>Ps = 5</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Reverse Video (DECSCNM)<BR> |
|
<B><TT>l</TT></B> : Normal Video (DECSCNM) |
|
</DD> |
|
<DT><B><TT>Ps = 6</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Origin Mode (DECOM)<BR> |
|
<B><TT>l</TT></B> : Normal Cursor Mode (DECOM) |
|
</DD> |
|
<DT><B><TT>Ps = 7</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Wraparound Mode (DECAWM)<BR> |
|
<B><TT>l</TT></B> : No Wraparound Mode (DECAWM) |
|
</DD> |
|
<DT><B><TT>Ps = 8</TT></B> <B><U>unimplemented</U></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Auto-repeat Keys (DECARM)<BR> |
|
<B><TT>l</TT></B> : No Auto-repeat Keys (DECARM) |
|
</DD> |
|
<DT><B><TT>Ps = 9</TT></B> (X10 XTerm <A HREF="#Mouse">mouse reporting</A>)</DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Send Mouse X & Y on button press.<BR> |
|
<B><TT>l</TT></B> : No mouse reporting. |
|
</DD> |
|
<A NAME="Priv10"></A> |
|
<DT><B><TT>Ps = 10</TT></B> (<B><U>rxvt</U></B>)</DT> |
|
<DD> |
|
<B><TT>h</TT></B> : <A HREF="#menuBar">menuBar</A> visisble<BR> |
|
<B><TT>l</TT></B> : <A HREF="#menuBar">menuBar</A> invisisble |
|
</DD> |
|
<DT><B><TT>Ps = 25</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Visible cursor {cnorm/cvvis}<BR> |
|
<B><TT>l</TT></B> : Invisible cursor {civis} |
|
</DD> |
|
<DT><B><TT>Ps = 30</TT></B> (<B><U>rxvt</U></B>)</DT> |
|
<DD> |
|
<B><TT>h</TT></B> : scrollBar visisble<BR> |
|
<B><TT>l</TT></B> : scrollBar invisisble |
|
</DD> |
|
<DT><B><TT>Ps = 35</TT></B> (<B><U>rxvt</U></B>)</DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Allow XTerm Shift+key sequences<BR> |
|
<B><TT>l</TT></B> : Disallow XTerm Shift+key sequences |
|
</DD> |
|
<DT><B><TT>Ps = 38</TT></B> : Enter Tektronix Mode (DECTEK) |
|
<B><U>unimplemented</U></B></DT> |
|
<DD> |
|
</DD> |
|
<DT><B><TT>Ps = 40</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Allow 80/132 Mode<BR> |
|
<B><TT>l</TT></B> : Disallow 80/132 Mode |
|
</DD> |
|
<DT><B><TT>Ps = 44</TT></B> <B><U>unimplemented</U></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Turn On Margin Bell<BR> |
|
<B><TT>l</TT></B> : Turn Off Margin Bell |
|
</DD> |
|
<DT><B><TT>Ps = 45</TT></B> <B><U>unimplemented</U></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Reverse-wraparound Mode<BR> |
|
<B><TT>l</TT></B> : No Reverse-wraparound Mode |
|
</DD> |
|
<DT><B><TT>Ps = 46</TT></B> <B><U>unimplemented</U></B></DT> |
|
<DT><B><TT>Ps = 47</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Use Alternate Screen Buffer<BR> |
|
<B><TT>l</TT></B> : Use Normal Screen Buffer |
|
</DD> |
|
<A NAME="Priv66"></A> |
|
<DT><B><TT>Ps = 66</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Application Keypad (DECPAM) |
|
== <A HREF="#ESC="><B><TT>ESC =</TT></B></A><BR> |
|
<B><TT>l</TT></B> : Normal Keypad (DECPNM) |
|
== <A HREF="#ESC="><B><TT>ESC ></TT></B></A> |
|
</DD> |
|
<DT><B><TT>Ps = 67</TT></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Backspace key sends <B><TT>BS</TT></B> (DECBKM)<BR> |
|
<B><TT>l</TT></B> : Backspace key sends <B><TT>DEL</TT></B> |
|
</DD> |
|
<DT><B><TT>Ps = 1000</TT></B> (X11 XTerm <A HREF="#Mouse">mouse reporting</A>)</DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Send Mouse X & Y on button press and release.<BR> |
|
<B><TT>l</TT></B> : No mouse reporting. |
|
</DD> |
|
<DT><B><TT>Ps = 1001</TT></B> (X11 XTerm <A HREF="#Mouse">mouse Tracking</A>) <B><U>unimplemented</U></B></DT> |
|
<DD> |
|
<B><TT>h</TT></B> : Use Hilite Mouse Tracking.<BR> |
|
<B><TT>l</TT></B> : No mouse reporting. |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="XTerm">XTerm Escape Sequences</A></H2> |
|
|
|
<DL> |
|
<DT><B><TT>ESC ] Ps;Pt BEL</TT></B></DT> |
|
<DD>Set XTerm Parameters</DD> |
|
<DT><B><TT>Ps = 0</TT></B></DT> |
|
<DD>Change Icon Name and Window Title to <B><TT>Pt</TT></B></DD> |
|
<DT><B><TT>Ps = 1</TT></B></DT> |
|
<DD>Change Icon Name to <B><TT>Pt</TT></B></DD> |
|
<DT><B><TT>Ps = 2</TT></B></DT> |
|
<DD>Change Window Title to <B><TT>Pt</TT></B></DD> |
|
<DT><B><TT>Ps = 10</TT></B></DT> |
|
<DD><A HREF="#menuBar">menuBar</A> command <B><TT>Pt</TT></B> |
|
(<B><U>rxvt compile-time option</U></B>)</DD> |
|
<DT><B><TT>Ps = 20</TT></B></DT> |
|
<DD>Change default background <A HREF="#XPM">pixmap</A> to <B><TT>Pt</TT></B> |
|
(<B><U>rxvt compile-time option</U></B>) |
|
</DD> |
|
|
|
<DT><B><TT>Ps = 39</TT></B></DT> |
|
<DD>Change default foreground color to <B><TT>Pt</TT></B> |
|
(<B><U>rxvt compile-time option</U></B>)</DD> |
|
<DT><B><TT>Ps = 46</TT></B></DT> |
|
<DD>Change Log File to <B><TT>Pt</TT></B>(normally disabled by a compile-time option) <B><U>unimplemented</U></B></DD> |
|
<DT><B><TT>Ps = 49</TT></B></DT> |
|
<DD>Change default background color to <B><TT>Pt</TT></B> |
|
(<B><U>rxvt compile-time option</U></B>)</DD> |
|
<DT> |
|
<B><TT>Ps = 50</TT></B></DT> |
|
<DD>Set Font to <B><TT>Pt</TT></B>, with the following special values of <B><TT>Pt</TT></B> (<B><U>rxvt</U></B>)<BR> |
|
<B><TT>#+n</TT></B> : change up <B><TT>n</TT></B> font(s)<BR> |
|
<B><TT>#-n</TT></B> : change down <B><TT>n</TT></B> font(s)<BR> |
|
<UL>if <B><TT>n</TT></B> is missing or 0, a value of 1 is used</UL> |
|
<EM>empty</EM> : change to font0<BR> |
|
<B><TT>#n</TT></B> : change to font<B><TT>n</TT></B></DD> |
|
</DL> |
|
<P> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="menuBar">menuBar</A></H2> |
|
<P> |
|
|
|
<STRONG>The exact syntax used is <EM>almost</EM> solidified.</STRONG><BR> |
|
In the menus, <STRONG>DON'T</STRONG> try to use menuBar commands that |
|
add or remove a menuBar. |
|
<P> |
|
|
|
Note that in all of the commands, the <B><EM>/path/</EM></B> |
|
<EM>cannot</EM> be omitted: |
|
use <B>./</B> to specify a menu relative to the current menu. |
|
|
|
<H3>Overview of menuBar operation</H3> |
|
|
|
For the menuBar XTerm escape sequence <B><TT>ESC ] 10; Pt BEL</TT></B>, the |
|
syntax of <B><TT>Pt</TT></B> can be used for a variety of tasks: |
|
<UL COMPACT> |
|
<LI><A HREF="#menuBarCommands">Commands</A></LI> |
|
<LI><A HREF="#menuBarAdd">Adding and accessing menus</A></LI> |
|
<LI><A HREF="#menuBarRemove">Removing menus</A></LI> |
|
<LI><A HREF="#menuBarArrows">Quick Arrows</A></LI> |
|
<LI><A HREF="#menuBarSummary">Command Summary</A></LI> |
|
</UL> |
|
|
|
At the top level is the current menuBar which is a member of a |
|
circular linked-list of other such menuBars. |
|
|
|
The menuBar acts as a parent for the various drop-down menus, which in |
|
turn, may have labels, separator lines, menuItems and subMenus. |
|
|
|
The menuItems are the useful bits: you can use them to mimic keyboard |
|
input or even to send text or escape sequences back to rxvt. |
|
|
|
The menuBar syntax is intended to provide a simple yet robust method |
|
of constructing and manipulating menus and navigating through the |
|
menuBars. |
|
|
|
<P> |
|
The first step is to use the tag <B>[menu:<EM>name</EM>]</B> which |
|
creates the menuBar called <EM>name</EM> and allows access. |
|
You may now |
|
<A HREF="#menuBarAdd">add</A> or <A HREF="#menuBarRemove">remove</A> |
|
menus, subMenus, and menuItems. Finally, use the tag |
|
<B>[done]</B> to set the menuBar access as <B>readonly</B> |
|
to prevent accidental corruption of the menus. |
|
To re-access the current menuBar for alterations, use the tag |
|
<B>[menu]</B>, make the alterations and then use |
|
<B>[done]</B> |
|
<P> |
|
|
|
<H3><A HREF="#menuBar" NAME="menuBarCommands">Commands</A></H3> |
|
|
|
<DL > |
|
<DT><B>[menu:<EM>name</EM>]</B></DT> |
|
<DD> |
|
access the named menuBar for creation or alteration. |
|
If a new menuBar is created, it is called <EM>name</EM> (max of 15 chars) |
|
and the current menuBar is pushed onto the stack |
|
</DD> |
|
|
|
<DT><B>[menu]</B></DT> |
|
<DD>access the current menuBar for alteration</DD> |
|
|
|
<DT><B>[title:<EM>string</EM>]</B></DT> |
|
<DD> |
|
set the current menuBar's title to <EM>string</EM>, which may contain |
|
the following format specifiers:<BR> |
|
<B>%%</B> : literal <B>%</B> character<BR> |
|
<B>%n</B> : rxvt name (as per the <B>-name</B> command-line option)<BR> |
|
<B>%v</B> : rxvt version |
|
</DD> |
|
|
|
<DT><B>[done]</B></DT> |
|
<DD> |
|
set menuBar access as <B>readonly</B>.<BR> |
|
End-of-file tag for <B>[read:<EM>file</EM>]</B> operations. |
|
</DD> |
|
|
|
<DT><B>[read:<EM>file</EM>]</B></DT> |
|
<DD> |
|
read menu commands directly from <EM>file</EM> |
|
(extension ".menu" will be appended if required). |
|
Start reading at a line with <B>[menu]</B> or <B>[menu:<EM>name</EM>]</B> |
|
and continuing until <B>[done]</B> is encountered. |
|
<BR> |
|
Blank and comment lines (starting with <B>#</B>) are ignored. |
|
Actually, since any invalid menu commands are also ignored, almost |
|
anything could be construed as a comment line, but this may be |
|
tightened up in the future ... so don't count on it!. |
|
</DD> |
|
|
|
<DT><B>[read:<EM>file</EM>;<EM>name</EM>]</B></DT> |
|
<DD> |
|
The same as <B>[read:<EM>file</EM>]</B>, but |
|
start reading at a line with <B>[menu:<EM>name</EM>]</B> |
|
and continuing until <B>[done:<EM>name</EM>]</B> |
|
or <B>[done]</B> is encountered. |
|
</DD> |
|
|
|
<DT><B>[dump]</B></DT> |
|
<DD> |
|
dump all menuBars to the file <B>/tmp/rxvt-PID</B> in a format suitable |
|
for later rereading. |
|
</DD> |
|
|
|
<DT><B> |
|
[rm:name]<BR> |
|
[rm] [rm:]<BR> |
|
[rm*] [rm:*] |
|
</B></DT> |
|
<DD> |
|
remove the named menuBar<BR> |
|
remove the current menuBar<BR> |
|
remove all menuBars |
|
</DD> |
|
|
|
<DT><B>[swap]</B></DT> |
|
<DD>swap the top two menuBars</DD> |
|
|
|
<DT><B>[prev]<BR>[next]</B></DT> |
|
<DD>access the previous or next menuBar</DD> |
|
|
|
<DT><B>[show]<BR>[hide]</B></DT> |
|
<DD>control display of the menuBar ... just like |
|
<A HREF="#Priv10"><B>ESC[?10 h/l</B></A> |
|
</DD> |
|
|
|
<DT><B> |
|
[pixmap:<EM>name</EM>]<BR> |
|
[pixmap:<EM>name</EM>;<EM>scaling</EM>] |
|
</B></DT> |
|
<DD>set the background pixmap globally ... just like |
|
<A HREF="#XPM"><B>ESC]20; Pt BEL</B></A> |
|
<BR> |
|
<B>A Future implementation <EM>may</EM> make this local to the menubar</B> |
|
</DD> |
|
|
|
<DT><B>[:<EM>command</EM>:]</B></DT> |
|
<DD>ignore the menu readonly status and issue a <EM>command</EM> to |
|
<A HREF="#menuBarAdd">Add/Modify</A> or |
|
<A HREF="#menuBarRemove">Remove</A> a menu or menuitem or |
|
change the <A HREF="#menuBarArrows">Quick Arrows</A>; |
|
a useful shortcut for setting the quick arrows from a menuBar. |
|
</DD> |
|
</DL> |
|
|
|
<H3><A HREF="#menuBar" NAME="menuBarAdd">Adding and accessing menus</A></H3> |
|
|
|
The following commands may also be <B>+</B> prefixed. |
|
<DL> |
|
<DT><B>/<BR>./<BR>../<BR>../../</B></DT> |
|
<DD> |
|
access menuBar top level<BR> |
|
access current menu level<BR> |
|
access parent menu (1 level up)<BR> |
|
access parent menu (multiple levels up) |
|
</DD> |
|
|
|
<DT><B><EM>/path/</EM>menu</B></DT> |
|
<DD>add/access menu</DD> |
|
|
|
<DT><B><EM>/path/</EM>menu/*</B></DT> |
|
<DD>add/access menu and clear it if it exists</DD> |
|
|
|
<DT><B><EM>/path/</EM>{-}</B></DT> |
|
<DD>add separator</DD> |
|
|
|
<DT><B><EM>/path/</EM>{item}</B></DT> |
|
<DD>add <B>item</B> as a label</DD> |
|
|
|
<DT><B><EM>/path/</EM>{item} action</B></DT> |
|
<DD> |
|
add/alter <EM>menuitem</EM> with an associated <EM>action</EM> |
|
</DD> |
|
|
|
<DT><B><EM>/path/</EM>{item}{right-text}</B></DT> |
|
<DD> |
|
add/alter <EM>menuitem</EM> with <B>right-text</B> |
|
as the right-justified text and as the associated <EM>action</EM> |
|
</DD> |
|
|
|
<DT><B><EM>/path/</EM>{item}{rtext} action</B></DT> |
|
<DD> |
|
add/alter <EM>menuitem</EM> with an associated <EM>action</EM> |
|
and with <B>rtext</B> as the right-justified text. |
|
</DD> |
|
</DL> |
|
|
|
<DL> |
|
<DT>Special characters in <EM>action</EM> must be backslash-escaped:</DT> |
|
<DD><B>\a \b \E \e \n \r \t \octal</B></DD> |
|
<DT>or in control-character notation:</DT> |
|
<DD><B>^@, ^A .. ^Z .. ^_, ^?</B></DD> |
|
</DL> |
|
|
|
To send a string starting with a <B>NUL</B> (<B>^@</B>) |
|
character to the program, start <EM>action</EM> with a pair of |
|
<B>NUL</B> characters (<B>^@^@</B>), |
|
the first of which will be stripped off and the balance directed to |
|
the program. |
|
Otherwise if <EM>action</EM> begins with <B>NUL</B> |
|
followed by non-<B>NUL</B> characters, the leading |
|
<B>NUL</B> is stripped off and the balance is sent back to rxvt. |
|
<P> |
|
As a convenience for the many Emacs-type editors, <EM>action</EM> |
|
may start with <B>M-</B> (eg, <B>M-$</B> is equivalent to <B>\E$</B>) |
|
and a <B>CR</B> will be appended if missed from <B>M-x</B> commands. |
|
|
|
As a convenience for issuing XTerm <B>ESC]</B> sequences from a menubar |
|
(or quick arrow), a <B>BEL</B> (<B>^G</B>) will be appended if needed. |
|
|
|
<DL> |
|
<DT>For example,</DT> |
|
<DD><B>M-xapropos</B></DD> |
|
<DT>is equivalent to</DT> |
|
<DD><B>\Exapropos\r</B></DD> |
|
<DT>and</DT> |
|
<DD><B>\E]10;mona;100</B> |
|
<DT>is equivalent to</DT> |
|
<DD><B>\E]10;mona;100\a</B></DD> |
|
</DL> |
|
|
|
<P> |
|
The option <B>{<EM>right-rtext</EM>}</B> will be right-justified. |
|
In the absence of a specified action, this text will be used as the |
|
<EM>action</EM> as well. |
|
<DL> |
|
<DT>For example,</DT> |
|
<DD><B>/File/{Open}{^X^F}</B></DD> |
|
<DT>is equivalent to</DT> |
|
<DD><B>/File/{Open){^X^F} ^X^F</B></DD> |
|
</DL> |
|
|
|
The left label <EM>is</EM> necessary, since it's used for matching, |
|
but implicitly hiding the left label (by using same name for both left |
|
and right labels), or explicitly hiding the left label (by preceding |
|
it with a dot), makes it possible to have right-justified text only. |
|
<DL> |
|
<DT>For example,</DT> |
|
<DD><B>/File/{Open}{Open} Open-File-Action</B></DD> |
|
<DT>or hiding it</DT> |
|
<DD><B>/File/{.anylabel}{Open} Open-File-Action</B></DD> |
|
</DL> |
|
|
|
<H3><A HREF="#menuBar" NAME="menuBarRemove">Removing menus</A></H3> |
|
|
|
<DL> |
|
<DT><B> |
|
-/*<BR> |
|
-<EM>/path/</EM>menu<BR> |
|
-<EM>/path/</EM>{item}<BR> |
|
-<EM>/path/</EM>{-} |
|
</B></DT> |
|
<DD> |
|
remove all menus from the menuBar, the same as <B>[clear]</B><BR> |
|
remove menu<BR> |
|
remove item<BR> |
|
remove separator |
|
</DD> |
|
<DT><B>-/path/menu/*</B></DT> |
|
<DD>remove all items, separators and submenus from menu</DD> |
|
</DL> |
|
|
|
<H3><A HREF="#menuBar" NAME="menuBarArrows">Quick Arrows</A></H3> |
|
|
|
The menus also provide a hook for <EM>quick arrows</EM> to provide easier |
|
user access. If nothing has been explicitly set, the default is to |
|
emulate the curror keys. The syntax permits each arrow to be altered |
|
individually or all four at once without re-entering their common |
|
beginning/end text. For example, to explicitly associate cursor |
|
actions with the arrows, any of the following forms could be used: |
|
|
|
<DL > |
|
<DT><B> |
|
<r><EM>Right</EM><BR> |
|
<l><EM>Left</EM><BR> |
|
<u><EM>Up</EM><BR> |
|
<d><EM>Down</EM> |
|
</B></DT> |
|
<DD>Define actions for the respective arrow buttons</DD> |
|
<DT><B> |
|
<b><EM>Begin</EM><BR> |
|
<e><EM>End</EM> |
|
</B></TT></DT> |
|
<DD> |
|
Define common beginning/end parts for <EM>quick arrows</EM> |
|
when used in conjunction with the above |
|
<B><r> <l> <u> <d></B> |
|
constructs |
|
</DD> |
|
</DL> |
|
|
|
<DL> |
|
<DT>For example, define arrows individually,</DT> |
|
<DD><B> |
|
<u>\E[A<BR> |
|
<d>\E[B<BR> |
|
<r>\E[C<BR> |
|
<l>\E[D |
|
</B></DD> |
|
<DT>or all at once</DT> |
|
<DD><B><u>\E[A<d>\E[B<r>\E[C<l>\E[D</B></DD> |
|
<DT>or more compactly (factoring out common parts)</DD> |
|
<DD><B><b>\E[<u>A<d>B<r>C<l>D</B></DD> |
|
</DL> |
|
|
|
<HR> |
|
<H3><A HREF="#menuBar" NAME="menuBarSummary">Command Summary</A></H3> |
|
|
|
A short summary of the most <EM>common</EM> commands: |
|
<DL > |
|
<DT>[menu:name]</DT> |
|
<DD>use an existing named menuBar or start a new one</DD> |
|
<DT>[menu]</DT> |
|
<DD>use the current menuBar</DD> |
|
<DT>[title:string]</DT> |
|
<DD>set menuBar title<DD> |
|
<DT>[done]</DT> |
|
<DD>set menu access to readonly and, if reading from a file, signal EOF</DD> |
|
<DT>[done:name]</DT> |
|
<DD>if reading from a file using [read:file;name] signal EOF</DD> |
|
<DT>[rm:name]<BR>[rm] [rm:]<BR>[rm*] [rm:*]</DT> |
|
<DD>remove named, current, or all menuBar(s)</DD> |
|
<DT>[swap]</DT> |
|
<DD>swap top two menuBars</DD> |
|
<DT>[prev]<BR>[next]</DT> |
|
<DD>access the previous/next menuBar</DD> |
|
<DT>[show]<BR>[hide]</DT> |
|
<DD>map/unmap menuBar</DD> |
|
<DT>[pixmap;file]<BR>[pixmap;file;scaling]</DT> |
|
<DD>set a background pixmap</DD> |
|
<DT> |
|
[read:file]<BR> |
|
[read:file;name]</DT> |
|
<DD>read in a menu from a file</DD> |
|
<DT>[dump]</DT> |
|
<DD>dump out all menuBars to /tmp/rxvt-PID</DD> |
|
<DT>/<DT><DD>access menuBar top level</DD> |
|
<DT>./<BR>../<BR>../../</DT><DD>access current or parent menu level</DD> |
|
<DT>/path/menu</DT><DD>add/access menu</DD> |
|
<DT>/path/{-}</DT><DD>add separator</DD> |
|
<DT>/path/{item}{rtext} action</DT> |
|
<DD>add/alter menu item<BR>({rtext} and/or action, may be omitted)</DD> |
|
<DT>-/*</DT><DD>remove all menus from the menuBar</DD> |
|
<DT>-/path/menu</DT><DD>remove menu items, separators and submenus from menu</DD> |
|
<DT>-/path/menu</DT><DD>remove menu</DD> |
|
<DT>-/path/{item}</DT><DD>remove item</DD> |
|
<DT>-/path/{-}</DT><DD>remove separator</DD> |
|
<DT><b>Begin<r>Right<l>Left<u>Up<d>Down<e>End</DT> |
|
<DD>menu quick arrows</DD> |
|
</DL> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="XPM">XPM</A></H2> |
|
<P> |
|
For the XPM XTerm escape sequence <B><TT>ESC ] 20; Pt BEL</TT></B> |
|
then value of <B><TT>Pt</TT></B> |
|
can be the name of the background pixmap followed by a sequence of |
|
scaling/positioning commands separated by semi-colons. The |
|
scaling/positioning commands are as follows: |
|
<DL> |
|
<DT>query scale/position</DT> |
|
<DD><B>?</B></DD> |
|
<DT>change scale and position</DT> |
|
<DD><B>WxH+X+Y</B><BR> |
|
<B>WxH+X</B> (== <B>WxH+X+X</B>)<BR> |
|
<B>WxH</B> (same as <B>WxH+50+50</B>)<BR> |
|
<B>W+X+Y</B> (same as <B>WxW+X+Y</B>)<BR> |
|
<B>W+X</B> (same as <B>WxW+X+X</B>)<BR> |
|
<B>W</B> (same as <B>WxW+50+50</B>) |
|
</DD> |
|
<DT>change position (absolute)</DT> |
|
<DD><B>=+X+Y</B><BR> |
|
<B>=+X</B> (same as <B>=+X+Y</B>) |
|
</DD> |
|
<DT>change position (relative)</DT> |
|
<DD><B>+X+Y</B><BR> |
|
<B>+X</B> (same as <B>+X+Y</B>) |
|
</DD> |
|
<DT>rescale (relative)</DT> |
|
<DD> |
|
<B>Wx0</B> -> <B>W *= (W/100)</B><BR> |
|
<B>0xH</B> -> <B>H *= (H/100)</B></DD> |
|
</DL> |
|
<P> |
|
|
|
For example: |
|
<DL> |
|
<DT><B>\E]20;funky\a</B></DT> |
|
<DD>load <B>funky.xpm</B> as a tiled image</DD> |
|
<DT><B>\E]20;mona;100\a</B></DT> |
|
<DD>load <B>mona.xpm</B> with a scaling of 100%</DD> |
|
<DT><B>\E]20;;200;?\a</B></DT> |
|
<DD>rescale the current pixmap to 200% and display the image geometry |
|
in the title</DD> |
|
</DL> |
|
<P> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="Mouse">Mouse Reporting</A></H2> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC [ M <b> <x> <y></TT></B></DT> |
|
<DD>report mouse position</DD> |
|
</DL> |
|
<P> |
|
<P> |
|
The lower 2 bits of <B><TT><b></TT></B> indicate the button: |
|
<DL> |
|
<DT>Button = <B><TT><b> & 3 - SPACE</TT></B></DT> |
|
<DD> |
|
0 = Button1 pressed<BR> |
|
1 = Button2 pressed<BR> |
|
2 = Button3 pressed<BR> |
|
3 = button released (X11 mouse report)</DD> |
|
</DL> |
|
The upper bits of <B><TT><b></TT></B> indicate the modifiers when |
|
the button was pressed and are added together (X11 mouse report only): |
|
<DL> |
|
<DT>State = <B><TT><b> & 28 - SPACE</TT></B></DT> |
|
<DD> |
|
4 = Shift<BR> |
|
8 = Meta<BR> |
|
16 = Control<BR> |
|
Col = <B><TT><x> - SPACE</TT></B><BR> |
|
Row = <B><TT><y> - SPACE</TT></B> |
|
</DD> |
|
</DL> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="Graphics">Special Graphics Mode</A></H2> |
|
|
|
Add more documentation here, <EM>if anyone actually cares.</EM> <P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC G Q</TT></B></DT> |
|
<DD>query if graphics are available<BR> |
|
returns: <B><TT>ESC G 0</TT></B> no graphics available<BR> |
|
returns: <B><TT>ESC G 1</TT></B> graphics available (color only)</DD> |
|
</DL> |
|
<DL> |
|
<DT><B><TT>ESC G W <x>;<y>;<w>;<h>:</TT></B></DT> |
|
<DD>create window</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC G C <id></TT></B></DT> |
|
<DD>clear window</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>ESC G G <id>:</TT></B></DT> |
|
<DD>query window<BR> |
|
returns: <B><TT>ESC G <id> <x> <y> <w> <h> <fw> <fh> <nw> <nh></TT></B> |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT> |
|
ESC G L <id><BR> |
|
ESC G P <id><BR> |
|
ESC G F <id> |
|
</TT></B></DT> |
|
<DD> |
|
start point<BR> |
|
start line<BR> |
|
start fill |
|
</DD> |
|
</DL> |
|
<P> |
|
|
|
<DL> |
|
<DT><B><TT>;<x>;<y></TT></B></DT> |
|
<DD>extend point/line/fill</DD> |
|
</DL> |
|
|
|
<P> |
|
<DL> |
|
<DT><B><TT>ESC G T <id>;<x>;<y>;<mode>;<len>:<text></TT></B></DT> |
|
<DD>place text</DD> |
|
</DL> |
|
<P> |
|
|
|
<HR> |
|
<H2><A HREF="#toc" NAME="KeyCodes">Key Codes</A></H2> |
|
<P> |
|
|
|
Note: <B>Shift</B> + <B>F1</B>-<B>F10</B> generates <B>F11</B>-<B>F20</B> |
|
<P> |
|
For the keypad, use <B>Shift</B> to temporarily override |
|
Application-Keypad setting use <B>Num_Lock</B> to toggle |
|
Application-Keypad setting if <B>Num_Lock</B> is off, |
|
<A HREF="#ESC=">escape sequences</A> toggle Application-Keypad setting. |
|
Also note that values of <B>Home</B>, <B>End</B>, <B>Delete</B> |
|
may have been compiled differently on your system. |
|
|
|
<TABLE CELLPADDING=5 WIDTH="100%" > |
|
<TR> |
|
<TD></TD> |
|
<TD><B>Normal<B></TD> |
|
<TD><B>Shift<B></TD> |
|
<TD><B>Control<B></TD> |
|
<TD><B>Ctrl+Shift<B></TD> |
|
</TR> |
|
<TR><TD>Tab </TD><TD>^I </TD><TD>ESC [ Z</TD><TD>^I </TD><TD>ESC [ Z</TD></TR> |
|
<TR><TD>BackSpace</TD><TD>^H </TD><TD>^? </TD><TD>^?</TD><TD>^?</TD></TR> |
|
<TR><TD>Find </TD><TD>ESC [ 1 ~</TD><TD>ESC [ 1 $ </TD><TD>ESC [ 1 ^</TD><TD>ESC [ 1 @</TD></TR> |
|
<TR><TD>Insert </TD><TD>ESC [ 2 ~</TD><TD><I>paste</I></TD><TD>ESC [ 2 ^</TD><TD>ESC [ 2 @</TD></TR> |
|
<TR><TD>Execute </TD><TD>ESC [ 3 ~</TD><TD>ESC [ 3 $ </TD><TD>ESC [ 3 ^</TD><TD>ESC [ 3 @</TD></TR> |
|
<TR><TD>Select </TD><TD>ESC [ 4 ~</TD><TD>ESC [ 4 $ </TD><TD>ESC [ 4 ^</TD><TD>ESC [ 4 @</TD></TR> |
|
<TR><TD>Prior </TD><TD>ESC [ 5 ~</TD><TD><I>scroll-up</I></TD><TD>ESC [ 5 ^</TD><TD>ESC [ 5 @</TD></TR> |
|
<TR><TD>Next </TD><TD>ESC [ 6 ~</TD><TD><I>scroll-down</I></TD><TD>ESC [ 6 ^</TD><TD>ESC [ 6 @</TD></TR> |
|
<TR><TD>Home </TD><TD>ESC [ 7 ~</TD><TD>ESC [ 7 $ </TD><TD>ESC [ 7 ^</TD><TD>ESC [ 7 @</TD></TR> |
|
<TR><TD>End </TD><TD>ESC [ 8 ~</TD><TD>ESC [ 8 $ </TD><TD>ESC [ 8 ^</TD><TD>ESC [ 8 @</TD></TR> |
|
<TR><TD>Delete </TD><TD>ESC [ 3 ~</TD><TD>ESC [ 3 $ </TD><TD>ESC [ 3 ^</TD><TD>ESC [ 3 @</TD></TR> |
|
|
|
<TR><TD>F1 </TD><TD>ESC [ 11 ~</TD><TD>ESC [ 23 ~</TD><TD>ESC [ 11 ^</TD><TD>ESC [ 23 ^</TD></TR> |
|
<TR><TD>F2 </TD><TD>ESC [ 12 ~</TD><TD>ESC [ 24 ~</TD><TD>ESC [ 12 ^</TD><TD>ESC [ 24 ^</TD></TR> |
|
<TR><TD>F3 </TD><TD>ESC [ 13 ~</TD><TD>ESC [ 25 ~</TD><TD>ESC [ 13 ^</TD><TD>ESC [ 25 ^</TD></TR> |
|
<TR><TD>F4 </TD><TD>ESC [ 14 ~</TD><TD>ESC [ 26 ~</TD><TD>ESC [ 14 ^</TD><TD>ESC [ 26 ^</TD></TR> |
|
<TR><TD>F5 </TD><TD>ESC [ 15 ~</TD><TD>ESC [ 28 ~</TD><TD>ESC [ 15 ^</TD><TD>ESC [ 28 ^</TD></TR> |
|
<TR><TD>F6 </TD><TD>ESC [ 17 ~</TD><TD>ESC [ 29 ~</TD><TD>ESC [ 17 ^</TD><TD>ESC [ 29 ^</TD></TR> |
|
<TR><TD>F7 </TD><TD>ESC [ 18 ~</TD><TD>ESC [ 31 ~</TD><TD>ESC [ 18 ^</TD><TD>ESC [ 31 ^</TD></TR> |
|
<TR><TD>F8 </TD><TD>ESC [ 19 ~</TD><TD>ESC [ 32 ~</TD><TD>ESC [ 19 ^</TD><TD>ESC [ 32 ^</TD></TR> |
|
<TR><TD>F9 </TD><TD>ESC [ 20 ~</TD><TD>ESC [ 33 ~</TD><TD>ESC [ 20 ^</TD><TD>ESC [ 33 ^</TD></TR> |
|
<TR><TD>F10</TD><TD>ESC [ 21 ~</TD><TD>ESC [ 34 ~</TD><TD>ESC [ 21 ^</TD><TD>ESC [ 34 ^</TD></TR> |
|
<TR><TD>F11</TD><TD>ESC [ 23 ~</TD><TD>ESC [ 23 $</TD><TD>ESC [ 23 ^</TD><TD>ESC [ 23 @</TD></TR> |
|
<TR><TD>F12</TD><TD>ESC [ 24 ~</TD><TD>ESC [ 24 $</TD><TD>ESC [ 24 ^</TD><TD>ESC [ 24 @</TD></TR> |
|
<TR><TD>F13</TD><TD>ESC [ 25 ~</TD><TD>ESC [ 25 $</TD><TD>ESC [ 25 ^</TD><TD>ESC [ 25 @</TD></TR> |
|
<TR><TD>F14</TD><TD>ESC [ 26 ~</TD><TD>ESC [ 26 $</TD><TD>ESC [ 26 ^</TD><TD>ESC [ 26 @</TD></TR> |
|
<TR><TD>F15 (Help)</TD><TD>ESC [ 28 ~</TD><TD>ESC [ 28 $</TD><TD>ESC [ 28 ^</TD><TD>ESC [ 28 @</TD></TR> |
|
<TR><TD>F16 (Menu)</TD><TD>ESC [ 29 ~</TD><TD>ESC [ 29 $</TD><TD>ESC [ 29 ^</TD><TD>ESC [ 29 @</TD></TR> |
|
<TR><TD>F17</TD><TD>ESC [ 31 ~</TD><TD>ESC [ 31 $</TD><TD>ESC [ 31 ^</TD><TD>ESC [ 31 @</TD></TR> |
|
<TR><TD>F18</TD><TD>ESC [ 32 ~</TD><TD>ESC [ 32 $</TD><TD>ESC [ 32 ^</TD><TD>ESC [ 32 @</TD></TR> |
|
<TR><TD>F19</TD><TD>ESC [ 33 ~</TD><TD>ESC [ 33 $</TD><TD>ESC [ 33 ^</TD><TD>ESC [ 33 @</TD></TR> |
|
<TR><TD>F20</TD><TD>ESC [ 34 ~</TD><TD>ESC [ 34 $</TD><TD>ESC [ 34 ^</TD><TD>ESC [ 34 @</TD></TR> |
|
<TR> |
|
<TD></TD><TD></TD><TD></TD><TD></TD> |
|
<TD><B>Application</B></TD> |
|
</TR> |
|
<TR><TD>Up </TD><TD>ESC [ A</TD><TD>ESC [ a</TD><TD>ESC O a</TD><TD>ESC O A</TD></TR> |
|
<TR><TD>Down </TD><TD>ESC [ B</TD><TD>ESC [ b</TD><TD>ESC O b</TD><TD>ESC O B</TD></TR> |
|
<TR><TD>Right</TD><TD>ESC [ C</TD><TD>ESC [ c</TD><TD>ESC O c</TD><TD>ESC O C</TD></TR> |
|
<TR><TD>Left </TD><TD>ESC [ D</TD><TD>ESC [ d</TD><TD>ESC O d</TD><TD>ESC O D</TD></TR> |
|
<TR><TD>KP_Enter</TD><TD>^M</TD><TD></TD><TD></TD><TD>ESC O M</TD></TR> |
|
<TR><TD>KP_F1</TD><TD>ESC O P</TD><TD></TD><TD></TD><TD>ESC O P</TD></TR> |
|
<TR><TD>KP_F2</TD><TD>ESC O Q</TD><TD></TD><TD></TD><TD>ESC O Q</TD></TR> |
|
<TR><TD>KP_F3</TD><TD>ESC O R</TD><TD></TD><TD></TD><TD>ESC O R</TD></TR> |
|
<TR><TD>KP_F4</TD><TD>ESC O S</TD><TD></TD><TD></TD><TD>ESC O S</TD></TR> |
|
<TR><TD>XK_KP_Multiply </TD><TD>*</TD><TD></TD><TD></TD><TD>ESC O j</TD></TR> |
|
<TR><TD>XK_KP_Add </TD><TD>+</TD><TD></TD><TD></TD><TD>ESC O k</TD></TR> |
|
<TR><TD>XK_KP_Separator</TD><TD>,</TD><TD></TD><TD></TD><TD>ESC O l</TD></TR> |
|
<TR><TD>XK_KP_Subtract </TD><TD>-</TD><TD></TD><TD></TD><TD>ESC O m</TD></TR> |
|
<TR><TD>XK_KP_Decimal </TD><TD>.</TD><TD></TD><TD></TD><TD>ESC O n</TD></TR> |
|
<TR><TD>XK_KP_Divide </TD><TD>/</TD><TD></TD><TD></TD><TD>ESC O o</TD></TR> |
|
<TR><TD>XK_KP_0 </TD><TD>0</TD><TD></TD><TD></TD><TD>ESC O p</TD></TR> |
|
<TR><TD>XK_KP_1 </TD><TD>1</TD><TD></TD><TD></TD><TD>ESC O q</TD></TR> |
|
<TR><TD>XK_KP_2 </TD><TD>2</TD><TD></TD><TD></TD><TD>ESC O r</TD></TR> |
|
<TR><TD>XK_KP_3 </TD><TD>3</TD><TD></TD><TD></TD><TD>ESC O s</TD></TR> |
|
<TR><TD>XK_KP_4 </TD><TD>4</TD><TD></TD><TD></TD><TD>ESC O t</TD></TR> |
|
<TR><TD>XK_KP_5 </TD><TD>5</TD><TD></TD><TD></TD><TD>ESC O u</TD></TR> |
|
<TR><TD>XK_KP_6 </TD><TD>6</TD><TD></TD><TD></TD><TD>ESC O v</TD></TR> |
|
<TR><TD>XK_KP_7 </TD><TD>7</TD><TD></TD><TD></TD><TD>ESC O w</TD></TR> |
|
<TR><TD>XK_KP_8 </TD><TD>8</TD><TD></TD><TD></TD><TD>ESC O x</TD></TR> |
|
<TR><TD>XK_KP_9 </TD><TD>9</TD><TD></TD><TD></TD><TD>ESC O y</TD></TR> |
|
</TABLE> |
|
|
|
<P><HR><ADDRESS> |
|
Mark Olesen<BR> |
|
Fri Feb 14 14:16:00 1997 |
|
</ADDRESS> |
|
</BODY> |
|
</HTML>
|
|
|