[0m


XMAG(1)             UNIX Programmer's Manual		  XMAG(1)



[1mNAME
     [0mxmag - magnify parts of the screen

[1mSYNOPSIS
     xmag [0m[-option ...]

[1mDESCRIPTION
     [0mThe _x_m_a_g program allows you to magnify portions of the
     screen.  If no explicit region is specified, a square cen-
     tered around the pointer is displayed indicating the area to
     be enlarged.  Once a region has been selected, a window is
     popped up showing 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 pro-
     gram.

[1mOPTIONS
     -display [0m_d_i_s_p_l_a_y
	     This option specifies the X server to use for both
	     reading the screen and displaying the enlarged ver-
	     sion of the image.

     [1m-geometry [0m_g_e_o_m
	     This option 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
	     [1m-source [0m_s_i_z_e and [1m-mag [0m_m_a_g_f_a_c_t_o_r options may be
	     specified if a window size is given with this
	     option.

     [1m-source [0m_g_e_o_m
	     This option 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 magnifi-
	     cation to compute the default enlargement window
	     size.  Therefore, only one of [1m-geometry [0m_s_i_z_e and
	     [1m-mag [0m_m_a_g_f_a_c_t_o_r options may be specified if a source
	     size is given with this option.

     [1m-mag [0m_m_a_g_f_a_c_t_o_r
	     This option specifies an integral factor by which
	     the source region should be enlarged.  The default
	     magnification is 5.  This is used with the size of



Printed 25/2/94             Release 4				1






XMAG(1)             UNIX Programmer's Manual		  XMAG(1)



	     the source to compute the default enlargement window
	     size.  Therefore, only one of [1m-geometry [0m_s_i_z_e and
	     [1m-source [0m_g_e_o_m options may be specified if a magnifi-
	     cation factor is given with this option.

     [1m-bw [0m_p_i_x_e_l_s
	     This option specifies the width in pixels of the
	     border surrounding the enlargement window.

     [1m-bd [0m_c_o_l_o_r
	     This option specifies the color to use for the
	     border surrounding the enlargement window.

     [1m-bg [0m_c_o_l_o_r_o_r_p_i_x_e_l_v_a_l_u_e
	     This option specifies the name of the color to be
	     used as the background of the enlargement window.
	     If the name begins with a percent size (%), 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.

     [1m-fn [0m_f_o_n_t_n_a_m_e
	     This option specifies the name of a font to use when
	     displaying pixel values (used when Button1 is
	     pressed in the enlargement window).

     [1m-z      [0mThis option indicates that the server should be
	     grabbed during the dynamics and the call to XGetIm-
	     age.  This is useful for ensuring that clients don't
	     change their state as a result of entering or leav-
	     ing them with the pointer.

[1mX DEFAULTS
     [0mThe _x_m_a_g program uses the following X resources:

     [1mgeometry ([0mclass [1mGeometry)
	     [0mSpecifies the size and/or location of the enlarge-
	     ment window.

     [1msource ([0mclass [1mSource)
	     [0mSpecifies the size and/or location of the source
	     region on the screen.

     [1mmagnification ([0mclass [1mMagnification)
	     [0mSpecifies the enlargement factor.

     [1mborderWidth ([0mclass [1mBorderWidth)
	     [0mSpecifies the border width in pixels.

     [1mborderColor ([0mclass [1mBorderColor)



[0mPrinted 25/2/94             Release 4				2






XMAG(1)             UNIX Programmer's Manual		  XMAG(1)



	     Specifies the color of the border.

     [1mbackground ([0mclass [1mBackground)
	     [0mSpecifies the color or pixel value to be used for
	     the background of the enlargement window.

     [1mfont ([0mclass [1mFont)
	     [0mSpecifies the name of the font to use when display-
	     ing pixel values when the user presses Button1 in
	     the enlargement window.

[1mSEE ALSO
     [0mX(1), xwd(1)

[1mBUGS
     [0mThis program will behave 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 very nice.

     Another possible interface would be for the user to drag out
     the desired area to be enlarged.

[1mCOPYRIGHT
     [0mCopyright 1988, Massachusetts Institute of Technology.

[1mAUTHOR
     [0mJim Fulton, MIT X Consortium






















Printed 25/2/94             Release 4				3



[0m