| … | |
… | |
| 4 | |
4 | |
| 5 | SYNOPSIS |
5 | SYNOPSIS |
| 6 | rxvt [options] [-e command [ args ]] |
6 | rxvt [options] [-e command [ args ]] |
| 7 | |
7 | |
| 8 | DESCRIPTION |
8 | DESCRIPTION |
| 9 | rxvt-unicode, version 7.4, is a colour vt102 terminal emulator intended |
9 | rxvt-unicode, version 7.6, is a colour vt102 terminal emulator intended |
| 10 | as an *xterm*(1) replacement for users who do not require features such |
10 | as an *xterm*(1) replacement for users who do not require features such |
| 11 | as Tektronix 4014 emulation and toolkit-style configurability. As a |
11 | as Tektronix 4014 emulation and toolkit-style configurability. As a |
| 12 | result, rxvt-unicode uses much less swap space -- a significant |
12 | result, rxvt-unicode uses much less swap space -- a significant |
| 13 | advantage on a machine serving many X sessions. |
13 | advantage on a machine serving many X sessions. |
| 14 | |
14 | |
| … | |
… | |
| 1175 | It is also possible to specify the colour values of foreground, |
1175 | It is also possible to specify the colour values of foreground, |
| 1176 | background, cursorColor, cursorColor2, colorBD, colorUL as a number |
1176 | background, cursorColor, cursorColor2, colorBD, colorUL as a number |
| 1177 | 0-15, as a convenient shorthand to reference the colour name of |
1177 | 0-15, as a convenient shorthand to reference the colour name of |
| 1178 | color0-color15. |
1178 | color0-color15. |
| 1179 | |
1179 | |
| 1180 | If Xft support has been compiled in and as long as Xft/Xrender/X don't |
1180 | In addition to the colours defined above, rxvt offers an additional 72 |
| 1181 | get their act together, rxvt-unicode will support |
1181 | colours. The first 64 of those (with indices 16 to 79) consist of a |
| 1182 | "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4 |
1182 | 4*4*4 RGB colour cube (i.e. *index = r * 16 + g * 4 + b + 16*), followed |
| 1183 | digits/component), "#ARGB", "#AARRGGBB" and "#AAAARRRRGGGGBBBB" colour |
1183 | by 8 additional shades of gray (with indices 80 to 87). |
| 1184 | specifications, in addition to the ones provided by X, where the |
|
|
| 1185 | additional A component specifies alpha (opacity) values (0 is completely |
|
|
| 1186 | transparent and the maximum is opaque). You probably need to specify |
|
|
| 1187 | "-depth 32", too, and have the luck that your X-server uses ARGB pixel |
|
|
| 1188 | layout, as X is far from just supporting ARGB visuals out of the box, |
|
|
| 1189 | and rxvt-unicode just fudges around. |
|
|
| 1190 | |
1184 | |
| 1191 | *Please note that transparency of any kind if completely unsupported by |
1185 | Together, all those colours implement the 88 colour xterm colours. Only |
| 1192 | the author. Don't bug him with installation questions!* |
1186 | the first 16 can be changed using resources currently, the rest can only |
|
|
1187 | be changed via command sequences ("escape codes"). |
| 1193 | |
1188 | |
| 1194 | Note that -rv ("reverseVideo: True") simulates reverse video by always |
1189 | Note that -rv ("reverseVideo: True") simulates reverse video by always |
| 1195 | swapping the foreground/background colours. This is in contrast to |
1190 | swapping the foreground/background colours. This is in contrast to |
| 1196 | *xterm*(1) where the colours are only swapped if they have not otherwise |
1191 | *xterm*(1) where the colours are only swapped if they have not otherwise |
| 1197 | been specified. For example, |
1192 | been specified. For example, |
| 1198 | |
1193 | |
| 1199 | rxvt -fg Black -bg White -rv |
1194 | rxvt -fg Black -bg White -rv |
| 1200 | would yield White on Black, while on *xterm*(1) it would yield Black |
1195 | would yield White on Black, while on *xterm*(1) it would yield Black |
| 1201 | on White. |
1196 | on White. |
|
|
1197 | |
|
|
1198 | ALPHA CHANNEL SUPPORT |
|
|
1199 | If Xft support has been compiled in and as long as Xft/Xrender/X don't |
|
|
1200 | get their act together, rxvt-unicode will support |
|
|
1201 | "rgba:rrrr/gggg/bbbb/aaaa" (recommended, but MUST have 4 |
|
|
1202 | digits/component) colour specifications, in addition to the ones |
|
|
1203 | provided by X, where the additional A component specifies opacity |
|
|
1204 | (alpha) values. The minimum value of 0 is completely transparent). You |
|
|
1205 | can also prefix any color with "[a]", where "a" is on to four hex digits |
|
|
1206 | specifiying the opacity value. |
|
|
1207 | |
|
|
1208 | You probably need to specify "-depth 32", too, and have the luck that |
|
|
1209 | your X-server uses ARGB pixel layout, as X is far from just supporting |
|
|
1210 | ARGB visuals out of the box, and rxvt-unicode just fudges around. |
|
|
1211 | |
|
|
1212 | For example, the following selects an almost completely transparent red |
|
|
1213 | background, and an almost opaque pink foreground: |
|
|
1214 | |
|
|
1215 | rxvt -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink" |
|
|
1216 | |
|
|
1217 | *Please note that transparency of any kind if completely unsupported by |
|
|
1218 | the author. Don't bug him with installation questions!* |
| 1202 | |
1219 | |
| 1203 | ENVIRONMENT |
1220 | ENVIRONMENT |
| 1204 | rxvt sets and/or uses the following environment variables: |
1221 | rxvt sets and/or uses the following environment variables: |
| 1205 | |
1222 | |
| 1206 | TERM |
1223 | TERM |
