from .exit import ExitDialog

from .settingsDialogs import (

BrailleDisplaySelectionDialog,

BrailleSettingsPanel,

BrowseModePanel,

def onBrailleSettingsCommand(self,evt):

self.popupSettingsDialog(NVDASettingsDialog, BrailleSettingsPanel)

def onKeyboardSettingsCommand(self,evt):

self.popupSettingsDialog(NVDASettingsDialog, KeyboardSettingsPanel)

== New Features ==

- Enhanced sound management:

- NVDA will now output audio via the Windows Audio Session API (WASAPI), which may improve the responsiveness, performance and stability of NVDA speech and sounds. (#14697, #11169, #11615, #5096, #10185, #11061)

- Note: WASAPI is incompatible with some add-ons.

Compatible updates are available for these add-ons, please update them before updating NVDA.

- The advanced setting to enable support for HID braille has been removed in favor of a new option.

You can now disable specific drivers for braille display auto detection in the braille display selection dialog. (#15196)

-

- Add-on Store: Installed add-ons will now be listed in the Available Add-ons tab, if they are available in the store. (#15374)

- Some shortcut keys have been updated in the NVDA menu. (#15364)

-

The settings categories found in the NVDA Settings dialog will be outlined below.

The General category of the NVDA Settings dialog sets NVDA's overall behaviour such as interface language and whether or not it should check for updates.

This category contains the following options:

If this is enabled, NVDA will inform you when there is a pending update on startup, offering you the possibility to install it.

You can also manually install the pending update from the Exit NVDA dialog (if enabled), from the NVDA menu, or when you perform a new check from the Help menu.

The Speech category in the NVDA Settings dialog contains options that lets you change the speech synthesizer as well as voice characteristics for the chosen synthesizer.

For a quicker alternative way of controlling speech parameters from anywhere, please see the [Synth Settings Ring #SynthSettingsRing] section.

The delayed character description will be cancelled if other text is spoken during that time, or if you press the ``control`` key.

The Synthesizer dialog, which can be opened by activating the Change... button in the speech category of the NVDA settings dialog, allows you to select which Synthesizer NVDA should use to speak with.

Once you have selected your synthesizer of choice, you can press Ok and NVDA will load the selected Synthesizer.

If there is an error loading the synthesizer, NVDA will notify you with a message, and continue using the previous synthesizer.

To toggle show selection from anywhere, please assign a custom gesture using the [Input Gestures dialog #InputGestures].

The Select Braille Display dialog, which can be opened by activating the Change... button in the Braille category of the NVDA settings dialog, allows you to select which Braille display NVDA should use for braille output.

Once you have selected your braille display of choice, you can press Ok and NVDA will load the selected display.

If there is an error loading the display driver, NVDA will notify you with a message, and continue using the previous display, if any.

it is currently impossible to tell NVDA which display to use.

Therefore it is recommended to only connect one Braille Display of a given type / manufacturer to your machine at a time.

+++ Audio +++[AudioSettings]

The Audio category in the NVDA Settings dialog contains options that let you change several aspects of audio output.

==== Output device ====[SelectSynthesizerOutputDevice]

When these providers have adjustable settings, they will be shown in this settings category in separate groupings.

For the supported settings per provider, please refer to the documentation for that provider.

The Keyboard category in the NVDA Settings dialog contains options that set how NVDA behaves as you use and type on your keyboard.

This settings category contains the following options:

This option allows the user to control if key presses generated by applications such as on-screen keyboards and speech recognition software should be processed by NVDA.

This option is on by default, though certain users may wish to turn this off, such as those typing Vietnamese with the UniKey typing software as it will cause incorrect character input.

The Mouse category in the NVDA Settings dialog allows NVDA to track the mouse, play mouse coordinate beeps and sets other mouse usage options.

This category contains the following options:

To toggle simple review mode from anywhere, please assign a custom gesture using the [Input Gestures dialog #InputGestures].

The Object Presentation category in the NVDA Settings dialog is used to set how much information NVDA will present about controls such as description, position information and so on.

These options don't typically apply to browse mode.

These options typically apply to focus reporting and NVDA object navigation, but not reading text content e.g. browse mode.

This option allows you to choose whether or not NVDA should report new symbols as they appear in the composition string.

This option is on by default.

The Browse Mode category in the NVDA Settings dialog is used to configure NVDA's behaviour when you read and navigate complex documents such as web pages.

This category contains the following options:

The focus will yet be updated to the particular element when interacting with it (e.g. pressing a button, checking a check box).

Enabling this option may improve support for some websites at the cost of performance and stability.

Most of the options in this category are for configuring what type of formatting you wish to have reported as you move the cursor around documents.

For example, if you check the report font name checkbox, each time you arrow onto text with a different font, the name of the font will be announced.