Back to Node List

Snapshot Node

snapshot_node

Stores the current result as a comparison snapshot without stopping live evaluation

Draft
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
入力
input
Any
live 出力として流しつつ、必要に応じて保存する現在値です

Output Ports

NameTypeDescription
出力
output
Any
現在の live 入力です
スナップショット
snapshot
Any
保存済みのスナップショット値です
保存済み
has_snapshot
Bool
スナップショットが保存されているかです
状態
status
Text
Snapshot 状態の要約です

Parameters

NameTypeDefaultRangeDescription / Options
保存データ
snapshot_data
CustomData

内部保存用の Snapshot データです

まず大事なこと

  • Snapshot比較用 です
  • BakeFreeze と違って、再評価は止めません
  • 保存した値と live current を見比べるためのノードです
  • 一番よく使う場面は、before / after 比較の基準を残したい時です

どういう時に使うか

  • 変更前の結果を 1 回保存して、あとで見比べたい時
  • 色調整や filter 調整の前後差を比較したい時
  • キーフレームや procedural 結果の変化をチェックしたい時
  • 「今の良い状態」を比較用の基準として残したい時

どういう時には向かないか

  • 再評価自体を止めたい時
    • BakeSubgraphFreezeNode を使います
  • この時の graph 設定へ戻したい時
    • SnapshotNode は結果の保存であって、設定の保存ではありません
    • その用途は PresetVariant の方が自然です

使い方

  1. 比較したい結果の出口に SnapshotNode を置きます
  2. Inspector で 取得 を押します
  3. output は live current、snapshot は保存値になります
  4. Preview compare で current と snapshot を見比べます
  5. 比較基準を更新したい時は 再取得 を押します

  • PixelCanvas -> Brightness -> SnapshotNode -> Preview

1回目に 取得 すると、その時点の明るさ結果が snapshot に入ります。
そのあと Brightness を変えると、

  • output
    • 今の新しい結果
  • snapshot
    • 前に保存した結果

になります。

つまり、before / after 比較に向いています。

何が保存されるか

  • 保存されるのは その時点の出力結果 です
  • 画像なら画像、Path なら Path、数値なら数値が保存されます
  • upstream のノード設定そのものは保存していません

つまり、SnapshotNode で「見た目は戻せる」ことはあっても、設定状態そのものを復元するノードではありません

よくある使い方

  • Brightness を触る前に 取得
  • 調整後に current と snapshot を compare
  • 気に入らなければ Preset / Variant 側で状態管理する

という使い分けが一番自然です。

Bake / Freeze との違い

  • Snapshot
    • 比較用
    • 再評価は止めない
  • Freeze
    • 一時固定
    • active の間は再評価を止める
  • Bake
    • 焼いた成果物として使う

注意

  • preview compare で比較しやすいよう、snapshot は専用 compare 候補にも出ます
  • v1 は checkpoint 用の最小構成です
  • SnapshotNode だけでは upstream の設定値には戻せません
  • 「この時の設定へ戻したい」は Preset / Variant の担当だと考えると混乱しにくいです
Back to Node List
Snapshot Node — PixPipeline Node Reference