AY-3-8910/12 ZX Spectrum Sound Chip Emulator

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

Эмулятор может воспринимать параметры, передаваемые в командной строке. Параметры должны быть разделены пробелами. Если параметр начинается со знака "/" (наклонная черта), то он воспринимается как ключ, иначе – как имя файла. Если имя файла-параметра содержит пробелы, то оно должно передаваться в двойных кавычках. Любой ключ, содержащий пробелы, так же должен браться в двойные кавычки, при этом допускается брать в кавычки как весь ключ, так и тот его фрагмент, который содержит пробелы. Если в командной строке имеется ряд одинаковых параметров, то запоминается значение последнего в строке. Все файлы, указанные в командной строке, будут добавлены в предварительно очищенный список проигрывания, после чего начнётся проигрывание первого из них. Допускается также указывать в командной строке имена файлов списка проигрывания (расширение AYL или M3U). Для файлов, которые содержат более одной мелодии (AY, AYM, MID или XMI), через двоеточие можно указать номер мелодии/трека (нумерация начинается с нуля).

Ниже приведён список ключей.

Частота сэмплирования           sXXXXX
                                XXXXX = от 8000 до 300000.
Количество бит на сэмпл         bXXXXX
                                XXXXX = 16 или 8.
Число каналов звуковой карты    dmono
                                dstereo
                                dlist – брать из списка проигрывания
                                dmixer – не брать из списка.
Количество звуковых буферов     wonXXXXX
                                XXXXX = от 2 до 10.
Длина звукового буфера          wolXXXXX
                                XXXXX = от 5 до 2000.
Номер устройства вывода звука   wodXXXXX
                                XXXXX >= 0.
Частота процессора Z80          zXXXXX
                                XXXXX = от 1000000 до 8000000
Тип микросхемы  AY-3-8910/12    eay
                YM2149(F)       eym
                                elist – брать из списка проигрывания
                                emixer – не брать из списка.
Частота сопроцессора            yXXXXX
                                XXXXX = от 1000000 до 3000000
                                ylist – брать из списка проигрывания
                                ymixer – не брать из списка.
Время первого прерывания        tXXXXX
                                XXXXX больше или равно нулю.
Число тактов между прерываниями iXXXXX
                                XXXXX больше нуля.
Амплитудный индикатор
                включить        aon
                отключить       aoff
Частотный индикатор
                включить        fon
                отключить       foff
Оптимизация     по скорости     op
                по качеству     oq
Язык интерфейса русский         lr
                английский      le
Частота прерываний              nXXXXX
                                XXXXX – от 1000 до 2000000 (в мГц)
                                nlist – брать из списка проигрывания
                                nmixer – не брать из списка.
Зацикливание мелодий
                включить        con
                выключить       coff
Приоритет Эмулятора             ri – низкий,
                                rn – обычный,
                                rh – высокий.
Усиление (раскладка) каналов    hMONO
                                hAYABC
                                hAYACB
                                hYMACB
                                и так далее для выбора стандартной раскладки.
                                hlist – брать из списка проигрывания
                                hmixer – не брать из списка.
Ручное задание усиления каналов hXX,XX,XX,XX,XX,XX
                                где после ключа h попарно перечисляются коэффициенты усиления для каналов A, B и C (каждая пара – усиление левого и правого канала). XX = от 0 до 255.
Иконка на панели        нет     g0
                        всегда  g1
                минимизировать  g2
Автоматическая прокрутка заголовка
                включить        kon
                выключить       koff
Режим таймера   “проиграно”     j0
                “осталось”      j1
                “длина”         j2
Загрузить обшивку
        стандартную             p
        пользовательскую        pИмя_AYS-Файла
Частота MFP-Timer привязать
                к частоте AY/YM q
                произвольно     qXXXXX
                                XXXXX = от 1000000 до 3000000
Усиление “бипера”               uXXXXX
                                XXXXX = от 0 до 255
Отображение окна
                свернуть        vhide
                развернуть      vshow
Запоминание пути к папкам
                включить        won
                отключить       woff
Запоминание положения регулятора громкости
                включить        !on
                выключить       !off
Запоминание положения основных окон
                включить        xon
                выключить       xoff
Ключи FIDO Tools
                File Name       fdfИмя_Файла
                Nothing         fdnСтрока
                Suffix          fdsСтрока
                Prefix          fdpСтрока
                Enabled да      fde1
                        нет     fde0
        Kill On Nothing да      fdk1
                        нет     fdk0
        Kill On Exit    да      fdx1
                        нет     fdx0
        Win Encoding    да      fdw1
                        нет     fdw0
Добавление файлов в конец
                плейлиста       add
Добавление файлов в конец плейлиста и начало
проигрывания первого из них     adp

Примеры:

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