(Japanese, UTF-8)

English is here

古いパソコン PC-8801 の N88-BASIC という言語の CMD PLAY 文を現代の Windows パソコンでエミュレート（再現）するプログラムです。

使い方: cmd_play [オプション] [#n] [文字列1] [文字列2] [文字列3] [文字列4] [文字列5] [文字列6]

オプション:
  -D変数名=値                変数に代入。
  -save-wav 出力.wav         WAVファイルとして保存（MIDI音源を除く）。
  -save-mid 出力.mid         MIDファイルとして保存（MIDI音源のみ）。
  -reset                     音楽を止めて設定をリセット。
  -stopm                     音色を変えない以外は -reset と同じ。
  -stereo                    音をステレオにする（デフォルト）。
  -mono                      音をモノラルにする。
  -voice CH FILE.voi         ファイルからチャンネルCHに音色を読み込む（FM音源）。
  -voice CH "CSV"            配列からチャンネルCHに音色を読み込む（FM音源）。
  -voice-copy TONE FILE.voi  音色をファイルにコピーする（FM音源）。
  -bgm 0                     演奏が終わるまで待つ。
  -bgm 1                     演奏が終わるまで待たない（デフォルト）。
  -help                      このメッセージを表示する。
  -version                   バージョン情報を表示する。

数値変数は、「L=数値変数名;」のように等号とセミコロンではさめば指定できます。
文字列変数は「[A$]」のように [ ] で囲えば展開できます。

• 【機能】 音楽を演奏します。
• 【語源】 Command play
• 【書式】 CMD PLAY [#音源モード,] [ 文字列1 ][, 文字列2 ][, 文字列3 ][, 文字列4 ][, 文字列5 ][, 文字列6 ]
• 【文例】 CMD PLAY "CDE"　⇒　ドレミを演奏
• 【説明】 6和音まで演奏できます。文字列1、文字列2、文字列3はチャンネル1、2、3に、文字列4、文字列5、文字列6はチャンネル4、5、6に対応します。

音源モードは0～5の値で、次のような意味があります。

• #0 … 外付けのSSG音源を使います。チャンネル1～6がSSG音源を使用します。
• #1 … 外付けのMIDI音源を使います。チャンネル1～6がMIDI音源を使用します。
• #2 … チャンネル1～3がFM音源を、チャンネル4～6がSSG音源を使用します。
• #3 … OPNを効果音モードに切り替えます。CMD PLAYのY文によって音を出します。
• #4 … OPNをCSM(サイン波)モードに切り替えます。CMD PLAYのY文によって音を出します。
• #5 … FM音源を使います。チャンネル1～6がFM音源を使用します。

音源モードを省略した場合は、#2が選択されます。#5は、サウンドボード2でなければ選択できません。 通常、音源モードは、#0、#1、#2、または#5でお使いください。リズム音源はまだ未対応です。

各チャンネルの文字列は、MML (Music Macro Language)といい、次のような意味を持ちます。

• 音符CDEFGABは「ドレミファソラシ」に対応します。
• 音色番号については、音色一覧をご覧ください。
• 実機のMIDIでは @xは指定できません。代わりにZdを複数回使ってプログラムチェンジしてください。
• 実機のMIDIでは @M、@L、@R は指定できません。代わりにZdを複数回使ってパンを設定してください。
• MIDIについては、WikipediaのMIDIのページをご覧ください。
• いくつかの機種では@V設定後はVの設定よりも@Vが優先されます。
• CMD PLAY文はCMD拡張命令であり、8801のみで使用できます。CMD PLAYを使用する前にNEW CMDを実行する必要があります(無制限モードを除く)。255文字を越える長さの文字列を指定すると、String too longエラーが発生します(無制限モードを除く)。

• 本ソフトウェアの使用においては、LICENSE.txtに記載されている「fmgon ライセンス」の使用条件に従ってください。
• 本ソフトウェアのソースコードは https://github.com/katahiromz/cmd_play からダウンロードできます。
• 本ソフトウェアの一部は、cisc さん ([email protected]) が著作権を所有しています。

• 片山博文MZ [email protected]