NEON SATURN

Ito ay isang Android port ng [Ymir](https://github.com/StrikerX3/Ymir), ang Sega Saturn emulator ng StrikerX3.

Pinapanatili ng NEON SATURN ang emulation core ng Ymir nang walang pagbabago at pinapalitan ang desktop frontend ng isang native na Android: isang setup wizard, isang cover-art game library, mga touch control na parang Saturn, at isang in-game quick actions
menu.

## Mga Tampok

### Library

- Setup wizard para sa pag-import ng IPL (BIOS) ROM at pagturo ng app sa isang folder ng laro

- Binabasa ang folder ng laro sa pamamagitan ng Storage Access Framework, kaya maaari itong mabuhay kahit saan sa device

- Tatlong view ng library, na iniikot mula sa header: isang listahan, mga takip ng NA box, at mga Japanese jewel case

- Coverflow na may perspective, mga repleksyon at snap-to-center paging

- Cover art na kinukuha at ini-cache kapag hiniling, o dina-download nang maramihan mula sa Mga Setting

- Animated na starfield backdrop

- Maliwanag / madilim / tema ng follow-system, na default sa madilim

### Sa laro

- Saturn-style na touch control overlay: D-pad, analogue stick, A/B/C, X/Y/Z, L/R, Start

- Ganap na nababagong layout, nakaimbak nang hiwalay para sa portrait at landscape

- Mga button na rewind at fast-forward sa overlay

- Menu ng mga mabilisang aksyon (back button o gamepad Select): resume, save state, load state, exit

- Suporta sa pisikal na gamepad at keyboard sa pamamagitan ng SDL, kasama ang isang naka-bundle na database ng controller

### Mga opsyon sa emulation

- Aspect ratio: 4:3, 16:9 o stretch
- Texture filtering: sharp (pinakamalapit) o ​​smooth (bilinear)
- Upscaling filter: off, o 6x xBRZ
- Deinterlaced rendering ng mga high-resolution mode
- Transparent mesh polygon rendering
- Rewind buffer (mga limang segundo sa 60 fps), off bilang default
- Opsyonal na low-level na CD block emulation kapag na-import ang isang CD block ROM

## Paggamit

I-install ang app. Ang setup wizard ay humihingi ng dalawang bagay:

1. **IPL BIOS** — mag-import ng Saturn BIOS ROM (`.bin` o `.rom`). Kinakailangan.
2. **Games folder** — piliin ang folder na naglalaman ng iyong mga disc image. Kinakailangan.

Maaari ring mag-import ng **CD Block ROM**. Ito ay opsyonal, at nagbibigay-daan sa low-level na CD block emulation.

Kapag naitakda na ang BIOS at games folder, papalitan ng library ang wizard. I-tap ang isang laro para i-stage at ilunsad ito. Ang icon na gear sa header ay magbubukas ng Mga Setting; ang icon sa kaliwa ay umiikot sa pagitan ng mga view ng listahan at pabalat.

Mga sinusuportahang format ng disc: **MAME CHD, BIN+CUE, IMG+CCD, MDF+MDS at ISO**. Ang mga format ng multi-file ay nangangailangan ng kanilang

kasamang mga track file na nasa iisang folder — sinusuri ng launcher ang mga ito at tumatangging magsimula kung nawawala ang mga ito.

## Mga Tala at Limitasyon

**Hindi pinapataas ng upscaling ang internal resolution.** Ang core ng Ymir ay mayroon lamang software renderer at
nagra-rasterize sa Saturn-native resolution, kaya ang upscaling filter ay isang edge-aware smoothing pass na inilalapat

sa natapos na frame. Pinatatalas nito ang mga 2D sprite at background nang kapansin-pansin; hindi ito maaaring magdagdag ng 3D na detalye. Ang totoong
internal-resolution rendering ay mangangailangan ng hardware renderer sa core, na wala pa.

**Ang rewind ay nagkakahalaga ng CPU at memorya.** Tinitipid nito ang estado ng emulator sa bawat frame at nagpapanatili ng ilang segundo ng

mga delta na naka-compress sa LZ4, kaya naka-off ito bilang default at ang onscreen button nito ay nakatago hanggang sa paganahin.


**Nalalapat ang mga setting sa paglulunsad.** Ang mga opsyon sa graphics at rewind ay binabasa kapag nagsimula ang isang laro, kaya ang pagbabago sa mga ito ay
magkakabisa sa susunod na maglulunsad ka ng isang laro.

## Mga kredito at lisensya
Ang NEON SATURN ay lisensyado sa ilalim ng **GNU General Public License v3.0** — tingnan ang [LISENSYA](LISENSYA).
- **[Ymir](https://github.com/StrikerX3/Ymir)** ni StrikerX3 — ang emulator core at lahat ng bagay na binuo ng port na ito.
** Kung gusto mo ito, suportahan ang upstream author sa
[Patreon](https://www.patreon.com/StrikerX3) at sumali sa
[Discord](https://discord.gg/NN3A7n5dzn).
- **[Kronos](https://github.com/FCare/Kronos)** / **Yabause** — ang 6x xBRZ upscaling shader sa
[`android/app/src/main/cpp/xbrz6x_shader.hpp`](android/app/src/main/cpp/xbrz6x_shader.hpp), ginagamit sa ilalim ng
GPL-2.0-or-later. Ang orihinal na abiso ng karapatang-ari ay nakaimbak sa file na iyon.
- **[SDL3](https://github.com/libsdl-org/SDL)** — windowing, audio, input at ang aktibidad ng Android.