АГАТ-КОМПОЗИТОР

Руководство по эксплуатации.

В настоящем документе приведена информация о назначении и условиях применения музыкального редактора "АГАТ-КОМПОЗИТОР" для персональной электронной вычислительной машины (ПЭВМ) "АГАТ" исполнения 7, основные характеристики и обращения к программе. Описаны входные, выходные данные и сообщения системы.

1. НАЗНАЧЕНИЕ И УСЛОВИЯ ПРИМЕНЕНИЯ.

Программная система АГАТ-КОМПОЗИТОР (в дальнейшем ПС) версии 89.1 является удобным и простым в эксплуатации двухголосым музыкальным редактором, предназначеным для создания, редактирования и воспроизведения нотных музыкальных файлов. Нотные файлы, созданые в ПС являются автономными модулями, готовыми к запуску (воспроизведению) независимо от ПС. Таким образом пользователь получает возможность писать в ПС файлы музыкального сопровождения собственных программ различного назначения. Запуск порождаемых автономных нотных файлов может быть осуществлен по команде BRUN <имя файла> или CALL <начальный адрес>. При этом редактор создает перемещаемые музыкальные модули, самонастраивающиеся на произвольный адрес загрузки, что позволяет широко и беспроблемно использовать музыкальные фрагменты, подготовленные редактором в целях музыкального оформления различных программных средств и систем. Немаловажным достоинством ПС является наличие дружественного, располагающего интерфейса.
Необходимой для функционирования ПС программно-технической средой являются ПЭВМ "АГАТ" исп.7 и штатная ДОС с БЕЙСИК-интерпретатором. ПС размещается на гибком магнитном диске вместе с необходимыми средствами автозапуска. На этом же диске располагается также библиотека готовых нотных файлов.

2. ХАРАКТЕРИСТИКИ ПРОГРАММЫ.

ПС является второй, двухголосой версией музыкального редактора 1989 года. ПС написана на языке ассемблера с использованием некоторых особенностей доступной программной среды - БЕЙСИК-интерпретатора, а также известных подпрограмм монитора.

ПС обеспечивает:

3. ОПИСАНИЕ РАБОТЫ ПРОГРАММЫ.

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

Если загрузка ПС прошла нормально, пользователь оказывается в главном меню системы, состоящем из следующих директив:

Выбор нужного режима осуществляется клавишами-стрелками "ВВЕРХ" и "ВНИЗ" с подтверждением клавишей "ВВОД".

А) РЕЖИМ "КАТАЛОГ ДИСКА".

Выводит на дисплей директорию диска.

Б) РЕЖИМ "ЧТЕНИЕ ФАЙЛА".

При переходе в этот режим ПС выдает запрос:
ИМЯ ФАЙЛА:
в ответ на который пользователь может сообщить имя загружаемого нотного файла или возвратиться в главное меню просто нажав "ВВОД". Далее ПС загружает поименованный нотный файл в память и возвращается в главное меню.

В) РЕЖИМ "ЗАПИСЬ ФАЙЛА".

Весь протокол обмена данного режима аналогичен протоколу режима "ЧТЕНИЕ ФАЙЛА". Попытка записи не существующего файла игнорируется.

Г) РЕЖИМ "СОЗДАНИЕ ФАЙЛА".

Переводит ПС непосредственно в редактор с предварительной чисткой буфера нотных знаков. При входе в режим ПС выдает запрос:
УНИЧТОЖИТЬ ФАЙЛ В ПАМЯТИ? ДА/НЕТ

Пользователь может выбрать нужное клавишами-стрелками и нажать "ВВОД". Выбор "НЕТ" отменяет действие директивы и возвращает пользователя в главное меню. При выборе "ДА" на экране дисплея перед пользователем оказываются два пронумерованных нотных стана (станы 0-ой и 1-ый) и маркер в начале 0-го стана. Это означает, что нотный буфер инициализирован на начало. Вертикальное положение маркера на нотном стане, естественно, указывает высоту предполагаемой к вводу ноты и никак не влияет на установку пауз и реприз. Исходная позиция маркера - нота 'си' первой октавы. Интервал воспроизводимых звуков: соль малой октавы - до-диез третьей октавы. Функции управления положением маркера на нотном стане исполняют клавиши на дополнительной клавиатуре:

те же функции дублируются клавишами-стрелками.

При этом перемещение маркера вправо или влево определяет переход с верхнего стана на нижний и наоборот, а также (в соответствующих крайних позициях маркера) листание на ОДИН нотный стан вперед или назад. В этих случаях к одному из показанных станов добавляется новый с большим или меньшим номером соответственно. Объем буфера вводимых нотных знаков составляет до 1400, что соответствует сотне (от 0-го до 99-го) станов по 14-ть нот в каждом. Управление вводом выбранных предварительно нотных знаков производится с дополнительной клавиатуры:

Первое из приведенных выше значений клавиши отрабатывают в верхнем положении маркера, задающего длительность нот и пауз, второе - в нижнем. При этом реприза в самом начале нотного файла может быть опущена. Разрешается да 20-ти вложенных друг в друга реприз. Возможно использование нот или пауз с точкой (продолжение на половину длительности) для чего используется префикс клавиша "." на дополнительной клавиатуре. Например, нажатие "." и затем "8" выводит ноту-бемоль с точкой в текущую позицию. В этой версии редактора отсутствуют ключевые знаки бемоль и диез. Поэтому необходимо вводить ноты-бемоль и ноты-диез в каждом случае.

Редактирование вводимых нотных знаков осуществляются следуюшим образом:

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

Диапазон возможных длительностей находится в пределах от целой до тридцать второй ноты или паузы. Следует учитывать тот факт, что положение маркера этого меню в нижней позиции (выбор пауз) предполагает ввод реприз при нажатии на функциональные клавиши '8' (начальная реприза) и '9' (конечная реприза). В верхнем положении маркера (выбор нот) нажатие этих ('8' и '9') клавиш дает ввод ноты-бемоль и ноты-диез соответственно.

ПС предоставляет пользователю возможность просмотра всего файла от начала до конца. Для этого необходимо использовать клавиши '1' и '3' функциональной клавиатуры:

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

Во всех критических состояниях: - в верхнем и нижнем положении маркера на нотном стане,

раздается предупреждающий звуковой сигнал (трель), после чего в первом случае маркер на нотном стане переводится в противоположное положение (из верхнего в нижнее и наоборот), во втором случае убирается маркер с нотного стана, в последнем случае попытка раздвижки игнорируется. Для того, чтобы вернуть убраный при вводе последнего 1400-го нотного знака (на 99-м нотном стане) маркер нужно нажать на одну из следующих функциональных клавиш:

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

Таким образом ПС предоставляет любому, имеющему самую слабую подготовку пользователю широкий, развитый набор средств просмотра, набора, редактирования и фрагментарного или полного воспризведения введенного нотного файла. Обладая при этом дружественным интерфейсом ПС способствует созданию хорошего настроения и получению эффективных результатов при минимально затраченном на работу времени. Кроме того ПС может быть с успехом ипользована для эффективного обучения азам нотной грамоты и служить своеобразным тренажор0м в этих целях. Для пользователя-программиста ПС предоставит хорошую возможноть создания файлов музыкального сопровождения собстенных программ различного назначения. Существует возможность полной чистки буфера нотных знаков (стирания всего нотного файла), не выходя из режима редактора. Для этого, независимо от текущего состояния редактора, нужно нажать на клавишу 'ц'. Редактор, после этого, выдает запрос:
УНИЧТОЖИТЬ ФАЙЛ В ПАМЯТИ? ДА/НЕТ
Выбор альтернативы "НЕТ" отменяет действие директивы, выбор "ДА" переводит редактор в исходное состояние.

Выход из режима редактора в главное меню осуществляется функциональной клавишей '='.

Д) РЕЖИМ "РЕДАКТИРОВАНИЕ".

Вход в этот режим предполагает, в отличие от режима 'создание файла' сохранение загруженного или введенного раннее файла в буфере. Таким образом пользователю предоставляется возможность дальнейшего редактирования или просто просмотра текущего нотного файла. То есть подготавливаемый файл может быть временно записан на дискетту, а работу с ним можно продолжить в другое время. В остальном действия в режиме редактирования ничем не отличаются от действий в режиме создания файла, описанных выше (см.Г)).

Ж) РЕЖИМ "ВОСПРОИЗВЕДЕНИЕ".

Данный режим позволяет воспроизвести музыкальный файл полностью от начала до конца, если при этом исполнение не прервать принудительно нажатием на любую клавишу. После конца воспроизведения или после его прерывания главное меню готово к дальнейшим действиям пользователя. Установка маркера главного меню на позицию 'воспроизведение' позволяет осуществить вход в дополнительное меню этого режима, задающее выбор режима воспроизведения. Вход в дополнительное меню производится простым нажатием на клавишу '->' в этой позиции маркера главного меню. Дополнительное меню режима воспроизведения имеет такой вид:
ТЕМП ИГРЫ: MODERATO
ИСПОЛНЕНИЕ: LEGATO

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

Исполнение можно задать двух типов:

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

В начале работы с ПС установлены:

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

Попытка воспроизведения несуществующего файла игнорируется.

З) РЕЖИМ "КОНЕЦ РАБОТЫ".

Данный режим позволяет закончить работу в ПС и выйти в директивный режим БЕЙСИК-интерпретатора. Кроме возможности ознакомления с принципами работы ПС 'агат-композитор' по данному описанию, существует возможность вывода справочной информации в самой ПС. Для этого в режиме главного меню или в режиме редактирования/создания файла необходимо нажать на клавиши 'упр-и'. На экране появится первый кадр с краткой справочной информацией. Для получения еще двух кадров информации нужно нажать на любую клавишу. После просмотра последнего кадра, опять-таки нажатием на лювую клавишу можно выйти в главное меню.