Back to Node List

Variant Select

variant_select

Selects one variant record and exposes its snapshot and metadata

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
バリアント一覧
variants
List<VariantRecord>
Required
選択元の variant record 一覧です

Output Ports

NameTypeDescription
レコード
record
VariantRecord
選ばれた variant record です
スナップショット
snapshot
VariantSnapshot
選ばれた record の snapshot です
レシピ
recipe
VariantRecipe
選ばれた record に recipe があれば返します
値マップ
values
Map
snapshot の値を展開したマップです
名前
name
Text
選ばれた record の名前です
お気に入り
favorite
Bool
選ばれた record が favorite かどうかです
候補数
count
Int
選択元の候補数です

Parameters

NameTypeDefaultRangeDescription / Options
インデックス
index
Int
00–1024

選ぶ variant の番号です。範囲外の値は先頭/末尾にクランプされます

まず大事なこと

  • VariantSelect は、候補を 1 件だけ選ぶ ノードです
  • ただし 1 件選ぶだけでなく、その候補を 見やすい形に分解して返す のがポイントです

出力の見方

出力 何が入るか どう使うか
record 候補の完全な保存形 保存 UI や名前付き運用
snapshot key=value の軽い形 BatchRender など後段へ渡す
values snapshot の中身だけを展開した Map 値だけ見たい時
name 候補名 一覧表示やラベル表示
favorite お気に入り状態 UI 表示や管理
count 候補総数 インデックス制御や表示

まずはこの例

前段に VariantRange を置いて、次の設定で候補を作ったとします。

  • key = value
  • start = 0
  • end = 1
  • count = 5

候補はこうです。

[0.0, 0.25, 0.5, 0.75, 1.0]

ここで VariantSelect.index = 2 にすると、3 件目の 0.5 が選ばれます。

record

{
  "version": 1,
  "id": "range:value:2",
  "name": "value=0.500",
  "favorite": false,
  "snapshot": {
    "version": 1,
    "values": { "value": 0.5 }
  },
  "recipe": {
    "version": 1,
    "kind": "range",
    "label": "value",
    "parameters": {
      "key": "value",
      "start": 0.0,
      "end": 1.0,
      "count": 5,
      "value_type": "Float"
    }
  },
  "note": null
}

snapshot

{
  "version": 1,
  "values": { "value": 0.5 }
}

values

{ "value": 0.5 }

name / favorite / count

name = "value=0.500"
favorite = false
count = 5

よくある使い方

  • VariantRangeSeedRange で作った候補から 1 件選ぶ
  • index を動かして候補を見比べる
  • values を downstream へ渡して値だけ使う

注意

  • 入力候補数に応じて Inspector の index 上限が自動調整されます
  • 空リストの場合は count=0 だけ返し、他出力は流しません
Back to Node List
Variant Select — PixPipeline Node Reference