Lambda Add-On for NVDA
このプロジェクトは、LAMBDAソフトウェアのためのアップモジュールです。Comenius Universityの、Peter Lecky氏の研究を元にしています。 LAMBDA(Linear Access to Mathematic for Brail Device and Audio-synthesis、点字デバイスと音声合成による、数学への線形アクセス)は、全盲の人が点字ディスプレイや読み上げ合成を使用して読み書きするのをサポートするソフトウェアです。 LAMBDAは、EUのプロジェクトの結果です。LAMBDAについての詳細は、https://www.lambdaproject.org/を参照して下さい。 このアドオンの現在のバージョンは、イタリア語とスペイン語の点字表を持っており、また、NVDAの翻訳コミュニティにより翻訳されているため、インターフェースはほとんどのNVDAの公用言語で利用可能です。もし、あなたがLAMBDAのイタリアのユーザーでなく、あなたの国の言語の点字表を作成することに貢献したい場合は、お気軽に(下記の)作者にご連絡いただくか、プロジェクトのメーリングリストに登録して下さい。
ご注意下さい: このアドオンは、Alberto Zanellaにより、ボランティア活動として開発されています。作者も、貢献者も、Lambdaのソフトウェアの販売や開発に関係していません。Lambdaについて情報が必要、または、Lambdaの使い方のサポートを必要としている場合は、地域の販売者に連絡して下さい。このアドオンの使用やインストール時にお困りの場合は、作者にご連絡をいただくか、GithubプロジェクトページのIssuesリンクをお使い下さい。
Official Github Repository
Addon Features:
Speech support:
- Dialogs and menus are properly reported;
- Natural speech support for math formulas using the Lambda math engine, i.e. "compound root 3 sep compound root 3 x plus 24, close compound root, minus 3 equals 0";
- implemented the Reading by character, words, lines and Say All;
- Speaks when a block of text is selected or extended (using CTRL+B and SHIFT+CTRL+B);
- Speaks when moving in the text editor using standard Windows commands and Lambda-specific commands;
- Both Extended and Short speech modes are supported (you can select it using the Tools menu in Lambda);
- Special dialogs like structure mode, calculator, and matrix window are now correctly reported and NVDA reads correctly when moving the cursor around or when new text is typed ;
- Typing echo uses the Lambda text processor, so symbols and markers will be correctly reported.
Braille support:
- The addon installs (inside the user profile directory) and activates a custom braille table. This table may be different for different languages. Custom braille tables were made from ones in the Lambda plugin for JAWS (jbt file). Then symbols and markers are represented using the same dots patterns;
- The addon creates an NVDA profile for a standard braille configuration. By this, the output is set to the custom braille table only when the Lambda application is active;
- Dialogs and menus are properly reported in braille;
- The content of the editor is correctly rendered in braille and the user is able to move using braille scrolling keys or cursor routing keys;
- Starting from the addon version 1.1.0, there are two ways in which the text in the Lambda editor is rendered: "Flat mode" and "non-Flat Mode". When the "Flat mode" is on, NVDA will use the Display Model to retrieve information from the editor and to determine the caret position. This is specially beneficial when the user needs to move around on the screen, even in white spaces. When the "Flat Mode" is set to "off", text rendering on the braille display is more stable, since NVDA uses Windows API to retrieve it. However when the the caret is moved in white spaces next to the end of the line of text, the braille display does not follow the real cursor as long as a non-white space is added by the user.
The "flat mode" is active by default. You can toggle "flat mode" on or off by pressing NVDA+SHIFT+F.
We strongly recommend to disable the Flat Mode if you are using custom DPI in Windows (Custom sizing option), especially when you have screen settings with more than 96 dpi (larger than 100%).
- The structure of dialog boxes is easier, repeated information has been removed;
- The selection will be marked properly using dots 7 and 8, and marking is properly refreshed while standard Windows commands (SHIFT+ARROWS) or Lambda specific commands (CTRL+B, CTRL+SHIFT+B) are pressed.
Before starting to use this addon.
This addon creates an NVDA profile named "lambda" which is associated with the "lambda.exe" application. The profile automatically sets all braille options: the custom braille table, the focus tethering and flat mode settings.
If a previous profile with the same name is present in your system, the addon will not override it and you have to manually adjust your configuration profile.
To stave off this situation, if you have specific settings you'd like to preserve, you can use the "Revert LAMBDA Profile Wizard". The shortcut to start this tool is NVDA+alt+r (when focused in LAMBDA).
An easy option is also to delete old versions of the "lambda" profile after the installation of the addon. To do so, open the NVDA menu, select the "Configuration profiles" menu Item and press ENTER.
In the Configuration profiles dialog, you'll be able to locate and delete the "lambda" profile. The profile will be re-created the next time the Lambda application is started.
Deleting the "lambda" profile should be an easy solution also when the addon runs into any problem. For instance, if the braille table is not properly set, instead of manually configuring the profile, you can simply delete it. The addon will create a new one the next time you'll load the Lambda editor.
Each time the Lambda editor is started, this addon checks if a profile with the name "lambda" exists. If it doesn't, it automatically generates a profile with the following form:
filename : userData\profiles\lambda.ini :
[braille]
readByParagraph = False
tetherTo = focus
translationTable = path-to-the-addon-brailleTable-dir\tableName
[lambda]
brailleFlatMode = True
Where :
- path-to-the-addon-brailleTable-dir : is the absolute path of the addon directory + "\brailleTables"
- tableName : depends on the active NVDA language. Currently only the italian and Spanish braille tables, "lambda-ita.utb" and "lambda-esp.utb" respectively, is present.
Addon Keyboard Shortcuts:
- NVDA+Shift+f: Toggle braille flat mode on or off;
- NVDA+alt+r: Open the "Revert LAMBDA Profile Wizard";
- NVDA+d: Duplicate lines (use this instad of control+d).
Known issues:
Due to a bug present in LAMBDA, the add-on provides an extra-logic that reports white spaces. This logic may fail in the following situations:
- When words like "space", "spazio" "Espacio" etc. are inserted into the text, they may be reported by NVDA as the local NVDA language translation.
- Blank lines are not reported by the LAMBDA speech engine. The user will hear the translation of the word "space" instead. This could be both a blank line or a line containing only the word "space".
Useful tips
This is a set of tips that will help you on using the addon in a more eficient way.
- Character-by-character reporting: Normally, when working with maths you would like NVDA to report things you're writing character by character. To do this, there are a couple of simple steps: ensure to have the focus on the LAMBDA's window or one of its variants (the six dots representation, for example); press NVDA+2 (number two) or navigate to NVDA menu>Preferences>Keyboard settings and check the box to Speak typed characters; go to LAMBDA>Options>Voice paramethers and ensure the checkbox "echo" is ON, otherwhise NVDA won't receive anything from the speech engine while you are typing. And done, NVDA will speak written characters, but don't worry, only in LAMBDA or its special windows, the settings for the rest of applications will be left as they were.
Addon mailing list:
To report bugs, suggestions or if you want to contribute you can subscribe the Addon Group (in English). You can subscribe from the website: https://groups.io/g/lambda-nvda.
Change log
Below is a list of changes between the different add-on versions. Next to the version number, between parentheses, is the development status. The current development release isn't included as it could have changes until it is flagged as stable or discarded as candidate.
Version 1.3.0 (stable)
- Support for newer version of NVDA (Support for Python 3)
- Solved an issue while pressing duplicate line command NVDA+d in a blank line caused clipboard content to be pasted. Now when you press NVDA+d and you are in a blank line, a new blank line appears as expected.
Version 1.2.2 (stable)
- Improved compatibility with WX Python version 4 (introduced with NVDA 2018.3). Warning related with wx.NewId() is no longer displayed in debug log.
- Implemented guiHelper to enhance dialogs's appearance.
- New languages. Updated translations.
Version 1.2.1a (stable)
This update is intended to be a long-term support release. It means that until, at least, june 2018, it won't be released a version as stable as this. We do it to provide students maximum stability and to minimize the changes during the academical year.
- New languages. Updated translations.
Version 1.2.1 (stable)
- Added compatibility with the way that NVDA 2017.3 uses to manage braille. Backwards compatibility kept.
- fixed many braille issues.
Version 1.2.0 (development)
This version was not published as stable because the version 1.2.1 included major fixes.
- New locales. Updated localizations.
Version 1.1.8 (stable)
- Initial stable release.