Az emulátor háttere:

Előzmények
Emulator Howto: Egy dokumentum azok számára, akik PRIMO emulátort szeretnének írni.

Az emulátor legfrissebb v3.1 verziójának letöltése:

Primo v3.1 (zip fájl)

Indítása:

vagy

primo.exe [/?|-?|/h|-h|-help|help|--help]

A parancsori paraméterek jelentése:

** Rendszervezérlő paraméterek **

delay=NNN A Z80 késleltési állandót NNN-re állítja, ahol NNN egy egész szám 1 és 65535 között. Az 1 jelenti a leggyorsabb processzor emulációt. A delay paramétert a calib=NO belállítás mellett lehet használni, egyébként az autokalibráció miatt a megadott érték hatástalan lesz.

calib=YES|NO "NO" érték mellet kikapcsolja az autokalibrációt, így a delay érték érvényre juthat. Az alabeállítás "YES", ha a calib paraméter nincs megadva, az emulátor induláskor autokalibrációt végez.

type=A32|A48|A64|B64 Géptípus. Ha nem adunk meg típust, az alapbeállítás A64 lesz.

display=NICE|STANDARD|TV Video kimenet. A "NICE" az alapbeállítás, ez a 320x240-es kompatíbilis, de nem szabványos videomódot aktiválja. "STANDARD" esetben a videomód 320x200 lesz, ebben az esetben a pixelek nem négyzet alakúak, viszont minden VGA kompatíbilis kártyának és eszköznek (monitor, LCD, flat-display) ismerni kell ezt a módot. A "TV" érték PAL kompatíbilis üzemmódba kapcsolja a VGA kártyát, ezt az üzemmódot tehát VGA monitorral nem lehet használni. További informáiók a TV módról a "Hagyományos TV készülékek illesztése" fejezetben találhatók.

** Fájl paraméterek **

prifile=PRIFILE Az Induláskor betöltendő PRI diszkfájl neve. Ha a paramétert nem adjuk meg, nem lesz PRI fájl betöltés.

tapefile=PTPFILE Az alapértelmezett magnófájl neve. Az emulátor működéséhez mindenképpen szükséges egy PTP magnófájl. Ha a paramétert nem adjuk meg, az alapértelmezett magnófájl a "tape.ptp" lesz. Ha ez a fájl nem létezik, az emulátor létrehozza.

textin=TEXTFILE Szövegfájl begépelése. Ha a textin paramétert megadjuk, akkor a "TEXTFILE" szövegfájlt az emulátor induláskor begépeli a BASIC interpreternek. A funkció csak A típusú gépeknél működik.

** Színvezérlő paraméterek **

border=RRGGBB
ink=RRGGBB
paper=RRGGBB Az emulátor alapszíneinek beállítása. A paramétereket a HTML nyelvben szokásos formában, hexadecimális (3*8 bites) RGB alakban kell megadni. (Például a tiszta telített piros szín kódja FF0000.)
border - keretszín (overscan)
ink - írásszín (foreground)
paper - háttérszín (background)

** Egyéb **

/?|-?|/h|-h|-help|help|--help Bármelyik paraméter ugyanazt a rövid HELP képernyőt nyomtatja ki, az emulátor ebben az esetben nem indul el.

A programhoz van nagyon részletes magyar nyelvű help is, ajánlom mindenkinek töltse le, és olvassa el azt is!

Verziók és változások:

primov31.zip

A joystick port nincs emulálva, de a detektálása most már jól működik, így az emulátor ugy érzi, mintha nem lenne joy csatlakoztatva
A gamectl.map tartalmazza a spectrum átirat játékokhoz a vezérlő kódokat.
A szerző (joco) email címe megváltozott

primov3.zip

Interaktív menürendszer
Többféle képernyő és videomód támogatása
Szabványos magyar PC billentyűzet támogatása
Kiegészítő billentyűzet funkciók
Automatikus Z80 processzor kalibráció
Pillanatnyi állapot (snapshot) fájlok készítése
Az alapbeállítások megváltoztatása működés közben
PRI diszkfájl és PTP magnófájl cseréje
Géptípus kiválasztása (A32/A48/A64/B64)
Felhasználói ROM betöltése
Játékvezérlő billentyűkombináció beállítása
Rengeteg... igazi profi program

primov2.zip

PRI file-ok támogatása, most már olvassa es automatikusan indítja a basic pri file-okat is
Az A64 ROM-t hozzászerkesztve az exe-hez, így azt nem kell külön fájlban tárolni.

primoemupri.zip

A pri fájlformátumot támogatja bár még nem teljeskörüen, ezt csak az exe fájl, be kell másolni tartalmát a legelső verzió fájljai közé, mert ez a csomag nem tartalmazza a ROM fájlt.
Játékok amik biztosanan futnak vele: testedpri.zip
Használatuk: primo prifile=<fajlnev>.pri

primoemu.zip - a legrégebbi verzió

A következő fájlok találhatóak meg benne:

basic1.txt	PRIMO BASIC példaprogram #1
basic2.txt	PRIMO BASIC példaprogram #2
primo.exe	Az emulátor
primo.rom	A64 ROM (csak ezzel működik)
tape.ptp	default tapefile

(joco)

delay=NNN	A Z80 késleltési állandót NNN-re állítja, ahol NNN egy egész szám 1 és 65535 között. Az 1 jelenti a leggyorsabb processzor emulációt. A delay paramétert a calib=NO belállítás mellett lehet használni, egyébként az autokalibráció miatt a megadott érték hatástalan lesz.
calib=YES\|NO	"NO" érték mellet kikapcsolja az autokalibrációt, így a delay érték érvényre juthat. Az alabeállítás "YES", ha a calib paraméter nincs megadva, az emulátor induláskor autokalibrációt végez.
type=A32\|A48\|A64\|B64	Géptípus. Ha nem adunk meg típust, az alapbeállítás A64 lesz.
display=NICE\|STANDARD\|TV	Video kimenet. A "NICE" az alapbeállítás, ez a 320x240-es kompatíbilis, de nem szabványos videomódot aktiválja. "STANDARD" esetben a videomód 320x200 lesz, ebben az esetben a pixelek nem négyzet alakúak, viszont minden VGA kompatíbilis kártyának és eszköznek (monitor, LCD, flat-display) ismerni kell ezt a módot. A "TV" érték PAL kompatíbilis üzemmódba kapcsolja a VGA kártyát, ezt az üzemmódot tehát VGA monitorral nem lehet használni. További informáiók a TV módról a "Hagyományos TV készülékek illesztése" fejezetben találhatók.

prifile=PRIFILE	Az Induláskor betöltendő PRI diszkfájl neve. Ha a paramétert nem adjuk meg, nem lesz PRI fájl betöltés.
tapefile=PTPFILE	Az alapértelmezett magnófájl neve. Az emulátor működéséhez mindenképpen szükséges egy PTP magnófájl. Ha a paramétert nem adjuk meg, az alapértelmezett magnófájl a "tape.ptp" lesz. Ha ez a fájl nem létezik, az emulátor létrehozza.
textin=TEXTFILE	Szövegfájl begépelése. Ha a textin paramétert megadjuk, akkor a "TEXTFILE" szövegfájlt az emulátor induláskor begépeli a BASIC interpreternek. A funkció csak A típusú gépeknél működik.