NEON SATURN

Detta är en Android-portering av [Ymir](https://github.com/StrikerX3/Ymir), StrikerX3:s Sega Saturn-emulator.

NEON SATURN behåller Ymirs emuleringskärna som den är och ersätter skrivbordsgränssnittet med ett inbyggt Android-gränssnitt: en installationsguide, ett spelbibliotek med omslagsbilder, pekkontroller i Saturn-stil och en snabbåtgärdsmeny i spelet.

## Funktioner

### Bibliotek

- Installationsguide för att importera IPL (BIOS) ROM och peka appen mot en spelmapp

- Spelmappen läses via Storage Access Framework, så den kan finnas var som helst på enheten

- Tre biblioteksvyer, cyklade från rubriken: en lista, NA-boxomslag och japanska juvelfodral

- Coverflow med perspektiv, reflektioner och snap-to-centre-paging

- Omslagsbild hämtas och cachas på begäran, eller laddas ner i bulk från Inställningar

- Animerad stjärnfältbakgrund

- Ljus / mörk / följ-system-tema, standardinställning till mörk

### I spelet

- Saturnusliknande pekkontrollöverlägg: D-pad, analog spak, A/B/C, X/Y/Z, V/H, Start

- Helt omplacerbar layout, lagras separat för stående och liggande

- Snabbspolnings- och framåtspolningsknappar på överlägget

- Snabbåtgärdsmeny (bakåtknapp eller spelkontrollval): återuppta, spara tillstånd, ladda tillstånd, avsluta

- Stöd för fysisk spelkontroll och tangentbord via SDL, inklusive en medföljande kontrolldatabas

### Emuleringsalternativ

- Bildförhållande: 4:3, 16:9 eller stretch
- Texturfiltrering: skarp (närmaste) eller jämn (bilinjär)
- Uppskalningsfilter: av eller 6x xBRZ
- Avsammanflätad rendering av högupplösta lägen
- Transparent mesh-polygonrendering
- Spolbuffert (cirka fem sekunder vid 60 fps), av som standard
- Valfri lågnivå-CD-blockemulering när en CD-block-ROM importeras

## Användning

Installera appen. Installationsguiden frågar efter två saker:

1. **IPL BIOS** — importera en Saturn BIOS ROM (`.bin` eller `.rom`). Obligatoriskt.

2. **Spelmapp** — välj mappen som innehåller dina skivavbildningar. Obligatoriskt.

En **CD-block-ROM** kan också importeras. Det är valfritt och möjliggör lågnivå-CD-blockemulering.

När BIOS- och spelmappen är inställda ersätter biblioteket guiden. Tryck på ett spel för att starta det. Kugghjulsikonen i sidhuvudet öppnar Inställningar; ikonen till vänster växlar mellan list- och omslagsvyer.

Skivformat som stöds: **MAME CHD, BIN+CUE, IMG+CCD, MDF+MDS och ISO**. Flerfilsformat behöver sina
kompanjonspårfiler i samma mapp — startprogrammet söker efter dem och vägrar att starta om de saknas.

## Anmärkningar och begränsningar

**Uppskalning höjer inte den interna upplösningen.** Ymirs kärna har endast en programvarurenderare och
rasteriserar med Saturnus-naturlig upplösning, så uppskalningsfiltret är en kantmedveten utjämning som appliceras
på den färdiga bilden. Det skärper 2D-sprites och bakgrunder märkbart; det kan inte lägga till 3D-detaljer. Riktig
rendering med intern upplösning skulle behöva en hårdvarurenderare i kärnan, som ännu inte finns.

**Återspolning kostar CPU och minne.** Den sparar emulatorns tillstånd varje bildruta och behåller några sekunder av
LZ4-komprimerade deltan, så den är avstängd som standard och dess knapp på skärmen är dold tills den aktiveras.

**Inställningarna gäller vid start.** Grafik och återspolningsalternativ läses när ett spel startar, så ändringar av dem
träder i kraft nästa gång du startar ett spel.

## Medverkande och licens
NEON SATURN är licensierad under **GNU General Public License v3.0** — se [LICENS](LICENS).
- **[Ymir](https://github.com/StrikerX3/Ymir)** av StrikerX3 — emulatorkärnan och allt som denna port är byggd på. Om du gillar detta, stöd uppströmsförfattaren på
[Patreon](https://www.patreon.com/StrikerX3) och gå med i [Discord](https://discord.gg/NN3A7n5dzn).

- **[Kronos](https://github.com/FCare/Kronos)** / **Yabause** — 6x xBRZ uppskalningsshadern i
[`android/app/src/main/cpp/xbrz6x_shader.hpp`](android/app/src/main/cpp/xbrz6x_shader.hpp), använd under GPL-2.0-eller senare. Den ursprungliga upphovsrättsmeddelandet finns i den filen.

- **[SDL3](https://github.com/libsdl-org/SDL)** — fönster, ljud, inmatning och Android-aktivitet.