花生國標

花生-GB

Peanut-GB 是基於 GameBoy 模擬器的單檔頭 Game Boy 模擬器庫。目的是製作一個高速且可移植的 Game Boy (DMG) 模擬器庫，可用於任何具有 C99 編譯器的平台。

這個模擬器速度非常快。以至於它可以在 Raspberry Pi Pico 上全速運行！請參閱 BENCHMARK.md 以了解 Peanut-GB 的基準測試。

目前僅支援原始 Game Boy (DMG)，但支援 Game Boy Color 的初步工作已經完成（請參閱#50）。

該模擬器仍在開發中，可能不準確（儘管它確實通過了 Blargg 的 CPU 指令和指令計時測試）。因此，某些遊戲可能無法正常運作或根本無法運作。如果準確性很重要，請尋找替代模擬器。

特徵

• Game Boy (DMG) 支持
• 非常快；速度足以在 RP2040 ARM Cortex M0+ 微控制器上全速運轉。
• MBC1、MBC2、MBC3 和 MBC5 支持
• 實時時鐘 (RTC) 支持
• 串行連接支援
• 可以在有或沒有 bootrom 的情況下使用
• 允許背景和精靈使用不同的調色板
• 跳幀和隔行掃描模式（對於慢速 LCD 很有用）
• 使用簡單並附帶範例
• LCD 和聲音可以在編譯時停用。
• 如果啟用聲音，則需要外部音訊處理單元 (APU) 庫。此儲存庫包含快速音訊處理單元 (APU) 庫，網址為 https://github.com/deltabeard/Peanut-GB/tree/master/examples/sdl2/minigb_apu 。

注意事項

• LCD 渲染是逐行執行的，因此某些動畫將無法正確渲染（例如在史前人類中）。
• 由於模擬不準確，某些遊戲可能無法玩（請參閱#31）。
• MiniGB APU 在單獨的執行緒中運行，因此計時不準確。如果需要精確的 APU 計時和仿真，則可以使用 Blarrgg 的 Gb_Snd_Emu 函式庫（或替代方案）。

SDL2 範例

花生_sdl.c 中給出了旗艦範例實現，它使用 SDL2 繪製螢幕並接受輸入。在./examples/sdl2/資料夾中執行cmake或make進行編譯。

運行peanut-sdl ，它會建立一個拖放區窗口，您可以將 ROM 檔案拖放到其中。或者，使用peanut-sdl game.gb在終端中運行，如果找不到遊戲，它將自動創建遊戲的保存檔案game.sav 。或者，執行peanut-sdl game.gb save.sav來指定儲存檔案。

螢幕截圖

注意：此處顯示的動畫 GIF 僅限於 50 fps，而模擬則以本機 ~60 fps 運行。這是因為流行的 GIF 解碼器將最大 FPS 限制為 50。

控制

行動	鍵盤	手把
一個	z	一個
乙	x	乙
開始	返回	開始
選擇	退格鍵	後退
方向鍵	方向鍵	DPAD
重複A	一個
重複B	s
正常速度	1
渦輪 x2（保持）	空間
Turbo X2（切換）	2
Turbo X3（切換）	3
Turbo X4（切換）	4
重置	r
改變調色板	p
重置調色板	Shift + p
全螢幕	F11/f
跳幀（切換）	哦
隔行掃描（切換）	我
轉儲 BMP（切換）	乙

預設情況下，跳幀和隔行掃描模式均處於關閉狀態。 Frameskip 在 60 FPS 和 30 FPS 之間切換。

按“b”會將每個訊框轉儲為目前資料夾中的 24 位元點陣圖檔案。請參閱 /screencaps/README.md 以了解更多資訊。

使用 Peanut-GB 的項目

以下項目使用 Peanut-GB，排名不分先後，並非詳盡無遺。

• Pico-GB - Raspberry Pi RP2040 微控制器上的 Game Boy 模擬。
• Peanut_gb-RGFW - RGFW 的 Gameboy 模擬器範例.
• CPBoy - Classpad II (fx-CP400) 的 Game Boy (DMG) 模擬器。
• PlayGB - Playdate 的 Game Boy 模擬器，基於 Peanut-GB.

入門

函數原型的文件可以在花生_gb.h 的底部找到。

所需功能

前端實作必須向庫提供許多函數。這些函數在呼叫 gb_init 時設定。

• GB_ROM_讀
• gb_cart_ram_read
• gb_cart_ram_write
• gb_錯誤

選用功能

可以定義以下可選函數以實現更多功能。

液晶螢幕繪製線

LCD繪圖需要此功能。使用 gb_init_lcd 設定此函數，並透過在包含花生_gb.h 之前將 ENABLE_LCD 定義為 1 來啟用 Peanut-GB 中的 LCD 功能。如果之前未定義，ENABLE_LCD 預設為 1。如果未呼叫 gb_init_lcd 或 lcd_draw_line 設定為 NULL，則停用 LCD 繪製。

傳送到 lcd_draw_line 的像素資料帶有陰影和圖層資料。前兩個最低有效位元是陰影資料（黑色、深色、淺色、白色）。位元 4 和位元 5 是圖層資料（OBJ0、OBJ1、BG），可用於為遊戲添加更多顏色，就像 Game Boy Color 對舊版 Game Boy 遊戲所做的那樣。

音訊讀取和音訊寫入

這些功能是音訊仿真和輸出所必需的。 Peanut-GB 不包含音訊仿真，因此必須使用外部函式庫。在包含花生_gb.h 之前，必須定義這些函數，並且必須透過將 ENABLE_SOUND 定義為 1 來啟用音訊輸出。

gb_serial_tx 和 gb_serial_rx

這些功能是串行通訊所必需的。使用 gb_init_serial 設定這些函數。如果未設定這些功能，則模擬將如同未連接鏈路電纜一樣運作。

有用的功能

這些功能由 Peanut-GB 提供。

重置GB

此功能會重置正在玩的遊戲，就像控制台已關閉然後再打開一樣。 gb_reset由gb_init呼叫來初始化CPU暫存器。

gb_get_save_size

此函數傳回正在玩的遊戲的保存大小。如果遊戲不使用任何保存數據，則此函數傳回 0。

gb_run_frame

此函數運行 CPU，直到將全幀渲染到 LCD 上。

gb_顏色_哈希

此函數計算遊戲標題的雜湊值。此雜湊值的計算方式與 Game Boy Color 相同，為 Game Boy 遊戲添加顏色。

gb_get_rom_name

該函數傳回遊戲的名稱。

gb_set_rtc

設定實時時鐘 (RTC) 的時間。有些遊戲使用此 RTC 數據。

gb_tick_rtc

已棄用：不使用。 RTC 在內部勾選。

gb_set_bootrom

重置時執行 bootrom 映像。呼叫 gb_set_bootrom 後必須執行重設才能使這些變更生效。這是因為gb_init呼叫了gb_reset，但是gb_set_bootrom必須在gb_init之後呼叫。 bootrom 必須是 DMG 或 MGB bootrom。

執照

該項目已獲得 MIT 許可證的許可。