シリーズのすべての投稿：
パート1.紹介とセットアップパート2.コードの学習パート3. VSTおよびAUパート4.デジタル歪みパート5.プリセットとGUIパート6.信号合成パート7. MIDIメッセージの受信パート8.仮想キーボードパート9.封筒パート10. GUIの改善パート11.フィルターパート12.低周波発振器パート13.再設計パート14.ポリフォニー1パート15.ポリフォニー2パート16.アンチエイリアス
REAPERで仮想キーボードを設定することはそれほど明白ではありません。さらに、ユーザーホストにはそのような機能がまったくない場合があります。 GUIに小さなオンスクリーンキーボードを追加しましょう。
GUI要素
WDL-OLでは、GUI要素は
controlsと呼ばれ
ます 。 このライブラリには、このタスクに必要なすべての機能を備えた
IkeyboardControlクラスがあります。
1つの背景画像と2つの追加のスプライトを使用します。1つは黒のキーを押し、もう1つは白のキーを押します。 論理的です。すべての黒のキーは同じ形状で、白のキーは異なります。 キーを押すと、これらのスプライトがキーボードの背景画像の上に表示され、常に表示されます。
すばらしいカスタムキーを作成する場合は、
このガイドをご覧ください 。 さて、ライブラリに付属するものは次のようになります。
これらのファイルをダウンロードして、プロジェクトフォルダー
/ resources / img /にドロップします。 Xcodeを使用する場合は、それらをウィンドウにドラッグしてプロジェクトに追加します。 いつものように、グラフィックの操作は、ファイル名を
resource.hに追加することから始まります。 同時に、そこにいる間に、
knob.pngと
background.pngへのリンクを削除し、プロジェクトからファイル自体を削除します。
より大きなウィンドウサイズが必要：
Windowsでは、
.pngファイルをアセンブリに含めるには、
Synthesis.rcヘッダーも編集する必要があります。
#include "resource.h" BG_ID PNG BG_FN WHITE_KEY_ID PNG WHITE_KEY_FN BLACK_KEY_ID PNG BLACK_KEY_FN
次に、
Synthesis.hファイルの
publicセクションに、
Synthesisクラスのメンバーをいくつか追加します。
public:
Synthesis.cppの初期化リストに、lastVirtualKeyboardNoteNumberを追加します。
Synthesis::Synthesis(IPlugInstanceInfo instanceInfo) : IPLUG_CTOR(kNumParams, kNumPrograms, instanceInfo), lastVirtualKeyboardNoteNumber(virtualKeyboardMinimumNoteNumber - 1) {
演奏されたノートのソースがホストの場合、プラグインキーボードで押された状態で表示されるはずです。 キーボードは
getNumKeysと
getKeyStatusを呼び出して、どのキーが押されたかを調べます。 前回、これらの機能を
MIDIReceiver実装
MIDIReceiverであるため、
MIDIReceiver 。
プライベートセクションでは、次の行も追加する必要があります。
IControl* mVirtualKeyboard; void processVirtualKeyboard();
IControlクラスは、すべてのGUIコントロールの基本クラスです。
IkeyboardControlで
IkeyboardControlオブジェクトを宣言することはできません。これは、
.hファイルには「不明」
IkeyboardControlです。 したがって、ポインターを使用する必要があります。
IKeyboardControl.hには 、「プラグインのクラスを宣言した
後にこのヘッダーを追加（#include）する必要があるため、プラグインのメインの.cppファイルに追加するのが最善です」というコメントがあります。
状況を明確にするために、
Synthesis.cppを見てみましょう。
#include resource.h前に
#include "IKeyboardControl.h"を追加します。
次に、コンストラクタを変更します。
Synthesis::Synthesis(IPlugInstanceInfo instanceInfo) : IPLUG_CTOR(kNumParams, kNumPrograms, instanceInfo), lastVirtualKeyboardNoteNumber(virtualKeyboardMinimumNoteNumber - 1) { TRACE; IGraphics* pGraphics = MakeGraphics(this, kWidth, kHeight); pGraphics->AttachBackground(BG_ID, BG_FN); IBitmap whiteKeyImage = pGraphics->LoadIBitmap(WHITE_KEY_ID, WHITE_KEY_FN, 6); IBitmap blackKeyImage = pGraphics->LoadIBitmap(BLACK_KEY_ID, BLACK_KEY_FN);
背景画像を添付すると興味深いことが始まります。 最初に、押された黒と白のキーを
Ibitmapオブジェクトの形式で
Ibitmapます。
LoadIBitmap （
6 ）関数の3番目の引数は、
whitekeys.pngに6つのフレームが含まれていることをグラフィックスシステムに
伝えます。
デフォルトでは、pRegularKeysには6つの画像（C / F、D、E / B、G、A、上部C）が含まれている必要がありますが、pSharpKeyには1つの画像（すべてのフラット/シャープ）しか含まれていません。
-IKeyboardControl.h
keyCoordinates配列は、システムに左境界線を基準とした各キーのオフセットを伝えます。 このアクションは1オクターブのみで実行する必要があり、
IKeyboardControl他のすべてのオクターブのオフセットを計算します。
大まかに言えば、次の行では、新しいオブジェクトnew
IKeyboardControlを初期化し、名前
mVirtualKeyboardを割り当てます。 多くの情報を送信します。
- プラグインのインスタンスへのポインター。 これは委任パターンの例です 。仮想キーボードは、このインスタンス（
this ）に対してGetNumKeysとGetKeyStatusを呼び出します。 - GUIのキーボード座標。
- 最低音の番号。 左端のキーをクリックすると、この特定のノートが再生されます。
- オクターブの数。
- 押されたキーの写真へのリンク。
- 1オクターブ内の相対X座標。
興味深いことに、仮想キーボードオブジェクトは
bg.pngファイルの存在さえも知りません。 彼はただ彼を必要としません、すべてがそのように機能します。 キーボード画像は背景画像の一部になることができ、
IkeyboardControlコンストラクターに渡すためだけにこのピースをカットする必要があるため、これはプラスです。
C ++でプログラミングの経験がある場合は、条件反射が発生するはずです。コンストラクターには
newが含まれているため、
delete mVirtualKeyboard必要があります。 ただし、これを行ってからトラックからプラグインを削除すると、
ランタイム例外がポップアップします。 理由は、呼び出しが行われるときです
pGraphics->AttachControl(mVirtualKeyboard);
メモリ管理をグラフィックシステムに移行し、このメモリ領域の管理は私たちの責任ではなくなりました。
deleteを使用して、既に空きメモリ領域の固定を解除します。
次に、
CreatePresets関数の本体を削除します。
void Synthesis::CreatePresets() { }
そして、kKeybXとkKeybYをELayoutに追加します。
enum ELayout { kWidth = GUI_WIDTH, kHeight = GUI_HEIGHT, kKeybX = 1, kKeybY = 0 };
パフォーマンス上の理由から、
IKeyboardControlはそれ自体を再描画しません。 これはグラフィックプログラミングの一般的な方法です。GUI要素を「ダーティ」としてマークします。つまり、そのイメージは次の再描画サイクルでのみ更新されます。
IKeyboardControl.h 、特に
OnMouseDownと
OnMouseUpを見ると、
mKey値
mKey割り当てられており、（
Drawではなく）
SetDirty関数が
SetDirtyていることが
SetDirtyます。
SetDirtyは
IControlクラスのメンバー関数です（その実装はそれぞれ
IControl.cppにあります）。 このコントロールの
mDirtyパラメーター
mDirtyを
trueに設定し
true 。 再描画サイクルごとに、グラフィックシステムは
mDirtyが
trueであるすべてのGUI要素を再描画し
true 。 グラフィックシステムのこの側面を理解することが重要なので、このような詳細を掘り下げました。
外部MIDIメッセージへの応答
これまでのところ、キーボードをクリックすると汚れています。
mMIDIReceiverから
mMIDIReceiverデータを受信しますが、外部MIDIデータも受信する必要があります。
mVirtualKeyboardと
mMIDIReceiverはお互いについて何も知らないので、
Synthesis.cppで ProcessMidiMsgを編集しましょう。
void Synthesis::ProcessMidiMsg(IMidiMsg* pMsg) { mMIDIReceiver.onMessageReceived(pMsg); mVirtualKeyboard->SetDirty(); }
最初に、
mMIDIReceiverは受信したMIDIデータに従って
mLast...メンバーを更新します。 その後、
mVirtualKeyboardはダーティとしてマークされます。 次に、次の再描画サイクルで、
Drawが
mVirtualKeyboardに対して
mVirtualKeyboardれ、次に
GetNumKeysおよび
GetKeyStatusを呼び出します。 最初は複雑に思えるかもしれませんが、実際には、冗長性と不要な動きを避ける透明で明確に構造化された設計です。
仮想キーボードは外部MIDIメッセージに応答し、押されたキーを正しく描画します。
キーボード応答
ホストに組み込まれた仮想キーボードの押下にキーボードを強制的に応答させ、MIDIメッセージを生成し、受信者
mMIDIReceiver送信します。
forループの直前にこの呼び出しを
ProcessDoubleReplacing追加します。
processVirtualKeyboard();
そして適切な関数を書きます：
void Synthesis::processVirtualKeyboard() { IKeyboardControl* virtualKeyboard = (IKeyboardControl*) mVirtualKeyboard; int virtualKeyboardNoteNumber = virtualKeyboard->GetKey() + virtualKeyboardMinimumNoteNumber; if(lastVirtualKeyboardNoteNumber >= virtualKeyboardMinimumNoteNumber && virtualKeyboardNoteNumber != lastVirtualKeyboardNoteNumber) {
GetKeyは、押されたキーに対応するノート番号を提供します。
IKeyboardControlはマルチタッチをサポートしていないため、一度に1つのキーしか押すことができません。 最初の
ifは、もう押されていないキー（ある場合）をリリースします。 この関数は
mBlockSizeサンプルごとに
mBlockSizeれるため、2番目のifは、このクリックに対してメッセージの
メモが 1つだけ生成されるようにします（
mBlockSizeサンプルごとではありません）。 関数が呼び出されるたびにこれらの「繰り返しクリック」を避けるために、
lastVirtualKeyboardNoteNumberの値を覚えています。
行こう！
シンセを再び起動する準備ができました！ すべてが正しく行われていれば、彼のキーボードで演奏できます。 そして、仮想ホストキーボードまたは他の接続されたMIDIソースの使用がプラグインキーボードに表示されます（順番に、最後に押されたキーが表示されます）。 確かに、音はこの最後の1つのキーにのみ対応します。 ポリフォニーについては少し後で説明します。
クラシックシンセサイザーサウンドで、お友達に自慢したり、お気に入りのベートーベンを演奏したりできます。 今だけ音は一種の「木」であり、キーを押して放すとクリック音が聞こえます。 これは、洞が生成される場合に特に顕著です。 そのため、封筒を追加する必要があります。 これは次の投稿で行います。
この段階のプロジェクトファイルは
、ここからダウンロードでき
ます 。
元の記事：
martin-finke.de/blog/articles/audio-plugins-010-virtual-keyboard