magnifier(1)							   User Commands						      magnifier(1)

NAME

       magnifier - standalone magnification service for GNOME

SYNOPSIS

       magnifier  --fullscreen	|  --horizontal  | --vertical [--border-color=long] [--border-size=int] [--cursor-color=long] [--cursor-scale-fac-
       tor=float] [--cursor-set=string] [--cursor-size=int] [--help] [--invert-image] [--mouse-follow] [--mouse-latency=int] [--no-initial-region]
       [--override-redirect]   [--refresh-time=int]   [--smooth-scrolling]   [--smoothing-type=string]	 [--source-display=string]  [--target-dis-
       play=string] [--timing-delta-x=int] [--timing-delta-y=int] [--timing-iterations=int]  [--timing-output]	[--timing-pan-rate=int]  [--usage]
       [--use-test-pattern] [--zoom-factor=float]

DESCRIPTION

       magnifier provides a simple fullscreen or splitscreen magnifier for GNOME.

       magnifier  also	provides   a magnification service API for use by assistive technologies such as gnopernicus, and is more commonly used in
       this service mode.

OPTIONS

       The following options are supported:

       --border-color=lSpecify the border color as (A)RGB 23-bit value, Alpha-MSB.  You can also use -c to specify this option.

       --border-size=inSpecify the width of the border. You can also use -b to specify this option.

       --cursor-color=lSpecify the cursor color, applied to 'black' pixels.

       --cursor-scale-fSpecifylthe cursor scale factor.

       --cursor-set=strSpecify the cursor set to use in the target display.

       --cursor-size=inSpecify the cursor size to use. This option overrides the --cursor-scale-factor option.

       --fullscreen    Specify fullscreen magnification, which covers the entire target display. If you specify this option, you must also specify
		       the --source-display and --target-display options. You can also use -f to specify this option.

       --help	       Display help message. You can also use -? to specify this option.

       --horizontal    Split  the  screen  horizontally,  if the target display is the same as the source display.  You can also use -h to specify
		       this option.

       --invert-image  Invert the image colormap. You can also use -i to specify this option.

       --mouse-follow  Track mouse movements. You can also use -m to specify this option.

       --mouse-latency=Specify the maximum mouse latency time, in ms.

       --no-initial-regDonnot create an initial zoom region.

       --override-redirMake the magnifier window completely unmanaged by the window manager.

       --refresh-time=iSpecify the minimum refresh time for idle, in ms. You can also use -r to specify this option.

       --smooth-scrolliUse smooth scrolling.

       --smoothing-typeSpecify the image smoothing algorithm to apply: either bilinear-interpolation or none.

       --source-displaySpecify the display to magnify. You can also use -s to specify this option.

       --target-displaySpecify the display on which to show the magnified view. You can also use -t to specify this option.

       --timing-delta-xSpecify the number of pixels to pan in the x-dimension each frame in the timing update test.

       --timing-delta-ySpecify the number of pixels to pan in the y-dimension each frame in the timing update test.

       --timing-iteratiSpecify the number of iterations to run the timing benchmark test (0=continuous).

       --timing-output Display performance output.

       --timing-pan-ratSpecify the timing pan rate in lines per frame.

       --usage	       Display a brief usage message.

       --use-test-patteUse the test pattern as the source.

       --vertical      Split the screen vertically, if the target display is the same as the source display.  You can also use -v to specify  this
		       option.

       --zoom-factor=flSpecify the zoom (scale) factor used to magnify the source display. You can also use -z to specify this option.

EXTENDED DESCRIPTION

       magnifier  provides  a  simple screen magnification utility for GNOME, offering splitscreen or fullscreen magnification. You should specify
       one of the following options: -v (vertical splitscreen magnification), -h (horizontal splitscreen magnification), or -f (fullscreen  magni-
       fication). If fullscreen magnification is specified, the source and target displays must also be specified.

       Note  that fullscreen magnification requires that two separate X server graphical screens are available. The source display can be virtual,
       that is, not connected to a physical graphics subsystem. The target display must be connected to a physical display device. Source and tar-
       get displays are of the following form:

       [hostname]:server_number.screen_number

       Most  users  of	magnifier  in standalone mode specify the -m option, which causes the magnified region to be continually recentered on the
       onscreen pointer position in the source display.

       magnifier capabilities include recoloring the mouse pointer, specifying the magnification factor for source to target conversion,  separate
       magnification factors for the mouse pointer, and whether or not to apply smoothing or averaging to the resized image.

EXAMPLES

       Example	1: Displaying a Fullscreen Magnified Image of Screen ":0.0" on Target Display ":0.1", at a Magnification Factor of 3.5, With Mouse
       Tracking:

       example% magnifier -f -m -s:0.0 -t:0.1 -z3.5

       Example 2: Displaying a Vertical Splitscreen Magnified Image on the Default Display, With a Scale Factor of 4 and a Horizontal Scale Factor
       of 3, Using Bilinear Interpolation to Smooth Resulting Image

       example% magnifier -v -m -z 4 --cursor-scale-factor=3 --smoothing-type=bilinear-interpolation

ENVIRONMENT VARIABLES

       magnifier uses $DISPLAY if the source or target displays are unspecified at startup.

FILES

       The following files are used by this application:

       /usr/bin/magnifier      Executable for standalone magnification service for GNOME

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWgnome-a11y-reader	   |
       +-----------------------------+-----------------------------+
       |Interface stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       Latest version of the GNOME Accessibility Guide for your platform.

       gnopernicus(1)

NOTES

       If  you need fullscreen magnification due to visual difficulties, you might benefit from using a full-featured assistive technology such as
       gnopernicus instead.

       Written by Bill Haneman, Sun Microsystems Inc., 2004.

SunOS 5.10							    7 Sep 2004							      magnifier(1)