Readout of Mouse Coordinates

Author: Cooper Wooten

Why this change was made:

• According to this issue: viewing the position of the mouse cursor can be challenging to those with limited visibility. The issue mentions that even a crosshair or other changes may not be enough to highlight position in certain conditions such as contrast or busy screen. Adding a readout for cursors can add another layer of visibility for those that may need it.

The form used to make this change:

• This change was made in a few different source files rather than as an addon. A gesture via addon was the first idea, but a selectable settings option was decided upon after further consideration. Especially within the scope of this project, and because an addon had already been written, learning more about the settings dialog would be beneficial. In order to make the functionality of the readout along with the functional check box in the settings, three files were changed: settingsDialog.py (for the checkbox), configSpec.py (for the config option to connect to the check box), and mouseHandler.py (for the coordinate readout function).

How to use this addon:

• Use NVDA+n to open the dialog, then select Preferences and Settings to open full settings menu. In the menu, the "mouse" sub-menu now has an additional check box that upon selection will initiate an audio readout of the mouse's coordinates. This speech is not of specific high priority and therefore will not take precedence over other readouts from NVDA. The readout happens on mouse movement, but was implemented specifically to occur briefly after the mouse stops moving.