NEON SATURN

Tämä on Android-portti [Ymiristä](https://github.com/StrikerX3/Ymir), StrikerX3:n Sega Saturn -emulaattorista.

NEON SATURN pitää Ymirin emulointiytimen sellaisenaan ja korvaa työpöytäkäyttöliittymän natiivilla Android-käyttöliittymällä: asennustoiminnolla, kansikuvakirjastolla, Saturn-tyylisillä kosketusohjaimilla ja pelinsisäisellä pikatoimintovalikolla.

## Ominaisuudet

### Kirjasto

- Ohjattu asennustoiminto IPL (BIOS) ROMin tuomiseksi ja sovelluksen ohjaamiseksi pelikansioon

- Pelikansio luetaan Storage Access Frameworkin kautta, joten se voi sijaita missä tahansa laitteella

- Kolme kirjastonäkymää, jotka vaihdellaan otsikosta: luettelo, Pohjois-Amerikan koteloiden kannet ja japanilaiset korukotelot

- Coverflow perspektiivillä, heijastuksilla ja keskelle napsauttamisella

- Kansikuva haetaan ja tallennetaan välimuistiin pyynnöstä tai ladataan joukkona asetuksista

- Animoitu tähtikentän tausta

- Vaalea/tumma/järjestelmän seurantateema, oletuksena tumma

### Pelissä

- Saturnustyylinen kosketusohjauspaneeli: D-pad, analoginen sauva, A/B/C, X/Y/Z, L/R, Käynnistä

- Täysin uudelleensijoitettava asettelu, tallennetaan erikseen pysty- ja vaakasuuntaan

- Kelaus taaksepäin ja eteenpäin -painikkeet paneelissa

- Pikatoimintovalikko (takaisin-painike tai peliohjaimen valinta): jatka, tallennustila, lataustila, poistu

- Fyysisen peliohjaimen ja näppäimistön tuki SDL:n kautta, mukaan lukien Mukana tuleva ohjaintietokanta

### Emulointivaihtoehdot

- Kuvasuhde: 4:3, 16:9 tai venytys
- Tekstuurisuodatus: terävä (lähin) tai pehmeä (bilineaarinen)
- Skaalaussuodatin: pois päältä tai 6x xBRZ
- Korkean resoluution tilojen lomittamaton renderöinti
- Läpinäkyvän verkon polygonirenderöinti
- Kelauspuskuri (noin viisi sekuntia 60 fps:llä), oletuksena pois päältä
- Valinnainen matalan tason CD-lohkon emulointi, kun CD-lohko-ROM tuodaan

## Käyttö

Asenna sovellus. Asennustoiminto pyytää kahta asiaa:

1. **IPL BIOS** — tuo Saturn BIOS ROM (`.bin` tai `.rom`). Pakollinen.

2. **Pelikansio** — valitse kansio, jossa levykuvat ovat. Pakollinen.

Myös **CD-lohko-ROM** voidaan tuoda. Se on valinnainen ja mahdollistaa matalan tason CD-lohkon emuloinnin.

Kun BIOS ja pelikansio on asetettu, kirjasto korvaa ohjatun toiminnon. Napauta peliä käynnistääksesi sen. Ylätunnisteen rataskuvake avaa Asetukset; vasemmalla oleva kuvake vaihtaa luettelo- ja kansinäkymän välillä.

Tuetut levyformaatit: **MAME CHD, BIN+CUE, IMG+CCD, MDF+MDS ja ISO**. Monitiedostoformaatit vaativat
seuraavien kappaletiedostojen olevan samassa kansiossa – käynnistysohjelma tarkistaa ne ja kieltäytyy käynnistämästä, jos ne puuttuvat.

## Huomautuksia ja rajoituksia

**Ylösskaalaus ei nosta sisäistä resoluutiota.** Ymirin ytimessä on vain ohjelmistorenderöinti ja
rasterointi tapahtuu Saturnuksen natiivilla resoluutiolla, joten ylösskaalaussuodatin on reunatietoinen tasoitus, jota sovelletaan
valmiiseen kuvaan. Se terävöittää 2D-spritejä ja taustoja huomattavasti; se ei voi lisätä 3D-yksityiskohtia. Oikeanlainen
sisäisen resoluution renderöinti vaatisi ytimessä olevan laitteistorenderöinnin, jota ei vielä ole olemassa.

**Takaisinkelaus kuluttaa prosessoria ja muistia.** Se tallentaa emulaattorin tilan joka ruudulla ja säilyttää muutaman sekunnin LZ4-pakattuja deltoja, joten se on oletuksena pois päältä ja sen näyttöpainike on piilossa, kunnes se otetaan käyttöön.

**Asetukset tulevat voimaan käynnistyksen yhteydessä.** Grafiikka- ja takaisinkelausasetukset luetaan pelin käynnistyessä, joten niiden muuttaminen
tulee voimaan pelin seuraavan käynnistyksen yhteydessä.

## Tekijät ja lisenssi
NEON SATURN on lisensoitu **GNU General Public License v3.0** -lisenssillä — katso [LISENSSI](LISENSSI).
- **[Ymir](https://github.com/StrikerX3/Ymir)** StrikerX3:n toimesta — emulaattorin ydin ja kaikki, mihin tämä porttaus
on rakennettu. Jos pidät tästä, tue aiemmin kirjoittanutta
[Patreonissa](https://www.patreon.com/StrikerX3) ja liity
[Discordiin](https://discord.gg/NN3A7n5dzn).
- **[Kronos](https://github.com/FCare/Kronos)** / **Yabause** — 6x xBRZ-skaalausvarjostin [`android/app/src/main/cpp/xbrz6x_shader.hpp`]-sovelluksessa, jota käytetään GPL-2.0-lisenssillä tai uudemmalla. Alkuperäinen tekijänoikeusilmoitus säilytetään kyseisessä tiedostossa.

- **[SDL3](https://github.com/libsdl-org/SDL)** — ikkunointi, ääni, syöte ja Android-toiminta.