ノード一覧に戻る

バリアント範囲

variant_range

数値範囲から variant record を量産します

下書き
解説あり

出力ポート

名前説明
バリアント一覧
variants
List<VariantRecord>
生成した variant record 一覧です
スナップショット一覧
snapshots
List<VariantSnapshot>
生成した variant snapshot 一覧です
レシピ
recipe
VariantRecipe
共通の生成レシピです
値一覧
values
List<Number>
生成した数値一覧です
個数
count
Int
生成した variant 数です

パラメータ

名前既定値範囲説明・選択肢
キー
key
Text
value

snapshot に書き込むキー名です

開始値
start
Float
0-4096–4096 / step 0.01

範囲の開始値です

終了値
end
Float
1-4096–4096 / step 0.01

範囲の終了値です

個数
count
Int
51–256

生成する variant の数です

値の型
value_type
Enum
Float

生成値を小数にするか整数にするかを選びます

  • 小数Float
  • 整数Int

まず大事なこと

  • このノードは 1個の値を作るノードではありません
  • 候補を複数作るノード です
  • count=5 なら 5 件の候補を返します

出力の見方

出力 何が入るか どう使うか
values 生の数値 数字だけ欲しい時
snapshots key=value の適用形式 BatchRender や後段へ候補を渡したい時
variants snapshot に名前や recipe を付けた保存形式 保存、選択、一覧表示したい時
recipe 候補群全体の作り方 どう生成したかを残したい時

まずはこの例

次の設定にします。

  • key = value
  • start = 0
  • end = 1
  • count = 5
  • value_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 の時は各サンプルを四捨五入して整数化します
  • BatchRender へつなぐ時は、key を変数名、variable_ref ノード id、または nodeId:paramId に合わせます
ノード一覧に戻る
バリアント範囲 — PixPipeline ノード解説