Variant Range

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

Parameters

Name	Type	Default	Range	Description / Options
キー key	Text	value	—	snapshot に書き込むキー名です
開始値 start	Float	0	-4096–4096 / step 0.01	範囲の開始値です
終了値 end	Float	1	-4096–4096 / step 0.01	範囲の終了値です
個数 count	Int	5	1–256	生成する variant の数です
値の型 value_type	Enum	Float	—	生成値を小数にするか整数にするかを選びます小数`Float` 整数`Int`

Overview

Batch-produces a list of numeric candidates, such as five steps from 0 to 1. It is an entry point to variant workflows: compare a parameter across several values, switch between them with variant_select, or batch-produce them with batch_render.

Usage tips

Start by using it as a comparison tool when you are unsure which brightness looks best. variant_range (5 steps) → variant_select (switch by index) lets you click through parameter variations side by side.
key names the destination parameter. When passing candidates to batch_render, it must match the destination variable name.
For a nonuniform sequence such as a quadratic curve, transform the values output with list_map.

Related nodes

seed_range — sibling node dedicated to seeds
variant_select — select and inspect one candidate
cartesian_product — expand combinations with another axis
batch_render — render the candidate list in a batch
list_map — make a numeric sequence nonlinear

Read this first

This node does not create one value.
It creates multiple candidates.
With count=5, it returns five candidates.

Understanding the outputs

Output	Contents	Use
`values`	Raw numbers	When you only need the numbers
`snapshots`	Application-ready `key=value` values	Pass candidates to `BatchRender` or downstream nodes
`variants`	Saved form with names and recipes attached to snapshots	Save, select, or display as a list
`recipe`	How the entire candidate set was made	Preserve how it was generated

Start with this example

Use these settings:

key = value
start = 0
end = 1
count = 5
value_type = Float

The range from 0 to 1 is divided into five values:

[0.0, 0.25, 0.5, 0.75, 1.0]

Value list

[0.0, 0.25, 0.5, 0.75, 1.0]

Snapshot list

[
  { "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 } }
]

Variant list

The first entry looks roughly like this:

{
  "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
}

Recipe

{
  "version": 1,
  "kind": "range",
  "label": "value",
  "parameters": {
    "key": "value",
    "start": 0.0,
    "end": 1.0,
    "count": 5,
    "value_type": "Float"
  }
}

Common uses

Sweep brightness or strength across five steps.
Switch through candidates one at a time with VariantSelect.
Use it as one axis of CartesianProduct.
Pass it to BatchRender for batch production.

Notes

With count=1, the node returns only start.
With count>1, it places values evenly from start through end.
With value_type=Int, each sample is rounded to an integer.
In Int mode, a narrow range with a large count can produce duplicate integers. Duplicates are retained for compatibility and a nonfatal Inspector warning is shown.
When connecting to BatchRender, set key to a variable name, a variable_ref node id, or nodeId:paramId.

Output Ports