BrlIMEHelper (Помощник по вводу Брайля)

Версия 2.7

Введение

Дополнение BrlIMEHelper (Braille IME Helper) позволяет пользователям вводить китайские символы напрямую через клавиатуру Брайля на брайлевском дисплее. Если физическая клавиатура Брайля недоступна, дополнение может эмулировать её с помощью компьютерной клавиатуры (например, QWERTY). Преобразуя ввод Брайля в операции IME, дополнение позволяет пользователям, знакомым с правилами Брайля, вводить китайские символы без изучения раскладки клавиатуры используемого метода ввода. На данный момент дополнение реализовано на основе бопомофо Брайля и Microsoft Phonetic IME (微軟注音), распространённого в Тайване, но в будущем его концепция может быть расширена для других систем Брайля и IME.

Возможности

1. Ввод китайских символов (включая пунктуацию и математические символы) через клавиатуру Брайля.
2. Эмуляция клавиатуры Брайля с помощью компьютерной клавиатуры.
3. Поддержка системных горячих клавиш и сочетаний NVDA.
4. Различные режимы композиции Брайля для разных окон.
5. Возможность ввода паролей в браузере с помощью клавиатуры Брайля.
6. Различные настройки на основе отзывов пользователей.

Требования к системе и окружению

Перед установкой убедитесь в соответствии следующим требованиям:

• NVDA версии 2017.3 или новее.
• IME должен быть правильно настроен (подробности в следующем разделе).
• Для эмуляции клавиатуры Брайля компьютерной клавиатурой требуется поддержка NKRO (N-key rollover). См. также: Какие компьютерные клавиатуры поддерживают ввод 6-точечного Брайля?
• Не рекомендуется использовать BrlIMEHelper вместе с другими приложениями или дополнениями, связанными с вводом Брайля, такими как PC Keyboard Braille Input for NVDA и Braille Chewing.
• Для более комфортного набора рекомендуется отключить опцию NVDA “Сообщать об изменениях в строке чтения” в настройках ввода.
• Для соответствия привычкам тайваньских пользователей рекомендуется установить таблицу ввода Брайля “English (U.S.) 8 dot computer braille”.

Дополнение предполагает следующую конфигурацию IME, но пользователь может изменить её в соответствии со своими потребностями.

Управление

Жесты

Дополнение поддерживает жесты как для компьютерной, так и для брайлевской клавиатуры. Перед ознакомлением с ними важно понимать следующие термины:

1. Компьютерная клавиатура: Включает основную клавиатуру и цифровой блок. Названия клавиш в этом разделе заключены в квадратные скобки.
2. Клавиши Брайля: 9 клавиш, соответствующих точкам 1–8 и пробелу Брайля. Пользователь может вводить символы через них в соответствии с правилами таблицы ввода.
3. Клавиатура Брайля: Физическая клавиатура Брайля, состоящая из 9 клавиш, обычно встроена в брайлевский дисплей. Дополнение также предоставляет виртуальную клавиатуру Брайля, эмулируемую компьютерной клавиатурой.
4. Шаблон Брайля: Внешний вид строки ячеек Брайля, то есть комбинация точек в ячейке(ах).

Компьютерная клавиатура

Вот основные жесты компьютерной клавиатуры, которые необходимо знать:

• NVDA+Ctrl+6: Включить/выключить эмуляцию клавиатуры Брайля.
• F, D, S, J, K, L, A, точка с запятой [;:] и пробел: Точки 1–8 и пробел Брайля в эмуляции клавиатуры Брайля.
• 0–9: Зарезервированы для ввода чисел и выбора кандидатов в 9-клавишном режиме Брайля.
• Цифровой блок (опционально, с включённым Num Lock): Ввод ячейки Брайля точка за точкой.
  • 0–9: Номера точек или индекс маршрутизации.
    1. 0–8: Пробел Брайля и точки 1–8; 9: Очистить незавершённую ячейку Брайля.
    2. Индекс маршрутизации, то есть номер ячейки Брайля (начиная с 0).
  • Десятичная точка [.]: Завершить ввод одной ячейки Брайля (двойное нажатие).
  • Умножение [*]: Завершить ввод индекса маршрутизации (двойное нажатие).
  • Деление [/]: Просмотреть незавершённую ячейку Брайля и/или индекс маршрутизации.
  • Вычитание [-]: Прокрутить брайлевский дисплей назад.
  • Сложение [+]: Прокрутить брайлевский дисплей вперёд.
• NVDA+PrintScreen: Скопировать сырой текст с брайлевского дисплея в буфер обмена.
  • Однократное нажатие: Скопировать текущую строку.
  • Двойное нажатие: Скопировать текущую строку и контекст фокуса.
• NVDA+Win+PrintScreen: Скопировать шаблоны Брайля с дисплея в буфер обмена.
  • Однократное нажатие: Скопировать текущие отображаемые ячейки Брайля.
  • Двойное нажатие: Скопировать все ячейки Брайля текущей строки.
• NVDA+Win+A: Просмотреть состояние BrlIMEHelper.
• NVDA+Win+U: Включить/выключить внутренний код Брайля.

Эмуляция клавиатуры Брайля

Помимо физической клавиатуры Брайля, дополнение предоставляет три способа ввода Брайля через компьютерную клавиатуру: 9-клавишный режим, полноразмерный режим и режим точка-за-точкой.

9-клавишный режим Брайля

Также известен как “6-точечный” или “8-точечный ввод”. Девять клавиш компьютерной клавиатуры (по умолчанию F, D, S, J, K, L, A, [;:] и пробел) эмулируют физическую клавиатуру Брайля. NVDA обрабатывает ввод так же, как и с физической клавиатурой, что позволяет пользователю вводить символы по правилам Брайля и отправлять жесты.

Примечание: Успешность ввода зависит от возможностей физической клавиатуры. Если клавиатура не поддерживает NKRO, одновременное нажатие некоторых пар клавиш может привести к регистрации только одной из них. Перед сообщением об ошибках проверьте корректность ввода через “Помощь по вводу” в NVDA.

Полноразмерный режим Брайля

Подходит для пользователей, знакомых с раскладкой компьютерной клавиатуры, но не с раскладкой IME. В отличие от 9-клавишного режима, здесь клавиши (с Shift или без) соответствуют шаблонам Брайля, определённым таблицей вывода. Примеры:

Пример 1:
1. Установите таблицу вывода “Chinese (Taiwan, Mandarin)”, а таблицу ввода — “Unicode braille”.
2. Переключите Microsoft Phonetic IME в алфавитно-цифровой режим.
3. Используйте жесты для переключения на “Full-keyboard NVDA Braille Input”.
4. Введите текст в поле редактирования, как будто эмуляция отключена.

Результат: шаблоны Брайля введённого текста совпадают с вводом, но текст состоит из символов Unicode Брайля, отображающих процесс ввода.

Пример 2:
1. Установите таблицу вывода “Chinese (Taiwan, Mandarin)” без ограничений для таблицы ввода.
2. Переключите Microsoft Phonetic IME в нативный режим.
3. Используйте жесты для переключения на “Full-keyboard Braille IME”.
4. Введите последовательность a&'=1 (где & — Shift+7).

Результат: в окне композиции отобразится 中文 (Zhong1Wen2), так как шаблон a&'=1 соответствует ⠁⠯⠄⠿⠂ (шаблон 中文).

Этот режим облегчает ввод для пользователей, которым сложно работать с физической клавиатурой Брайля или 9-клавишным режимом. Например, нажатие “f” преобразуется в ⠋ (точки 1, 2, 4) согласно текущей таблице вывода.

Примечание: Для отправки жестов Брайля в этом режиме удерживайте пробел Брайля вместе с другими точками.

Рекомендация: Используйте таблицу вывода “computer braille” для корректной работы. Например, в классическом английском Брайле ABC отображается как ⠠⠠⠁⠃⠉, но Shift+A, B, C даст ⠠⠁⠠⠃⠠⠉, что отличается.

Ограничение: В старых версиях NVDA пробел может не преобразовываться в Unicode-пробел Брайля (⠀). Обновите NVDA для исправления.

Режим точка-за-точкой

Позволяет вводить номера точек каждой ячейки Брайля через цифровой блок (с включённым Num Lock). Например, [1][2][.] [1][2][3][5][.] [1][2][3][.] выведет “brl”. Функции клавиш цифрового блока описаны в начале раздела. Этот режим позволяет отправлять жесты Брайля с более чем 6 точками, независимо от ограничений клавиатуры.

Внутренний код Брайля

Это уникальная система, реализованная в BrlIMEHelper, для однозначного представления символов (цифр, букв, бопомофо, иероглифов) в Брайле. Шаблоны сложны для запоминания, но полезны для поиска конкретных символов в IME. Кодировка основана на UTF-8, поэтому ASCII-символы соответствуют 8-точечному английскому Брайлю, а иероглифы и полновесные знаки выделяются.

Состояние BrlIMEHelper

Сообщение о состоянии включает три компонента:
1. Буфер Брайля: Незавершённые шаблоны в нативном режиме (например, ⠙⠜ (145-345)).
2. Режим ввода: Например, “9-key Braille IME”.
3. Состояние IME: Например, “Microsoft Phonetic IME {-NH}”.

Подробности:
- Буфер Брайля: Очищается при ошибках, смене фокуса, изменении режима IME и других событиях.
- Режим ввода: Может быть “9-key”, “Full-keyboard” или отсутствовать (если эмуляция отключена). Обработчик — “NVDA Braille Input” или “Braille IME”.
- Состояние IME: Указывает имя IME и режим (например, -N для нативного, -H для полновесного). Если IME не распознан, отображается (?).

Жесты Брайля

Жесты Брайля (пробел + комбинация точек) позволяют выполнять функции или эмулировать сочетания клавиш, что повышает эффективность работы. Жесты делятся на:
- Общие: Основные функции, такие как переключение режимов IME, очистка буфера.
- Редактирование: Навигация ([Home], [End]), действия ([Ctrl]+[C], [Ctrl]+[V]).
- Системные: [Alt]+[F4], [Win]+[D].
- NVDA: Открытие меню NVDA, чтение текста.

Примеры жестов:
- 2, 4, 5 + пробел: Очистка буфера при ошибке.
- 1, 3, 6 + пробел: Переключение между таблицами ввода Брайля.
- 4, 5, 6 + пробел: Переключение режимов IME.

Полный список жестов приведён в таблицах документации.

Настройки

• Автоматическое включение эмуляции при запуске NVDA.
• Отчёт об изменениях буфера Брайля.
• Сочетание для переключения режимов IME (по умолчанию левый Shift).
• Подавление избыточных сообщений о композиции.
• Запрет бессрочного отображения сообщений о смене режима IME.
• Использование полноразмерного режима по умолчанию.
• Настройка клавиш Брайля и игнорируемых клавиш.
• Освобождение не-брайлевских клавиш в алфавитно-цифровом режиме.
• Согласованность состояния эмуляции для всех процессов.

Известные проблемы и планы

• Несовместимость с Braille Extender.
• Планы: поддержка других IME, настройка шаблонов символов.

История изменений

Полный список изменений от версии 0.0 до 2.7 приведён в документации. Основные улучшения:
- Поддержка новых версий NVDA.
- Добавление режимов ввода.
- Улучшение обработки буфера Брайля.
- Оптимизация работы с IME.

Благодарности

Разработка спонсирована Taiwan Visually Impaired People Association (2020–2021).

История изменений

Версия 0.0

• Начальная версия.

Версия 0.1

• Рефакторинг документации, чтобы она стала более читаемой для пользователей.
• Сброс буфера Брайля при смене окна переднего плана.

Версия 0.2

• Исправлено неправильное поведение имитации точки 7 (A) в проводнике.
• Разделен init.py на два файла.

Версия 0.3

• Включена локализация сообщений.
• Реализована новая схема разбора шрифта Брайля.
• Добавлена информация о “addon_lastTestedNVDAVersion”.
• Добавлены правила, обеспечивающие ввод одного символа bopomofo.
• Исправлено несколько шаблонов ввода математических символов.

Версия 0.4

• Реализована совместимость префиксов брайлевских шаблонов путем отложенной отправки ввода.
• Попытка замены последнего брайлевского ввода при отказе от брайлевского ввода.
• Заменен брайлевский шаблон ∠ на ⠫⠪ (1246-246), т.е. на префикс ←.

Версия 0.5

• Рефакторинг кода.
• Прекращена имитация клавиатуры Брайля клавиатурой компьютера в режиме просмотра.
• Присвоить каждому скрипту соответствующую документацию и категорию.

Версия 0.6

• Реализован тумблер для включения/выключения имитации ввода шрифта Брайля в буквенно-цифровом режиме IME.
• Обработка пути bopomofo.json в типе str.
• Не имитировать ввод шрифта Брайля, если при загрузке клавиатурных хуков BrlIMEHelper все еще удерживается какая-либо клавиша-модификатор.

Версия 0.7

• Добавлены точечные варианты некоторых символов.
• Обеспечена возможность управления ярлыками Брайля менеджером жестов ввода NVDA.
• Скорректирован стиль кодирования командных скриптов.

Версия 1.0

• Поддержка NVDA 2019.3 на базе Python 3.
• Реализован диалог для пользовательских настроек.

Версия 1.1

• Использован более корректный звуковой эффект для предупреждения об опечатке.
• Позволяет настраивать положение клавиш Брайля и игнорируемых клавиш на клавиатуре компьютера.
• Добавлена кнопка [Применить] в диалог настроек.

Версия 1.2

• Позволяет игнорировать все небрайлевские клавиши при имитации клавиатуры Брайля в алфавитно-цифровом режиме.
• Добавлена опция “Сопоставление клавиатуры”, соответствующая опции сопоставления клавиатуры в 微軟注音 IME.
• Разрешить ввод рифм с префиксом ⡼ по Брайлю.

Версия 2.0

• Разрешен точечный ввод шрифта Брайля с помощью клавиш нумпада.
• Добавлены способы обратной связи - звуковой и без звукового сопровождения - для индикации переключения имитации клавиатуры Брайля.
• Разрешить независимое состояние тумблера имитации клавиатуры Брайля для каждого процесса.
• Изменена комбинация клавиш NVDA+X на NVDA+Ctrl+6.
• Добавить спецификацию всех опций в readme.md.
• Рефакторинг кода.

Версия 2.1

• Добавлены различные жесты Брайля для повышения эффективности работы пользователей, использующих виртуальную клавиатуру Брайля.
• Отказ от использования NVDA winVersion API во избежание проблем с совместимостью, вызванных обновлением API в NVDA 2021.1.
• Добавлена опция “Сочетание клавиш для переключения алфавитно-цифрового/нативного режима IME”.
• Избежать предупреждения gettext в keyboard.py.
• Обновление файлов, полученных из AddonTemplate.
• Различные исправления и улучшения данной документации.

Версия 2.2

• Реализовано быстрое переключение между двумя таблицами перевода Брайля, оригинальной и Unicode Брайля, по точкам 1, 3, 6 + пробел.
• Разрешить ⡀ и ⢀ при вводе Unicode BRL с клавиатуры компьютера.
• Правильно удалять сообщения Брайля NVDA, даже если включена опция “Показывать сообщения бесконечно”.
• Отказаться от устаревшего использования модуля “collections”, вместо него использовать “collections.abc”.
• Реализована функция “print screen” для брайлевского дисплея.

Версия 2.3

• Назначение различных сочетаний клавиш для двух режимов работы функции “копирование содержимого дисплея Брайля”.
• Добавлена возможность заставить NVDA показывать текущее сообщение бесконечно долго без жеста по умолчанию.
• Загрузка клавиатурно-символьных отображений IME из JSON-файлов.
• При установке спрашивать пользователя, нужно ли автоматически менять таблицу перевода на “английский (американский) 8-точечный компьютерный шрифт Брайля”.
• Принять новое правило для определения строки версии аддона.
• Дизайн брайлевского ввода и общих режимов ввода, а также реализация в IME алфавитно-цифрового ввода.

Версия 2.4

• Поддержка NVDA версии 2023.1.
• Добавлена опция “Формат для копирования содержимого брайлевского дисплея”.
• Рефакторинг кода и разделение файлов данных и кода.
• Добавление модуля msctf, который может способствовать развитию последующих возможностей.

Версия 2.5

• Поддержка NVDA версии 2023.3.
• Замените параметр “Формат для копирования содержимого, отображаемого шрифтом Брайля” на 3 отдельных сценария.
• Добавьте сценарии для преобразования содержимого буфера обмена в шрифт Брайля.
• Улучшены правила вывода в режиме ввода.

Версия 2.6

• При обновлении режима преобразования и изменении языка ввода прерывать ввод текста шрифтом Брайля.
• Добавлена опция “Предотвращать избыточное объявление об изменении строки ввода”.
• Добавлена опция “Никогда не показывать сообщение об обновлении режима преобразования ввода
  опция “на неопределенный срок”.
• Исправлена настройка отображения шрифта Брайля в режиме просмотра.
• Добавлена опция “Сообщать об изменениях в буфере Брайля”.
• Улучшено представление состояния дополнения и изменен жест для его отображения.
• Улучшена функция точечного ввода шрифтом Брайля.
• При выборе кандидата в IME используйте оригинальный шрифт Брайля NVDA.
• Добавлена функция брайля с внутренним кодом.
• Включите полноформатный ввод символов через IME.

Версия 2.7

• Поддержка NVDA версии 2025.1.
• Переименовать /переписать правила
  9-клавишный ввод и ввод с полной клавиатуры.
• Функция 9-клавишного ввода NVDA со шрифтом Брайля сохраняется, даже если во время загрузки не найдено распознанного IME-файла bopomofo.
• Добавьте информацию о режиме ввода в сообщение об обновлении режима преобразования ввода.
• Устраните проблему, связанную с невозможностью поиска раскладки клавиатуры в secure desktop.
• Внесите другие изменения в код и документацию.