概要
「0から1まで5段階」のような数値候補の一覧を量産するノードです。
バリアント機能の入り口で、パラメータを何通りにも振って見比べる・書き出す
ワークフロー(variant_select での切り替えや batch_render での量産)の
出発点になります。
使い方のポイント
- 「どの明るさが良いか迷う」時の比較ツールとして最初に覚えると使いどころが
分かりやすい:
variant_range(5段階) → variant_select(index で切替)で パラメータ違いをカチカチ見比べられる keyは適用先のパラメータを指す名前。batch_renderへ渡す場合は 適用先の変数名と一致させる必要がある- 等間隔以外の並び(二次カーブ等)が欲しければ
values出力をlist_mapで変換する
関連ノード
seed_range— seed 専用の姉妹ノードvariant_select— 候補から1件選んで確認cartesian_product— 他の軸との組み合わせ展開batch_render— 候補一覧の一括レンダリングlist_map— 数列の非線形化
まず大事なこと
- このノードは 1個の値を作るノードではありません
- 候補を複数作るノード です
count=5なら 5 件の候補を返します
出力の見方
| 出力 | 何が入るか | どう使うか |
|---|---|---|
values |
生の数値 | 数字だけ欲しい時 |
snapshots |
key=value の適用形式 |
BatchRender や後段へ候補を渡したい時 |
variants |
snapshot に名前や recipe を付けた保存形式 | 保存、選択、一覧表示したい時 |
recipe |
候補群全体の作り方 | どう生成したかを残したい時 |
まずはこの例
次の設定にします。
key = valuestart = 0end = 1count = 5value_type = Float
このとき、0 から 1 までを 5 個に分けるので、作られる値はこうなります。
[0.0, 0.25, 0.5, 0.75, 1.0]
値一覧
[0.0, 0.25, 0.5, 0.75, 1.0]
スナップショット一覧
[
{ "version": 1, "values": { "value": 0.0 } },
{ "version": 1, "values": { "value": 0.25 } },
{ "version": 1, "values": { "value": 0.5 } },
{ "version": 1, "values": { "value": 0.75 } },
{ "version": 1, "values": { "value": 1.0 } }
]
バリアント一覧
1 件目はだいたいこうなります。
{
"version": 1,
"id": "range:value:0",
"name": "value=0.000",
"favorite": false,
"snapshot": {
"version": 1,
"values": { "value": 0.0 }
},
"recipe": {
"version": 1,
"kind": "range",
"label": "value",
"parameters": {
"key": "value",
"start": 0.0,
"end": 1.0,
"count": 5,
"value_type": "Float"
}
},
"note": null
}
レシピ
{
"version": 1,
"kind": "range",
"label": "value",
"parameters": {
"key": "value",
"start": 0.0,
"end": 1.0,
"count": 5,
"value_type": "Float"
}
}
よくある使い方
- 明るさや強度を 5 段階で振る
VariantSelectで 1 件ずつ切り替えるCartesianProductの片側として使うBatchRenderに渡して量産する
注意
count=1の時はstartだけを返しますcount>1の時はstartからendまでを等間隔に並べますvalue_type=Intの時は各サンプルを四捨五入して整数化しますvalue_type=Intでは、狭い範囲に対してcountが多いと同じ整数候補が 複数できます。互換性のため重複は残し、Inspectorに非致命的な警告を表示しますBatchRenderへつなぐ時は、keyを変数名、variable_refノード id、またはnodeId:paramIdに合わせます