MAN(1) MAN(1)
6 January 1989
NAME
xbgsun - load Sun rasterfiles onto an X11 root window
SYNOPSIS
xbgsun [global_options] [raster_options] rasterfile ...
DESCRIPTION
Xbgsun loads one or more Sun rasterfiles onto an X11 root window. If
raster file names end in .Z, they will be uncompressed before loading
(this saves a lot of disk space). If configured to use them, xbgsun
will look for files along a default path and/or with a default suffix
in addition to .Z.
Unless the first image loaded onto the window is centered or placed,
it will be replicated over the entire window, essentially becoming the
background for all subsequent images.
Xbgsun will load color images onto a display of any depth, although
they may look strange if it cannot allocate the proper colors. It
allocates only those colors which are used in the image that you are
transferring. Usually this allows many colormap entries to remain the
same as before you load the image, although it slows down operation
somewhat. Any combination of image depths may be loaded at one time.
GLOBAL OPTIONS
The following options affect the global operation of xbgsun:
-border color
This sets the background portion of the window which is not
covered by any images to be color.
-corrupt
Attempt to load a rasterfile whose image data area has been
corrupted. This is really only useful if the image is shorter
than expected.
-defaults
Displays the default path and suffix which xbgsun will use if
it cannot find the image with the given name. This options
causes everything else to be ignored.
-display display_name
X11 display name.
-geometry =XxY
This sets the size of the window onto which the images are
loaded to a different value than the size of the display. If
the window is smaller than the display, it will be replicated
to fill the display.
- 1 - Formatted: August 19, 2008
MAN(1) MAN(1)
6 January 1989
-help Displays a short summary of xbgsun command line syntax. This
option causes everything else to be ignored.
-quiet Forces xbgsun to be quiet while it works. Normally it likes
to whistle.
-verbose
Causes xbgsun to be talkative, telling you what kind of image
it's playing with and any special processing that it has to
do. This is the default.
RASTER OPTIONS
The following options may preceed each rasterfile. These options are
local to the rasterfile they preceed.
-background color
Use color as the background color instead of white if you are
transferring a monochrome image to a color display.
-center
Center the image on the window.
-at X,Y
Indicates where the image should be loaded onto the window.
-clip X,Y,W,H
Clip the image before loading it. X and Y are the coordinates to
start clipping at, W is the width to use, and H is the height.
If W or H are zero or negative, clipping will start at (X,Y) and
will continue to the end of the image. Clipping boundaries are
adjusted to fit within the image (eg -10,0,100,100 for a 50x50
image will be adjusted to 0,0,50,50). This is useful when you
would only like a portion of an image, such as the girl (guy) in
the middle of an image but not all the guys (girls) around her
(him).
-foreground color
Use color as the foreground color instead of black if you are
transferring a monochrome image to a color display.
EXAMPLES
To load the rasterfile "raster.sun" onto the background and replicate
it to fill the entire background:
xbgsun raster.sun
To load a monochrome image "raster.sun" onto the background, using red
as the foreground color, replicate the image, and overlay
"raster2.sun" onto it at coordinate (10,10):
xbgsun -foreground red raster.sun -at 10,10 raster2.sun
- 2 - Formatted: August 19, 2008
MAN(1) MAN(1)
6 January 1989
To center the rectangular region from 10 to 110 along the X axis and
from 10 to the height of the image along the Y axis:
xbgsun -center -clip 10,10,100,0 raster.sun
AUTHOR
Jim Frost
Associative Design Technology
madd@bu-it.bu.edu
BUGS
Xbgsun assumes that the number of colors in a colormap is power(2,
depth). This might be bogus on some systems.
Things can look strange if you transfer an image of depth n to a
display with a smaller depth (eg color to monochrome).
- 3 - Formatted: August 19, 2008
|
