XMAG(1) XMAG(1)
NAME
xmag - magnify parts of the screen
SYNOPSIS
xmag [-option ...]
DESCRIPTION
The xmag program allows you to magnify portions of the
screen. If no explicit region is specified, a square
centered around the pointer is displayed indicating the
area to be enlarged. Once a region has been selected,
a window shows a blown up version of the region in
which each pixel in the source image is represented by
a small square of the same color. Pressing Button1 on
the pointer in the enlargement window pops up a small
window displaying the position, number, and RGB value
of the pixel under the pointer until the button is
released. Pressing the space bar or any other pointer
button removes the enlarged image so that another
region may be selected. Pressing q, Q, or ^C in the
enlargement window exits the program.
OPTIONS
-display display
specifies the X server to use for both reading the
screen and displaying the enlarged version of the
image.
-geometry geom
specifies the size and/or location of the enlargement
window. By default, the size is computed from the
size of the source region and the desired
magnification. Therefore, only one of -source size
and -mag magfactor options may be specified if a
window size is given with this option.
-source geom
specifies the size and/or location of the source
region on the screen. By default, a 64x64 square
centered about the pointer is provided for the user
to select an area of the screen. The size of the
source is used with the desired magnification to
compute the default enlargement window size.
Therefore, only one of -geometry size and -mag
magfactor options may be specified if a source size
is given with this option.
- 1 -
XMAG(1) XMAG(1)
-mag magfactor
specifies an integral factor by which the source
region is enlarged. The default magnification is 5.
This is used with the size of the source to compute
the default enlargement window size. Therefore, only
one of -geometry size and -source geom options may be
specified if a magnification factor is given with
this option.
-bw pixels
specifies the width in pixels of the border
surrounding the enlargement window.
-bd color
specifies the color to use for the border surrounding
the enlargement window.
-bg colororpixelvalue
specifies the name of the color to be used as the
background of the enlargement window. If the name
begins with a percent sign (%), it is interpreted to
be an absolute pixel value. This is useful when
displaying large areas since pixels that are the same
color as the background do not need to be painted in
the enlargement. The default is to use the
BlackPixel of the screen.
-fn fontname
specifies the name of a font to use when displaying
pixel values (used when Button1 is pressed in the
enlargement window).
-z
indicates that the server is grabbed during the
dynamics and the call to XGetImage. This is useful
to ensure that clients do not change their state as a
result of entering or leaving them with the pointer.
X DEFAULTS
The xmag program uses the following X resources:
geometry (class Geometry)
specifies the size and/or location of the
enlargement window.
source (class Source)
specifies the size and/or location of the source
region on the screen.
magnification (class Magnification)
specifies the enlargement factor.
- 2 -
XMAG(1) XMAG(1)
borderWidth (class BorderWidth)
specifies the border width in pixels.
borderColor (class BorderColor)
specifies the color of the border.
background (class Background)
specifies the color or pixel value to be used for
the background of the enlargement window.
font (class Font)
specifies the name of the font to use when
displaying pixel values when the user presses
Button1 in the enlargement window.
SEE ALSO
xwd(1)
BUGS
This program behaves strangely on displays that support
windows of different depths.
Because the window size equals the source size times
the magnification, you only needs to specify two of the
three parameters. This can be confusing.
Being able to drag the pointer around and see a dynamic
display would be useful.
Another possible interface would be for the user to
drag out the desired area to be enlarged.
AUTHOR
Jim Fulton, MIT X Consortium
- 3 -