NAME

       xmag - magnify parts of the screen

SYNOPSIS

       xmag [ -mag magfactor ] [ -source geom ] [ -toolkitoption ... ]

DESCRIPTION

       The  xmag program allows you to magnify portions of an X screen.  If no explicit region is
       specified, a square with the pointer in the upper left corner is displayed indicating  the
       area  to  be enlarged.  The area can be dragged out to the desired size by pressing Button
       2.  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 in the enlargement window shows the position and  RGB  value
       of  the  pixel  under the pointer until the button is released.  Typing ``Q'' or ``^C'' in
       the enlargement window exits the program.  The application has 5 buttons across  its  top.
       Close  deletes  this particular magnification instance.  Replace brings up the rubber band
       selector again to select another region for this magnification instance.   New  brings  up
       the  rubber  band  selector  to  create  a  new  magnification  instance.  Select puts the
       magnification image into the primary selection.  Paste copies the primary selection buffer
       into xmag.  Note that you can cut and paste between xmag and the bitmap program.  Resizing
       xmag resizes the magnification area.  xmag preserves  the  colormap,  visual,  and  window
       depth of the source.

WIDGETS

       xmag  uses  the  X Toolkit and the Athena Widget Set.  The magnified image is displayed in
       the Scale widget.  For more information, see the Athena Widget Set  documentation.   Below
       is  the  widget  structure  of  the  xmag application.  Indentation indicates hierarchical
       structure.  The widget class name is given first, followed by the widget instance name.

            Xmag xmag
                 RootWindow root
                 TopLevelShell xmag
                      Paned pane1
                           Paned pane2
                                Command close
                                Command replace
                                Command new
                                Command select
                                Command paste
                                Label xmag label
                           Paned pane2
                                Scale scale
                 OverrideShell pixShell
                      Label pixLabel

OPTIONS

       -source geom   This option specifies the size and/or location of the source region on  the
                      screen.   By  default, a 64x64 square is provided for the user to select an
                      area of the screen.

       -mag integer   This option indicates the magnification to be used.  5 is the default.

AUTHORS

       Dave Sternlicht and Davor Matic, MIT X Consortium.