ym2151-log-player

YM2151レジスタイベントログをJSONファイルから読み込んで、リアルタイム再生とWAVファイル出力を行うプログラム。

概要

このプログラムはYM2151（OPM）のレジスタ操作ログをJSON形式で読み込み、Nuked-OPMエミュレータを使用して音声を再生します。

機能

• ✅ JSONログファイルからイベントを読み込み
• ✅ リアルタイムオーディオ再生
• ✅ WAVファイル出力（output.wav）
• ✅ Nuked-OPMライブラリによる正確なYM2151エミュレーション

ビルド

python build.py build-phase4-windows && ./player events.json

入力JSON形式

YM2151ログJSONファイルは以下の形式である必要があります：

{
  "event_count": 8,
  "events": [
    {"time": 0, "addr": "0x08", "data": "0x00"},
    {"time": 100, "addr": "0x20", "data": "0xC7"},
    ...
  ]
}

各イベントフィールド：

• time: サンプル時刻（絶対時刻、デルタではない）
• addr: YM2151レジスタアドレス（16進数文字列）
• data: レジスタに書き込むデータ（16進数文字列）

注意: プログラムは自動的にレジスタ書き込みを2段階（アドレス書き込み→データ書き込み）に分割し、必要な遅延を追加します。 JSONファイルにis_dataフィールドが含まれていても無視されます。入力は常にpass1形式（単純なレジスタ書き込み）として扱われます。

出力

• リアルタイムオーディオ再生
• output.wav - 再生内容を記録したWAVファイル（ハードコーディング）

利用ライブラリ

• Nuked-OPM: LGPL 2.1
• MiniAudio: Public Domain OR MIT-0

ライセンス

MIT License

※英語版README.mdは、README.ja.mdを元にGeminiの翻訳でGitHub Actionsにより自動生成しています