--- rxvt-unicode/doc/rxvt.1.pod 2007/10/29 13:40:41 1.141 +++ rxvt-unicode/doc/rxvt.1.pod 2007/11/15 18:40:10 1.144 @@ -121,11 +121,11 @@ Turn on/off illusion of a transparent window background. Obsolete form of it is B<-ip> and it should not be used anymore; resource B. -I is obsolete and should be -changed to B. Backwards compatibility support for B will +I is obsolete and should be +changed to B. Backwards compatibility support for B will be phased out in future versions of rxvt!> -I =item B<-fade> I @@ -147,8 +147,8 @@ used to brighten or darken the image in addition to tinting it. Please note that certain tint colours can be applied on the server-side, thus yielding performance gain of two orders of magnitude. These colours are: -blue, red, green, cyan, magenta, yellow, and those close to them. Also -pure black and pure white colors essentialy mean no tinting; resource +blue, red, green, cyan, magenta, yellow, and those close to them. Also +pure black and pure white colors essentially mean no tinting; resource I. Example: @@RXVT_NAME@@ -tr -tint blue -sh 40 @@ -186,9 +186,9 @@ Window foreground colour; resource B. -=item B<-pixmap> I +=item B<-pixmap> I -Compile I: Specify image file for the background and also +Compile I: Specify image file for the background and also optionally specify its scaling with a geometry string. Note you may need to add quotes to avoid special shell interpretation of the C<;> in the command-line; for more details see resource B. @@ -678,7 +678,7 @@ =item B I -Apply Gaussian Blurr with the specified radius to the transparent +Apply Gaussian Blurr with the specified radius to the transparent background image; option B<-blr>. =item B I @@ -695,20 +695,29 @@ The colour of the border around the text area and between the scrollbar and the text. -=item B I +=item B I -Use the specified image file for the background and also optionally -specify its scaling with a geometry string B, -in which B<"W" / "H"> specify the horizontal/vertical scale (percent), -and B<"X" / "Y"> locate the image centre (percent). -A scale of 0 displays the image with tiling. A scale of 1 displays the -image without any scaling. A scale of 2 to 9 specifies an integer -number of images in that direction. No image will be magnified beyond -10 times its original size. The maximum permitted scale is 1000. -Special string of B<"auto"> used as a geometry will cause image to be -automatically scaled to match window size. -If used in conjunction with B<-tr> option - specified pixmap will be -blended over transparency image using either alpha-blending, or any +Use the specified image file for the background and also optionally +specify its scaling with a geometry string B, +in which B<"W" / "H"> specify the horizontal/vertical scale (percent), +and B<"X" / "Y"> locate the image centre (percent). +A scale of 0 displays the image with tiling. A scale of 1 displays the +image without any scaling. A scale of 2 to 9 specifies an integer +number of images in that direction. No image will be magnified beyond +10 times its original size. The maximum permitted scale is 1000. +Additional operations can be specified after colon B<:op1:op2...>. +Supported operations are: + B<"tile"> - force background image to be tiled and not scaled. Equivalent to 0x0, + B<"propscale"> - will scale image keeping proportions, + B<"auto"> - will scale image to match window size. Equivalent to 100x100; + B<"hscale"> - will scale image horizontally to the window size; + B<"vscale"> - will scale image vertically to the window size; + B<"scale"> - will scale image to match window size; + B<"root"> - will tile image as if it was a root window background, auto-adjusting + whenever terminal window moves. + +If used in conjunction with B<-tr> option - specified pixmap will be +blended over transparency image using either alpha-blending, or any other blending type, specified with B<-blt "type"> option. [default 0x0+50+50] @@ -1473,8 +1482,8 @@ =item B Either C, C, depending on whether @@RXVT_NAME@@ was -compiled with background image support, and optionally with the added -extension C<-mono> to indicate that rxvt-unicode runs on a monochrome +compiled with background image support, and optionally with the added +extension C<-mono> to indicate that rxvt-unicode runs on a monochrome screen. =item B @@ -1484,7 +1493,7 @@ C to indicate that the default-colour escape sequence is to be used), C is the colour code used as default background colour (or the string C), and C is the string C if @@RXVT_NAME@@ -was compiled with background image support. Libraries like C +was compiled with background image support. Libraries like C and C can (and do) use this information to optimize screen output. =item B @@ -1586,7 +1595,7 @@ =item Geoff Wing L<< >> Rewrote screen display and text selection routines. - + Project Coordinator (changes.txt 2.4.6 - rxvt-unicode) =item Marc Alexander Lehmann L<< >>