GBA Background Studio 是一款用於建立和編輯 Game Boy Advance (GBA) 背景的桌面應用程式。它允許將圖像轉換為 GBA 相容的圖塊集和圖塊映射，可視化編輯圖塊和調色盤，並匯出可在 GBA 專案中直接使用的資源。
⚠️ 此應用程式專為需要精確控制 GBA 背景的開發者、ROM 駭客和像素藝術家設計。
此 README 提供以下語言版本：
English | Español | Português (BR) | Français | Deutsch | Italiano | Português | Nederlands | Polski
Türkçe | Tiếng Việt | Bahasa Indonesia | हिन्दी | Русский | 日本語 | 简体中文 | 繁體中文 | 한국어
-
圖像轉 GBA
- 將標準圖像轉換為 GBA 相容的圖塊集和圖塊映射。
- 設定輸出尺寸和顏色深度（4bpp 和 8bpp）。
- 匯出前預覽結果。
-
編輯圖塊
- 圖塊的可視化選擇和編輯。
- 圖塊映射網格上的互動式繪圖工具。
- 100% 至 800% 的縮放級別，支援逐像素編輯。
-
編輯調色盤
- 每個調色盤最多編輯 256 種顏色。
- 將調色盤更改與預覽和圖塊同步。
- 重新排列、替換或調整個別顏色。
-
預覽分頁
- 在類似 GBA 的螢幕上可視化最終背景的外觀。
- 快速驗證圖塊和調色盤設定。
-
復原/重做歷史
- 完整的編輯歷史追蹤。
- 具有大型歷史緩衝區的復原和重做操作。
-
可設定的介面和狀態列
- 詳細的狀態列，包含圖塊選擇、圖塊映射座標、調色盤 ID、翻轉狀態和縮放級別。
- 每個分頁的上下文工具列（預覽、圖塊、調色盤）。
-
多語言支援
- 內部翻譯系統（Translator），透過設定選擇語言。
- 設計為支援介面中的多種語言。
GBA Background Studio 使用 Python 和 PySide6 / PySide2（混合）建構，遵循模組化介面設計：
-
主視窗（
GBABackgroundStudio）- 管理應用程式狀態（目前 BPP、縮放級別、圖塊和調色盤選擇）。
- 承載主分頁和自訂狀態列。
- 載入並套用設定（包括最後一次輸出工作階段）。
-
分頁
PreviewTab– GBA 風格的背景預覽。EditTilesTab– 圖塊和圖塊映射編輯工具。EditPalettesTab– 調色盤編輯器和顏色操作工具。
-
介面元件和公用程式
MenuBar– 檔案操作（開啟圖像、匯出檔案、結束）和編輯器操作。CustomGraphicsView– 具有基於圖塊互動的擴充QGraphicsView。TilemapUtils– 圖塊映射互動和選擇的共用邏輯。HistoryManager– 編輯器操作的復原/重做管理。HoverManager、GridManager– 懸停效果和網格疊加的視覺輔助工具。Translator、ConfigManager– 本地化和持久設定。
從 GitHub Releases 下載最新版本：
| 安裝程式 | Python | 作業系統 |
|---|---|---|
GBABackgroundStudio_Setup.exe |
已內建（無需安裝） | Windows 10 / 11 |
GBABackgroundStudio_Legacy_Setup.exe |
已內建（無需安裝） | Windows 7 / 8 / 8.1 |
只需執行安裝程式並啟動應用程式 — 無需 Python 或 pip。
| 環境 | Python | Qt 後端 | 作業系統 |
|---|---|---|---|
| 現代 | 3.10+ | PySide6 (自動) | Windows 10/11, macOS 11+, Linux |
| 舊版 | 3.8 / 3.9 | PySide2 5.15.2 (自動) | Windows 7 / 8 / 8.1 |
應用程式根據您的 Python 版本自動偵測使用哪個 Qt 後端 — 無需手動設定。
pip install -r requirements.txtrequirements.txt 自動安裝正確的 Qt 後端：
- Python ≥ 3.10 →
PySide6 - Python 3.8 / 3.9 →
PySide2 5.15.2
其他相依性：Pillow、numpy、scipy、scikit-learn、opencv-python、certifi。
完整圖形介面可在 Windows 7 及更高版本上執行。使用 Python 3.8，requirements.txt 將自動安裝 PySide2 5.15.2。
此外，多語言命令列精靈 (GBA_Studio_Wizard.bat) 可用於無 GUI 的批次轉換，適用於安裝了 Python 3.8+ 的任何 Windows 版本：
- 導覽至專案根目錄。
- 執行
GBA_Studio_Wizard.bat。 - 選擇您的語言（支援 18 種語言）。
- 按照逐步說明轉換您的圖像。
-
複製儲存庫
git clone https://github.com/CompuMaxx/gba-background-studio.git cd gba-background-studio -
建立並啟用虛擬環境（可選但建議）
python -m venv .venv source .venv/bin/activate # 在 Windows 上：.venv\Scripts\activate
-
安裝相依性
pip install -r requirements.txt
-
執行應用程式
python main.py
-
開啟圖像
- 前往檔案 → 開啟圖像或按
Ctrl+O。 - 選擇要轉換為 GBA 背景的圖像。
- 前往檔案 → 開啟圖像或按
-
設定轉換
- 選擇背景模式（文字模式或旋轉/縮放）。
- 選擇要使用的調色盤或圖塊映射（僅適用於文字模式 4bpp）。
- 設定將用作透明的顏色。
- 調整輸出尺寸和其他必要參數。
- 點擊轉換，應用程式將處理其餘部分。
-
編輯圖塊
- 切換到編輯圖塊分頁。
- 使用圖塊映射檢視繪製和修改個別圖塊。
- 選擇整個區域以複製、剪下、貼上或旋轉圖塊群組。
- 即時同步更改以查看即時結果。
- 調整縮放級別以獲得完美精度。
- 優化/取消優化圖塊以節省空間或確保硬體相容性。
- 在 4bpp 和 8bpp 格式之間轉換資源。
- 在文字模式和旋轉/縮放之間無縫切換。
-
編輯調色盤
- 前往編輯調色盤分頁。
- 在調色盤網格中修改顏色，並使用顏色編輯器進行調整。
- 選擇特定區域或屬於某個調色盤的所有圖塊，以替換或與另一個調色盤交換。
-
背景預覽
- 切換到預覽分頁，以忠實呈現在真實 GBA 上的外觀。
- 驗證圖塊和調色盤設定是否完美協同運作。
-
匯出資源
- 前往檔案 → 匯出檔案或按
Ctrl+E。 - 以可整合到 GBA 開發工具鏈的格式匯出圖塊集、圖塊映射和調色盤。
- 如有需要，從各自的選單單獨匯出各個資源。
- 前往檔案 → 匯出檔案或按
應用程式使用歷史管理員追蹤您的編輯操作：
- 復原 – 復原最後一次操作。
- 重做 – 重新套用已復原的操作。
歷史系統維護最近狀態的緩衝區，包括圖塊編輯、調色盤更改和圖塊映射操作。
應用程式使用設定管理員儲存以下設定：
- 最後使用的語言
- 最後使用的縮放級別
- 啟動時是否載入最後的輸出
- 其他介面和編輯器偏好設定
設定在啟動時載入並套用於介面和選單。
Translator 元件管理介面文字：
- 預設語言透過設定設定。
- 可以新增或編輯翻譯檔案以支援更多語言。
- 介面文字（選單、對話框、標籤）透過翻譯器處理。
歡迎貢獻！如果您想提供協助：
- Fork 此儲存庫。
- 建立功能分支：
git checkout -b feature/my-new-feature
- 提交您的更改：
git commit -am "新增我的新功能" - 推送分支：
git push origin feature/my-new-feature
- 開啟描述您更改的 Pull Request。
請保持程式碼與現有風格一致，並在可能的情況下包含測試。
本專案在 GNU General Public License v3.0 (GPL-3.0) 下授權。
有關更多詳細資訊，請參閱 LICENSE 檔案。
- 感謝 GBA homebrew 和 ROM 駭客社群提供的文件和工具。
- 受經典像素藝術編輯器和 GBA 開發公用程式的啟發。
如果您覺得這個工具有用並想支援其開發，請考慮請我喝杯咖啡！
