Командная строка
Ay_Emul может воспринимать параметры, передаваемые в командной строке. Параметры должны быть разделены пробелами. Если параметр начинается с символа "-" или "/" (в Linux-версии – только "-"), то он воспринимается как ключ, иначе – как имя файла.
Если параметр (имя файла или ключ) содержит пробелы, то он должен передаваться в двойных кавычках, при этом допускается брать в кавычки как весь параметр, так и тот его фрагмент, который содержит пробелы.
Если в командной строке имеется ряд одинаковых ключей, то запоминается значение последнего в строке.
Все файлы (за исключением файлов обшивки), указанные в командной строке, будут добавлены в предварительно очищенный список проигрывания, после чего начнётся проигрывание первого из них. Файл обшивки можно указать как без ключа, так и с ключом (см. далее). Допускается также указывать в командной строке имена файлов-списков проигрывания (расширение AYL, M3U, M3U8, PLS или CUE). Для файлов, которые содержат более одной мелодии (AY, AYM, SNDH, MID или XMI), через двоеточие можно указать номер мелодии/трека (нумерация начинается с нуля).
Для Windows-версии указывать полный путь до исполняемого файла необязательно, если приложение зарегистрировано в системе (см. описание окна "Инструменты").
Cписок ключей
- -sX – частота сэмплирования в Гц
- X = от 8000 до 300000
- -b8, -b16 – количество бит на сэмпл
- 8 или 16
- -dmono, -dstereo, -dlist, -dmixer – число каналов звуковой карты
- моно или стерео; указанное в списке проигрывания брать или игнорировать
- -wonX – количество звуковых буферов
- X = от 2 до 10
- -wolX – длина звукового буфера в мс
- X = от 5 до 2000
- -wodX – номер устройства вывода цифрового звука
- X >= 0
- -zX – частота процессора Z80 в Гц
- X = от 1000000 до 8000000
- -eay, -eym, -elist, -emixer – тип микросхемы
- AY-3-8910/12 или YM2149(F); указанный в списке проигрывания брать или игнорировать
- -yX, -ylist, -ymixer – частота сопроцессора в Гц
- X = от 1000000 до 3000000; указанную в списке проигрывания брать или игнорировать
- -tX – смещение до первого прерывания в тактах Z80
- X >= 0
- -iX – количество тактов Z80 между прерываниями
- X > 0
- -aon, -aoff – амплитудный индикатор
- включить или отключить
- -fon, -foff – частотный индикатор
- включить или отключить
- -lX – язык интерфейса
- X = стандартный идентификатор языка (ru – русский, en – английский и т.д.)
- -nX, -nlist, -nmixer – частота прерываний в мГц
- X = от 1000 до 2000000; указанную в списке проигрывания брать или игнорировать
- -con, -coff – зацикливание мелодий
- включить или выключить
- -ri, -rn, -rh – приоритет приложения (для Windows-версии)
- низкий, обычный или высокий
- -hX, -hlist, -hmixer – усиление (раскладка) каналов
- X - аббревиатура стандартной раскладки (MONO, AYABC, YMABC, AYACB, YMACB и так далее); указанное в списке проигрывания брать или игнорировать
- -hX,X,X,X,X,X – ручное задание усиления каналов
- попарно перечисляются коэффициенты усиления для каналов A, B и C (каждая пара – усиление левого и правого канала), X = от 0 до 255
- -g0, -g1, -g2 – иконка в трее
- нет, всегда или минимизировать
- -kon, -koff – автоматическая прокрутка заголовка
- включить или отключить
- -j0, -j1, -j2 – режим таймера
- "проиграно", "осталось", "продолжительность"
- -p, -pX – загрузить обшивку
- стандартную или из файла (X – его имя и путь), имя файла обшивки можно указать и без ключа -p
- -q, -qX – частота MFP-Timer в Гц
- привязать к частоте AY/YM или установить произвольно (X = от 1000000 до 3000000)
- -uX – усиление "бипера"
- X = от 0 до 255
- -vhide, -vshow – отображение окна
- свернуть или развернуть
- -won, -woff – запоминание пути к последней использованной папке
- включить или отключить
- -!on, -!off – запоминание положения регулятора громкости
- включить или отключить
- -xon, -xoff – запоминание положения основных окон
- включить или отключить
- -fdPX – настройка информации о треке (см. окно "Инструменты")
- вместо P подставить параметр, вместо X его значение:
-fdfX – X задаёт имя и путь целевого файла
-fdnX – X задаёт строку "Молчание"
-fdsX – X задаёт строку "Окончание"
-fdpX – X задаёт строку "Префикс"
-fde0, -fde1 – убрать или поставить галочку "Включено"
-fdk0, -fdk1 – убрать или поставить галочку "Удалять при молчании"
-fdx0, -fdx1 – убрать или поставить галочку "Удалять на выходе"
-fdcX – X задаёт строку "Кодировка"
- -add – сменить режим добавления следующих файлов
- добавление файлов в конец плейлиста
- -adp – сменить режим добавления следующих файлов
- добавление файлов в конец плейлиста и начало проигрывания первого из них
Примеры
- Проиграть My_Song.vtx, будет слышен только канал B в центре (ключ hmixer нужен для того, чтобы Ay_Emul проигнорировал соответствующий параметр в заголовке VTX-файла):
Ay_Emul -h0,0,255,255,0,0 -hmixer My_Song.vtx
- Проиграть My New Song.sqt, эмулируя AY-3-8910/12:
Ay_Emul.exe "My New Song.sqt" /eay
- Установить в микшере раскладку YMABC, тип чипа YM2149, частоту чипа 1750000 Гц, частота прерываний 48,828 Гц (типичный отечественный клон ZX Spectrum – Пентагон 128K):
Ay_Emul.exe /hYMABC /eym /y1750000 /n48828
- Загрузить обшивку Example.ays:
Ay_Emul Example.ays
- Загрузить обшивку Example.ays с использованием ключа (обратная совместимость):
Ay_Emul.exe /p"C:\Skin Manager\"Example.ays
- Добавить в плейлист первый трек из DESERT.XMI, третью мелодию из Dizzy 7.ay и вторую мелодию из Dizzy 6.aym:
Ay_Emul -add DESERT.XMI:0 "Dizzy 7.ay":2 "Dizzy 6.aym:1"