NEON SATURN

Đây là phiên bản Android của [Ymir](https://github.com/StrikerX3/Ymir), trình giả lập Sega Saturn của StrikerX3.

NEON SATURN giữ nguyên nhân giả lập của Ymir và thay thế giao diện người dùng máy tính để bàn bằng giao diện Android gốc: trình hướng dẫn thiết lập, thư viện trò chơi có ảnh bìa, điều khiển cảm ứng kiểu Saturn và menu thao tác nhanh trong trò chơi.

## Tính năng

### Thư viện

- Trình hướng dẫn thiết lập để nhập ROM IPL (BIOS) và trỏ ứng dụng đến thư mục trò chơi

- Thư mục trò chơi được đọc thông qua Khung truy cập bộ nhớ (Storage Access Framework), vì vậy nó có thể nằm ở bất kỳ đâu trên thiết bị

- Ba chế độ xem thư viện, được chuyển đổi từ tiêu đề: danh sách, bìa hộp phiên bản Bắc Mỹ và bìa hộp phiên bản Nhật Bản

- Coverflow với phối cảnh, phản chiếu và căn giữa trang

- Ảnh bìa được tìm nạp và lưu vào bộ nhớ cache theo yêu cầu, hoặc tải xuống hàng loạt từ Cài đặt

- Hình nền bầu trời sao động

- Chủ đề sáng / tối / theo hệ thống, mặc định là tối

### Trong trò chơi

- Lớp phủ điều khiển cảm ứng kiểu Saturn: phím điều hướng, cần điều khiển analog, A/B/C, X/Y/Z, L/R, Start

- Bố cục có thể định vị lại hoàn toàn, được lưu riêng cho chế độ dọc và ngang

- Các nút tua lại và tua nhanh trên lớp phủ

- Menu thao tác nhanh (nút quay lại hoặc nút Chọn trên tay cầm): tiếp tục, lưu trạng thái, tải trạng thái, thoát

- Hỗ trợ tay cầm và bàn phím vật lý thông qua SDL, bao gồm Cơ sở dữ liệu bộ điều khiển đi kèm

### Tùy chọn giả lập

- Tỷ lệ khung hình: 4:3, 16:9 hoặc kéo giãn
- Lọc vân bề mặt: sắc nét (gần nhất) hoặc mượt mà (song tuyến)

- Bộ lọc nâng độ phân giải: tắt hoặc 6x xBRZ

- Hiển thị khử xen kẽ các chế độ độ phân giải cao
- Hiển thị đa giác lưới trong suốt
- Bộ đệm tua lại (khoảng năm giây ở 60 khung hình/giây), mặc định là tắt
- Tùy chọn giả lập khối CD cấp thấp khi nhập ROM khối CD

## Cách sử dụng

Cài đặt ứng dụng. Trình hướng dẫn thiết lập sẽ yêu cầu hai điều:

1. **IPL BIOS** — nhập ROM BIOS Saturn (`.bin` hoặc `.rom`). Bắt buộc.

2. **Thư mục trò chơi** — chọn thư mục chứa hình ảnh đĩa của bạn. Bắt buộc.

Bạn cũng có thể nhập **ROM khối CD**. Điều này là tùy chọn và cho phép giả lập khối CD cấp thấp.

Sau khi BIOS và thư mục trò chơi được thiết lập, thư viện sẽ thay thế trình hướng dẫn. Chạm vào một trò chơi để chọn và khởi chạy. Biểu tượng bánh răng ở đầu trang mở Cài đặt; biểu tượng bên trái chuyển đổi giữa chế độ xem danh sách và ảnh bìa.

Các định dạng đĩa được hỗ trợ: **MAME CHD, BIN+CUE, IMG+CCD, MDF+MDS và ISO**. Các định dạng nhiều tệp cần có các tệp nhạc đi kèm trong cùng thư mục — trình khởi chạy sẽ kiểm tra chúng và từ chối khởi động nếu chúng bị thiếu.

## Ghi chú và hạn chế

**Nâng độ phân giải không làm tăng độ phân giải nội bộ.** Nhân của Ymir chỉ có trình kết xuất phần mềm và
tạo ảnh raster ở độ phân giải gốc của Saturn, vì vậy bộ lọc nâng độ phân giải là một bước làm mịn nhận biết cạnh được áp dụng
cho khung hình đã hoàn thiện. Nó làm sắc nét các hình ảnh 2D và hình nền một cách rõ rệt; nó không thể thêm chi tiết 3D. Việc kết xuất ở độ phân giải nội bộ thực sự sẽ cần một trình kết xuất phần cứng trong nhân, điều này hiện chưa tồn tại.

**Chức năng tua lại tiêu tốn CPU và bộ nhớ.** Nó lưu trạng thái giả lập mỗi khung hình và giữ lại vài giây dữ liệu nén LZ4, vì vậy nó được tắt theo mặc định và nút trên màn hình của nó bị ẩn cho đến khi được kích hoạt.

**Cài đặt được áp dụng khi khởi chạy.** Các tùy chọn đồ họa và tua lại được đọc khi trò chơi bắt đầu, vì vậy việc thay đổi chúng sẽ có hiệu lực vào lần tiếp theo bạn khởi chạy trò chơi.

## Tín dụng và giấy phép
NEON SATURN được cấp phép theo **Giấy phép Công cộng GNU phiên bản 3.0** — xem [LICENSE](LICENSE).

- **[Ymir](https://github.com/StrikerX3/Ymir)** của StrikerX3 — lõi giả lập và mọi thứ mà bản port này được xây dựng dựa trên. Nếu bạn thích điều này, hãy ủng hộ tác giả gốc trên

[Patreon](https://www.patreon.com/StrikerX3) và tham gia
[Discord](https://discord.gg/NN3A7n5dzn).
- **[Kronos](https://github.com/FCare/Kronos)** / **Yabause** — shader nâng cấp độ phân giải 6x xBRZ trong
[`android/app/src/main/cpp/xbrz6x_shader.hpp`](android/app/src/main/cpp/xbrz6x_shader.hpp), được sử dụng theo
GPL-2.0-or-later. Thông báo bản quyền gốc được giữ nguyên trong tệp đó.
- **[SDL3](https://github.com/libsdl-org/SDL)** — cửa sổ, âm thanh, đầu vào và hoạt động Android.