Командная строка

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 – сменить режим добавления следующих файлов
добавление файлов в конец плейлиста и начало проигрывания первого из них

Примеры

  1. Проиграть My_Song.vtx, будет слышен только канал B в центре (ключ hmixer нужен для того, чтобы Ay_Emul проигнорировал соответствующий параметр в заголовке VTX-файла):
    Ay_Emul -h0,0,255,255,0,0 -hmixer My_Song.vtx
  2. Проиграть My New Song.sqt, эмулируя AY-3-8910/12:
    Ay_Emul.exe "My New Song.sqt" /eay
  3. Установить в микшере раскладку YMABC, тип чипа YM2149, частоту чипа 1750000 Гц, частота прерываний 48,828 Гц (типичный отечественный клон ZX Spectrum – Пентагон 128K):
    Ay_Emul.exe /hYMABC /eym /y1750000 /n48828
  4. Загрузить обшивку Example.ays:
    Ay_Emul Example.ays
  5. Загрузить обшивку Example.ays с использованием ключа (обратная совместимость):
    Ay_Emul.exe /p"C:\Skin Manager\"Example.ays
  6. Добавить в плейлист первый трек из DESERT.XMI, третью мелодию из Dizzy 7.ay и вторую мелодию из Dizzy 6.aym:
    Ay_Emul -add DESERT.XMI:0 "Dizzy 7.ay":2 "Dizzy 6.aym:1"