xmag(1X) xmag(1X)NAME xmag - magnifies parts of the screen SYNOPSIS xmag [-display display] [-geometry geometry] [-source geometry] [-mag factor] [-bw width] [-bd color] [- bg color-or-pixel-value] [-fn font] [-z] DESCRIPTION xmag magnifies portions of the screen. If you don't specify an explicit region, a square centered around the pointer is displayed and indicates the area to be enlarged. Once you select a region by pressing the mouse button, the enlarge- ment window is displayed showing a blown-up version of the region in which each pixel from the source image is represented by a small square of the same color. Pressing the mouse button while the pointer resides in the enlarge- ment window displays a small window that shows the position, number, and RGB (red-green-blue) value of the pixel under the pointer. This window disappears when you release the mouse button. Pressing the SPACE BAR or the LEFT ARROW key or RIGHT ARROW key removes the enlarged image so that you may select another region. Pressing the Q key or CONTROL-C in the enlargement window terminates the program. Options The xmag client application accepts these options: -bd color Specifies the color for the border of the enlarge- ment window. -bg color-or-pixel-value Specifies the color for the background of the en- largement window. If color-or-pixel-value begins with a percent sign (%), it is interpreted as an ab- solute pixel value. This option is useful when displaying large areas because pixels that are the same color as the background do not need to be painted in the enlargement. The default is the value of the screen's BlackPixel. -bw width Specifies in pixels the width of the border of the enlargement window. November, 1990 1
xmag(1X) xmag(1X)-display display Specifies the X server to use for both reading the screen and displaying the enlarged version of the image. -fn font Specifies the name of a font to use when displaying pixel values The font is used in the window that is displayed when the pointer is in the enlargement window). -geometry geometry Specifies the size or location of the enlargement window. See X(1X) for details. By default, the size is computed from the size of the source region and the desired magnification. Therefore, you can speci- fy only the -source geometry or -mag factor option if you specify a window size using this option. -mag factor Specifies an integral factor by which the source re- gion should be enlarged. The default magnification is 5. This option is used with the size of the source to compute the default enlargement window size. Therefore, you can specify only the -geometry geometry or -source geometry option if you specify a magnification factor using this option. -source geometry Specifies the size or location of the source region on the screen. See X(1X) for details. By default, a 64 x 64 square of pixels 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 en- largement window size. Therefore, you can specify only the -geometry geometry or -mag factor option if you specify a source size using this option. -z Indicates that the server should be grabbed during the dynamics and the call to XGetImage(3X). This option is useful for ensuring that clients do not change their state as a result of entering or leav- ing them with the pointer. X defaults The xmag client application uses the following X resources: background (class Background) Specifies the color or pixel value to be used for the background of the enlargement window. 2 November, 1990
xmag(1X) xmag(1X)borderWidth (class BorderWidth) Specifies in pixels the border width. borderColor (class BorderColor) Specifies the color of the border. font (class Font) Specifies the name of the font to use when display- ing pixel values in the window that appears when the user presses the mouse button in the enlargement window. geometry (class Geometry) Specifies the size or location of the enlargement window. magnification (class Magnification) Specifies the enlargement factor. source (class Source) Specifies the size or location of the source region on the screen. LIMITATIONS The xmag client application 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. Being able to drag the pointer around and see a dynamic display would be nice. Another possible interface would be for the user to drag out the desired area to be enlarged. NOTES Copyright 1988, Massachusetts Institute of Technology. Author: Jim Fulton, MIT X Consortium SEE ALSO X(1X), xwd(1X) November, 1990 3