NEON SATURN

Toto je port pre Android hry [Ymir](https://github.com/StrikerX3/Ymir), emulátora Sega Saturn od StrikerX3.

NEON SATURN zachováva emulačné jadro Ymiru tak, ako je, a nahrádza rozhranie pre počítače natívnym rozhraním pre Android: sprievodca nastavením, knižnica obalov hier, dotykové ovládanie v štýle Saturnu a menu rýchlych akcií v hre.

## Funkcie

### Knižnica

- Sprievodca nastavením pre import IPL (BIOS) ROM a nasmerovanie aplikácie na priečinok s hrami

- Priečinok s hrami sa číta cez Storage Access Framework, takže sa môže nachádzať kdekoľvek v zariadení

- Tri zobrazenia knižnice, ktoré sa cyklicky prepínajú z hlavičky: zoznam, obaly NA boxov a japonské šperkovnice

- Obal s perspektívou, odrazmi a stránkovaním prichytávaním do stredu

- Obrázky obalu sa načítavajú a ukladajú do vyrovnávacej pamäte na požiadanie alebo sa hromadne sťahujú z nastavení

- Animované pozadie hviezdneho poľa

- Svetlá / tmavá / téma podľa systému, predvolene tmavá

### V hre

- Dotykové ovládanie v štýle Saturn: D-pad, analógová páčka, A/B/C, X/Y/Z, L/R, Štart

- Plne premiestniteľné rozloženie, uložené samostatne pre na výšku a na šírku

- Tlačidlá pretáčania dozadu a dopredu na prekrytí

- Ponuka rýchlych akcií (tlačidlo späť alebo gamepad Select): obnovenie, uloženie stavu, načítanie stavu, ukončenie

- Podpora fyzického gamepadu a klávesnice prostredníctvom SDL vrátane balíka databáza ovládača

### Možnosti emulácie

- Pomer strán: 4:3, 16:9 alebo roztiahnutie
- Filtrovanie textúr: ostré (najbližšie) alebo hladké (bilineárne)
- Filter pre rozlíšenie: vypnuté alebo 6x xBRZ
- Vykresľovanie režimov s vysokým rozlíšením bez prekladania
- Vykresľovanie priehľadných sieťových polygónov
- Vyrovnávacia pamäť s pretáčaním dozadu (približne päť sekúnd pri 60 fps), predvolene vypnuté
- Voliteľná nízkoúrovňová emulácia bloku CD pri importe ROM bloku CD

## Použitie

Nainštalujte si aplikáciu. Sprievodca nastavením sa spýta na dve veci:

1. **IPL BIOS** — importujte ROM Saturn BIOS (`.bin` alebo `.rom`). Povinné.

2. **Priečinok s hrami** — vyberte priečinok s obrazmi diskov. Povinné.

Je možné importovať aj **ROM bloku CD**. Je to voliteľné a umožňuje nízkoúrovňovú emuláciu bloku CD.

Po nastavení priečinka BIOS a hier knižnica nahradí sprievodcu. Klepnutím na hru ju pripravíte a spustíte. Ikona ozubeného kolieska v hlavičke otvorí Nastavenia; ikona vľavo prepína medzi zobrazením zoznamu a obalu.

Podporované formáty diskov: **MAME CHD, BIN+CUE, IMG+CCD, MDF+MDS a ISO**. Formáty viacerých súborov vyžadujú, aby boli ich
súbory sprievodných skladieb prítomné v rovnakom priečinku – spúšťač ich vyhľadá a odmietne spustiť, ak chýbajú.

## Poznámky a obmedzenia

**Zvýšenie rozlíšenia nezvyšuje interné rozlíšenie.** Jadro Ymir má iba softvérový renderer a
rasterizuje v natívnom rozlíšení Saturn, takže filter na zvýšenie rozlíšenia je vyhladzovací prechod s ohľadom na okraje, ktorý sa aplikuje
na hotový záber. Výrazne zaostruje 2D sprity a pozadia; nemôže pridať 3D detaily. Skutočné
renderovanie s interným rozlíšením by vyžadovalo hardvérový renderer v jadre, ktorý zatiaľ neexistuje.

**Pretočenie späť spotrebúva CPU a pamäť.** Ukladá stav emulátora každý snímok a zachováva niekoľko sekúnd
delta kódov komprimovaných pomocou LZ4, takže je štandardne vypnuté a jeho tlačidlo na obrazovke je skryté, kým nie je zapnuté.

**Nastavenia sa aplikujú pri spustení.** Možnosti grafiky a pretočenia späť sa načítajú pri spustení hry, takže ich zmena
sa prejaví pri ďalšom spustení hry.

## Poďakovania a licencia
NEON SATURN je licencovaný pod **GNU General Public License v3.0** – pozri [LICENCIA](LICENCE).
- **[Ymir](https://github.com/StrikerX3/Ymir)** od StrikerX3 – jadro emulátora a všetko, na čom je tento port
postavený. Ak sa vám to páči, podporte autora na [Patreon](https://www.patreon.com/StrikerX3) a pripojte sa k [Discord](https://discord.gg/NN3A7n5dzn).
- **[Kronos](https://github.com/FCare/Kronos)** / **Yabause** — 6x xBRZ upscaling shader v
[`android/app/src/main/cpp/xbrz6x_shader.hpp`](android/app/src/main/cpp/xbrz6x_shader.hpp), používanom pod licenciou GPL-2.0 alebo novšou. Pôvodné oznámenie o autorských právach je uložené v tomto súbore.
- **[SDL3](https://github.com/libsdl-org/SDL)** — otváranie okien, zvuk, vstup a aktivita systému Android.