The Magnifier Initialization File Documentation (MAGNIFY.INI)

Listed below are settings and information for specific applications that require special actions by The Magnifier, along with the Configuration settings for The Magnifier. The Brackets [ ] denote the area in the MAGNIFY.INI file corresponding to the instance of The Magnifier. Internally the count starts at 0, so the first instance uses the [Settings], the second [Settings1], etc.

All Settings are the default Settings of The Magnifier.

[Settings]

The following are the default settings for The Magnifier at Install.

ConfigPath=1

This setting determines where the MAGNIFY.INI file will be located. ConfigPath=0 means the MAGNIFY.INI will be in the installation folder - there are no per user configuration files with this setting and user permissions must allow read-write access to MAGNIFY.INI, or users must run with a fixed (read-only) configuration. When ConfigPath=1 or ConfigPath=2, each user will have their own configuration files. If ConfigPath=3, these are in shared among all users in a public location (this is the preferred setting if global settings for all users is desired).

Note that the MAGNIFY.INI file in the installation folder determines the location of new users' configuration files, and if an administrator changes this after The Magnifier has already been used by other users, their existing individual configuration files will NOT be transferred to the new location. What will happen is the software will be unable to find configuration files for the current user in the current specified path, and a copy of the current configuration files will be used as a starting point for this new location.

This is a breakdown by Operating System of the specific locations used - [User] indicates the actual user logged onto the system, and [ProductDir] indicates the Product's directory name, e.g. The Magnifier folder.

ConfigPath Locations

ConfigPath: 0

Windows 2000/XP: \Program Files \[ProductDir]

Windows Vista: \Program Files \[ProductDir]

ConfigPath: 1

Windows 2000/XP: C:\Documents and Settings \[User] \Application Data \Innovation Management Group \[ProductDir]

Windows Vista: C:\Users \[User] \AppData \Roaming \Innovation Management Group \[ProductDir]

ConfigPath: 2

Windows 2000/XP: C:\Documents and Settings \[User] \Local Settings \Application Data \Innovation Management Group \[ProductDir]

Windows Vista: C:\Users \[User] \AppData \Local \Innovation Management Group \[ProductDir]

ConfigPath: 3

Windows 2000/XP: C:\Documents and Settings \All Users \Application Data \Innovation Management Group \[ProductDir]

Windows Vista: C:\ProgramData \Innovation Management Group \[ProductDir]

DoNotUseRegistry=0

If DoNotUseRegistry=0, then the registry is used for each user (HKEY_CURRENT_USER). The location is at [HKEY_CURRENT_USER \Software \Innovation Management Group \The Magnifier \Settings]. If DoNotUseRegistry=1, then the INI file is used (as specified by the ConfigPath setting).

TopMost=1

Window is Always on Top if TopMost=1 The Magnifier is a normal sizable popup window if TopMost=0

ForceTopmost=1

ForceTopmost is not available from The Magnifier menu. The default is 1. If ForceTopmost=1 then The Magnifier will reposition itself above every other Window every 50 milliseconds. In 1.50, this was re-worked to sort windows in a sensible manner. Using AutoPosition=1 may be helpful if you set ForceTopmost=1.

AutoPosition=0

If AutoPosition=1 then The Magnifier will automatically reposition to the next logical screen corner when the mouse cursor is held over The Magnifier window for several seconds. AutoPosition=0 disables this action. Screen positions: Top-Left, Top-Right, Bottom-Left, Bottom-Right

ShowCursor=1

If ShowCursor=1 then a cursor image will be displayed over the magnified screen area within The Magnifier window. ShowCursor=0 disables the cursor image, and The Magnifier only displays the screen area.

OpenPositionX=0

OpenPositionY=0

OpenPositionX and OpenPositionY indicate where on screen The Magnifier should Open - X & Y indicate Top Left Corner. Default is center of screen. 0 indicates use default. Therefore, the window cannot open at position 0,0 - use -1,-1 or 1,1

OpenWidth=0

OpenHeight=0

OpenWidth and OpenHeight indicate size of window. Default window is based on the current screen resolution. 0 indicates use default. Do not use values below 10.

TimerInterval=50

The TimerInterval setting is used to set the number of milliseconds between each Magnifier update. This can affect the system performance and should be set as slow as possible while still being useful to the user. Higher values indicate slower updates. A setting of 1000 means The Magnifier updates once every second.

MagnifierMenu=0

This indicates which menu is used. If MagnifierMenu=1 then the large button / large font Magnifier Menu is used. If MagnifierMenu=0 then the windows menu's are used, and the display settings are controlled via the Display Properties | Appearance options.

MagnificationFactor=2

This is the Magnification factor that is used within the Magnifier window to magnify from the center of either the current cursor position or the locked screen position. Valid values are 2 through 10.

AllowDrag=1

This is used to track whether the Left Click & Drag is active. If AllowDrag=1 then a Left Double Click will open the menu. If AllowDrag=0 then the drag is not available, and a single Left Click will open the menu.

LockPosition=0

If LockPosition=1 then the Magnifier no longer track the mouse cursor position, but magnifies the screen position indicated by the LockPos settings below.

LockPosX=457

LockPosY=180

These indicate the screen position X and Y that is magnified when the Magnifier is Locked on a position.

TrackCursor=0

This indicates whether the Magnifier is tracking the mouse cursor or not. If TrackCursor=1 then the Magnifier moves along with the mouse cursor, repositioning automatically as needed.

TrackPosX=101

TrackPosY=225

These are used internally for the Track Cursor Option. They should not be modified.

ShowLines=0

This setting indicates whether the Cursor Position Indicator Lines are shown. If ShowLines=1 then these 4 lines point towards the current position of the mouse cursor.

AnimateLines=1

This setting only applies if ShowLines=1. If AnimateLines=1 then the Cursor Position Indicator Lines will animate. This may assist finding the lines.

LineWidth=1

This setting indicates the line width of the Cursor Position Indicator Lines. Valid values are 1, 3, or 5.

NoMagWindow=0

If ShowLines=1, and NoMagWindow=1 then ONLY the cursor lines will be shown without the Magnifier window.

LinesTopmost=1

This is an internal setting, and should remain LinesTopmost=1 This is used to keep the Cursor Position Indicator lines above other windows so they are always visible.

LayeredPct=255

This is the transparency level for the "Layered" window setting It can range from 1-255, with 255 being opaque (NOT transparent) At lower levels, the windows becomes more & more transparent Internally, if set at 255, transparency is disabled entirely.

FullScreenPrimary=0

If FullScreenPrimary=1, then the full screen operation on the primary monitor is enabled. If FullScreenPrimary=0, then the Magnifier is operating as a window.

ShowReferenceWindow=1

This only applies when operating in full screen mode. If ShowReferenceWindow=1, then a reference window showing a representation of the area being magnified is shown in the upper right (or toggles to upper left if the mouse moves over the window). The white area is displayed on a black background, where the background represents the entire screen area that can be magnified, and the white area represents the area that is currently being magnified.

FullScreenVirt=0

When FullScreenVirt=1, then the entire virtual area (multiple monitors) is used in the full screen magnfication mode. This can only be true if the system indicates there is more than 1 monitor available and is in use.

TextCaretTracking=1

When TextCaretTracking=1, the MAGLIB.DLL enables a windows accessibility event hook and overrides the mouse cursor as the magnification point, shifting the magnification point to the text caret. Wen TextCaretTracking=0, this tracking is disabled.

DialogsAndFocus=1

This is similar in operation to the Text Caret tracking, but it monitors the dialog start and dialog end events, along with keyboard focus events. DialogsAndFocus=1 means the mouse cursor location is ignored, and the magnification point is moved to the object in focus. If DialogsAndFocus=0, then this tracking is disabled. This is partially controlled by the FocusWaitTime internally (see below to override this).

;FocusWaitTime=500

This entry is an override settings for the lockout period used to prevent conflicts between the mouse operation and tracking the DialogsAndFocus events. The time is in milliseconds and 500 is the internal default. You may notice this if you start using the keyboard, then use the mouse, and go back to the keyboard - the wait time period must elapse before the keyboard events override the mouse (and the mouse must remain stationary). You may wish to make this time shorter for a more responsive keyboard, but understand that the mouse and keyboard focus events may conflict if this delay is too short.

LensViewMode=0

When LensViewMode=1, (in window mode), a circle region is created so the Magnifier appears as a round lens. This is not available in full screen mode. LensViewMode=0 means the window is a normal, sizable window.

InvertColors=0

InvertColors=1 means the actual screen display is inverted in the Magnifier display, and InvertColors=0 means it is normal.

AltShortcuts=1

AltShiftShortcuts=0

CtrlShiftShortcuts=0

Only 1 of these can be set to 1, the others should be at 0. These determine which keystroke combination is required to get at the Magnifier's shortcuts. By default, it is the Alt key, but this can conflict with some applications (e.g. Alt-O will open the option menu, but will also toggle the Follow cursor (track cursor) mode. If this is problematic, set AltShiftShortcuts=1 to use the Alt-Shift-[Key] combination, or CtrlShiftShortcuts=1 to use Ctrl-Shift-[Key].

rgbLines=7346

This is a decimal representation of the colors used by the cursor lines using the hexadecimal 0x00FFFFFF COLORREF type internally for 0x00BBGGRR.

RangeSlider=100

This is used to track the range setting in the Magnification dialog (10x, 20x, 30x, 40x)

MagnVista=20

This records the setting for incremental magnification values, e.g. the real magnification internally is this value divided by 10, i.e. MagnVista/10 = Magnification.

UseFocusEdge=1

PctFocusEdgeX=8

PctFocusEdgeY=16

If UseFocusEdge=1, then an internal calculation takes place (based on the PctFocusEdgeX and PctFocusEdgeY values) that take the current position provided by the system for the object in focus (e.g. menu item, icon, dialog control, etc.), and if it is within that percentage of the edge of the screen, then the edge of the screen is used (rather than the actual position). This helps make things visible, especially at higher magnification values.

If UseFocusEdge=0, then the actual position is used directly, and the PctFocusEdge values mean nothing. The PctFocusEdgeX and PctFocusEdgeY values are used internally as a percentage calculation for pixels (based on the primary monitor resolution). If the position provided by the system is within the number of pixels calculated of the edge, then the edge is used. The best values depend on the monitor resolution, the magnification factor, and usage. The values chosen were based on experimentation for lower magnification factors.

UseCaretEdge=1

PctCaretEdgeX=8

PctCaretEdgeY=8

If UseCaretEdge=1, then an internal calculation takes place (based on the PctCaretEdgeX and PctCaretEdgeY values) that take the current position provided by the system for the text caret, and if it is within that percentage of the edge of the screen, then the edge of the screen is used (rather than the actual position). This helps make things visible, especially at higher magnification values.

If UseCaretEdge=0, then the actual position is used directly, and the PctCaretEdge values mean nothing. The PctCaretEdgeX and PctCaretEdgeY values are used internally as a percentage calculation for pixels (based on the primary monitor resolution). If the position provided by the system is within the number of pixels calculated of the edge, then the edge is used. The best values depend on the monitor resolution, the magnification factor, and usage. The values chosen were based on experimentation for lower magnification factors.