.\" t
.\" @(#)MyBackground.1		01/13/2023
.TH MyBackground 1x "AfterStep v.2.2.12" "Jan 13 2023" "AfterStep X11 window manager"
.UC
.SH NAME
\fBMyBackground\fP\ \- details how background is to be rendered



.SH CONFIGURATION OPTIONS

.IP "Align \fI[type]\fP "

it will align resulting image according to type\&. Possible values are :
1: \- align to the right of the screen

2: \- align to the bottom of the screen

3: \- align to the bottom\-right of the screen

0 or 4: \- align to the center of the screen This option works only in conjunction with the following Pad option\&.



.IP "Cut \fI""geometry""\fP "

will cut piece with specified geometry from the source image\&.


.IP "MyBackground \fI""background_name""\fP "

.IP "background_option"

.IP "~MyBackground"

Specifies the beginning of a background definition\&. The background can be referred to later by background_name\&. ~MyBackground ends a root background definition\&.


.IP "Pad \fI[type color]\fP "

will pad image if it is smaller then screen with specified color\&. Possible type values are :

1: \- pad horizontally and tile vertically

2: \- pad vertically and tile horizontally

3: \- pad both vertically and horizontally to make the image the size of the screen\&.


.IP "Scale \fI[geometry]\fP "

scale image to specified geometry\&. If geometry is omitted the image will be scaled to the screen size\&.


.IP "Tint \fIcolor\fP "




.IP "Use \fItype\fP  \fI""data""\fP "

Specifies what to use as the root background\&. Possible type values are :

0: load image from the file\&. In that case "data" should specify filename\&.

1: Use MyStyle definition to fill root\&. In that case "data" should specify one of the MyStyle names defined in your look file\&.

2: Use external application to set root background\&. "data" should specify command line options to this external app\&. If you wish to use another application to display the root background, you need to set the "\-\-with\-imageloader" flag to use that application then recompile AfterStep\&.)

Note: remaining Background options are valid only for type of 0 !!!

The remaining options will perform transformations on the source image, in this order:

.IP "Cut\->Tint\->Scale\->Align\->Pad\&."