Swanium Crystal

SwanCrystal 固定で WonderSwan 系 ROM を実行する、Crystal 製のヘッドレステスト可能なエミュレータです。Mono / WonderSwan Color ROM は SwanCrystal の後方互換として起動します。実 BIOS は扱わず、CPU、映像・入力、音声、セーブステート、デバッグ基盤を実装しています。対応範囲と Rust 版 Swanium との差分は機能対応表を正とします。

mise run setup
mise run ci
mise run build
./bin/swanium-crystal --version

mise run build は最適化済みのリリースビルドを生成します。遅い場合は、以前の通常ビルドではなくこのコマンドを実行してから起動してください。

SDL2 の導入確認には、デスクトップ環境で mise run sdl-smoke を実行します。通常 CI は自作 fixture だけを使います。公開テスト ROM はローカルで WS_CPU_TEST_ROM=/path/to/WSCpuTest.wsc mise run public-roms として opt-in 検証でき、ROM 本体はリポジトリや CI に含めません。詳細は 開発計画、設計、テスト、開発規約、ライセンス方針 を参照してください。

利用者が合法的に用意した .ws / .wsc は、明示指定で起動できます。ROM は収集・配布せず、SRAM セーブは macOS の Application Support/swanium-crystal/saves に ROM ファイル名ごとに保存します。

./bin/swanium-crystal --rom /path/to/game.wsc

Escape で終了します。矢印キーがX方向パッド（↑→↓←）、WASDがY方向パッド（WDSA）、X/ZがA/B、ReturnがStartです。これは元Swaniumと同じ初期割り当てです。F5/F9はROMごとのステート保存・復元です。ネイティブのコントロールウィンドウにはROM名、FPS、音量スライダーがあり、メニューからROMを開く、停止・再開、ステート保存・復元ができます。--headless-frames COUNT を付けると画面を開かずに起動後の実行を確認できます。

画面と入力の自作検証プログラムは次のコマンドで起動し、Escapeまたはウィンドウを閉じると終了します。

mise run video-demo

固定3倍（672×432）、60 Hz上限で表示します。矢印キーがX方向パッド、WASDがY方向パッド、Z/XがA/B、ReturnがStartです。SDL2対応ゲームパッドでは方向パッド、A/B、Startを利用できます。

デモでは約440 Hzの音声も再生します。F1でデバッグ表示、Spaceで一時停止・再開、Nで1命令実行、1/2/3で背景1・背景2・スプライト表示を切り替えます。Page Up / Page Downはメモリ表示位置、F5 / F9は0番スロットの保存・復元です。デバッグ表示にはSDL音声キューの推定遅延とアンダーラン回数も表示します。