Home ja

MUCOMSX Wiki

MUCOM88 for MSX — 作曲ガイド

リポジトリの説明書はツールの操作方法を扱います。どのキーでコンパイルするのか、エラーコードが何を意味するのか、セッションはどう動くのか。この Wiki は音楽の書き方を扱います。MMLの書き方と、PCで作ったFM音色・PCMバンクをMSXへ持ち込む方法です。

🇺🇸 English · 🇰🇷 한국어

---

まず理解しておくこと

MUCOMSXは音楽を再生します。サウンド素材を作ることはしません。

MSX側にFM音色エディタもPCMサンプル変換器もありません。そもそもそういう設計ではないのです。YM2608の音色はオペレータのパラメータ25バイトで、いじりながら聴きたいものですし、ADPCMバンクは16ビットのWAVファイルから始まります。どちらも24 KiBのMSXテキストバッファの中で行うには収まりの悪い作業です。

そこで作業は2つに分かれます。

どこで	何を
PC (Windows)	FM音色の設計、PCMバンクの作成、アイデアを素早く試聴
MSX	MMLの記述と編集、コンパイル、実機のYM2608での再生、.MUB / .VGMの書き出し

素材は普通のファイルとして一度だけ渡ります。そのあとMSX側は自己完結します。

flowchart LR
  subgraph PC["PC / Windows"]
    T["FmToneEditor"]
    W["WAVサンプル"]
  end
  subgraph MSX["MSX"]
    S["SONG.MUC"]
    O["SONG.MUB"]
    S -- "コンパイル — MUCPLAY / MUC2MUB" --> O
  end
  T -- "VOICE.DAT" --> S
  W -- "MUCOMPCM.BIN" --> S

Loading

全体の経路は**作業の流れ**で順を追って説明します。

---

ページ一覧

公開中

ページ	内容
作業の流れ	PC → MSXの全経路、ファイル名の規則、何をいつ複製するか
ツールとリンク	MUCOM88 Windows、変換ツール、上流のドキュメント

作成中

まだ公開していません。以下は予定している見出しのため、あえてリンクにしていません。

ページ	扱う予定の内容
MMLの基本	ファイル構造、ヘッダタグ、チャンネルA–K、音符、音長、オクターブ、テンポ
MMLリファレンス	表現コマンド、リピート、マクロ、ポルタメント、上級コマンド表
FM音色	PCでの音色設計、@の各形式、ライブラリ方式とインライン定義
PCMとADPCM	WAVからバンクを作る、Kチャンネル、PCMが.MUBに入るまで
リズム	Gチャンネル、7値の音量形式、パターンの書き方
制限と仕様	すべてのサイズ制限を1つの表に、そして実際にぶつかるのはどれか
トラブルシューティング	症状 → 原因。鳴らないチャンネル、違う音色、欠けたPCM

それまではMUCEditの説明書がMML文法とすべてのコンパイルエラーコードを扱い、上流のonitama/mucom88 wikiがMUCOM88自体の正典リファレンスです。

---

始める前に

まずMSX側が動く必要があります。要件はリポジトリのREADMEにあります — MSX2以降、MSX-DOS2またはNextor、512 KBのマッパー推奨、再生にはMAKOTO(YM2608)カートリッジ。

PC側にはONION softwareのMUCOM88 Windowsが必要です。単独で動作し、音色エディタとPCMバンクの作成機能はここにあります。

文法についての注記。 MUCOMSXはMUCOM88 v1.7系を対象とし、MUB8形式を出力します。MUCOM88向けに書かれたMMLはたいていコンパイルできますが、MUCOMSXはあらゆるMUCOM88派生のビット単位の複製ではありません。この Wiki が制限や挙動を述べるときはMUCOMSXを基準にしています。上流プロジェクト自身のリファレンスはonitama/mucom88 wikiをご覧ください。

---

貢献について

修正や追加を歓迎します。ここに誤りがある、あるいは書かれていない技法があれば、Issueへお寄せください。韓国語・日本語・英語のいずれでも構いません。