xmag(1) X Version 11 (22 October 1988) xmag(1)
NAME
xmag - magnifies parts of the screen
SYNOPSIS
xmag [-options ...]
DESCRIPTION
The xmag program allows you to magnify portions of the
screen. When you invoke xmag, a square appears around the
pointer indicating the area to be enlarged. Once you select
a region, a window pops up showing an enlarged version of
the region in which each pixel in the source image is
represented by a small square of the same color.
To display the position, number, and RGB value of any pixel
in the enlarged window, press mouse button 1 over that
pixel, and a small window appears that displays the
information. This information stays on your screen until
you release the mouse button.
To remove the current enlarged image, press the space bar or
any other mouse button. Now you can select a different
region to enlarge.
To exit the program, press q, Q, '', or Ctrl-C in the
enlargement window.
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 location of the enlargement
window. By default, the size is computed from the size
of the source region and the desired magnification.
Therefore, you can use only one of the -source size and
-mag magfactor options if you specify a window size
with this option.
-source geom
Specifies the size and location of the source region.
By default, a 64x64 square around the pointer is
provided so you can 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, you can use only one of the -geometry
size and -mag magfactor options if you specify a source
size with this option.
-mag magfactor
Page 1 (printed 10/4/89)
xmag(1) X Version 11 (22 October 1988) xmag(1)
Specifies an integral factor by which to enlarge the
source region. The default magnification is 5. This
is used with the size of the source to compute the
default enlargement window size. Therefore, you can
use only one of the -geometry size and -source geom
options if you specify a magnification factor with this
option.
-bw pixels
Specifies the width of the window border in pixels.
-bd color
Specifies the border color of the enlargement window.
-bg colororpixelvalue
Specifies the color name for the window background. 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 BlackPixel.
-fn fontname
Specifies the font name for displaying pixel values
(used when you press mouse button 1 in the enlargement
window).
-z Indicates that the server should be grabbed during the
dynamics and the call to XGetImage. This ensures that
clients don't change their state as a result of
entering or leaving them with the mouse.
X DEFAULTS
The xmag program uses the following X resources:
geometry (class Geometry)
Specifies the size and location of the enlargement
window.
source (class Source)
Specifies the size and location of the source region on
the screen.
magnification (class Magnification)
Specifies the enlargement factor.
borderWidth (class BorderWidth)
Specifies the border width in pixels.
borderColor (class BorderColor)
Specifies the border color.
Page 2 (printed 10/4/89)
xmag(1) X Version 11 (22 October 1988) xmag(1)
background (class Background)
Specifies the color or pixel value for the background
of the enlargement window.
font (class Font)
Specifies the font name for displaying pixel values.
(This happens when you press mouse button 1 in the
enlargement window.)
LIMITATIONS
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 need to specify two of the three
parameters. This can be confusing.
You cannot see a dynamic display while dragging the mouse.
SEE ALSO
X(1)
xwd(1)
COPYRIGHT
Copyright 1988, Massachusetts Institute of Technology.
AUTHOR
Jim Fulton, MIT X Consortium.
Page 3 (printed 10/4/89)