# WonderSwan：時刻付きVoice PCM

自作の1秒・12kHz PCMを先にまとめて予約し、CH1のVoiceモードで再生します。
自作の波形・PCMだけを使用し、ゲームROM・BIOS・音楽データは使用しません。
`tetorica-fm2612@0.2.30` の共通factory、WonderSwanSynth、Transportを使います。

## Web

[ページ](web/index.html) / [全コード](web/main.js)。repositoryルートで `npm install` → `npm run dev` を実行し、一覧から開きます。
HTTPSまたはlocalhostと、AudioWorklet対応ブラウザーが必要です。Playのユーザー操作から音声を開始します。

```js
const chip = await createSoundChip('wonderswan', {execution: 'worklet', audioContext, signal});
const transport = new WonderSwanWorkletTransport(chip);
const ws = new WonderSwanSynth({transport, clock: chip.clock});
ws.initialize();
await transport.start();
```

SynthはMain、実コアと音声生成はAudioWorkletで動きます。コード欄は編集して再実行できます。
各Playで新しいチップを生成し、終了・Stop・ページ移動で予約と音声リソースを解放します。読み込み中もStopできます。
WASM・Worklet・ライセンスはインストール済みnpm packageから静的サイトへコピーされます。

## Node

```sh
node examples/wonderswan/voice/01-timed-pcm/node/main.mjs
node examples/wonderswan/voice/01-timed-pcm/node/main.mjs ./wonderswan.wav
```

[全コード](node/main.mjs)。Node.js 22以降。
`createSoundChip('wonderswan', {sampleRate:44100})` → `WonderSwanDirectTransport` → `WonderSwanSynth` と接続し、
`generateStereo()` で時間を進めます。AudioContext・audify・音声デバイス・実時間のsleepは不要です。
出力先省略時は `output/wonderswan-voice-01-timed-pcm.wav` です。

Node版はrawコアのPCMを44,100 Hz stereo PCM16 WAVに保存し、共通の出力gain 0.25だけを掛けます。
チップ固有のunipolar DAC/DC成分を残し、正規化や音量校正は行いません。
Webの音声エンジンはPlaygroundと同じtick単位の波形／Voice中心値補正を使うため、raw Node WAVとビット一致するものではありません。
この違いはチップの音程・命令の意味とは別の出力処理です。

## APIの要点

Voiceの入力はunsigned 8-bit・0〜255、中心128です。PCMデータは1秒・12,000バイトだけ生成します。
Webは全レジスター命令を `transport.scheduleWrites()` で予約してACKを待ってから開始します。
`time` はAudioContextの絶対秒、`register` はハードウェアの絶対アドレスです。
最初にVoice＋CH1 gateを有効にし、最後にgateを切ります。PCMの各バイトにJSタイマーは使いません。
Stopは予約を消してチップを解放します。大量の曲データ用のVGMインポート例ではありません。
Nodeは同じデータを出力フレーム時刻へ丸め、`generateStereo()` と `writeVoice()` を交互に呼びます。

物理CHは0〜3。VoiceはCH1、SweepはCH2、NoiseはCH3を使用します。
チップの入力クロックは3,072,000 Hz、音声出力のサンプルレートとは別です。
内蔵スピーカー・HyperVoice・音声DMA・CPUエミュレーションはこの例の対象外です。

[repository README](../../../../README.md) / [package API](https://github.com/kyorohiro/hello_ymfm_wasm/tree/main/packages/fm2612#api-entry-points)

コアの出典・BSD-3-Clauseライセンス・改変内容はnpm packageの `licenses/mame-wonderswan/` と `sources/third_party/mame-wonderswan/` に含まれます。