Scripting

Скрипты в UKNCBTL.Qt

Начиная с UKNCBTL.Qt версии beta-32 в оболочку эмулятора добавлена поддержка скриптинга. Командой File > Run Script выбирается .JS-файл и запускается на выполнение. Язык файла -- ECMAScript, по сути это JavaScript.

Справочник по ECMAScript: http://qt-project.org/doc/qt-4.8/ecmascript.html

В тексте программы может использоваться объект emulator, методы которого используются для управления эмулятором UKNCBTL.

Методы объекта emulator

emulator.reset(); // since beta 32

Сброс эмулируемой машины.

emulator.run(100); // since beta 32

Работа эмулятора в течение 100 фреймов, каждый фрейм это 1/25 секунды.

emulator.saveScreenshot("test.png"); // since beta 32

Сохранение скриншота в формате PNG.

emulator.attachCartridge(1, 'romctr_basic.bin'); // since beta 33

Подключение картриджа.

emulator.detachCartridge(1); // since beta 33

Отключение картриджа.

emulator.attachFloppy(0, 'sys1002.dsk'); // since beta 33

Подключение образа диска.

emulator.detachFloppy(0); // since beta 33

Отключение диска.

emulator.attachHard(1, 'WDC170inv.img'); // since beta 33

Подключение образа жёсткого диска, работает только если уже подключена прошивка через emulator.attachCartridge

emulator.detachHard(1); // since beta 33

Отключение жёсткого диска.

emulator.getUptime() либо свойство emulator.uptime // since beta 33

Возвращает тип number -- количество секунд работы эмулируемой машины, по emulator.reset() сбрасывается в 0.

emulator.keyScan(0153); // since beta 33

Нажимает клавишу (задаётся скан-код), прогон 3 фрейма, отпускает, прогон 3 фрейма.

emulator.keyScan(0153, 6); // since beta 33

То же, но задаётся интервал (фреймов) от нажатия до отжатия.

emulator.keyScanShift(0013); // since beta 33

Нажатие SHIFT, 2 фрейма, нажатие клавиши, 3 фрейма, отжатие клавиши, 2 фрейма, отжатие SHIFT, 3 фрейма -- т.е. комбинация для ввода символа в другом регистре.

emulator.keyString('1\n'); // since beta 33

Ввод серии символов; для каждого ASCII-символа ищется скан-код, если нужно используется нажатие SHIFT.

emulator.getCPU() либо emulator.cpu // since beta 33

Получение объекта для ЦП.

emulator.getPPU() либо emulator.ppu // since beta 33

Получение объекта для ПП.

emulator.consolePrint('message') // since beta ??

Вывод сообщения в окно отладочной консоли; это окно видно если показаны отладочные окна.

Методы объектов emulator.cpu и emulator.ppu

(В примерах используется emulator.ppu, для emulator.cpu работает точно также.)

emulator.ppu.getName() либо emulator.ppu.name // since beta 33

Название процессора, "CPU" либо "PPU".

emulator.ppu.getReg(0) либо emulator.ppu.r(0) // since beta 33

Значение в регистре 0..7.

emulator.ppu.getPC() либо emulator.ppu.pc // since beta 33

Значение в регистре 7.

emulator.ppu.getSP() либо emulator.ppu.sp // since beta 33

Значение в регистре 6.

emulator.ppu.getPSW() либо emulator.ppu.psw // since beta 33

Значение в PSW.

emulator.ppu.setReg(0, 0123456) // since beta ??

Изменить значение в регистре 0..7.

emulator.ppu.setPC(0123456) либо emulator.ppu.pc = 0123456 // since beta ??

Изменить значение в регистре 7.

emulator.ppu.setSP(0123456) либо emulator.ppu.sp = 0123456 // since beta ??

Изменить значение в регистре 6.

emulator.ppu.setPSW(0123456) либо emulator.ppu.psw = 0123456 // since beta ??

Изменить значение в регистре PSW.

emulator.ppu.isHalt() либо emulator.ppu.halt // since beta 33

Признак HALT/USER режима.

emulator.ppu.readWord(0160304) // since beta 33

Прочитать слово из памяти процессора.

emulator.ppu.readByte(0160304) // since beta ??

Прочитать байт из памяти процессора.

emulator.ppu.disassemble(0160304) // since beta 33

Дизассемблирует одну инструкцию по заданному адресу, возвращает массив из четырёх элементов: { address, instruction, arguments, instruction length }.

Пример скрипта

Сбрасываем машинку, записываем процесс загрузки в виде скриншотов через каждые 10 фреймов:

emulator.reset();



for (i = 0; i < 10; i++)

{

  emulator.run(10);

  emulator.saveScreenshot('test' + i + '.png');

}

Советы и находки

Для перевода числа в строку в восьмеричной системе используем toString(8).

Ссылки

Подобный скриптинг в других эмуляторах:

• http://code.google.com/p/snes9x-rr/wiki/LuaScriptingFunctions
• http://code.google.com/p/psxjin/wiki/LuaScriptingFunctions
• http://code.google.com/p/vba-rerecording/wiki/LuaScriptingFunctions
• http://www.fceux.com/web/help/fceux.html