メインコンテンツまでスキップ
バージョン: 2.0.0-preview

ノードグラフ

ノードベースの描画オブジェクト(ノードグラフ系の描画オブジェクトやフィルターエフェクト)の ノードを配置・接続して編集 するためのタブです。 ノードを追加・移動・削除し、ポート同士を線で繋いで処理の流れを組み立てます。

タブの特性​

  • デフォルトで開く: いいえ
  • 複数同時に開く: できる(編集対象のグラフごとに別タブとして開けます)

開き方​

開き方は 2 通りあります。

  • メニューバーの 「表示」→「ツール」→「ノードグラフ」 から、現在選択している要素のノードグラフを開きます。
  • プロパティタブで、ノードベースの描画オブジェクトやフィルターエフェクトが持つグラフプロパティの 「タブで開く」 ボタンからも、同じグラフをこのタブで開けます。

プロパティと接続した出力ポートを持つノード

画面構成​

  • パンくずバー(上部): 現在編集しているグラフの階層を表示します。グループノードに入った後、項目をクリックすると親のグラフへ戻れます。
  • グラフパネル(中央): ドット模様の背景の上にノードと接続線を配置する作業領域です。背景はパンとズームに合わせてスクロールします。
  • 選択範囲オーバーレイ: 矩形選択中だけ、半透明の青い枠が表示されます。

ノードの追加​

右クリックメニューから追加​

グラフパネル上の何もない場所を右クリックすると、以下が表示されます。

  • ノードを追加: 登録済みのノードがカテゴリ別のサブメニューで一覧表示されます。選んだ位置にノードが配置されます。
  • ズームをリセット: グラフパネルの拡大率を 100% に戻します。

ドラッグ&ドロップで追加​

ライブラリのノード項目をグラフパネルへドロップすると、ドロップ位置にそのノードが追加されます。

ノードの操作​

各ノードは、上部に色付きのヘッダーがあり、その下にポートやプロパティエディタ、モニター項目が並びます。

ヘッダー​

  • 展開トグル(左の矢印): ノードの中身(ポートとプロパティ)の表示/非表示を切り替えます。畳んだ状態では、接続線はノードの中央左右からまとめて出ます。
  • 名前: 中央にノード名を表示します。名前が空のときは登録時の表示名が使われます。
  • 開くボタン(右、グループノードのみ): グループノードの内側のグラフへ移動します。パンくずバーが更新され、戻るときはパンくずをクリックします。

移動​

  • ヘッダーを左ドラッグでノードを移動します。
  • 複数のノードを選択していれば、選択中のすべてのノードが一緒に動きます。
  • ドラッグ中のノードは前面に持ち上がり、リリース後に元の重なり順に戻ります。

選択​

  • ヘッダーをクリックするとそのノードが単一選択になります。
  • Ctrl + クリックで選択を追加/解除できます。
  • グラフパネルの何もない場所を Ctrl + ドラッグ すると、矩形範囲で複数のノードを一括選択します。

右クリックメニュー(ヘッダー)​

  • 削除 (Delete): ノードと、そのノードに繋がる接続をすべて削除します。
  • リネーム: ノード名を編集するフライアウトを開きます。

ポートと接続の操作​

ノード内の各行の左右端にある小さい円形がポートです。色は値の型に応じて変わり、何かに繋がっているときは塗りつぶされ、未接続のときは薄い色で表示されます。

接続する​

  • ポートを左ドラッグしてワイヤーを引き、相手のポートを表示している行のどこか(ラベル、値の入力欄、行の空白部分、入れ子の行のインデント)で離すと接続されます。接続できるポートの上では、ワイヤーの先端がそのポートの円に吸い付くので、離す前にどこへ繋がるかが分かります。
  • 入力と出力の組み合わせのみ繋がります。型が違っても自動変換が試みられ、変換できないときは接続線がエラー色になります。
  • ポートのない行、無効なポート、すでに接続のある入力、ノードのタイトルバーにはワイヤーを繋げません。展開したエディターはヘッダーがその行になるので、自身のポートを持たないリスト項目の上で離しても何も繋がりません。
  • ノードの出力を自身の入力に繋ぐなど、循環になる接続は拒否されます。
  • macOS のトラックパッドでは、接続できるポートにワイヤーが吸い付くと触覚フィードバックが返ります。

切断する​

  • ポートを ダブルクリック すると、そのポートに繋がっているすべての接続を切断します。
  • ポートの右クリックメニューから 切断(接続をすべて削除)を選べます。

接続線の色​

接続線は接続状態に応じて色が変わります。

  • 未接続(ドラッグ中のみ): 通常色
  • 接続済み・成功: 緑系
  • 型変換あり: 黄色系
  • エラー: 赤系

動的ポート(追加可能なポート)​

グループノードや一部のノードには、動的に増減できるポートがあります。空のプレースホルダーポートが用意されており、相手ポートからドラッグして接続するとポートが新しく追加されます。

ポートの右クリックメニュー(動的ポートのとき)

  • 削除: そのポートを削除します。繋がっていた接続も切れます。
  • リネーム: ポート名を変更します。

リスト型のポート​

複数の接続を順序付きで受け取るリスト型のポートでは、接続ごとに別々のポイントが縦に並びます。

  • リスト型ポートの行やスロットの上で離したワイヤーは、新しい接続が入るスロットの後ろの空き位置に吸い付きます。
  • 縦方向のドラッグで、リスト内の接続スロットの順序を入れ替えます。
  • 横方向のドラッグで、その接続を 1 回の取り消し単位で別の出力に繋ぎ直します。接続はリスト内の位置を保ち、繋ぎ先が受け付けない場合はスロットの接続は元のままです。
  • ダブルクリックで、その接続だけを切断します。

入れ子のプロパティとノードの案内​

オブジェクトの入れ子になったプロパティにも入力ポートを追加できます。ポートを空白部分へドラッグして離すと、互換性のあるノードの追加メニューが開きます。ポートのラベルにマウスを乗せると、説明・型・プロパティの範囲を確認できます。

拡張機能の不足などで読み込めないノードはフォールバックとして表示されます。元のデータを保った状態で表示するため、利用できないノードを通常の実行可能なノードとして扱わないでください。

AI生成ノード​

AI生成 カテゴリーには プロンプト、画像を生成、画像を編集、動画を生成、動画を編集 があります。プロンプトノードで指示、スタイル、構図、動き、除外事項を組み立て、複数の生成ノードに共有できます。

通常のプレビューや再生は保存済みの生成結果を表示し、課金されるリクエストを自動的には送信しません。キャンバスのメニューの AIノードを実行 で明示的に開始し、停止 で中断します。上流の依存ノードから順番に実行し、リクエスト全体が変わっていない結果は再利用します。明示的な再生成はその対象を新しく生成します。

生成ノードでは履歴から結果を選び、固定や整理、バリエーションの比較を行えます。生成結果の変更は取り消し履歴に記録されます。グループはテンプレートとして保存し、空白部分の テンプレート メニューから再利用できます。

動画生成・編集ノードは VideoSource を出力します。表示するには動画ソースノードの Source に接続し、時間入力と出力を描画の流れにつなぎます。利用できるモデルや入力条件はアカウントとモデルに依存します。AIワークスペースも参照してください。

シェーダーノード​

シェーダー カテゴリーには、C# を書かずにシェーダーグラフ(画像を読み書きする GPU のパス)を組み立てるノードがあります。ほとんどのシェーダーは、ノードグラフ(エフェクト)の エフェクト入力 と グラフ出力 の間にパスを 1 つ置くだけで作れます。

  1. シェーダー から 全画面パス (GLSL) を追加します。
  2. エフェクト入力 をパスの source サンプラーに、パスの color 出力を グラフ出力 に接続します。
  3. パスの コード を編集します。Tab でタブ文字を入力できます。最初のコードは入力をそのまま出力します。
#version 450
layout(location = 0) in vec2 uv;
layout(location = 0) out vec4 color;
layout(set = 0, binding = 0) uniform sampler2D source;

void main() {
color = texture(source, uv);
}

パスのコードがポートを決めます。 パスは GLSL をコンパイルし、見つかった宣言をポートとして表示します。サンプラー、画像、バッファはワイヤーのポート、ブロックのメンバーと特殊化定数は値のポート、書き込む先は出力になります。名前と型が変わらない限り、ポートは値と接続を保ちます。コンパイルできないコードでは、すべてのポートと接続を保ったまま、ノードにコンパイラーのメッセージを表示します。

ノードは次のように分類されています。

  • シェーダー: 全画面パス (GLSL)、コンピュートパス (GLSL)、描画パス (GLSL)、ジオメトリ・テッセレーション付き描画パス (GLSL)
  • リソース: 画像、固定サイズの画像、画像ビュー、バッファ、テキストからデータ、値をまとめる
  • 操作: 画像をクリア、バッファをクリア、画像をコピー、バッファをコピー、ミップマップを生成、色の解釈を変換
  • 反復: 繰り返し、シミュレーションを再生、反復の情報、反復の入力、反復の出力
  • パスへの入力: サンプリング、入力領域、画像の情報、ベクトル、色をvec4に
  • パスの設定: ブレンド、描画数、ディスパッチ、ラスタライザー、深度・ステンシル、ステンシル面、頂点バッファ、頂点属性、インデックスバッファ、出力の初期内容、部分描画、部分画像。パスの 設定 ポートに接続します。

シェーダーグラフの動作は次のとおりです。

  • 接続によって実行内容が決まります。 ワイヤーはレシピを運び、絵に届いた時点で評価されるので、どこにも繋がっていないノードは何も記録しません。順序を指定するポートはありません。
  • 絵と画像のワイヤーは直接繋がります。 エフェクト入力 などの絵はパスのサンプラーに、パスの出力は グラフ出力 など絵を受け取る入力に直接繋がります。これらのワイヤーは型変換ありの色で表示されます。グラフが最初に読む絵がソースで、出力が覆う範囲を決めます。ほかの絵はソースに位置を揃えます。繋いでいないサンプラーはソースを読みます。描画先 は画像のワイヤーだけを受け取り、絵を繋ぐとワイヤーが赤くなります。
  • uv はすべての入力を同じ位置で読みます。 覆う範囲が違う入力は、パスの出力に揃えたコピーを使うので、出力に余白を付けても入力の位置はずれません。固定サイズの画像、メッシュ、画像の情報 に繋いだパスは、それぞれの座標を保ちます。
  • 反復はグループです。 繰り返し と シミュレーションを再生 は中身を反復ごとに評価し、各状態の出力は同じ位置の状態の入力に渡ります。シミュレーションの再生は開始時刻から一定の刻みで計算し直すので、シークしても再生したときと同じ絵になり、プレビューでも書き出しでも同じです。毎フレーム計算し直し、100,000 ステップを超えるとノードは実行せずにエラーを表示します。反復の中で余白を付けると反復ごとに大きくなるので、余白は反復の前で付けます。
  • 失敗はノードに表示されます。 コードや接続の誤りは、グラフを記録した時点でノードに表示されます。macOS でのジオメトリステージや上限を超える画像など、GPU だけが拒否できる失敗は、出力が絵になったノード、またはグループの出力に届く中のノードに表示されます。ワイヤーは赤くなり、そのグラフは何も描画せず、フレームのほかの部分は描画されます。書き出しも止まりません。
  • 部分描画と部分画像。 部分描画 を使うと、パスは出力のうちフレームに必要な部分だけを描画し、入力領域 で出力の各ピクセルが入力のどの部分を読むかを指定できます。部分画像 ではさらに、パスの画像がその部分だけを持つので、大きな繰り返し配置のグリッドのようにフレームよりはるかに広い絵でも解像度を保ちます。このときパスは、各ピクセルの位置を 画像の情報 から求める必要があります。余白のないパスなら最初のコードはそのまま動き、入力領域のない入力は全体のままです。

モニターノード​

実行結果を可視化するモニター系のノードでは、編集中のグラフの値が次のように表示されます。

  • テキスト表示: 等幅フォントで現在の値をそのまま表示します。
  • 画像表示: ノード内に最大 200×200 のサムネイルとして描画されます。

再生中はパフォーマンスのためにモニターの更新は止まり、ノードを 展開している ときだけ更新されます。

グラフパネルの操作​

マウス​

  • 何もない場所を 左ドラッグ でグラフ全体をパンします。
  • ホイールでズームイン/アウト(ポインタ位置を中心に拡大)します。
  • タッチパッドのスクロールでパンし、ピンチでズームできます。

キーボード​

  • ノード選択中に Delete キーで選択ノードを削除します(コンテキストメニューと同じ動作)。

グループノードのナビゲーション​

グループノードは、内側に独自のノードグラフを持ちます。

  • ノードヘッダー右の 開くボタンでグループの内側に入ります。タブ上部のパンくずバーが 1 段深くなります。
  • パンくずバーの上位項目をクリックすると、その階層へ戻ります。それより下の階層は閉じられます。
  • グループの内側には、グループの入力・出力に対応する専用ノードがあり、それぞれ 1 個までしか配置できません。

状態の保存​

ノードの位置・展開状態・グラフのパン/ズーム位置は、シーンを閉じても保持されます。次回タブを開いたときに、最後に表示していたグラフ階層と表示状態が復元されます。

関連ドキュメント​

ソース​