Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

xmag_multivis (1)

Name

xmag_multivis - magnify parts of the screen

Synopsis

xmag_multivis  [ -display display ] [ -geometry geom ] [ -source geom ]
[ -mag magfactor ] [ -bw pixels ] [ -bd color ] [ -bg colorpixelvalue ]
[ -fn fontname ] [ -z ]

Description

xmag_multivis(1)            General Commands Manual           xmag_multivis(1)



NAME
       xmag_multivis - magnify parts of the screen

SYNOPSIS
       xmag_multivis  [ -display display ] [ -geometry geom ] [ -source geom ]
       [ -mag magfactor ] [ -bw pixels ] [ -bd color ] [ -bg colorpixelvalue ]
       [ -fn fontname ] [ -z ]

DESCRIPTION
       The xmag_multivis program allows you to magnify portions of the screen.
       If no explicit region  is  specified,  a  square  centered  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, in hexadecimal
       notation, the position, pixel value, 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 program.

       On displays that export multiple Visuals, the selected region is  first
       examined  for  overlaps  by  windows of differing depth, visual or col-
       ormap. If the selected region does contain such windows, the image dis-
       played  in  the  enlargement  window  is constructed by compositing the
       images from the various windows under  the  selected  region.  In  this
       case,  the composite image will only be displayed in a TrueColor 24 bit
       deep window, provided such a window can be created on that screen.  The
       image  displayed in the enlargement window will exhibit true colors for
       every pixel in the composite image, regardless of  the  Colormap  state
       (Installed/UnInstalled)  of  any  of  the  windows  within the selected
       region.


OPTIONS
       -display display
               This option specifies the X server to use for both reading  the
               screen and displaying the enlarged version of the image.

       -geometry geom
               This  option specifies the size and/or location of the enlarge-
               ment window.  By default, the size is computed from the size of
               the  source  region  and the desired magnification.  Therefore,
               only one of -source size and  -mag  magfactor  options  may  be
               specified if a window size is given with this option.

       -source geom
               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
               magnification  to  compute the default enlargement window size.
               Therefore, only  one  of  -geometry  size  and  -mag  magfactor
               options  may  be  specified if a source size is given with this
               option.

       -mag magfactor
               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 the source to compute the default
               enlargement window size.  Therefore, only one of -geometry size
               and -source geom options may be specified  if  a  magnification
               factor is given with this option.

       -bw pixels
               This  option  specifies  the width in pixels of the border sur-
               rounding the enlargement window.

       -bd color
               This option specifies the color to use for the border surround-
               ing the enlargement window.

       -bg colororpixelvalue
               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  Black-
               Pixel of the screen.

       -fn fontname
               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 XGetImage.   This  is  useful  for
               ensuring  that  clients don't change their state as a result of
               entering or leaving them with the pointer.

X DEFAULTS
       The xmag_multivis program uses the following X resources:

       geometry (class Geometry)
               Specifies the size and/or location of the enlargement 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)
               Specifies the color of the border.

       background (class Background)
               Specifies  the  color  or  pixel value to be used for the back-
               ground of the enlargement window.

       font (class Font)
               Specifies the name of the font to  use  when  displaying  pixel
               values when the user presses Button1 in the enlargement window.

SEE ALSO
       xwd(1), xmag(1)

BUGS
       On  displays that export multiple visuals, if the selected region needs
       to be composited from each window, xmag_multivis insists on a TrueColor
       24  bit window to display the selected region, and exits with a failure
       if such a window cannot be created.   It  would  be  nice,  instead  if
       xmag_multivis  would  determine the best possible visual to display the
       image, or instead tried to display the image in a  visual  selected  by
       the user in a command line option.

       Because the window size equals the source size times the magnification,
       you only need to specify two of the three parameters.  This can be con-
       fusing.

       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.

       MultiVisual  code:  Copyright 1990, 1997, Oracle and/or its affiliates.
       All rights reserved.

AUTHOR
       Jim Fulton, MIT X Consortium

       MultiVisual code: Milind Pansare, Sun Microsystems, Inc.



                                 23 March 1992                xmag_multivis(1)