パッチ

ケーブルは、音楽がしていること（低音、ビート、ビルドアップ、ゆっくりした時計、ほかのレイヤーまで）を受け取り、それを使って 1 つのノブを動かします。それらをつなぐ場所がパッチです。Pro

ケーブルを作る

ウインドウの左にソース、真ん中に通り道、右にすべてのレイヤーのすべてのノブ（とシーンの色）があります。ソースとノブには、それぞれ小さな丸（ポート）があります。

1. ソースの丸からノブの丸へドラッグします。その間に、ソースの色のケーブルが現れます。
2. ケーブルをタップ（または行の名前をタップ）すると設定が開きます。ノブをどれだけ動かすか、どれだけなめらかにするか、どんな形にするかを決めます。
3. ケーブルの端をドラッグして別の丸に移すと、つなぎ替えられます。
4. ケーブルを削除するには、ケーブルを開いてゴミ箱をタップし、もう一度タップして確定します。Mac では、選択して Backspace を押します。

1 つのノブに複数のケーブルをつなげます。その効果は足し合わされます。名前を長押しする（またはポインタを置く）と、短いヘルプが表示されます。つなぎ先にできるのは、エレメントのページで「Cable: yes」となっているノブだけです。

ヒント。エレメントはそれだけで音楽に反応するので、すべてのノブにケーブルをつなぐ必要はほとんどありません。レイヤーごとに、ねらいのはっきりしたケーブルを 1〜2 本つなぐほうが、10 本よりも効果的です。

ケーブルの働き

ケーブルをタップすると、小さなグラフ（ソースが淡く、結果が明るく、直近 3 秒分）と、次の設定が表示されます：

カーブ

カラーノブは少し違う動きをします。数値のソースは、色の一覧に沿ってノブを動かします。一覧はレイヤー自身のパレット、なければシーンの色、それもなければ色相環です。信号が最大のとき、Amount 1 で一覧を一周し、0.25 なら 4 分の 1 進みます。色のソース（色を参照）は、Amount の分だけノブをその色に近づけます。スイッチは、ケーブルの信号が 2 分の 1 を超えている間オンになります。

すべてのソース

ソースはグループに分かれていて、ウインドウにはこの順に並んでいます。特に断りがなければ、値はすべて 0 から 1 です。

音楽（リアルタイム）

これらは、曲、ラジオ、マイク、This Mac のすべてで使えます。

帯域（Bands）

スペクトルは 64 の帯域に分かれています。帯域 0 がいちばん低い低音（約 30 Hz）、帯域 63 がいちばん高い高音（約 16 kHz）です。Bands のソースは連続した帯域を平均したもので、各帯域はそれぞれの最近の範囲に合わせて調整されるので、小さな帯域も動きます。ウインドウには 12 個が用意されています。ほかの範囲を使いたいときは、シーンファイルで指定します（bands:A-B）。

曲の構成

これらを使うには、Nebula が曲の組み立てを知っている必要があります。自分の曲なら Nebula が解析したあと（Nebulaが曲を聴き取るしくみを参照）、ラジオの曲なら先読みしたか記憶している曲です。それまでの間とマイクでは 0 のままです。

ランダム

テンポがないとき（たとえばマイク）は、random:smooth は 1 秒に 2 つの値で動き続けます。

Numbers（ビートごとのステップ）

Numbers のソースは、選んだ数を 1 ビートに 1 つずつ数えていき、ノブをその数に直接設定します。単位はノブ自体の単位です。Amount は使いません。ウインドウの Numbers の欄にソースを入力すると（たとえば 1-5:1）、つなげられる行として現れます。

書き方

詳しい形式は low-high:step で、そのあとに必要なら :random（ランダムなステップ）、:seed（整数）、/bar または /beat を付けます。範囲を逆に書いても（5-1:1）Nebula が入れ替えます。ステップは 0 より大きく、値の数が 1000 個以下でなければなりません。ソースは最大 64 文字で、スペースは無視されます。

ウインドウでは、自分で作った Numbers に Edit と × が表示されます。Edit はソースを変更し、ケーブルはノブにつないだまま残します。削除するとソースとそのケーブルが消えます。

ヒント。Numbers は、エミッターの数のように整数で段階が変わるノブや、1 小節ごとに見た目を切り替えたいときにぴったりです。

Time（曲の秒数）

Time のソースは、ビートではなく曲の時間の秒数に沿って変わります。これもノブを直接設定します（Amount は使いません）。Time の欄に入力します。ウインドウには最初から 0-1:gate/4s,4s、0-1:tri/30s、0-1:ramp/30s が用意されています。

オプション

• 範囲。前に low-high: を付けます。たとえば 0.2-0.8:tri/30s。付けないと、ノブの全範囲を使います。1-0:ramp/20s のような高い値から低い値への範囲はそのまま使われ、下向きに動きます。
• 遅れて始める。最後に @30s を付けます。たとえば 0-1:gate/3s,7s@30s や ramp/20s@10s。それまでは低い値のままです。
• 長さは 0.1〜3600 秒で、どれも s で終わります。0s を使えるのは ramp だけです。
• 全部入りの例：0.3-1:gate/2.5s,12s@45s は、最初の 45 秒はオフ（0.3）、その後は 14.5 秒ごとに 2.5 秒オン（1）になります。

時計の進み方

曲の時間は、音楽を一時停止すると止まり、曲の中で位置を移動するとそれに合わせ、新しい曲になるたびに 0 から始まります。シーンを変えてもリセットされません。

ヒント。Time のソースはゆっくりしたシーンに向いています。ramp/60s で 1 分かけてレイヤーをフェードインしたり、tri/90s で色をゆっくり変えたり、ゲートで 30 秒ごとに数秒だけレイヤーを光らせたりできます。

色

カラーノブにつなぐと、色のソースは Amount の分だけノブをその色に近づけます。ほかのノブにつなぐと、その色の明るさを渡します。

レイヤーの出力と下のレイヤー

レイヤーの出力。信号を出すエレメントがあります。たとえば Fireflies の burst です。エレメントのページで、そのエレメントの下に載っています。シーンファイルでは layer:<number>:<output> と書き、レイヤーは上から 0 から数えます。layer:1:burst を別のレイヤーの明るさにつなぐと、群れと一緒に光ります。

下のレイヤー。あるレイヤーの下にあるレイヤーが作り出しているものを見ます：

いちばん下のレイヤーの下には何もないので、Layers below のソースはありません。

計算式

数値のノブの場合：

knob = base + amount × shaped value × (knob max − knob min)

結果はノブの範囲内に収められます。base はノブ自体のスライダーの位置、shaped value は In from / In to とカーブを通したあとのソースです。ですから、音楽に合わせて上がってほしいノブは、上がる余地が残るよう base を低めにしておきます。たとえば Pin height は 0 から 2 なので、base 0.6、amount 0.4 なら 1.4 まで上がれます。1 つのノブに複数のケーブルがあれば足し合わされます。

Numbers と Time のソースはこれを使わず、ノブを自分の値に直接設定します。

レシピ

出発点です。好みで調整してください。「つなぐ」とは、ソースからノブへドラッグすることです。

シーンファイルの中では

シーンは .nebula ファイルとして保存され、ケーブルはその中にテキストで書かれています。AI アシスタントにシーンを書いてもらうときや、手で編集するときに役立ちます。ケーブルは次のように書きます：

{ "source": "bass", "target": { "layer": 0, "key": "height" },
  "amount": 0.25, "smooth": 0.2, "curve": "ease", "range": [0.1, 0.8], "threshold": 0.5 }

target.layer はレイヤーを上から数えたもの（0 がいちばん上のレイヤー）で、シーンの色（shift、speed、colour1 など）の場合は "scene" です。range は In from と In to と同じです。ソースの名前はこのページに出てくるものです。ソースを読み取れないケーブルや、レイヤーやノブが存在しないケーブルは、メッセージなしで読み飛ばされます。シーン › .nebula ファイルを見てください。