NEON SATURN

To port na Androida emulatora Segi Saturn [Ymir](https://github.com/StrikerX3/Ymir), gry StrikerX3.

NEON SATURN zachowuje rdzeń emulacji Ymir bez zmian i zastępuje interfejs pulpitu natywnym interfejsem dla Androida: kreatorem konfiguracji, biblioteką okładek gier, sterowaniem dotykowym w stylu Saturna i menu szybkich akcji w grze.

## Funkcje

### Biblioteka

- Kreator konfiguracji do importowania ROM-u IPL (BIOS) i kierowania aplikacji na folder z grami

- Folder z grami jest odczytywany przez Storage Access Framework, dzięki czemu może znajdować się w dowolnym miejscu na urządzeniu

- Trzy widoki biblioteki, przełączane z nagłówka: lista, okładki NA i japońskie pudełka

- Coverflow z perspektywą, odbiciami i funkcją przyciągania do środka

- Okładki pobierane i buforowane na żądanie lub pobierane zbiorczo z Ustawień

- Animowane tło z gwiezdnym polem

- Motyw jasny / ciemny / zgodny z systemem śledzenia, domyślnie ciemny

### W grze

- Nakładka dotykowa w stylu Saturna: D-pad, gałka analogowa, A/B/C, X/Y/Z, L/R, Start

- W pełni konfigurowalny układ, przechowywany oddzielnie dla trybu pionowego i poziomego

- Przyciski przewijania do tyłu i do przodu na nakładce

- Menu szybkich akcji (przycisk Wstecz lub gamepad Select): wznów, zapisz stan, wczytaj stan, Wyjście

- Obsługa fizycznego gamepada i klawiatury przez SDL, w tym dołączona baza danych kontrolerów

### Opcje emulacji

- Proporcje obrazu: 4:3, 16:9 lub rozciągnięcie
- Filtrowanie tekstur: ostre (najbliższe) lub gładkie (dwuliniowe)
- Filtr skalowania: wyłączony lub 6x xBRZ
- Renderowanie bez przeplotu w trybach wysokiej rozdzielczości
- Renderowanie przezroczystych wielokątów siatkowych
- Bufor przewijania (około pięciu sekund przy 60 kl./s), domyślnie wyłączony
- Opcjonalna emulacja bloku CD niskiego poziomu po zaimportowaniu ROM-u bloku CD

## Użycie

Zainstaluj aplikację. Kreator instalacji poprosi o dwie rzeczy:

1. **IPL BIOS** — zaimportuj ROM Saturn BIOS (`.bin` lub `.rom`). Wymagane.
2. **Folder gier** — wybierz folder zawierający obrazy płyt. Wymagane.

Można również zaimportować **ROM bloku CD**. Jest to opcjonalne i umożliwia niskopoziomową emulację bloku CD.

Po ustawieniu BIOS-u i folderu gier biblioteka zastępuje kreatora. Dotknij gry, aby ją uruchomić. Ikona koła zębatego w nagłówku otwiera Ustawienia; ikona po lewej stronie przełącza między widokiem listy a okładką.

Obsługiwane formaty płyt: **MAME CHD, BIN+CUE, IMG+CCD, MDF+MDS i ISO**. Formaty wieloplikowe wymagają, aby ich
pliki towarzyszące znajdowały się w tym samym folderze — program uruchamiający je sprawdza i odmawia uruchomienia, jeśli ich brakuje.

## Uwagi i ograniczenia

**Skalowanie w górę nie zwiększa rozdzielczości wewnętrznej.** Rdzeń Ymira ma tylko renderer programowy i
rasteryzuje w natywnej rozdzielczości Saturna, więc filtr skalujący w górę to wygładzanie uwzględniające krawędzie, stosowane
do gotowej klatki. Wyraźnie wyostrza sprite'y 2D i tła; nie może dodać szczegółów 3D. Prawdziwe renderowanie w rozdzielczości wewnętrznej wymagałoby sprzętowego renderera w rdzeniu, który jeszcze nie istnieje.

**Przewijanie obciąża procesor i pamięć.** Zapisuje stan emulatora w każdej klatce i zachowuje kilka sekund delty skompresowanej kodekiem LZ4, więc jest domyślnie wyłączone, a jego przycisk ekranowy jest ukryty do momentu włączenia.

**Ustawienia obowiązują przy uruchomieniu.** Opcje grafiki i przewijania są odczytywane podczas uruchamiania gry, więc ich zmiana
zadziała przy następnym uruchomieniu gry.

## Podziękowania i licencja
NEON SATURN jest licencjonowany na podstawie **GNU General Public License v3.0** — patrz [LICENSE](LICENSE).
- **[Ymir](https://github.com/StrikerX3/Ymir)** autorstwa StrikerX3 — rdzeń emulatora i wszystko, na czym zbudowany jest ten port.
Jeśli Ci się podoba, wesprzyj autora na
[Patreonie](https://www.patreon.com/StrikerX3) i dołącz do
[Discorda](https://discord.gg/NN3A7n5dzn).
- **[Kronos](https://github.com/FCare/Kronos)** / **Yabause** — shader upscalingu 6x xBRZ w
[`android/app/src/main/cpp/xbrz6x_shader.hpp`](android/app/src/main/cpp/xbrz6x_shader.hpp), używany na
licencji GPL-2.0 lub nowszej. Oryginalna informacja o prawach autorskich znajduje się w tym pliku.
- **[SDL3](https://github.com/libsdl-org/SDL)** — okna, dźwięk, wejście i aktywność Androida.