… | |
… | |
122 | .\} |
122 | .\} |
123 | .rm #[ #] #H #V #F C |
123 | .rm #[ #] #H #V #F C |
124 | .\" ======================================================================== |
124 | .\" ======================================================================== |
125 | .\" |
125 | .\" |
126 | .IX Title "@@RXVT_NAME@@ 1" |
126 | .IX Title "@@RXVT_NAME@@ 1" |
127 | .TH @@RXVT_NAME@@ 1 "2011-08-19" "@@RXVT_VERSION@@" "RXVT-UNICODE" |
127 | .TH @@RXVT_NAME@@ 1 "2011-11-18" "@@RXVT_VERSION@@" "RXVT-UNICODE" |
128 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
128 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
129 | .\" way too many mistakes in technical documents. |
129 | .\" way too many mistakes in technical documents. |
130 | .if n .ad l |
130 | .if n .ad l |
131 | .nh |
131 | .nh |
132 | .SH "NAME" |
132 | .SH "NAME" |
… | |
… | |
780 | .IP "\fBbackgroundPixmap:\fR \fIfile[;oplist]\fR" 4 |
780 | .IP "\fBbackgroundPixmap:\fR \fIfile[;oplist]\fR" 4 |
781 | .IX Item "backgroundPixmap: file[;oplist]" |
781 | .IX Item "backgroundPixmap: file[;oplist]" |
782 | Use the specified image file for the background and also |
782 | Use the specified image file for the background and also |
783 | optionally specify a colon separated list of operations to modify it. |
783 | optionally specify a colon separated list of operations to modify it. |
784 | Supported operations are: |
784 | Supported operations are: |
785 | .Sp |
785 | .RS 4 |
786 | .Vb 8 |
786 | .IP "\fBWxH+X+Y\fR" 4 |
787 | \& B<WxH+X+Y> sets scale and position. B<"W" / "H"> specify the |
787 | .IX Item "WxH+X+Y" |
788 | \& horizontal/vertical scale (percent), and B<"X" / "Y"> |
788 | sets scale and position. \fB\*(L"W\*(R" / \*(L"H\*(R"\fR specify the horizontal/vertical |
789 | \& locate the image centre (percent). A scale of 0 disables |
789 | scale (percent), and \fB\*(L"X\*(R" / \*(L"Y\*(R"\fR locate the image centre (percent). A |
790 | \& scaling. The maximum permitted scale is 1000. |
790 | scale of 0 disables scaling. The maximum permitted scale is 1000. |
791 | \& op=tile enables tiling |
791 | .IP "\fBop=tile\fR" 4 |
|
|
792 | .IX Item "op=tile" |
|
|
793 | enables tiling |
|
|
794 | .IP "\fBop=pscale\fR" 4 |
|
|
795 | .IX Item "op=pscale" |
792 | \& op=pscale enables proportional scaling |
796 | enables proportional scaling |
|
|
797 | .IP "\fBop=root\fR" 4 |
|
|
798 | .IX Item "op=root" |
793 | \& op=root use the position of the terminal window relative to the root |
799 | use the position of the terminal window relative to the root window as |
794 | \& window as the image offset, simulating a root window background |
800 | the image offset, simulating a root window background |
795 | .Ve |
801 | .RE |
|
|
802 | .RS 4 |
796 | .Sp |
803 | .Sp |
797 | The default scale and position setting is \f(CW\*(C`100x100+50+50\*(C'\fR. |
804 | The default scale and position setting is \f(CW\*(C`100x100+50+50\*(C'\fR. |
798 | Alternatively, a predefined set of templates can be used to achieve |
805 | Alternatively, a predefined set of templates can be used to achieve |
799 | the most common setups: |
806 | the most common setups: |
800 | .Sp |
807 | .IP "\fBstyle=tiled\fR" 4 |
801 | .Vb 6 |
808 | .IX Item "style=tiled" |
802 | \& style=tiled the image is tiled with no scaling |
809 | the image is tiled with no scaling. Equivalent to 0x0+0+0:op=tile |
803 | \& style=aspect\-stretched the image is scaled to fill the whole window maintaining |
810 | .IP "\fBstyle=aspect\-stretched\fR" 4 |
804 | \& the aspect ratio and centered |
811 | .IX Item "style=aspect-stretched" |
805 | \& style=stretched the image is scaled to fill the whole window |
812 | the image is scaled to fill the whole window maintaining the aspect |
806 | \& style=centered the image is centered with no scaling |
813 | ratio and centered. Equivalent to 100x100+50+50:op=pscale |
807 | \& style=root\-tiled the image is tiled with no scaling and using \*(Aqop=root\*(Aq positioning |
814 | .IP "\fBstyle=stretched\fR" 4 |
808 | .Ve |
815 | .IX Item "style=stretched" |
|
|
816 | the image is scaled to fill the whole window. Equivalent to 100x100 |
|
|
817 | .IP "\fBstyle=centered\fR" 4 |
|
|
818 | .IX Item "style=centered" |
|
|
819 | the image is centered with no scaling. Equivalent to 0x0+50+50 |
|
|
820 | .IP "\fBstyle=root\-tiled\fR" 4 |
|
|
821 | .IX Item "style=root-tiled" |
|
|
822 | the image is tiled with no scaling and using 'root' positioning. |
|
|
823 | Equivalent to 0x0:op=tile:op=root |
|
|
824 | .RE |
|
|
825 | .RS 4 |
809 | .Sp |
826 | .Sp |
810 | If multiple templates are specified the last one wins. Note that a |
827 | If multiple templates are specified the last one wins. Note that a |
811 | template overrides all the scale, position and operations settings. |
828 | template overrides all the scale, position and operations settings. |
812 | Indeed, the templates can be specified in terms of low level settings |
|
|
813 | as follows: |
|
|
814 | .Sp |
|
|
815 | .Vb 5 |
|
|
816 | \& style=tiled 0x0+0+0:op=tile |
|
|
817 | \& style=aspect\-stretched 100x100+50+50:op=pscale |
|
|
818 | \& style=stretched 100x100 |
|
|
819 | \& style=centered 0x0+50+50 |
|
|
820 | \& style=root\-tiled 0x0:op=tile:op=root |
|
|
821 | .Ve |
|
|
822 | .Sp |
829 | .Sp |
823 | If used in conjunction with \fB\-tr\fR option, the specified pixmap will be |
830 | If used in conjunction with \fB\-tr\fR option, the specified pixmap will be |
824 | blended over the transparent background using alpha-blending. If \fIafterimage\fR |
831 | blended over the transparent background using alpha-blending. If \fIafterimage\fR |
825 | support has been compiled in it is possible to choose other blending |
832 | support has been compiled in it is possible to choose other blending |
826 | types with \fB\-blt \*(L"type\*(R"\fR option. |
833 | types with \fB\-blt \*(L"type\*(R"\fR option. |
|
|
834 | .RE |
827 | .IP "\fBpath:\fR \fIpath\fR" 4 |
835 | .IP "\fBpath:\fR \fIpath\fR" 4 |
828 | .IX Item "path: path" |
836 | .IX Item "path: path" |
829 | Specify the colon-delimited search path for finding background image files. |
837 | Specify the colon-delimited search path for finding background image files. |
830 | .IP "\fBfont:\fR \fIfontlist\fR" 4 |
838 | .IP "\fBfont:\fR \fIfontlist\fR" 4 |
831 | .IX Item "font: fontlist" |
839 | .IX Item "font: fontlist" |