バリアント選択

名前	型	説明
バリアント一覧 variants	List<VariantRecord> 必須	選択元の variant record 一覧です

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

パラメータ

名前	型	既定値	範囲	説明・選択肢
インデックス index	Int	0	0–1024	選ぶ variant の番号です。範囲外の値は先頭/末尾にクランプされます

概要

バリアント候補の一覧から1件を番号で選んで取り出すノードです。 variant_range / seed_range が作った候補を index でカチカチ切り替えて、「どの値が良いか」を目で見比べるのが主な仕事です。

使い方のポイント

比較検討の基本形: variant_range → variant_select → variant_value_get → 値を使う側。index を回して選び、snapshotのキーを型付き値へ戻して適用する
値だけ欲しいなら values 出力(Map)が手軽。名前やお気に入り状態も一緒に出るので、候補管理UIのような使い方もできる
全候補を一括で出したいなら batch_render。variant_select は「1件ずつ確認する」側の道具

まず大事なこと

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

よくある使い方

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

注意

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

入力ポート

出力ポート