5. Magnifier Magnifier Configuring the zoom window appearance Joanmarie Diggs joanied@gnome.org

Creative Commons Share Alike 3.0

 Magnifier Preferences
Enable Magnifier

The Enable magnifier check box enables and disables Orca's magnification support. When it is unchecked, the other widgets on this page become unavailable.

Default value: not checked

Zoomer

The Zoomer options allow you to customize the magnifier's level, position, and size, as well as to hide the system pointer.

Scale factor

Scale factor can be used to set the magnification level from 1.0x to 16.0x (fractional values are supported).

Position

Position can be used to specify the placement of the magnifier on your screen. The available positions are: Full Screen, Left Half, Right Half, Top Half, Bottom Half, and Custom.

Default value: Full Screen

Specifying the Bounds of a "Custom" Zoomer

Choosing a Position of Custom causes four spin buttons to become available: Top, Left, Right , and Bottom.

These spin buttons allow you to define the location of each edge of the zoom window. Units are in pixels.

Hide system pointer

The Hide system pointer checkbox will hide the unmagnified pointer, leaving just the magnified one visible.

Default value: unchecked

Tracking and Alignment

These options control the tracking of the mouse cursor.

Mouse Pointer

The Mouse Pointer combo box allows you to select your tracking and alignment from the following options:

Centered: Keeps the mouse pointer at the center of the screen whenever possible.

Proportional: Positions the mouse pointer in the zoom window relative to its actual, unmagnified position. For instance, if the mouse pointer is 25% away from the left edge of the desktop, Orca positions the magnified mouse pointer 25% from the left edge of the zoom window.

Push: Moves the zoomer window the least amount necessary to keep the mouse pointer on the screen.

None: Moving the mouse pointer has no impact on what the zoomer window displays.

Default value: Centered

Pointer follows zoomer

The Pointer follows zoomer checkbox allows you to customize what should occur if the mouse pointer is not on the screen when you initially move the mouse. With this option enabled, if the mouse pointer is not on the screen when you initially move the mouse, it will be moved into the zoomer so that you can continue to see what you were working on. If your preferred mouse tracking mode is centered, the pointer will be moved to the center; otherwise it will be moved to the item with focus.

Default value: checked

Control and menu item

These options control additional behavior of the magnifier.

Centered: When navigating via keyboard, keep the focused dialog box control or menu item at the center of the screen whenever possible.

Push: When navigating via keyboard, move the zoomer window the least amount necessary to display the focused dialog box control or menu item.

None: Using the keyboard to navigate among dialog box controls and menu items will have no impact on what the zoomer window displays.

Default value: Push

Pointer follows focus

Pointer follows focus: If this option is enabled, the mouse pointer will follow you as you arrow through menu items and move among controls in dialog boxes.

Default value: not checked

Text cursor

These options control how the text cursor behaves.

Centered: As the text cursor moves, keep it at the center of the screen whenever possible.

Push: As the text cursor moves, move the zoomer window the least amount necessary to display it.

None: Moving the text cursor will have no impact on what the zoomer window displays.

Default value: Push

Edge margin

The Edge margin is how close the caret should be allowed to get to the edge of the screen before it's time to "push" the zoomer window. The margin can range from 0 to 50%, with 50% being the equivalent of choosing centering.

This option is only available if "Push" is your text cursor tracking mode.

Default value: 0

Color

The Color options allow you to do some rough color adjustments of the magnified region.

Invert colors

Invert colors: Creates a reverse or negative-image effect.

Default value: not checked

Brightness

Brightness: Ranges from -1 to 1 (-1 is black/no brightness; 1 is white/total brightness; 0 is "normal"/unchanged).

Default value: 0.00

Contrast

Contrast: Ranges from -1 to 1 (-1 is grey/no contrast; 1 is maximum contrast; 0 is "normal"/unchanged).

Default value: 0.00

Border

The Border options can be used to customize the border which separates the magnified region from the non-magnified region. As such, these options are not available when Full Screen is selected.

Enable border

Enable border: This option determines if a window border is visible for the magnifier.

Default value: not checked

Border size

This value determines the size of the border in pixels.

Default value: 1

Border color

This value determines the color of the border.

Default value: black

Cursor

These controls can be used to customize the size and color of the magnifier's cursor.

Enable cursor

If this checkbox is checked then a cursor is visible and the size and color options become available.

Default value: checked

Custom size

Check this checkbox if you would like to make the mouse pointer larger than it normally is.

Default value: not checked

Cursor size

This value determines the size of the cursor in pixels.

Default value: 32

Cursor color

This value determines the color of the cursor.

Default value: black

Cross-hair

This set of controls can be used to customize the magnifier's optional area-targeting cursor.

Enable cross-hair

If this checkbox is checked then the cross-hair is visible and the size and color options become available.

Default value: checked

Enable cross-hair clip

If checked, the cross-hair will be "clipped" (removed) in the area immediately surrounding the mouse pointer.

Default value: not checked

Cross-hair size

This control sets the thickness of the cross-hair in pixels.

Default value: 16

Cross-hair color

This value determines the color of the cross-hair.

Default value: black

Advanced

If you press the Advanced button located near the bottom of the Magnifier page, you can further customize Orca's magnification support.

Smoothing: Bilinear or none.

Brightness: Choosing different brightness levels for red, blue, and green allows you to create the color scheme that works best for you.

Contrast: While not as significant as changes to brightness, choosing different contrast levels for red, blue, and green helps you to create the color scheme that works best for you.

Color Filtering: Allows you to pick one of the colorblind filters available through libcolorblind. In order to take advantage of this feature you will need to install libcolorblind and then rebuild gnome-mag.

Multi-Monitor Settings - Source Display: X Window System DISPLAY of what should be magnified. Written in the form ":0.x" where x is the number of the screen whose contents should be magnified.

Multi-Monitor Settings - Target Display: X Window System DISPLAY of where to put the zoomer window. Written in the form ":0.y" where y is the number of the screen where the zoomer window should appear.