XMAG(1)                  USER COMMANDS                    XMAG(1)



NAME
     xmag - magnify parts of the screen

SYNOPSIS
     xmag [-option ...]

DESCRIPTION
     The _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.

OPTIONS
     -display _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.

     -geometry _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
             -source _s_i_z_e  and  -mag  _m_a_g_f_a_c_t_o_r  options  may  be
             specified  if  a  window  size  is  given  with this
             option.

     -source _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  -geometry  _s_i_z_e  and
             -mag  _m_a_g_f_a_c_t_o_r options may be specified if a source
             size is given with this option.

     -mag _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



X Version 11         Last change: Release 4                     1






XMAG(1)                  USER COMMANDS                    XMAG(1)



             the source to compute the default enlargement window
             size.  Therefore, only one  of  -geometry  _s_i_z_e  and
             -source  _g_e_o_m options may be specified if a magnifi-
             cation factor is given with this option.

     -bw _p_i_x_e_l_s
             This option specifies the width  in  pixels  of  the
             border surrounding the enlargement window.

     -bd _c_o_l_o_r
             This option specifies  the  color  to  use  for  the
             border surrounding the enlargement window.

     -bg _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.

     -fn _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).

     -z      This 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.

X DEFAULTS
     The _x_m_a_g program uses the following X resources:

     geometry (class Geometry)
             Specifies the size and/or location of  the  enlarge-
             ment window.

     source (class Source)
             Specifies the size and/or  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)



X Version 11         Last change: Release 4                     2






XMAG(1)                  USER COMMANDS                    XMAG(1)



             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  display-
             ing  pixel  values  when the user presses Button1 in
             the enlargement window.

SEE ALSO
     X(1), xwd(1)

BUGS
     This 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.

COPYRIGHT
     Copyright 1988, Massachusetts Institute of Technology.

AUTHOR
     Jim Fulton, MIT X Consortium






















X Version 11         Last change: Release 4                     3