MyMouse Manager

Оглавление

  1. Введение
  2. Условия использования
  3. Установка
  4. Работа со скриптами
  5. Особенности работы
  6. Дополнительная настройка скриптов
  7. Информация для локализации
  8. Дополнительная информация
  9. Благодарности

Введение

Вашему вниманию предлагается пакет скриптов к screenreader'у "JAWS for Windows" - "MyMouse Manager".

Он предназначен для регулировки дополнительных параметров коммерческой версии речевого драйвера Сергея Волкова "MyMouse for JAWS" версии 2 посредством глобальных клавиатурных команд.

"MyMouse Manager" предоставляет следующие возможности:

Условия использования

Никаких гарантий не предоставляется. Все риски (прямые, косвенные, явные и неявные), связанные с использованием этих скриптов, пользователь принимает на себя. Допускается свободное использование и безвозмездное распространение данных скриптов при условии сохранения их целостности (за исключением процесса локализации скриптов на другие языки), неприкосновенности авторских атрибутов и прав. Не допускается распространение этих скриптов за плату.

Установка

Для подключения и использования скриптов надо произвести следующие действия:

  1. Поместить SFX-архив (файл из пакета с расширением *.exe) в папку пользовательских настроек "JAWS" по пути: C:\Documents and Settings\(имя пользователя)\Application Data\Freedom Scientific\JAWS\(версия JAWS)\Settings\(язык JAWS)\ (буква диска зависит от настроек операционной системы и может отличаться). Также в эту директорию можно попасть, последовательно выбрав в меню "Пуск" \Программы\JAWS xx.x\Файлы JAWS\Мои настройки\. Для portable-версии "JAWS" файл надо помещать в общую папку настроек по относительному пути в директории программы: ...\JAWSxx.x\SETTINGS\(язык JAWS)\. Далее следует нажать на этом архиве клавишу Enter и согласиться на извлечение данных, не изменяя предлагаемый путь. После этого EXE-файл можно будет удалить.
  2. Вызвать "Диспетчер Скриптов" по комбинации JAWSKey+0, а в нём открыть файл "Default.JSS" по комбинации CTRL+Shift+D. После этого в группе строк, начинающихся на "use", вписать строку
    use "MyMouseManager.jsb"
    После этого следует нажать комбинацию CTRL+S для компиляции файла.
  3. В этой же директории настроек "JAWS" открыть файл "Default.JKM" в любом текстовом редакторе, например, Блокноте Windows, и, после строки
    [Common Keys]
    вписать следующие девять строк:
    Shift+Windows+UpArrow=MyMouseChannelUp
Shift+Windows+DownArrow=MyMouseChannelDown
Shift+Windows+RightArrow=MyMousePauseUp
Shift+Windows+LeftArrow=MyMousePauseDown
Control+Windows+UpArrow=MyMouseFxUp
Control+Windows+DownArrow=MyMouseFxDown
Control+Windows+RightArrow=MyMouseKxUp
Control+Windows+LeftArrow=MyMouseKxDown
Control+Windows+M=MyMouseSettings
    После этого надо закрыть файл "Default.jkm" с сохранением изменений. Если же в данной директории отсутствует сам файл "Default.jkm", то следует скопировать его туда из пакета поставки данного скрипта.

Всё! "MyMouse Manager" подключён и готов к работе.

Работа со скриптами

Скрипт "MyMouse Manager" управляется следующими командами:

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

При переключении каналов эквалайзера, "JAWS" будет произносить их номера, а также частоту и приблизительный коэффициент усиления. При нажатии перехода на следующий канал, при активном последнем, или предыдущий, при активном первом, осуществиться сквозное переключение по списку и будет воспроизведён стандартный звук "Windows". По умолчанию скрипт работает с первыми семью каналами из файла "mymouse.ini" (для редактирования этого значения см. "Дополнительная настройка скриптов").

Изменение паузы между словами происходит в диапазоне [0; 100], представляющим из себя процентное значение от стандартной паузы оригинального "Speaking Mouse" (см. документацию к "MyMouse"). При достижении верхней или нижней границы дальнейшее изменение в соответствующем направлении будет не возможно. При этом будет произноситься "максимум" или "минимум", а также проигрываться стандартный звук "Windows". Шаг изменения паузы по умолчанию равен 10 (для редактирования этого значения см. "Дополнительная настройка скриптов").

При изменении частоты звукового сигнала выбранного канала эквалайзера, "JAWS" будет произносить устанавливаемое число Герц, оно не ограничивается сверху, но с низу имеет порог 0. При достижении нижней границы дальнейшее изменение в сторону понижения будет невозможно. При этом будет воспроизводиться стандартный звук "Windows". По умолчанию шаг изменения частоты канала равен 50 Гц (для редактирования этого значения см. "Дополнительная настройка скриптов").

При регулировки коэффициента усиления звукового сигнала, "JAWS" произносит его приблизительное новое значение. Изменение данного параметра не является линейным (см. "Особенности работы").

В меню "MyMouse Manager" доступны следующие команды для навигации и управления:

Кроме вышеперечисленных способов навигации по списку, пользователь может ввести первую букву названия нужного пункта, и фокус будет перемещён к первому элементу, чьё название начинается на данную букву. Если существует несколько таких пунктов списка, то перемещаться между ними можно последовательным нажатием клавиши с их начальной буквой. При подобном методе навигации регистр не имеет значения.

Особенности работы

Дополнительная настройка скриптов

"MyMouse Manager" позволяет легко изменить некоторые свои параметры. Для этого в папки пользовательских настроек "JAWS" (см. первый шаг процесса установки) следует открыть в любом текстовом редакторе файл "MyMouseManager.jsh".

В данном файле можно отредактировать значение пяти констант:

  1. StepF - шаг изменение частоты звукового сигнала. Допустимо любое целое число. Установление отрицательного или нулевого значения также допустимо, но не логично.
  2. StepK - шаг изменения децибел в формуле расчёта коэффициента усиления частоты звукового сигнала (см. "Особенности работы"). Допустима любая десятичная дробь с точкой в качестве разделителя. Установление отрицательного или нулевого значения также допустимо, но не логично.
  3. StepPause - шаг изменения значения паузы между словами. Допустимо любое целое число. Установление отрицательного или нулевого значения также допустимо, но не логично. Кроме того, не имеет смысла значение 100 и больше.
  4. SerialNumberVoiceProfile - порядковый номер голосового профиля "MyMouse" в меню "JAWS", вызываемом по Insert+CTRL+S. Рассчитывается сверху вниз. Требует изменения, когда вышеозначенный профиль является не первым, что влечёт за собой некорректную работу скриптов. Допускается любое целое положительное число.
  5. NumberChannels - количество первых каналов эквалайзера из файла "mymouse.ini", которые будут доступны через скрипты. Допустимо любое целое положительное число. При значении выше 7, каналы 8, 9 и т. д. будут обрабатываться "MyMouse Manager" не полностью.
После внесения и сохранения нужных изменений в файл "MyMouseManager.jsh", следует открыть в "Диспетчере скриптов" (Script manager) файл "MyMouseManager.JSS" и в его окне нажать CTRL+S для перекомпиляции. После этого, изменение дополнительных настроек вступит в силу.

Не в коем случае не следует, при редактировании значения констант, удалять или добавлять кавычки и прочие знаки, отличные от оговоренного формата чисел.

Информация для локализации

При желании, "MyMouse Manager" можно локализовать для другого языка. Для этого следует сделать следующее:

  1. Выполнить первый шаг процесса установки.
  2. В любом текстовом редакторе в той же директории открыть файл "MyMouseManager.jsm".
  3. В данном файле перевести русские фразы, написанные в кавычках, на язык локализации и заменить их переводом, после чего сохранить изменения.
  4. В той же директории открыть файл "MyMouseManager.jsd" и внутри него перевести содержимое полей "Synopsis" и "Description", сохранив внесённые изменения.
  5. Не обязательно, но желательно, тут же открыть файл "MyMouseManager.jsh" и перевести содержимое строк, начинающихся со знака ";" (точка с запятой).
  6. Здесь же открыть файл "MyMouseManager.JSS" и в окне Диспетчера скриптов (Script manager) перевести первые четыре строчки, начинающиеся с ";" (точка с запятой) без изменения первого символа строки, после чего нажать CTRL+S для перекомпиляции скрипта.
  7. После этого локализованный "MyMouse Manager" следует снова запаковать в SFX-архив, поместив в него следующие шесть файлов из директории пользовательских настроек:
  8. После этого желательно перевести на язык локализации документацию к пакету скриптов (в произвольном формате) и распространять согласно условиям использования.

Дополнительная информация

Синтезатор "MyMouse" 2 полностью интегрируется в "JAWS", поэтому для изменения параметров, общих для всех голосов, таких как скорость, высота и громкость, можно использовать встроенные возможности программы экранного доступа.

Изначально "JAWS" уже имеет семь стандартных скриптов, предназначенных как раз для быстрого редактирования голосовых параметров:

  1. IncreaseVoiceRate - увеличение темпа активного голоса.
  2. DecreaseVoiceRate - понижение темпа активного голоса.
  3. IncreaseVoiceVolume - увеличение громкости активного голоса.
  4. DecreaseVoiceVolume - понижение громкости активного голоса.
  5. IncreaseVoicePitch - увеличение тона активного голоса.
  6. DecreaseVoicePitch - понижение тона активного голоса.
  7. RestoreVoiceSettings - восстановление нормальных параметров для активного голоса.

Первые два из этих скриптов уже имеют по умолчанию горячие клавиши (Alt+CTRL+PageUp и Alt+CTRL+PageDown соответственно). Другие пять требуют закрепления за ними команд со стороны пользователя.

Для получения подробной информации о том, как присвоить существующему скрипту горячую клавишу, можно обратиться к справке "JAWS" или к соответствующему материалу на сайте "Тифлокомп" - http://win.tiflocomp.ru/docs/howto/keyb.php.

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

Автор скрипта благодарит Анатолия Камынина И Сергея Волкова за помощь и советы. Без этих людей "MyMouse Manager" вряд ли когда-нибудь был бы закончен. Все же допущенные, не смотря ни на что, ошибки и неточности полностью на совести автора.




Удачной работы!


Автор скриптов: © Цейковец Никита

Обратная связь с автором: E-mail - tseikovets@rambler.ru