Manual Pages for UNIX Operating System command usage for man magnifier

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-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-
     display=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  mag-
     nifier for GNOME.

     magnifier also provides a magnification service API for  use
     by assistive technologies such as orca, and is more commonly
     used in this service 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 specify 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 display.





SunOS 5.11           Last change: 7 Aug 2008                    1






User Commands                                        magnifier(1)



     --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-
                             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=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.





SunOS 5.11           Last change: 7 Aug 2008                    2






User Commands                                        magnifier(1)



     --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  algo-
                             rithm  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  magnifie 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.



SunOS 5.11           Last change: 7 Aug 2008                    3






User Commands                                        magnifier(1)



     --usage                 Display a brief usage message.



     --use-test-pattern      Use 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=float     Specify the zoom (scale) factor used
                             to  mag-nify 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 mag-
     nification), or -f (fullscreen magnification). 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 con-
     nected to a  physical  display  device.  Source  and  target
     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.





SunOS 5.11           Last change: 7 Aug 2008                    4






User Commands                                        magnifier(1)



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 Hor-
     izontal 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 magnifica-
                             tion service for GNOME



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       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 difficul-
     ties, 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           Last change: 7 Aug 2008                    5