View source for Ep128emu-core leírás


== Bevezető ==

Az EP128emu alapján 2022-től elérhető egy olyan változat is, ami a libretro keretrendszerben fut, választható magként (ep128emu-core). A RetroArch, ami ennek a rendszernek a legelterjedtebb (bár nem egyetlen) felülete, sok platformra telepíthető, ezek közül az ep128emu-core jelenleg Windows, Linux, MacOS, és Android platformokra fordul.

== Telepítés (PC) ==

Az ajánlott lépések:
# Telepíteni a [https://retroarch.com/?page=platforms retroarch]-ot 
# Amennyiben armv7 architektúrájú gépet használunk (pl. korábbi Raspberry Pi-k), látogassunk el [https://zoltanvb.github.io/armv7-hf-neon/ ide] egy plusz beállításért
# Az online frissítővel letölteni az ep128emu core-t (és egyúttal az asseteket, kontroller profilokat, és a core info fájlokat is érdemes frissíteni)
# Elhelyezni a kicsomagolt [http://www.ep128.hu/Emu/ep128emu_roms-2.0.11.zip ROM fájlokat] a retroarch rendszerkönyvtára alatt, az ep128emu/roms alá (1.1.0 verziótól nem kötelező)
# Betölteni a core-t, majd az Information / Core Information alatt ellenőrizni, hogy megtalálta-e a ROM-okat (1.1.0 verziótól nem kötelező)

== Telepítés (Android) ==

# Telepíteni a [https://docs.libretro.com/guides/install-android/ retroarch]-ot. A Play Store-os verzió elég régi, de azért nagyrészt használható, a többi módszerrel (direkt install, F-Droid) újabb változatot kapunk.
# Az online frissítővel letölteni az ep128emu core-t (és egyúttal az asseteket, kontroller profilokat, és a core info fájlokat is érdemes frissíteni). Letöltés után még az Install core szükséges.
# ROM-okat itt is lehet biztosítani, de nem kötelező.

== Használat ==

Az indításhoz meg kell adni, hogy milyen tartalmat szeretne az ember betölteni (ami itt lehet diszk image, szalagos image, vagy a fileio-val rögtön a programfájl). TVC, ZX, CPC fájlokat ugyanígy ki lehet választani, a szükséges emulátort automatikusan detektálja. Ha ez lehetséges, akkor a programot pár gombnyomással be is tölti (startup sequence). Magnóról töltés ideje hasonló az eredeti géphez, a fast forward funkcióval (alapértelmezett gyorsbillentyű: szóköz) lehet rajta rövidíteni.

Az irányítás alapvetően nem billentyűzettel történik, hanem egy virtuális joypad-del (retropad), ami tetszőlegesen felüldefiniálható, tehát végeredményben maradhat a billentyűzet is - itt érdemes tudni, hogy a Scroll Lock-kal lehet a teljes billentyűzetet átadni az emulátornak. A billentyűzet leképezés nem változatható, a részletek a [https://docs.libretro.com/library/ep128emu/#keyboard libretro leírásban] találhatóak. De bármilyen, a retroarch által felismert irányító eszköz használható.

== Eltérések az ep128emu-hoz képest ==

* A megjelenítés bármilyen kijelzőhöz tud alkalmazkodni, és használható pixel shader pl. a CRT hatás emulálására
* Intelligens nagyítás: gombnyomásra az egyszínű keretet levágja, és a tényleges játéktér tölti ki a teljes képernyőt
* Ugyanakkor az ep128emu saját menüi és az abból elérhető funkciók (pl. debugger) egyáltalán nem elérhetőek a core változatban
* Kisebb emulációs kiegészítések, ami az ep128emu eleddig utolsó 2.0.11.2 verziójában nem szerepelnek: 
** hangszóró kikapcsolás támogatása, mono hang lehetőség
** 6 joystick kezelése
** TAPir formátumú fájlok olvasása
** 1 bites WAV fájlok olvasása (TVC archívum)
* A save state mentés retroarch-on belül lehetséges. Demo felvétel nem készíthető / játszható le.
* Lemezt / kazettát / fájlt cserélni a Disk Control menüvel lehet, bár ez inkább csak a többlemezes / többkazettás játékoknál szükséges.
* A RetroArch beépített memória-elemzőjével lehet csalásokat keresni

== Konfigurációs lehetőségek ==

A retroarch menün belül két állítási hely van:
* Controls: ha nem megfelelő az alapértelmezett irányítás típusa, itt lehet átállítani pl. External joystickra
* Core Options: az intelligens nagyításhoz és egyéb funkciókhoz kapcsolódó állítási lehetőségek

Ezen felül, lehetséges konfigurációs fájlokat létrehozni rendszerszinten, vagy akár az egyes programokhoz is .ep128cfg kiterjesztéssel. A részletes szintaxis a [https://github.com/libretro/ep128emu-core/blob/core/core/sample.ep128cfg példafájlban] található. Innen lehet a kontroller gombkiosztását szabályozni, vagy speciális konfigurációt beállítani (pl. cartridge nélküli EP128).

== Fordítás saját használatra ==

Szükség esetén (pl. ha az adott platformra nem elérhető az online frissítés), saját fordítás is lehetséges, egyszerűen a make paranccsal. Kötelező függőség nincs, opcionálisan be lehet kapcsolni a libsndfile támogatást (az EXCLUDE_SOUND_LIBS értékét állítsuk 0-ra).

== SPEmu futtatása ep128emu-core alatt ==

Érdekességként futtatható a szoftveres SPEmu is, a következő módon:
* Töltsük le a ROM változatot a fórumból
* Helyezzük el a fájlokat a RetroArch rendszerkönyvtárán belül: system/ep128emu/roms/
* Hozzunk létre egy tájlt szintén a RetroArch rendszerkönyvtára alatt (system/ep128emu/config/enterprise.ep128cfg), a tartalma legyen a következő:
 machineDetailedType "EP128_TAPE"
 memory.ram.size 256
 memory.rom.40.file "spemu128.rom"
 memory.rom.40.offset 0
 memory.rom.41.file "spemu128.rom"
 memory.rom.41.offset 16384
 memory.rom.42.file "spemu128.rom"
 memory.rom.42.offset 32768
 tape.forceMotorOn Yes
* Indítsuk el az ep128emu magot tartalom nélkül
* Töltsük be az SPEmu bővítményt: :sp128
* Válasszük a Load tape opciót
* Lépjünk be a RetroArch gyorsmenübe (F1), és a lemezkezelésen belül válasszuk ki a Spectrum programot tartalmazó .tap fájlt

== CPCEmu futtatása ep128emu-core alatt ==

Érdekességként futtatható a szoftveres CPCEmu is, a következő módon:
* Töltsük le a COM változatot a fórumból
* Nyissuk meg a COM fájlt az ep128emu-val
* Várjuk meg, amíg a kék képernyő betölt
* Lépjünk be a RetroArch gyorsmenübe (F1), és a lemezkezelésen belül válasszuk ki a CPC programot tartalmazó fájlt
* Folytassuk a futtatást, és a Scroll Lock lenyomása után adjuk ki a szükséges RUN parancsot a fájlnévvel (pl. RUN"PROGRAM )
* Ha szükséges, állítsuk át az irányítást a gyorsmenüből External 2-re