xmag_multivis
(1)
Name
xmag_multivis - magnify parts of the screen
Synopsis
/usr/bin/xmag_multivis [ -display display ] [ -geometry geom
] [ -source geom ] [ -mag magfactor ] [ -bw pixels ] [ -bd
color ] [ -bg colorpixelvalue ] [ -fn fontname ] [ -z ]
Description
Games and Demos xmag_multivis(6)
NAME
xmag_multivis - magnify parts of the screen
SYNOPSIS
/usr/bin/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 differ-
ing depth, visual or colormap. If the selected region does
contain such windows, the image displayed 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 ver-
sion of the image.
-geometry geom
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 size and -mag magfactor options may be spec-
ified if a window size is given with this option.
SunOS 5.11 Last change: 23 March 1992 1
Games and Demos xmag_multivis(6)
-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 magnifi-
cation 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 magnifi-
cation factor is given with this option.
-bw pixels
This option specifies the width in pixels of the
border surrounding the enlargement window.
-bd color
This option specifies the color to use for the bor-
der surrounding 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 BlackPixel 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 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 xmag_multivis program uses the following X resources:
SunOS 5.11 Last change: 23 March 1992 2
Games and Demos xmag_multivis(6)
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)
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
xwd(1), xmag(1)
BUGS
On displays that export multiple visuals, if the selected
region needs to be composited from each window, xmag_multi-
vis 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_multi-
vis 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 confusing.
Being able to drag the pointer around and see a dynamic dis-
play 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.
SunOS 5.11 Last change: 23 March 1992 3
Games and Demos xmag_multivis(6)
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.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |x11/xmag |
+-----------------------------+-----------------------------+
|Interface Stability |Committed |
+-----------------------------+-----------------------------+
SunOS 5.11 Last change: 23 March 1992 4