Автор:	© Анатолий Камынин
Дата публикации:	2005

Описание встроенных функций и скриптов языка сценариев JAWS для управления параметрами синтезаторов речи и голосовыми настройками.

• Скрипт IncreaseVoicePitch
• Скрипт IncreaseVoicePitchSayAll
• Скрипт IncreaseVoiceRate
• Скрипт IncreaseVoiceRateSayAll
• Скрипт IncreaseVoiceVolume
• Скрипт IncreaseVoiceVolumeSayAll
• Функция InitializeGlobalVoiceSettings
• Функция IsSpeaking
• Функция IsSpeechOff
• Скрипт MuteSynthesizer
• Функция MuteSynthesizerToggle
• Функция NullAllGlobalSettings
• Функция ResetSynth
• Функция ResetVoiceSettings
• Скрипт RestoreVoiceSettings
• Функция SayAllInProgress
• Функция SayUsingVoice

Скрипт IncreaseVoicePitch

Описание: Этот скрипт повышает тон активного голоса. При каждом вызове этого скрипта, JAWS будет проговаривать "Higher".

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт IncreaseVoicePitchSayAll

Описание: Этот скрипт повышает тон активного голоса во время процесса непрерывного чтения (SayAll). JAWS голосом с изменённой высотой тона повторит текущую порцию текста, прочитанную в режиме непрерывного чтения.

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт IncreaseVoiceRate

Описание: Этот скрипт увеличивает темп речи активного голоса. При каждом вызове этого скрипта JAWS будет проговаривать "Faster".

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт IncreaseVoiceRateSayAll

Описание: Этот скрипт увеличивает темп речи активного голоса во время процесса непрерывного чтения (SayAll). JAWS голосом с изменённым темпом речи повторит текущую порцию текста, прочитанную в режиме непрерывного чтения.

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт IncreaseVoiceVolume

Описание: Этот скрипт увеличивает громкость активного голоса. При каждом вызове этого скрипта JAWS будет проговаривать "Louder".

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт IncreaseVoiceVolumeSayAll

Описание: Этот скрипт увеличивает громкость активного голоса во время процесса непрерывного чтения (SayAll). JAWS голосом с изменённой громкостью повторит текущую порцию текста, прочитанную в режиме непрерывного чтения.

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция InitializeGlobalVoiceSettings

Описание: Эта функция сохраняет в глобальных переменных текущие значения указанного голосового параметра (громкость, темп речи, высоту тона), действующее в каждом из голосовых контекстов (VCTX_PCCURSOR, VCTX_JAWSCURSOR, VCTX_KEYBOARD, VCTX_MESSAGE).

Возвращаемое значение: Void

Параметр 1:

Int, константа с префиксом "V_" из файла HJCONS.JSH, определяющая тот голосовой параметр, который следует сохранить. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция IsSpeaking

Описание: Функция проверяет, озвучивается ли текст в данный момент.

Возвращаемое значение: Int, TRUE - если синтезатор озвучивает текст; FALSE - в противном случае.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

1. PAC Mate 1.10 и более поздних

Функция IsSpeechOff

Описание: Функция позволяет определить, выключен ли синтезатор.

Возвращаемое значение: Int, TRUE - если синтезатор выключен. False - если синтезатор не выключен.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт MuteSynthesizer

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

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

1. JAWS 4.51 и более поздних

Функция MuteSynthesizerToggle

Описание: Если используется программный синтезатор речи, то эта функция меняет его состояние на противоположное: если синтезатор был включён, то функция выключает его, и наоборот.

Возвращаемое значение: String, строка, сообщающая, отключён синтезатор или нет.

Параметр 1:

Int, true - если нужно получить текущее значение, false - если нужно изменить значение и вернуть измененное значение. Этот параметр является обязательным.

Эта функция доступна в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция NullAllGlobalSettings

Описание: Эта функция обнуляет все глобальные переменные, в которых функция InitializeGlobalVoiceSettings сохраняет параметры (громкость, высоту тона, темп речи) голосовых контекстов.

Возвращаемое значение: Void

Параметр 1:

Int, Голосовой параметр, который нужно установить. Этот параметр не является обязательным.

Эта функция доступна в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция ResetSynth

Описание: Функция реинициализирует синтезатор с надлежащими установками громкости, темпа речи и высоты тона. Используется, чтобы вернуть синтезатор в нормальное состояние в том случае, если он рассогласовался с JAWS.

Возвращаемое значение: Void

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция ResetVoiceSettings

Описание: Это функция восстанавливает значение голосовых параметров, сохраненное до манипуляций с голосами. Вызов этой функции будет иметь эффект, если, прежде чем манипулировать голосами, голосовые параметры были сохранены при помощи вызова функции SetVoiceGlobalSettings. После восстановления голосовых параметров все глобальные значения устанавливаются в ноль (точнее, сбрасывается признак того, что в глобальных переменных что-то было сохранено).

Возвращаемое значение: Void

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Скрипт RestoreVoiceSettings

Описание: Этот скрипт восстанавливает нормальное состояние голосовых настроек, которые пользователь изменял в процессе работы. Например, при помощи Alt+Control+PAGE UP или Alt+Control+PAGE DOWN он мог изменить темп речи.

Возвращаемое значение: Void

Параметры: отсутствуют

Этот скрипт доступен в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних

Функция SayAllInProgress

Описание: Функция позволяет узнать, активен ли режим непрерывного чтения.

Возвращаемое значение: Int, TRUE - если идет процесс непрерывного чтения, FALSE - в противном случае.

Параметры: отсутствуют

Эта функция доступна в следующих приложениях:

1. JAWS 4.51 и более поздних

Функция SayUsingVoice

Описание: Эта функция озвучивает строку текста, используя указанный голосовой контекст.

Возвращаемое значение: Void

Параметр 1:

String, одна из констант, обозначающих голосовой контекст и определённых в файле hjconst.jsh, то есть : VCTX_GLOBAL, VCTX_MESSAGE, VCTX_KEYBOARD, VCTX_SCREEN, VCTX_PCCURSOR, VCTX_JAWSCURSOR. Этот параметр является обязательным.

Параметр 2:

String, Текст, заключенный в двойные кавычки, или строковая переменная, содержащая текст для озвучивания. Этот параметр является обязательным.

Параметр 3:

Int, одна из следующих констант, отражающих используемый режим вывода: OT_STRING, OT_liNE, OT_WORD, OT_CHAR, OT_FIELD, OT_CHUNK, OT_SAYALL, OT_SPELL, OT_PHONEMIC, OT_APP_name, OT_DIALOG_name, OT_CONTROL_name, OT_MDI_name, OT_WINDOW_name, OT_GRAPHIC, OT_HELP, OT_STATUS, OT_SELECTED, OT_TEXT, OT_POSITION, OT_STATIC, OT_FONT, OT_KEYBOARD, OT_CURSOR, OT_DEBUG. Этот параметр является обязательным.

Параметр 4:

Int, не используется. Этот параметр не является обязательным.

Эта функция доступна в следующих приложениях:

1. PAC Mate 1.10 и более поздних
2. JAWS 4.51 и более поздних