dd_commands.hで定義されているコマンド

インストールフォルダにある　dd_commands.h　というファイルが、スクリプト内で使うコマンド(=Deckadance2に発行できる命令)を定義しているファイルです。MIDIメッセージを受信した時にDeckadance2で何らかの処理を行う場合に、このファイルの中身を使います。

テキストエディタで開くと、使用できる命令が縦にずらっと並んでいます。コメント部に使い方が書いてあります。実際に使う場合は

set(hogehoge)

または

get(hogehoge)

のように、setかgetをつけて使います。setをつけた時とgetをつけた時の振る舞いの違いも、コメントに書いてあります。

dd_commands.hの最初に出てくる、PLAY_PAUSE_Aを例に挙げて説明すると

set(PLAY_PAUSE_A)　：デッキAを再生または停止状態にします。

get(PLAY_PAUSE_A)　：デッキAの再生状態（再生しているか/停止しているか）を返します。

となります。後はMIDIメッセージの受信とこれらのコマンドを組み合わせればスクリプトを作っていけます。

その2です。

MIDIコントローラについて知っておく

MIDIの細かい仕様まで理解する必要はありませんが、MIDIコントローラを操作した場合、コンピュータにどういう信号が送出されているかは知っておく必要があります。

ほとんどのDJ用MIDIコントローラの場合、ボタンやノブを操作すると送出されるのは

• ノート信号（いわゆる鍵盤を押した時に相当する信号）
• コントロールチェンジ信号（汎用のパラメータ変更に使える信号）

です。手持ちのコントローラのどの部分を操作するとどういう信号が出るのか、ということは事前にチェックしておかなくてはなりません。コントローラの取扱説明書に書いてある場合もありますが、情報がない場合は自分で実際に調べてみるのが早いです。

MIDIコントローラの信号を調べる

実際の調べ方です。

1. コントローラを接続した上でPreferencesのMIDI Controlを開きます。
2. 対象になるコントローラの”Input”をオンにします。
3. 上段のController欄にある”MIDI Learn Editor”を開きます。

これは、従来のDeckadanceにもついていたキーアサイン用の機能です。使い勝手も大体一緒です。ポイントは、キーアサインの結果をスクリプトとして出力できるということです。つまり、調べたいボタンやノブに何か適当な機能を割りつけた状態でスクリプトを出力すると、そのスクリプトに信号の中身が出力されているというわけです。具体的には

1. どれか適当な機能をダブルクリックします。
2. MIDIコントローラの信号を調べたいボタンなどを押します。
3. ボタンに機能が割り付けられるので、”Export Script”でスクリプトファイルを出力します。

ファイルを開いてみると、ノート情報であればこういう記述の行が見つかると思います。

【例】

if(status == 0x90 && data == 0x12) {
set(hogehoge, isDown);
return;
}

強調しましたがdata==0x12のところが重要です。これはノート信号の例ですが、0x12の信号を受信した時に何らかの処理を行う、という内容になっています。

勘の良い方はここまで見ると何となく分かってしまうのではないかと思いますが、信号の種類分こういったif文を用意すれば自作のスクリプトが作れます。

Launchpadなんかはボタンだらけなので調べるのに根気が要りましたが、こんな要領で全ボタンからどんな信号が出るかを調べました。

Deckadance2のMIDIスクリプトの概要

Deckadance2（以下DD2と省略）でMIDIコントローラからの操作を行う場合、必ずMIDIスクリプトというファイルが必要になります。

MIDIスクリプトはコントローラから受け取ったMIDI信号をDD2側の操作命令に変換する働きをします。そのため、コントローラごとにMIDIスクリプトは異なるものになります。

MIDIスクリプトはAngelScriptというC++に近いスクリプト言語で書かれており、多少でもプログラムの心得があれば、サポートされていないコントローラをDD2対応にしたり、または既存のスクリプトを改造して使い勝手をよくしたりできます。

MIDIスクリプトのチュートリアルとサンプル

DD2のインストールフォルダに　tutorial.txt　というテキスト文書があり、これがチュートリアルです。ただし、それほど中身は細かく書かれているわけではありません。

同じくインストールフォルダにある　dd_commands.h　というファイルが、スクリプト内で使う列挙型を定義しているファイルです。各スクリプトではこのdd_commands.hを必ずincludeして使います。メモ帳やテキストエディタで開くことができます。

上記のファイルを見ただけではスクリプトを書くのは難しいと思うので、あわせて既存のMIDIスクリプトファイルを見ておくと良いと思います。公式なものからユーザーメイドのものまで色々あるので、人によってどの機能をどういう風に実装しているか個性が出ていて、参考になります。

Launchpad MK2用の自作スクリプトが大体できたので、DD2のMIDIスクリプトファイルの書き方をまとめてみることにしました。

「C++ベースのスクリプトだからわかりやすいぞ」ということなのですが、そのC++がほとんど分からないので苦戦しました。C関係については、はるか昔に”学生のためのC”という本で勉強を試みたのですが、例外にもれずポインタのことがよく分からなくて勉強するのをやめたことが悔やまれます。