Официальный русскоязычный каталог дополнений NVDA

• Мастер тона

• Авторы: Hrvoje Katić

• Скачать стабильную версию

Добро пожаловать в Tone Master! Я создал это небольшое дополнение к NVDA просто для развлечения, а также для того, чтобы вы получали удовольствие от его использования.

Мне всегда хотелось создавать музыкальные мелодии с помощью NVDA, а не просто слушать звуковые сигналы NVDA о прогрессе и ошибках. Однако это не так просто сделать, поэтому сначала я хотел сделать это проще. Именно поэтому я написал программу Tone Master. Только представьте себе, что вы можете услышать, как NVDA играет песни Моцарта или Бетховена, а может быть, лучшие хиты Rolling Stones. И хотя конечный результат будет напоминать рингтоны на старых мобильных телефонах, это все равно может быть забавно.

Tone Master упрощает процесс воспроизведения тональных последовательностей за счет реализации файлов тональных данных. Эти файлы можно редактировать с помощью вашего любимого текстового редактора, а затем сохранять для воспроизведения с помощью NVDA. Читайте далее инструкции!

Файлы данных тембров

Прежде чем воспроизвести первую музыкальную мелодию с помощью Tone Master, необходимо создать и загрузить файл данных тембра. Файлы тональных данных - это просто текстовые файлы с расширением .tdf. Tone Master использует эти файлы для обработки и воспроизведения тональных последовательностей. Чтобы создать файл тональных данных для Tone Master и успешно его воспроизвести, необходимо следовать простым правилам, описанным ниже.

1. Каждая строка в файле .tdf должна содержать три параметра, разделенных двоеточием (:). Первый параметр - высота тона, второй - длительность тона, третий - время тишины между тонами. Все три параметра необходимо указать, иначе Tone Master не сможет воспроизвести ваши тональные данные.
2. Параметры высоты тона и длительности должны быть заданы в виде целых знаковых чисел, а время тишины - в виде вещественного значения с плавающей точкой.
3. Хеш-знак (#) в начале любой строки файла .tdf будет восприниматься как комментарий и игнорироваться программой Tone Master.

Пример: Воспроизведение последовательности из 3 тонов

1500:100:0.5

1000:100:0.09

500:100:0.7

В данном примере первый тон в последовательности имеет высоту тона 1500, длительность 100 и 0,5 тишины. Высота второго тона равна 1000, длительность - 100, а тишина - 0,09. Последний тон в последовательности имеет высоту тона 500, длительность 100, а тишина составляет 0,7.

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

Чтобы лучше ознакомиться с синтаксисом файлов тональных данных, посмотрите и попробуйте отредактировать файл примера, входящий в состав данного дополнения. Он находится в подпапке "tones", где должны находиться и все ваши файлы .tdf.

Сочетание клавиатурных команд

• Alt+NVDA+T: Воспроизводит загруженные тональные данные, если все в порядке.
• Alt+Shift+NVDA+T: останавливает воспроизведение загруженных тональных данных, если воспроизводятся какие-либо тональные данные.
• Alt+NVDA+N: Создает и открывает новый пустой файл тембральных данных в Блокноте для редактирования.
• Alt+NVDA+L: Открывает диалог, позволяющий выбрать один из доступных файлов тональных данных, который будет загружен для воспроизведения.
• Alt+NVDA+E: открывает текущий загруженный файл тембральных данных в Блокноте для редактирования.
• Alt+NVDA+O: Открывает папку с файлами тембральных данных, в которую их также следует сохранить для поиска программой Tone Master.

Другие примечания

Создать, отредактировать и загрузить файлы тональных данных, а также открыть папку tones, в которой находятся эти файлы, можно, зайдя в меню NVDA, подменю Tools, подменю Tone Master.

Когда появится диалог создания нового файла тональных данных, введите имя без расширения .tdf. Расширение будет автоматически добавлено программой Tone Master. Если имя не было указано, то Tone Master использует имя по умолчанию "untitled.tdf". Tone Master автоматически создаст и загрузит новый файл, а также откроет его в Блокноте для редактирования. Для отмены создания нового файла нажмите Escape в подсказке имени файла.

Примечание: Для редактирования файлов тембральных данных в Tone Master используется программа Notepad, так как она по умолчанию поставляется с операционной системой Windows, и поэтому на любом компьютере она должна быть доступна.

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

Открыв папку с файлами .tdf, можно загрузить их в текстовый редактор для просмотра или редактирования. Однако для того, чтобы услышать результат "на лету", я настоятельно рекомендую сначала загрузить файл в программу Tone Master, если это возможно. Затем можно редактировать файл, сохранять результаты и после каждого сохранения с помощью команды play прослушивать последний результат.

Перевод

• Валентин Куприянов.

Журнал версий

Изменения для 1.5

• Исправлено: Исправлена проблема совместимости с NVDA 2022.1 и более поздними версиями.

Изменения для 1.4

• Исправлено: Исправлена проблема совместимости с NVDA 2021.1 и более поздними версиями.

Изменения для 1.3

• Исправлено: Исправлена проблема совместимости с новыми версиями NVDA, использующими wxPython 4.

Изменения для 1.2

• Исправлено: Устранена проблема, при которой выбор пустого тонального сигнала, а затем выбор другого и попытка его воспроизведения приводили к тому, что тональные данные не воспроизводились.

Изменения для 1.1

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

Изменения для 1.0

• Первоначальный релиз.