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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.110 by root, Sun Jan 29 22:38:43 2006 UTC vs.
Revision 1.112 by root, Mon Feb 6 05:55:33 2006 UTC

… …
1346It is also possible to specify the colour values of B<foreground>, 1346It is also possible to specify the colour values of B<foreground>,
1347B<background>, B<cursorColor>, B<cursorColor2>, B<colorBD>, B<colorUL> as 1347B<background>, B<cursorColor>, B<cursorColor2>, B<colorBD>, B<colorUL> as
1348a number 0-15, as a convenient shorthand to reference the colour name of 1348a number 0-15, as a convenient shorthand to reference the colour name of
1349color0-color15. 1349color0-color15.
1350 1350
1351If Xft support has been compiled in and as long as Xft/Xrender/X don't get 1351In addition to the colours defined above, @@RXVT_NAME@@ offers an
1352their act together, rxvt-unicode will support C<rgba:rrrr/gggg/bbbb/aaaa> 1352additional 72 colours. The first 64 of those (with indices 16 to 79)
1353(recommended, but B<MUST> have 4 digits/component), C<#ARGB>, C<#AARRGGBB> 1353consist of a 4*4*4 RGB colour cube (i.e. I<index = r * 16 + g * 4 + b +
1354and C<#AAAARRRRGGGGBBBB> colour specifications, in addition to the ones 135416>), followed by 8 additional shades of gray (with indices 80 to 87).
1355provided by X, where the additional A component specifies alpha (opacity)
1356values (0 is completely transparent and the maximum is opaque). You
1357probably need to specify B<"-depth 32">, too, and have the luck that your
1358X-server uses ARGB pixel layout, as X is far from just supporting ARGB
1359visuals out of the box, and rxvt-unicode just fudges around.
1360 1355
1361I<Please note that transparency of any kind if completely unsupported by 1356Together, all those colours implement the 88 colour xterm colours. Only
1362the author. Don't bug him with installation questions!> 1357the first 16 can be changed using resources currently, the rest can only
1358be changed via command sequences ("escape codes").
1363 1359
1364Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by 1360Note that B<-rv> (B<"reverseVideo: True">) simulates reverse video by
1365always swapping the foreground/background colours. This is in contrast to 1361always swapping the foreground/background colours. This is in contrast to
1366I<xterm>(1) where the colours are only swapped if they have not otherwise 1362I<xterm>(1) where the colours are only swapped if they have not otherwise
1367been specified. For example, 1363been specified. For example,
… …
1372 1368
1373would yield White on Black, while on I<xterm>(1) it would yield Black 1369would yield White on Black, while on I<xterm>(1) it would yield Black
1374on White. 1370on White.
1375 1371
1376=back 1372=back
1373
1374=head2 ALPHA CHANNEL SUPPORT
1375
1376If Xft support has been compiled in and as long as Xft/Xrender/X don't get
1377their act together, rxvt-unicode will support C<rgba:rrrr/gggg/bbbb/aaaa>
1378(recommended, but B<MUST> have 4 digits/component) colour specifications,
1379in addition to the ones provided by X, where the additional A component
1380specifies opacity (alpha) values. The minimum value of C<0> is completely
1381transparent). You can also prefix any color with C<[a]>, where C<a> is on
1382to four hex digits specifiying the opacity value.
1383
1384You probably need to specify B<"-depth 32">, too, and have the luck that
1385your X-server uses ARGB pixel layout, as X is far from just supporting
1386ARGB visuals out of the box, and rxvt-unicode just fudges around.
1387
1388For example, the following selects an almost completely transparent red
1389background, and an almost opaque pink foreground:
1390
1391 @@RXVT_NAME@@ -depth 32 -bg rgba:0000/0000/0000/2222 -fg "[e]pink"
1392
1393I<Please note that transparency of any kind if completely unsupported by
1394the author. Don't bug him with installation questions!>
1377 1395
1378=head1 ENVIRONMENT 1396=head1 ENVIRONMENT
1379 1397
1380B<@@RXVT_NAME@@> sets and/or uses the following environment variables: 1398B<@@RXVT_NAME@@> sets and/or uses the following environment variables:
1381 1399

Diff Legend

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