magnifier(1) User Commands magnifier(1)NAMEmagnifier - standalone magnification service for GNOME
SYNOPSISmagnifier--fullscreen | --horizontal | --vertical [--border-
color=long] [--border-size=int] [--cursor-color=long] [--cursor-scale-
factor=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]
DESCRIPTIONmagnifier provides a simple fullscreen or splitscreen magnifier for
GNOME.
magnifier also provides a magnification service API for use by assis‐
tive technologies such as orca, and is more commonly used in this ser‐
vice mode.
OPTIONS
The following options are supported:
--border-color=long Specify the border color as (A)RGB 23-bit
value, Alpha-MSB. You can also use -c to spec‐
ify this option.
--border-size=int Specify the width of the border. You can also
use -b to specify this option.
--cursor-color=long Specify the cursor color, applied to
'black'pixels.
--cursor-scale-f=float Specify the cursor scale factor.
--cursor-set=string Specify the cursor set touse in the target dis‐
play.
--cursor-size=int Specify 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-dis‐
play 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=int Specify the maximum mouse latency time, in ms.
--no-initial-region Do not create an initial zoom region.
--override-redirect Make the magnifier window completely unmanaged
by the window manager.
--refresh-time=int Specify the minimum refresh time for idle, in
ms. You can also use -r to specify this option.
--smooth-scrolling Use smooth scrolling.
--smoothing-type=string Specify the image smoothing algorithm to apply:
either bilinear-interpolation or none.
--source-display=string Specify the display to magnify. You can also
use -s to specify this option.
--target-display=string Specify the display on which to show the magni‐
fie view. You can also use -t to specify this
option.
--timing-delta-x=int Specify the number of pixels to pan in the x-
dimension each frame in the timing update test.
--timing-delta-y=int Specify the number of pixels to pan in the y-
dimension each frame in the timing update test.
--timing-iterations=int Specify the number of iterations to run the
timing benchmark test (0=continuous)
--timing-output Display performance output.
--timing-pan-rate=int Specify the timing pan rate in lines per frame.
--usage Display a brief usage message.
--use-test-pattern Use the test pattern as the source.
--vertical Split the screen vertically, if the target dis‐
play is the same as the source display. You can
also use -v to specify this option.
--zoom-factor=float Specify the zoom (scale) factor used to mag-
nify the source display. You can also use -z to
specify this option.
EXTENDED DESCRIPTIONmagnifier 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 mag-nification), or -f (fullscreen magnifi‐
cation). If fullscreen magnification is specified, the source and tar‐
get 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 mag‐
nification 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 VARIABLESmagnifier uses $DISPLAY if the source or target displays are unspeci‐
fied 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 │gnome/accessibility/orca │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSO
Latest version of the GNOME Accessibility Guide for your platform.
orca(1), libatk-1.0(3), libcspi(3), attributes(5)NOTES
If you need fullscreen magnification due to visual difficulties, you
might benefit from using a full-featured assistive technology such as
orca instead.
Written by Bill Haneman, Sun Microsystems Inc., 2004.
SunOS 5.11 7 Aug 2008 magnifier(1)
