ドキュメント
Cupboard
鍵盤で弾く 4 レーンのビデオ楽器
概要
Cupboard は、サンプラーが音を扱うのと同じやり方で動画を扱う楽器です。動画ファイルを 4 つのレーンのどれかに読み込み、基準の音程と反応する音域を決めて、弾きます。弾いた鍵盤が再生速度を決め、映像が音についてきます。逆ではありません。
オーディオ出力から出るのは、その速度で鳴っているクリップ自身の音です。画面のキャンバスに映るのは、鳴っているレーンをすべて重ねた絵で、レーンごとに位置、大きさ、不透明度、そしてクロマキーを持っています。
クイックスタート
動作環境
- macOS Intel は 10.15 以降、Apple Silicon は 11.0 以降。スタンドアロン・AU・VST3
- Windows 版は準備中です
インストール
| 形式 | macOS の置き場所 |
|---|---|
| AU | ~/Library/Audio/Plug-Ins/Components に Cupboard.component |
| VST3 | ~/Library/Audio/Plug-Ins/VST3 に Cupboard.vst3 |
| スタンドアロン | /Applications に Cupboard.app |
インストールしたら DAW を再起動するか、プラグインを再スキャンしてください。
スタンドアロンで音を出す
- アプリを開きます。
- メニューバーの Preferences(⌘,)で、オーディオ出力と MIDI 入力デバイスを選びます。MIDI 入力は最初「なし」になっているため、選ぶまでは MIDI キーボードを弾いても鳴りません。
はじめの一音
- 動画ファイル(.mp4 / .mov / .m4v)を、左側のレーンのどれかにドラッグします。空のレーンをクリックしてファイルを選んでも同じです。
- そのレーンのキーゾーン(画面下の鍵盤)で、反応する音域が分かります。
- 鍵盤を弾きます。MIDI キーボードが無ければ、キーゾーンの鍵盤をクリックするか、PC のキーボードの A〜L(Z / X でオクターブ)が使えます。
- 基準の音程は Root で決めます(最初は C3、ノート番号 60)。この音程で弾くと、クリップは録画されたままの速さで鳴ります。高い音ほど速く、低い音ほど遅くなります。
4 つ全部に別々のクリップを入れて、Split を押すと鍵盤を分け合い、Layer を押すと 1 つの音で 4 つが重なります。
パネルの区画

レイアウトは 1200 × 800 で固定です。ウィンドウの角をドラッグするか、≡ メニューのウィンドウ倍率を選ぶと、全体がまとめて拡大縮小します。配置は変わりません。
4 つのレーン
レーンはクリックすると選ばれ、キャンバス下の 2 列のコントロールがそのレーンを操作します。つまりこの 2 列は、いつでも「いま選んでいるレーン」です。レーンを切り替えると、同じつまみが別のレーンの値を指します。
レーンはそれぞれ MIDI チャンネルを 1 つ持っていて(最初はレーン番号と同じ)、そのチャンネルに届いたノートに反応します。2 列目の右端の MIDI で変えられ、Omni にすると全チャンネルに反応します。
レーンの右端には 4 つのボタンがあります。
- SOLO — このレーン以外を無音にします
- MUTE — このレーンを無音にします
- 1 SHOT / GATE / TOGGLE — 鍵盤を離したときの動きです。押すたびに切り替わります。1 SHOT は最後まで鳴り、GATE は離すと止まり、TOGGLE は次に押すと止まります。最初は GATE です
- COPY — このレーンの設定を別のレーンへ写します。クリップも一緒に写すかどうかを選べます
サムネイルにポインタを重ねると出る x で、クリップを外せます。
キャンバス
鳴っているレーンが、それぞれの位置・大きさ・不透明度で重なります。重なる順番はレーンの順番です。ここに動画をドロップすると、選んでいるレーンに読み込みます。
キャンバスの下地は Canvas で選びます。Transparent(透明)は、映像を後段に送るときに普通に選ぶものです。Blue / Green / Magenta は、送った先でもう一度キーイングするとき用です。
クリップと配置
前半がクリップの鳴り方、後半がキャンバス上の置き方です。
Key Flw が 100% なら 1 オクターブで速度が 2 倍になり、0% ではどの鍵盤で弾いても等倍速のままです。映像だけを止めて音程を動かす、ということはできません。画と音はいつも同じ速さで動きます。
Speed は、鍵盤で決まった速さにさらに掛ける倍率です(0.25x〜4x)。Start と End はクリップのどこからどこまでを使うかで、Loop がその終点に着いたときの動きを決めます(Off / Forward / Ping-Pong)。Reverse は画も音も逆向きに走らせます。
Gain と Pan はこのレーンの音量と定位です。どちらもつまみ列の右端に並んでいます。4 レーン合計の音量は、左下の Master で決めます。
エンベロープ、ループ、キーヤー
A / D / S / R は音と絵の両方に効きます。不透明度がエンベロープに従うので、立ち上がりを長くすれば絵もゆっくり現れます。
Key とその右の 3 つがクロマキーです。緑や青の背景で撮った素材を抜いて、下のレーンに重ねるためのものです。色の距離ではなく色味で判定するので、背景の明るさにむらがあっても抜けます。
左から順に触るのが早道です。Key を入れて、Amount を被写体が欠け始める手前まで上げ、Soft で輪郭をなじませ、最後に Despill で髪や肩に乗った緑を抜きます。
楽器全体の操作
Split と Layer は、キーゾーンをまとめて引き直すボタンです。Split はクリップの入っているレーンで鍵盤を分け合い、そのレーンを Omni にします。Layer は全レーンに鍵盤全域を渡し、こちらも全レーンを Omni にします。どちらも、そのあと手で直せます。
Panic は、鳴っている音をすべて止めます。
ヘッダーとメニュー
画面上端の帯と ≡ メニューは、Hügelton のプラグインすべてに共通です。この製品はプリセットを持たないので、帯にプリセット欄と ▲ / ▼ はなく、メニューにプリセットの項目もありません。
| 場所 | 働き |
|---|---|
| ロゴ(左端) | クリックすると製品情報を開きます |
| レベルメーター | 出力レベルです。上段が左、下段が右チャンネル。一番上の赤は、出力段のリミッターが働いている目安です |
| ≡(右端) | メニューを開きます |
≡ メニュー
- 〈製品名〉について… — バージョンと著作権表示
- 設定 — 製品ごとの設定(その製品の章を参照)
- ウィンドウ倍率 — 75% / 100% / 125% / 150%
- 言語 — 自動 / English / 日本語(日本語を表示できるフォントがある環境のみ)
ヘルプとツールチップ
パネルの部品にポインタを重ねると、その近くに名前と現在の値が、画面下端の帯にその部品が何をするかが表示されます。名前と値の吹き出しは ≡ → 設定 → ツールチップで消せます。
設定(≡ → 設定)
- ツールチップ — ポインタの横に出る、名前と値の吹き出しの表示 / 非表示
キーゾーン
どのレーンがどの音域に反応するかを、鍵盤の形で見て、そのまま直せます。端をドラッグすると伸び縮みし、真ん中をドラッグすると音域ごと動き、鍵盤をクリックすると試聴できます。鳴っている音は、ここで光ります。
この鍵盤をクリックすると、選んでいるレーンが鳴ります。PC のキーボードの A〜L でも弾けて、Z / X でオクターブが変わります。
プリセットがない理由
Cupboard にはプリセットがありません。これは作りかけだからではなく、そう決めたからです。
パッチは 4 つのクリップを運べません。ファイルの場所は、その 1 台にしか通用しないからです。そして残るものの多くは、特定のクリップについての数字です。基準の音程、反応する音域、ファイルのどこから鳴らすか。別の素材に当てはめると、それは出発点ではなく単に間違った値になります。
本当に戻ってきてほしいのはセッションのほうで、そちらはクリップごと丸ごと戻ります。DAW ではプロジェクトが持ちます。スタンドアロンは自前で覚えていて、閉じて開き直しても中身はそのままです。
~/Library/Application Support/Hugelton/Cupboard/standalone.state
空の状態から始めたいときは、このファイルを消してください。
素材をまたいで持ち運べるものは、Split と Layer、そしてキャンバスの下地だけです。どれもボタン 1 つです。
MIDI
レーンはそれぞれ MIDI チャンネルを持っているので、同じ CC 番号が、どのチャンネルでも「そのレーンの」パラメーターを指します。チャンネル 1 の CC 24 はチャンネル 1 のレーンの Speed を動かし、チャンネル 2 の CC 24 はチャンネル 2 のレーンの Speed を動かします。Omni のレーンは全チャンネルに反応します。同じ CC 番号を、4 つのレーンで使い回せるということです。
CC で動かした値は、パネルには反映されますが、ホストのオートメーションには書き込まれません。
レーンごと — そのレーンのチャンネルに送る
| CC | パラメーター | 備考 |
|---|---|---|
| 20 | Root | 音域全体に対応 |
| 21 | Key Low | 音域の下端 |
| 22 | Key High | 音域の上端 |
| 23 | Key Flw | 0% で速さ固定、100% で 1 オクターブごとに 2 倍 |
| 24 | Speed | 0.25x〜4x |
| 25 | Start | クリップ内の位置(%) |
| 26 | End | クリップ内の位置(%) |
| 27 | Loop | 0〜42 Off、43〜85 Forward、86〜127 Ping-Pong |
| 28 | Reverse | 0〜63 切、64〜127 入 |
| 29 | Note Off | 0〜42 1 SHOT、43〜85 GATE、86〜127 TOGGLE |
| 30 | Attack | 0.1〜2000 ms |
| 31 | Decay | 1〜2000 ms |
| 102 | Sustain | 0〜100% |
| 103 | Release | 2〜4000 ms |
| 104 | Gain | 0〜100% |
| 105 | Pan | 64 が中央 |
| 106 | X | 64 が中央 |
| 107 | Y | 64 が中央 |
| 108 | Scale | 5〜300% |
| 109 | Opacity | 0〜100% |
| 110 | Key | 0〜63 切、64〜127 入 |
| 111 | Key Amount | パネルでは Amount。1〜150% |
| 112 | Key Soft | パネルでは Soft。0〜100% |
| 113 | Despill | 0〜100% |
レーンの MIDI チャンネルを変える CC はありません。チャンネルは CC がレーンに届くための経路なので、チャンネルを変える CC があると、その CC 自身が届かない先へレーンを動かせてしまいます。
楽器全体 — どのチャンネルでも
| CC | パラメーター |
|---|---|
| 7 | Master |
| 114 | Canvas(Black / Blue / Green / Magenta / White / Transparent) |
そのほか
- ノートオン / オフ — ベロシティが、その音の音量を決めます
- CC 64(サステインペダル) — ペダルを踏んでいる間に届いたノートオフを、離すまで保留します。効くのは Gate のレーンです
- CC 120 / 123 — 鳴っている音をすべて止めます
ピッチベンドには対応していません。クリップの速さは弾いた鍵盤で決まるので、ベンドすると音と一緒に絵も滑ります。
トラブルシューティング
鍵盤を弾いても鳴らない スタンドアロンでは、Preferences(⌘,)で MIDI 入力デバイスが選ばれているか確認してください。最初は「なし」になっています。DAW では、トラックの MIDI 入力を確認してください。どちらでも、キーゾーンの鍵盤と PC のキーボード(A〜L)では鳴ります。
レーンに動画を入れたのに、何も起きない そのレーンのキーゾーンが、弾いている音域に掛かっているか確認してください。Split を押すと、クリップの入っているレーンで鍵盤を分け合います。
音は出るが絵が出ない そのレーンの Opacity と Scale を確認してください。キャンバスの外へ出ていることもあります(X / Y)。音しか入っていないファイルの場合は、レーンにその旨が出ます。
グリーンバックを抜くと被写体まで消える Amount を下げてください。上げるほど広い範囲が透明になります。輪郭のギザギザは Soft、縁に残る緑は Despill です。
DAW に Cupboard が出てこない 置き場所を確認して、DAW を再起動するかプラグインを再スキャンしてください。
変更履歴
0.1.0
初版。
利用条件
本ソフトウェアと、同梱されるプリセット、画像、音、書体、文書を含む一切のアセットは、Hügelton Instruments の著作物です。著作権は Hügelton Instruments に帰属し、オープンソースではありません。
購入した方、およびベータテストに参加した方には、本ソフトウェアを自分の機材にインストールして使用する、譲渡できない個人の権利が与えられます。与えられるのはそれだけです。
次のことを固く禁じます。
- リバースエンジニアリング、逆コンパイル、逆アセンブル、解析
- 再配布。有償・無償、全部・一部を問いません
- 転売、貸与、譲渡
- 同梱のアセット(画像、音、プリセット、書体、文書)を取り出して、本ソフトウェアの外で使うこと
- 認証や保護のしくみを回避すること
本ソフトウェアは、いまの状態のままお渡しします。動作や結果についての保証はありません。