MIDI構文

OnSongはMIDIコマンドを表現するためのテキストベースの構文を使用します。メタデータエディタのMIDIイベントを使用できますが、テキストでMIDIコマンドを表現することもできます。

区切られた値

まず最初に、複数のMIDIコマンドはさまざまな文字で区切ることができます。タブ文字、コンマ、セミコロン、縦棒、または改行などが含まれます。コンマが最も一般的な区切り文字です。例えば：

1.2:0@0, PC1.2:3@0, N67@1, START, SS8

チャネル

各エントリには@シンボルが含まれている場合があります。シンボルの後の数値は、コマンドを送信するチャネルです。MIDIのチャネルはゼロから始まるため、チャネル1はゼロ(0)、チャネル2は1(1)などになります。

@シンボルが使用されない場合、コマンドはすべてのチャネルで送受信されます。

プレフィックス

リスト内の各エントリには、プレフィックスが含まれます。このプレフィックスは、送信するMIDIコマンドのタイプを決定します。これらには次が含まれます：

• PCまたはプレフィックスなしはプログラムチェンジイベントです。
• Nはノートイベントです
• CCはコントロールチェンジイベントです。
• SSはソング選択イベントです。
• STARTはスタートコマンドです。
• STOPはストップコマンドです。
• CONTINUEは継続コマンドです。
• F0はSysExメッセージの前に付きます。

値

コマンドの値は@シンボルの直前、または@が指定されていない場合はエントリの最後に表示されます。これはプレフィックスに基づいて、プログラムチェンジ、コントロールチェンジ、ノート、またはソング選択の値です。SysExエントリの場合、SysExの16進数値はF0プレフィックスの直後に提供され、すべてのSysExコマンドのヘッダーとして使用されます。

サブ値

場合によっては、追加情報がMIDIコマンドにサブ値として伝達されます。例えば、MSBおよびLSB、ならびにコントロール値の速度はこの方法で送信できます。これは値部分にコロンを追加することで表現されます。サブ値は、送信されるMIDIコマンドのタイプに応じて異なるコンテキストを持ちます：

• プログラムチェンジはプログラムチェンジのMSB/LSBに合わせたサブ値を持ちます。これらの値はピリオドで区切られ、MSBが左側、LSBが右側にあります。
• コントロールチェンジはこれを使用して設定されたコントロールの値を持ちます。数値は0～127の間にすることができます。省略された場合、値127が推定されます。
• ノートイベントはノートを再生する速度に関連するサブ値を持ちます。これは0～127の数値に設定できます。

例

シンプルなプログラムチェンジから始めましょう。このシナリオでは、プログラムチェンジ8を使用して、チャネル1でMSB4およびLSB2も送信します。この例は、この変動の最も複雑なバリエーションから始まり、銀行選択とチャネルを削除してより広くなります：

PC3.1:7@0, 3.1:7@0, 3:7@0, 3:7, 7@0, 7

コントロールチェンジは似ていますが、構文の左側はコントロールチェンジ番号で、右側はオプションの値です。値が提供されない場合、127が代わりに送信されます。チャネル3でコントロールチェンジ106の値64を送信します。

CC105:63@2, CC105:63. CC105@2, CC105

次に、ノートイベントを見てみましょう。チャネル8でC4を75%ベロシティで再生する場合、OnSongがMIDI C0をMIDIノートスケールで0としてカウント開始するため、以下を入力します：

N60:95@7, N60@7, N60:95, N60

繰り返しになりますが、MIDI構文から値が削除されるにつれて、MIDIステートメントはより広く、より具体性が低くなることを覚えておくことが重要です。例えば、ノートイベントの最後のバージョンでは、C4をすべてのチャネルで100%ベロシティで送信します。