(Japanese, UTF-8)

cmd_play by 片山博文MZ

概要

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

使い方

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

オプション:
  -D変数名=値            変数に代入。
  -save_wav 出力.wav     WAVファイルとして保存。
  -reset                 設定をリセット。
  -help                  このメッセージを表示する。
  -version               バージョン情報を表示する。

文字列変数は [ ] で囲えば展開できます。

CMD PLAY文 (8801のみ) (CMD拡張)

• 【機能】 音楽を演奏します。

• 【語源】 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～4の値で指定でき、次のような意味があります。

• #0 … 別売のミュージックインタフェースボードのSSG音源を使います。

• #1 … 別売のミュージックインタフェースボードのMIDIインタフェースを使います(未対応)。

• #2 … チャンネル1、2、3がFM音源を、チャンネル4、5、6がSSG音源を使用します。

• #3 … OPNを効果音モードに切り替えます。CMD PLAYのY文によって音を出します。

• #4 … OPNをCSM(サイン波)モードに切り替えます。CMD PLAYのY文によって音を出します。

cmd_playでは現在、#1は選択できません。音源モードを省略した場合は、#2が選択されます。各チャンネルの文字列は、MML (Music Macro Language)といい、次のような意味を持ちます。

文字列	意味	初期値
Mx (SSG音源のみ)	エンベロープ周期を設定します(1≦x≦65535)。	M255
Sx (SSG音源のみ)	エンベロープ形状を設定します(0≦x≦15)。	S1
Vx	音量を設定します(0≦x≦15)。	V8
Lx	音符や休符の既定値の長さを設定します(1≦x≦64)。	L4
Qx	音の長さの割合を設定します(1≦x≦8)。	Q8
Ox	オクターブを設定します(1≦x≦8)。	O4
>	オクターブを１つ上げます。
<	オクターブを１つ下げます。
Nx	xで指定された高さの音を発生します(0≦x≦96)。
Tx	テンポを設定します(32≦x≦255)。	T120
Rx	休符を演奏します(1≦x≦64)。xは休符の長さです。	R4
C～B[+/-][x][.]	音符を演奏します(1≦x≦64)。xは音符の長さです。
+ (#)	直前の音符を半音上げます。
-	直前の音符を半音下げます。
.	直前の音符や休符に符点をつけます。長さが1.5倍になります。
&	前後の音をつなげます。
{ ... }x	指定された長さのx分音符を{ }の中の音符の個数で等分した連符を演奏します。
@x (FM音源のみ)	音色番号xで指定された音色に切り替えます。	@0
Yr,d (OPNのみ)	OPNのレジスタrの内容をdにします。
Zd (MIDIのみ)	MIDIにデータdを送ります。
@Vx (FM音源とMIDIのみ)	音量を細かく調整します(0≦x≦127)。	@V106
@Wx	xで指定された長さだけ状態を維持します(1≦x≦64)。	@W4

• 音符CDEFGABは「ドレミファソラシ」に対応します。
• 音色番号については、音色一覧をご覧ください。
• 【注意】 CMD PLAY文はCMD拡張命令であり、8801のみで使用できます。CMD PLAYを使用する前にNEW CMDを実行する必要があります(無制限モードを除く)。255文字を越える長さの文字列を指定すると、String too longエラーが発生します(無制限モードを除く)。

音色一覧

音色番号	音色名	解説
0	Default VOICE	既定の音色
1	BRASS 2	ブラス系の音
2	STRING 2	ストリング系の音
3	EPIANO 3	電子ピアノ系の音
4	EBASS 1	電子ベース系の音
5	EORGAN 1	電子オルガン系の音
6	PORGAN 1	パイプオルガン系の音
7	FLUTE	フルート
8	OBOE	オーボエ
9	CLARINET	クラリネット
10	VIBRPHN	ビブラフォン
11	HARPSIC	ハープシコード
12	BELL	ベル
13	PIANO	ピアノ
14	MUSHI	虫の鳴き声
15	DESCENT	高空から降下する音
16	UFO	UFOが遠ざかる音
17	GRANPRI	レーシングカーのエンジン音
18	LASER 1	レーザーガンの音
19	LASER 2	レーザーガンの音
20	SIN WAVE	チューニング用の正弦波
21	BRASS 1	ブラス系の音
22	BRASS 2	ブラス系の音、音色1と同じ
23	TRUMPET	トランペット
24	STRING 1	ストリング系の音
25	STRING 2	ストリング系の音、音色2と同じ
26	EPIANO 1	電子ピアノ系の音
27	EPIANO 2	電子ピアノ系の音
28	EPIANO 3	電子ピアノ系の音、音色3と同じ
29	GUITAR	ギター
30	EBASS 1	電子ベース系の音、音色4と同じ
31	EBASS 2	電子ベース系の音
32	EORGAN 1	電子オルガン系の音、音色5と同じ
33	EORGAN 2	電子オルガン系の音
34	PORGAN 1	パイプオルガン系の音、音色6と同じ
35	PORGAN 2	パイプオルガン系の音
36	FLUTE	フルート、音色7と同じ
37	PICCOLO	ピッコロ
38	OBOE	オーボエ、音色8と同じ
39	CLARINET	クラリネット、音色9と同じ
40	GROCKEN	グロッケン
41	VIBRPHN	ビブラフォン、音色10と同じ
42	XYLOPHN	シロフォン
43	KOTO	琴
44	ZITAR	ツィター
45	CLAV	クラビネット
46	HARPSIC	ハープシコード、音色0、11と同じ
47	BELL	ベル、音色12と同じ
48	HARP	ハープ
49	BELL/BRASS	スタッカートでベル、ロングトーンでブラスの音
50	HARMONICA	ハーモニカ
51	STEEL DRUM	スチールドラム
52	TIMPANI	ティンパニー
53	TRAIN	列車の警笛
54	AMBULAN	救急車
55	TWEET	小鳥のさえずり
56	RAIN DROP	雨の落ちる音
57	HORN	ホルン
58	SNARE DRUM	スネアドラム
59	COW BELL	カウベル
60	PERC 1	打楽器系の音
61	PERC 2	打楽器系の音

使用許諾

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

連絡先

• 片山博文MZ [email protected]