MSX用FM音源ドライバ「いっぱいOPLL」

MSXでは、アプリケーション側からFM音源カートリッジ「FM-PAC」や本体に内蔵されたFM音源（OPLL）を使う場合、どれか一つの音源しか有効にしてはいけない、という決まりがあります。

それをぶっちぎって、同時にいっぱい使ってしまおう というドライバです。

ただし、このツールを使用することで本体や周辺機器に悪影響を与える可能性もありますので、必ず自己責任でお願いします。

ダウンロード

いっぱいOPLL（コンパイルツール・サンプルMML）

IppaiOPLLv107.zip (2025/11/15 update!)

更新履歴

1.07 (2025/11/15)

• OPLLごとのマスターボリュームを調整できるようにしました

動作環境

「いっぱいOPLL」は、PC上で動くMMLコンパイラと、そこから出力されるMSX用の実行ファイルから成り立っています。

MMLコンパイラ（IppaiOPLL.exe）

• MMLをコンパイルし、MSXで演奏するための実行ファイルを出力するツールです。
• Windows7以降のPCで動作します。
• .NET Framework 4.5以上が必要です。

実行ファイル

• RAM32KB以上のMSXで動作します。
• 本体内蔵FM音源、あるいはFMPACが必要です。FMPACは何個でも認識しますが、MMLの仕様上、内蔵と外付けを合わせて10個までが制御可能となっています。
• フロッピーディスク用のBLOAD形式、およびテープイメージファイルでの出力が可能です。
• 実行ファイルには、演奏データとサウンドドライバの両方が含まれています。

使い方

直接記述方式

• IppaiOPLL.exeを起動したら、MMLウィンドウに直接MMLを記述してください。
• 出力形式を選んで、「名前を付けて保存」「上書き保存」のどちらかをクリックしてください（「コンパイルのみ」はエラーチェック等に使用してください）。
• 「コンパイルに成功しました」「保存しました」と表示されれば成功です。

ファイル読み込み方式

• MMLを記述したテキストファイルを用意してください。
• IppaiOPLL.exeを起動したら、「指定ファイルから読む」でそのテキストファイルを指定してください（ツール側のMMLウインドウはリードオンリーになります）。
• 出力形式を選んで、「名前を付けて保存」「上書き保存」のどちらかをクリックしてください（「コンパイルのみ」はエラーチェック等に使用してください）。
• すると、自動的にテキストファイルを再読み込みし、そのままコンパイルを行います。
• 「コンパイルに成功しました」「保存しました」と表示されれば成功です。
  
  
  

MMLの書式について

MMLについては、なるべく一般的な書式に近づけたつもりですが、機能は極限までシンプルにしています。

大文字と小文字は厳密に区別しているので、マクロや16進数などの特別な場合以外は すべて小文字で記述してください。

音色定義

音色を定義するには、以下の3通りの定義方法があり、データの個数で自動的に判断されます。

また、16進数を用いる場合、データの先頭に 0x を付け、A～F は必ず大文字で記述してください。

1. レジスタの値を直接指定する。最後にボイス移調を設定することもできる。（8ビット×8個あるいは9個）

   *@<音色番号>= <レジスタ0>, <レジスタ1>, ..., <レジスタ7>

   *@<音色番号>= <レジスタ0>, <レジスタ1>, ..., <レジスタ7>, <ボイス移調>

   *@1=0,0,0,27,249,244,18,34

2. _VOICE COPY で配列に格納される値で指定する（16ビット×16個）

   *@<音色番号>= <配列要素0>,<配列要素1>, ..., <配列要素15>

   *@7=0x6C43,0x6573,0x6948,0x7468,0x1800,0x0008,0x0000,0x0000,0x08A3,0x76F1,0x0080,0x0000,0x0082,0x17F2,0x0080,0x0000

3. FM音源のパラメータを個々に指定する（24～25個・MuSICA互換）

   *@<音色番号>= <トータルレベル>,<フィードバック>, <(M)エンベロープタイプ>,<(M)マルチプルレベル>, <(M)アタック>,<(M)ディケイ>,<(M)サスティン>,<(M)リリース>, <(M)キーレイトスケール>,<(M)キーレベルスケール>,<(M)トレモロ>,<(M)ビブラート>,<(M)ディストーション>, <(C)エンベロープタイプ>,<(C)マルチプルレベル>, <(C)アタック>,<(C)ディケイ>,<(C)サスティン>,<(C)リリース>, <(C)キーレイトスケール>,<(C)キーレベルスケール>,<(C)トレモロ>,<(C)ビブラート>,<(C)ディストーション>, <ボイス移調>

   ※(M)はモジュレータ用パラメータ・(C)はキャリア用パラメータ・ボイス移調は省略可

   *@8=0,2, 0,2,15,1,0,0,0,0,0,0,1, 0,1,5,4,13,8,0,0,0,0,1, 0

注意事項

• 内蔵音色は編集できないため、該当する音色番号は指定できません
• ユーザー音色は、OPLL一つにつき同時に一種類 しか発音できません

MMLコマンド

• p … トラック指定（0～99）。これより後に書かれたMMLは、すべてそのトラック用データとみなされる。【※１】
• [ … ループ開始位置指定。このコマンドで位置が指定された場合、最後まで演奏するとその位置に戻る。指定しない場合は最初から演奏する。
• t … テンポ指定（1～750）。これより後に書かれたMMLは、指定されたテンポで演奏される。
• c,d,e,f,g,a,b … 音程ド～シ。直後に+でシャープ、-でフラット。その後に数値（1～256分音符）やピリオドをつけると音長指定。音長を指定しない場合はデフォルト音長。
• r … 休符。
• o … オクターブ設定（1～8）。

  > … 1オクターブ上げる。

  < … 1オクターブ下げる。

• v … ボリューム設定（0～15）。ボリュームを変更する。0が無音、15で最大。

  ( … ボリュームを1上げる。直後に数値をつけると任意の数だけ上げる。

  ) … ボリュームを1下げる。直後に数値をつけると任意の数だけ下げる。

• l … デフォルト音長指定（1～256分音符）。
• u … デチューン指定（-1920～1920）。発音時、周波数を加減算する。±16でちょうど半音変化する。
• U … レジスタデチューン指定（-31～31）。発音時、周波数レジスタに出力する値を直接加減算する。
• UO … オクターブユニゾン指定（-3～3）。発音時、オクターブレジスタに出力する値を直接加減算する。
• q … ゲートタイム指定（1～8）。音長のn/8でキーオフする。デフォルトは8。
• y … サウンドレジスタに値を指定する。
• & … タイ。次の音までキーオンを継続する。
• @ … 音色指定（0～63）。FM音源の音色を指定する。【※２】
• M … マクロ指定（0～999）。定義済のマクロを演奏する。
• b,m,s,h,c … リズム楽器演奏。リズムトラックのみで使用可能。
• @b,@m,@s,@h,@c … リズム楽器のボリュームを個別に指定する（0～15）。リズムトラックのみで使用可能。

【※１】トラック番号について

トラック番号を使いわけることで、同時に10個までのOPLLを制御することができます。

トラック番号とOPLLの関係は以下の通りです。

トラック番号	対応するOPLL
p0～9	OPLL#1（p9 がリズムトラック）
p10～19	OPLL#2（p19 がリズムトラック）
p20～29	OPLL#3（p29 がリズムトラック）
p30～39	OPLL#4（p39 がリズムトラック）
p40～49	OPLL#5（p49 がリズムトラック）
p50～59	OPLL#6（p59 がリズムトラック）
p60～69	OPLL#7（p69 がリズムトラック）
p70～79	OPLL#8（p79 がリズムトラック）
p80～89	OPLL#9（p89 がリズムトラック）
p90～99	OPLL#10（p99 がリズムトラック）

※例えば、OPLL#1でリズム音源を使用しない場合は p0～p8 までの 9トラックが使用可能、リズム音源を使用する場合は p0～p5 の 6トラックと p9 が使用可能となります（無視してもエラーにはなりませんが、正しく発音されません）。

【※２】音色番号について

以下の内蔵音色は *@ コマンドによる編集ができません

音色番号	楽器名
@0	ピアノ
@2	バイオリン
@3	フルート
@4	クラリネット
@5	オーボエ
@6	トランペット
@9	オルガン
@10	ギター
@12	エレキベース
@14	ハープシコード
@16	ビブラフォン
@23	シンセベース
@24	シンセ
@33	ウッドベース
@48	ホルン

特殊コマンド

コメント

•  ;  … セミコロン以降の文字はコメントとして無視します

マクロ

• *M<マクロ番号 >=< MML文字列> … マクロを定義します。マクロ番号は 000～999 で指定してください。 ※コンパイル時に文字列として展開されるので、出力データが節約できるというようなことはありません。

  *M001 = cde
*M002 = fga
*M003 = o4 M001 M002 o5 M001 M002

p0 M003 ;o4 cde fga o5 cde fga と演奏される


ラベルジャンプ

• *L<ラベル番号 > … ジャンプ先となるラベルを定義します。ラベル番号は 000～999 で指定してください。
• *J<ラベル番号 > … 指定したラベルにジャンプします。

  p0 v15 o4cde L001 fga ;普通に v15 o4cde fga と演奏される
p1 v15 o5cdefga J001 ;v15 o5cdefga と演奏した後、L001 の位置にジャンプする。オクターブはコンパイル時に確定するため v15 o5cdefga v15 o4fga と演奏される
p3 v15 o5cdefga UO1 J001 ;v15 o5cdefga と演奏した後、L001 の位置にジャンプする。オクターブはコンパイル時に確定するが UOコマンドは有効のため v15 o5cdefga v15 o5fga と演奏される
p2 v12 o5cdefga J001 ;v12 o5cdefga と演奏した後、L001 の位置にジャンプする。ボリュームは実行時に確定するため v12 o5cdefga v12 o4fga と演奏される


コンパイル制御

• *REVV … この行以降、ボリューム上下の記号を逆にします。
• *REVO … この行以降、オクターブ上下の記号を逆にします。
• *END … この行以降はコンパイルしません。

  p0 o4c>c>c ;o4c o5c o6c と演奏される
*REVO
p0 o4c>c>c ;o4c o3c o2c と演奏される
*END
p0 cdefg ;この行は演奏されない


ボリューム制御

• *DIRV … 通常、vコマンドで指定したボリュームの値は、一度テーブルで変換されてからサウンドレジスタにセットされます（MSX-BASIC互換）が、 このコマンドを指定すると、0～15の値が直接レジスタにセットされるようになります。

  p0 v15c v14c ;実は v15 と v14 では音量は変化しない

*DIRV
p0 v15c v14c ;音量が変化するようになる


• *V<OPLL番号 >=< マスターボリューム> … OPLLごとのマスターボリュームを指定します。15が最大（デフォルト）となり、0で無音になります。

  *V0=15 ;OPLL0はデフォルトの音量
*V1=12 ;OPLL1に出力されるボリュームを3下げる

;OPLL0
p00 v12 c ;OPLL0はマスターボリュームがそのままなのでMMLどおりに v12c と演奏される
;OPLL1
p10 v12 c ;OPLL1はマスターボリュームが3つ下げられるので v9c と演奏される
p19 v15 b4s4 ;OPLL1はリズムを含むすべてのトラックのボリュームが3つ下げられるため v12b4s4 と演奏される


その他のオプションについて

出力形式

以下の3通りの出力形式があります。

1. BLOADファイル

   BLOADコマンドでロード可能なマシン語ファイルを出力します。

   サウンドドライバと演奏データがセットになっているので、ファイル単体で演奏することができます。

2. バイナリーファイル

   ヘッダのない純粋なバイナリーファイルを出力します。

   BASICからロードすることはできません。

   主にデバッグ用です。

3. テープイメージ

   エミュレータなどで使用できるCASファイルを出力します。

   サウンドドライバと演奏データがセットになっているので、ファイル単体で演奏することができます。

   なんでもピーガーmkII等で音声ファイルに変換することで、実機でロードすることもできます。

※どの出力形式でも、「演奏データのみ」をチェックすると、サウンドドライバを出力せず演奏データのみを出力します。

各種情報

コンパイル後、演奏に必要なOPLLの個数や、演奏時に使用されるメモリが「各種情報」の部分に表示されます。

ファイルとして出力されるのは「演奏データ」と「サウンドドライバ」の部分になります。

実行方法

1. ロードして演奏

   BLOAD形式あるいはテープイメージで出力した場合、ファイルにドライバーも含まれるので、簡単に演奏することができます。

   ディスクから読むのであれば、

   BLOAD"ファイル名",R

   テープイメージであれば、

   BLOAD"CAS:ファイル名",R

   と入力すれば、ファイルを読み込んだ後、自動的に演奏が開始されます。

   演奏中に何かキーを押すと停止します。

2. 演奏のみ

   一度メモリ上にBLOADしたデータは、ドライバーを再実行することで何度でも演奏することができます。

   BLOAD"ファイル名"
DEFUSR=&HD000

   と事前にデータを読み込んでおいて

   A=USR(0)

   と入力すれば、すぐに演奏が開始されます。

   また、

   A=USR(1)

   と入力すると、画面にインフォメーションを表示しながら演奏します。OPLLのスロットや個数なども確認できるので、うまく演奏されない場合は試してみてください。

   ちなみに、変数 A にはOPLLの個数が入ります。

3. 演奏しない

   演奏せずにOPLLの個数だけが知りたい場合は

   A=USR(2)

   で A の値を調べてください。

   また、演奏せずにインフォメーション表示のみを行う場合は

   A=USR(3)

   です。

4. マスターボリュームの調整

   「実機で演奏してみたら音量のバランスが悪かった」というような場合、OPLLごとのマスターボリュームを後から調整することができます。

   データを BLOAD した後、

   POKE&HD4E0,＜OPLL0ボリューム補正値＞
POKE&HD4E1,＜OPLL1ボリューム補正値＞
POKE&HD4E2,＜OPLL2ボリューム補正値＞
POKE&HD4E3,＜OPLL3ボリューム補正値＞
POKE&HD4E4,＜OPLL4ボリューム補正値＞
POKE&HD4E5,＜OPLL5ボリューム補正値＞
POKE&HD4E6,＜OPLL6ボリューム補正値＞
POKE&HD4E7,＜OPLL7ボリューム補正値＞
POKE&HD4E8,＜OPLL8ボリューム補正値＞
POKE&HD4E9,＜OPLL9ボリューム補正値＞


   と、必要なOPLLの補正値を書き換えてから USR関数で演奏を開始してください。

   ここでPOKEする補正値は「 0～15 」で、「元のデータから減少させる値」です。デフォルトは 0 で、15を指定するとミュートになります（*Vコマンドと逆）。

   以前に書いたように、OPLLごとの音量は環境によって変わるので、例えば自分以外の人が作ったデータを演奏する場合などは、FMPACの切り替えスイッチや、このマスターボリューム補正を使うことで、最適なバランスを見つけてください。

サンプル

OPLLを3つ使ったサンプルのMMLファイルが入っています。参考にしてみてください。

ちなみに実機で演奏させた動画はこちら

最後に

MSXのお約束をブッチして、こんなことをやってみましたが、いかがだったでしょうか。

実機でFMPACを複数使う場合の注意ですが、例えば、「拡張スロットに4つのFMPACを差した場合」と、「基本スロットに1つだけFMPACを差した場合」では、本体から聴こえる音量が変わります。

もともと外部音源がどのように聴こえるかは、MSXの機種や環境によって異なりますし、「*V」コマンドでマスターボリュームを調整するなど、皆さんの環境に合わせてチューニングしてください。

また、複数のFMPACからの出力が合成されるとかなりの音量になるので、実機で試す場合、FMPACの音量切り替えは「中」か「小」にしておくと良いと思います。

ちなみに、実機でこんな環境が用意できるのは変態だけだと思うので、エミュレータ用の設定ファイルも入れておきました。

エミュレータ上だけでも、「OPLLx9個」の世界を楽しんでみてください。

コンパイラとサウンドドライバについては、以前作ったぴゅう太用のものを改変して作りました。

あくまでも「ちょっとしたお遊び」で始めたということもあって、最低限の機能のみとなっていますし、PSGも使えません。ごめんなさい。

IppaiOPLLに関する質問や、「こんなの作ってみたよー」みたいなお知らせは、twitter で @tiny_yarou までコメントください。よろしくお願いします！

初版 2019/06/08

更新 2025/11/12