====== Музыкальный пакет MEDIA ======
FIXME

{{med230.png?nolink}}

Автор: Сергей Новосельцев (1987-1988).

Музыкальный пакет "MEDIA" является инструментальным программным средством (ПС) для разработки музыкального сопровождения учебных, игровых и демонстрационных программ для ПЭВМ MSX. Пакет состоит из музыкального редактора MED и [[msx:maestro:maestro#GRPLIBM|библиотеки функций для языка C]].

ПЭВМ MSX оснащены трёхголосным программируемым звукогенератором ([[msx:psg:psg|PSG]]) GI AY-3-8910, имеющим диапазон 8 октав и генератор шума. Для программной поддержки [[msx:psg:psg|PSG]] в языке [[msx:basic:|]] имеется оператор ''[[msx:basic_dialogue_programming_language:006#play|PLAY]]'' с встроенным языком MML (Music Macro Language), позволяющим в символической форме представлять нотную запись а также управлять громкостью и формой звукового сигнала; однако среда [[msx:basic:|]] мало приспособлена для создания программ профессионального уровня. В системе же [[msx:dos:|]] музыкальные средства отсутствуют.

Пакет "MEDIA" предоставляет разработчикам программ в [[msx:dos:|]] удобный инструмент подготовки музыкальных фрагментов для [[msx:psg:|PSG]], включения их в программу и управления исполнением, создания музыкальных и шумовых эффектов.

Пакет "MEDIA" разработан в рамках идеологии [[msx:maestro:maestro|ПС "МАЭСТРО"]] и предназначен для использования вместе с ним.

Автор выражает благодарность А.Родионову за идейную и техническую поддержку разработки.

Дополнительную информацию о музыкальных возможностях [[msx:basic:|]] можно узнать тут:
  * [[msx:basic_dialogue_programming_language:006]]
  * [[msx:using_musical_means_in_basic:using_musical_means_in_basic|]]


8-) В нём написана музыка: [[msx:ar_games:|]]
====== Язык MML+ ======
В качестве основы нотной записи использован язык [[msx:basic_dialogue_programming_language:006:#mml|MML]], реализованный в [[msx:basic:|]] со следующими дополнениями:
  * при записи нот большие и малые буквы обозначают разные октавы, большие буквы относятся к октаве, указанной в операторе ''О'', a a малые — к ''O+1'' ; это существенно сокращает количество операторов ''О'' в нотной записи.
Например
<code>о3AbCda</code>
''A'',''C'' — октава 3, ''а'' ''b'',''d'',''a'' — октава 4.
  * оператор ''Zn[-]'' повышает (а если указан "-" — понижает) все последующие звуки на "n" полутонов.
  * оператор ''Un[-]'' понижает или повышает все последующие звуки, увеличивая или уменьшая  на "n" единиц делитель частоты PSG.
  * знак '':'' устанавливает на первую следующую за ним ноту или паузу указатель начала цикла для очереди пакетов  данного голоса (см. описание функции play()). 
  * разрешено произвольное количество пробелов в строке, они игнорируются; это позволяет поддерживать "вертикальность" записи аккордов.
  * текст между операторами ''<'' и ''>'' рассматривается как комментарий и не транслируется.
  * трансляция заканчивается, если встречен символ "%" или "\0".

Операторы для  управления LFO и шумом (LFO — Low Frequency Oscillation — изменение частоты звучания генератора относительно основной загруженной ноты):
  * операторы ''['' и '']'' включают и выключают LFO для соответствующего голоса; за оператором [ может следовать цифра 0, 1 или 2, задающая форму  LFO: 
    * ''╱╲''
    * ''╲╱''
    * ''_∏''
  * операторы ''{'' и ''}'' включают и выключают LFO для шума; за оператором ''{'' может следовать цифра 0, 1 или 2, задающая форму LFO:    
    * ''╱╲''
    * ''╲╱''
    * ''_∏''
  * операторы ( и ) включают и выключают  шум в соответствующем голосе.
  * оператор ''*a'' задаёт амплитуду LFO для данного голоса.
  * оператор ''*t'' задаёт период LFO для данного голоса.
  * оператор ''/a'' задаёт амплитуду LFO для шума.
  * оператор ''/t'' задаёт период LFO для шума.
  * оператор ''/f'' задаёт период шума.

Исключён из языка оператор ''X'' подстановки переменной [[msx:basic:|]].

Данный язык будет в дальнейшем обозначаться MML+.

====== Работа с музыкальным редактором MED ======

Музыкальный редактор MED позволяет вести экранное редактирование нотной строки, состоящей из четырёх строк - по одной для каждого из трёх голосов и строки комментариев. При этом осуществляется горизонтальный скроллинг нотной строки.

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

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

Редактор снабжён четырьмя страницами подсказок, которые высвечиваются в верхнем окне экрана. Первая страница описывает клавиши управления редактированием, вторая - операторы языка MML+, третья - операторы MML+ для прямого управления PSG, четвёртая - формы огибающих для оператора S MML+.

После вызова программы MED на экране появляются нотная строка, CUT/PASTE буфер, окно музыкальной очереди, окно прямого управления PSG и строка главного меню с подсвеченным курсором.

Нажатием клавишей <key>→</key> и <key>←</key> курсор меню устанавливается на нужную функцию; для вызова функции надо нажать пробел или <key>'Ввод '⏎</key>.

Из главного меню вызываются функции:
  * [[#EDIT]]
  * [[#LOAD]]
  * [[#SAVE]]
  * [[#BLOAD]]
  * [[#BSAVE]]
  * [[#QUIT]]

Во всех четырёх дисковых функциях: [[#LOAD]], [[#SAVE]], [[#BLOAD]], [[#BSAVE]] после выбора функции в верхнем окне экрана появляется запрос: "enter file name:", в ответ на который следует ввести требуемое имя файла.

Для отмены функции и возврата в меню можно нажать <key>STOP</key> или <key>ESC</key>.

===== EDIT =====
Переход в режим редактирования.

Режим редактирования.

После выбора функции "EDIT" главного меню строка меню стирается с экрана, на её месте появляется строка подсказки; кроме того, в верхней части экрана появляется текущая страница подсказки. Переключение страниц подсказки производится нажатием <key>SHIFT+F5</key>.

Редактирование осуществляется в режиме скроллинга строки при неподвижном курсоре. При этом номер позиции, в которой находится курсор, высвечивается над нотной строкой.

Клавиши управления редактированием:
|<key>↑</key> и <key>↓</key>|перемещают курсор со строки на строку.|
|<key>←</key> и <key>→</key>|двигают строку.
|<key>SHIFT+←</key> и <key>SHIFT+→</key>|двигают строку с шагом 20 символов.|
|<key>HOME</key>|устанавливает курсор на начало строки.|
|<key>HOME+SHIFT</key>|устанавливает курсор на последний символ в строке.|
|<key>INS</key>|переключает режимы вставки/замены символов (текущий режим указан надписью >INSERT< / OVERTYPE в правой части экрана).|
|<key>BS</key> (backspace)|стирает символ слева от курсора.|
|<key>DEL</key>|стирает символ, на который указывает курсор.|
|<key>SHIFT+CTRL+DEL</key>|стирает все символы текущей строки справа от курсора.|
|<key>GRAPH</key>|PASTE: содержимое CUT/PASTE буфера копируется в нотную строку, начиная с позиции курсора.|
|<key>SELECT</key>|транслирует содержимое строчных буферов голосов 1-3 в  музыкальную очередь; в каждой из строк трансляция прекращается по достижении последнего не пробела или символа '%'. В окне музыкальной очереди высвечивается информации о длине музыкальной очереди для каждого из голосов и общей длине музыкального фрагмента, а также продолжительность звучания каждого голоса - в тиках и в секундах. \\ Запускает исполнение музыки.|
|<key>'Ввод '⏎</key>|play; запускает исполнение музыки, однократно или в цикле. Во время исполнения можно продолжать редактирование.|
|<key>STOP</key>|"выключает" музыку.|
|<key>STOP+SHIFT</key>|приостанавливает/продолжает исполнение музыки.|
|<key>F1</key>, <key>F2</key>, <key>F3</key>, <key>F4</key>|включает/выключает LFO для голосов 1-3 и шума. Для голосов, в которых включён LFO, подсвечивается соответствующая колонка в строке "LFO on" окна прямого управления.|
|<key>F5</key>|устанавливает/сбрасывает признак циклического исполнения. \\ Если установлен признак цикла, на экране появляется подсвеченная надпись "CYCLE".|
|<key>F1+SHIFT</key>, <key>F2+SHIFT</key>, <key>F3+SHIFT</key>|включает/выключает шум в голосах 1-3. \\ Для голосов, в которых включён шум, подсвечивается колонка в строке "Noise on" окна прямого управления.|
|<key>F1+CTRL</key>, <key>F2+CTRL</key>, <key>F3+CTRL</key>, <key>F4+CTRL</key>|меняет форму LFO для голосов 1-3 и шума.|
|<key>←+CTRL</key>, <key>→+CTRL</key>|перемещение курсора LFO по строке параметров LFO. \\ В этой строке отображаются текущие значения параметров *a, *t для каждого из голосов и /a, /t, /f для шума.|
|<key>↑+CTRL</key>, <key>↓+CTRL</key>|увеличение или уменьшение параметра LFO, на который указывает курсор LFO.|
|<key>ESC+SHIFT</key>|сброс всех параметров LFO, выключение LFO и шума.|
|<key>ESC</key>|выход из режима редактирования в главное меню.  Окно подсказки стирается, музыка выключается.|
|<key>SHIFT+F5</key>|Вывод справки (подсказки)|



==== CUT/YANK ====
|<key>TAB</key> (1-е нажатие)|переход из режима редактирования в режим CUT/YANK; в этом режиме можно только управлять движением нотной строки; при этом помечается блок текста.|

Выход из режима CUT/YANK может осуществляться следующими способами:
|<key>TAB</key> (2-e нажатие)|YANK: отмеченный блок копируется в CUT/PASTE буфер; возврат в режим редактирования.|
|<key>TAB</key> (2-e нажатие)+<key>SHIFT</key>|CUT: отмеченный блок пересылается в CUT/PASTE буфер; возврат в режим редактирования.|
|<key>TAB</key> (2-e нажатие)+<key>CTRL</key>|возврат в режим редактирования.|


===== LOAD =====
Загрузка символического файла для редактирования. 

Если первым символом файла является "%", файл загружается в строчные буфера, начиная с буфера комментариев. Загрузка в каждом буфере начинается с позиции, в которой находился курсор. Разделителями голосов являются знаки "%" или "\0"(0). Знаки–разделители в буфер не переписываются. Также подавляются знаки с шестнадцатеричным значением < 0x20. Максимальная длина каждого голоса 700 байт. Если редактор при вызове функции LOAD находился в режиме замены (OVERTYPE), то старое содержимое буферов, начиная с позиции курсора, стирается; если был включён режим вставки (>INSERT<), это старое содержимое добавляется в конец буфера после вновь загруженного; при этом стирается буфер CUT/PASTE. 

Если первый символ файла не "%", файл переписывается в буфер CUT/PASTE (700 байтов), а строчные буфера не изменяются.

===== SAVE =====
Строчные буфера переписываются в файл на диске. 

Если в записи содержится символ "%", то символы, стоящие в строке данного голоса правее %, не записываются на диск.

Первым символом файла, а также после каждого голоса записываются "%".

===== BLOAD =====
Файл с диска ( музыкальный фрагмент ) переписывается в область музыкальной очереди редактора (до 10500 байтов). 

Фрагмент можно затем прослушать функцией play редактора. 

Дальнейшее редактирование фрагмента невозможно.
===== BSAVE =====
Готовый музыкальный фрагмент из области музыкальной очереди редактора записывается на диск.

===== QUIT =====
Выход из редактора в [[msx:dos:|]].


{{tag>MSX Programming Rodionov_A_B}}