xsri man page on Cygwin
[printable version]
XSRI(1) XSRI(1)
NAME
xsri - set the root window background in X
SYNOPSIS
xsri [OPTION]...
DESCRIPTION
Allows the display of text, patterns, and images in the root window, so
users can customize the XDM-style login screen and/or the normal X
background.
The image displayed by xsri is composed of three layers:
1) A background color or gradient
2) An optional tiled image
3) An optional “emblem” image
OPTIONS
Mode Selection Options
--set Set the background, by the standard method used for setting a
users background (_XROOTPMAP_ID, ESETROOT_PMAP_I point to the
pixmap ID, pixmap ID is owned by a persistant X connection which
must be killed with XKillClient). This is the default mode.
--run Maintains the background while running, but does not set it.
This mode may take less memory than SET, since xsri can use mul‐
tiple windows to display the image, and will work better on
Pseudo-color displays. On exit, the background will be in an
undefined state.
--test The image is displayed in a window which is half the width and
height of the screen.
Background Color and Gradient Options
--color=COLOR1
Set the background color.
--color2=COLOR2
If set, the background will be a gradient.
--hgradient
Draw a horizontal gradient from COLOR1 at the left to COLOR2 at
the right. (Default if --color2 is given.)
--vgradient
Draw a vertical gradient from COLOR1 at the top to COLOR2 at the
bottom. (Default if --color2 is given.)
Tiled Image Options
--tile=IMAGE
The image to tile.
--tile-alpha={0-255}
The alpha value of the tile (255 == fully opaque, default)
Emblem Options
--emblem=IMAGE
Set the emblem image to IMAGE.
--emblem-alpha={0-255}
Set the alpha value of the emblem. The default is 255 ( == fully
opaque).
--emboss
Emboss the emblem on the background.
--geometry=[WIDTHxHEIGHT][+X+Y]
Set the location or size of the emblem. Either the width and
height or the location may be omitted.
--center-x
Center the emblem in the X direction.
--center-y
Center the emblem in the Y direction.
--scale-width[=PERCENT]
Scale the emblem horizontally to a fraction of the width of the
screen. 100% is the default.
--scale-height[=PERCENT]
Scale the emblem vertically to a fraction of the height of the
screen. 100% is the default.
--avoid=WIDTHxHEIGHT[+X+Y]
Shrink the width and/or height of the emblem as necessary to
avoid the given rectangle. If X and Y are not specified, the
rectangle is centered. (Implies --keep-aspect.)
--keep-aspect
The width or height of the emblem will be shrunk as needed to
maintain the aspect ratio.
PLACEMENT AND SCALING
The placement and scaling item algorithm, specified exactly:
Set w and h to width and height of the image.
If --geometry=WxH was specifed, set w to W, h to H. If --scale-
width=PERCENT was specified, set w to (PERCENT/100) * screen_width. If
--scale-height=PERCENT was specified, set h to (PERCENT/100) *
screen_height.
Define the horizontal gravity point to be at center if --center-x was
specified; otherwise, at right if --geometry=-X was specified; other‐
wise at left.
Define the vertical gravity point to be at center if --center-y was
specified; otherwise, at bottom if --geometry=-Y was specified; other‐
wise at top.
If --center-x, was specified, set x to center the image on the screen;
otherwise, if the position was specified via geometry, use that; other‐
wise set x = 0.
If --center-y, was specified, set y to center the image on the screen;
otherwise, if the position was specified via geometry, use that; other‐
wise set y = 0.
If --keep-aspect or --avoid was specified, then if the aspect ratio is
narrower than that of the image, shrink the height to make the aspect
ratio match; if the aspect ratio is wider than that of the image,
shrink the height to make the apsect ratio match, keeping the gravity
point at the same location.
If --avoid was specified, shrink the image, keeping the aspect ratio
the same and the gravity point in the same place to avoid the given
rectangle. If this isn't possible, do not display the emblem.
AUTHOR
Owen Taylor <otaylor@redhat.com>
COPYRIGHT
Copyright © 2001, Red Hat, Inc. xsri is distributed under the terms of
the GNU General Public License. See the included file “COPYING”.
SEE ALSO
Esetroot(1), xsetroot(1)
xsri 2.1.0 2004-01-25 XSRI(1)
[top]
List of man pages available for Cygwin
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
Vote for polarhome
|