Kacang GB

Kacang-GB

Peanut-GB adalah pustaka emulator Game Boy header file tunggal yang didasarkan pada emulator gameboy ini. Tujuannya adalah untuk membuat pustaka emulator Game Boy (DMG) berkecepatan tinggi dan portabel yang dapat digunakan untuk platform apa pun yang memiliki kompiler C99.

Emulator ini sangat cepat . Sedemikian rupa sehingga bisa berjalan dengan kecepatan penuh di Raspberry Pi Pico! Kunjungi BENCHMARK.md untuk mengetahui benchmark Peanut-GB.

Hanya Game Boy (DMG) asli yang didukung saat ini, namun pekerjaan awal telah diselesaikan untuk mendukung Game Boy Color (lihat #50).

Emulator ini masih dalam proses dan mungkin tidak akurat (walaupun emulator ini lolos dari instruksi CPU dan pengujian waktu instruksi Blargg). Oleh karena itu, beberapa game mungkin tidak berjalan dengan benar atau tidak berjalan sama sekali. Silakan mencari emulator alternatif jika keakuratan itu penting.

Fitur

• Dukungan Game Boy (DMG).
• Sangat cepat; cukup cepat untuk dijalankan pada mikrokontroler RP2040 ARM Cortex M0+ dengan kecepatan penuh.
• Dukungan MBC1, MBC2, MBC3, dan MBC5
• Dukungan Jam Waktu Nyata (RTC).
• Dukungan koneksi serial
• Dapat digunakan dengan atau tanpa bootrom
• Memungkinkan palet berbeda pada latar belakang dan sprite
• Mode lompatan bingkai dan interlacing (berguna untuk LCD lambat)
• Mudah digunakan dan dilengkapi dengan contoh
• LCD dan suara dapat dinonaktifkan pada waktu kompilasi.
• Jika suara diaktifkan, perpustakaan unit pemrosesan audio (APU) eksternal diperlukan. Pustaka unit pemrosesan audio (APU) cepat disertakan dalam repositori ini di https://github.com/deltabeard/Peanut-GB/tree/master/examples/sdl2/minigb_apu .

Peringatan

• Rendering LCD dilakukan baris demi baris, sehingga animasi tertentu tidak akan ditampilkan dengan benar (seperti di Manusia Prasejarah).
• Beberapa permainan mungkin tidak dapat dimainkan karena ketidakakuratan emulasi (lihat #31).
• MiniGB APU berjalan di thread terpisah, sehingga waktunya tidak akurat. Jika pengaturan waktu dan emulasi APU yang akurat diperlukan, maka perpustakaan Gb_Snd_Emu Blargg (atau alternatifnya) dapat digunakan sebagai gantinya.

Contoh SDL2

Contoh implementasi unggulan diberikan di kacang_sdl.c, yang menggunakan SDL2 untuk menggambar layar dan mengambil masukan. Jalankan cmake atau make di folder ./examples/sdl2/ untuk mengkompilasinya.

Jalankan peanut-sdl , yang membuat jendela drop-zone tempat Anda dapat menarik dan melepas file ROM. Alternatifnya, jalankan di terminal menggunakan peanut-sdl game.gb , yang secara otomatis akan membuat file penyimpanan game.sav untuk game tersebut jika tidak ditemukan. Atau, jalankan dengan peanut-sdl game.gb save.sav untuk menentukan file penyimpanan.

Tangkapan layar

Catatan: GIF animasi yang ditampilkan di sini dibatasi hingga 50fps, sementara emulasi berjalan pada kecepatan asli ~60fps. Ini karena dekoder GIF populer membatasi FPS maksimum hingga 50.

Kontrol

Tindakan	papan ketik	papan kegembiraan
A	z	A
B	X	B
Awal	Kembali	AWAL
Memilih	Ruang belakang	KEMBALI
D-Pad	Tombol Panah	DPAD
Ulangi A	A
Ulangi B	S
Kecepatan Biasa	1
Turbo x2 (Tahan)	Ruang angkasa
Turbo X2 (Beralih)	2
Turbo X3 (Beralih)	3
Turbo X4 (Beralih)	4
Mengatur ulang	R
Ganti Palet	P
Atur Ulang Palet	Shift + hal
Layar penuh	F11 / f
Frameskip (Beralih)	Hai
Jalin (Beralih)	Saya
Buang BMP (Beralih)	B

Mode Frameskip dan Interlaced keduanya dinonaktifkan secara default. Frameskip beralih antara 60 FPS dan 30 FPS.

Menekan 'b' akan membuang setiap frame sebagai file bitmap 24-bit di folder saat ini. Lihat /screencaps/README.md untuk informasi lebih lanjut.

Proyek Menggunakan Peanut-GB

Tanpa urutan tertentu, dan daftar yang tidak lengkap, proyek berikut menggunakan Peanut-GB.

• Pico-GB - Emulasi Game Boy pada mikrokontroler Raspberry Pi RP2040.
• Peanut_gb-RGFW - Contoh emulator Gameboy untuk RGFW.
• CPBoy - Emulator Game Boy (DMG) untuk Classpad II (fx-CP400).
• PlayGB - Emulator Game Boy untuk Playdate, berdasarkan Peanut-GB.

Memulai

Dokumentasi prototipe fungsi dapat ditemukan di bagian bawah Peanut_gb.h.

Fungsi yang Diperlukan

Implementasi front-end harus menyediakan sejumlah fungsi ke perpustakaan. Fungsi-fungsi ini disetel saat memanggil gb_init.

• gb_rom_read
• gb_cart_ram_read
• gb_cart_ram_write
• gb_error

Fungsi Opsional

Fungsi opsional berikut dapat ditentukan untuk fungsionalitas lebih lanjut.

lcd_draw_line

Fungsi ini diperlukan untuk menggambar LCD. Setel fungsi ini menggunakan gb_init_lcd dan aktifkan fungsionalitas LCD dalam Peanut-GB dengan menentukan ENABLE_LCD ke 1 sebelum menyertakan kacang_gb.h. ENABLE_LCD diatur ke 1 secara default jika tidak ditentukan sebelumnya. Jika gb_init_lcd tidak dipanggil atau lcd_draw_line diatur ke NULL, maka gambar LCD dinonaktifkan.

Data piksel yang dikirim ke lcd_draw_line dilengkapi dengan data bayangan dan lapisan. Dua bit paling tidak signifikan pertama adalah data bayangan (hitam, gelap, terang, putih). Bit 4 dan 5 adalah data lapisan (OBJ0, OBJ1, BG), yang dapat digunakan untuk menambahkan lebih banyak warna pada game dengan cara yang sama seperti yang dilakukan Game Boy Color pada game Game Boy lama.

audio_baca dan audio_tulis

Fungsi-fungsi ini diperlukan untuk emulasi dan output audio. Peanut-GB tidak menyertakan emulasi audio, jadi perpustakaan eksternal harus digunakan. Fungsi-fungsi ini harus ditentukan dan output audio harus diaktifkan dengan mendefinisikan ENABLE_SOUND ke 1 sebelum menyertakan kacang_gb.h.

gb_serial_tx dan gb_serial_rx

Fungsi-fungsi ini diperlukan untuk komunikasi serial. Atur fungsi-fungsi ini menggunakan gb_init_serial. Jika fungsi ini tidak diatur, maka emulasi akan bertindak seolah-olah tidak ada kabel penghubung yang tersambung.

Fungsi Berguna

Fungsi-fungsi ini disediakan oleh Peanut-GB.

gb_reset

Fungsi ini mengatur ulang game yang sedang dimainkan, seolah-olah konsol telah dimatikan dan dihidupkan. gb_reset dipanggil oleh gb_init untuk menginisialisasi register CPU.

gb_get_save_size

Fungsi ini mengembalikan ukuran penyimpanan game yang sedang dimainkan. Fungsi ini mengembalikan 0 jika game tidak menggunakan data simpanan apa pun.

gb_run_frame

Fungsi ini menjalankan CPU hingga full frame dirender ke LCD.

gb_colour_hash

Fungsi ini menghitung hash dari judul game. Hash ini dihitung dengan cara yang sama seperti Game Boy Color untuk menambah warna pada game Game Boy.

gb_get_rom_name

Fungsi ini mengembalikan nama permainan.

gb_set_rtc

Atur waktu jam waktu nyata (RTC). Beberapa game menggunakan data RTC ini.

gb_tick_rtc

Tidak berlaku lagi: jangan gunakan. RTC dicentang secara internal.

gb_set_bootrom

Jalankan image bootrom saat reset. Penyetelan ulang harus dilakukan setelah memanggil gb_set_bootrom agar perubahan ini dapat diterapkan. Ini karena gb_init memanggil gb_reset, namun gb_set_bootrom harus dipanggil setelah gb_init. Bootrom harus berupa bootrom DMG atau MGB.

Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT.