候補選択

value_select

同じ型の複数入力から、番号で 1 つを選んで次へ流します

確認済み

解説あり

入力ポート

名前	型	説明
候補 0 item_0	Number	選択候補 0
候補 1 item_1	Number	選択候補 1
候補 2 item_2	Number	選択候補 2
候補 3 item_3	Number	選択候補 3

出力ポート

名前	型	説明
値 value	Number	選ばれた値です

パラメータ

名前型既定値範囲説明・選択肢

名前	型	既定値	範囲	説明・選択肢
候補の型 value_type	Enum	Number	—	このノードで選ぶ候補の型を指定します。全候補は同じ型で接続してください。数値（汎用）`Number` このノードで数値（汎用）型の値を扱います小数`Float` このノードで小数型の値を扱います整数`Int` このノードで整数型の値を扱います ON/OFF`Bool` このノードでON/OFF型の値を扱います色`Color` このノードで色型の値を扱います文字`Text` このノードで文字型の値を扱います画像`Image` このノードで画像型の値を扱いますパス`Path` このノードでパス型の値を扱いますピクセル線`PixelLine` このノードでピクセル線型の値を扱います Vec2`Vec2` このノードでVec2型の値を扱います Vec3`Vec3` このノードでVec3型の値を扱います OKLCH補正`OklchAdjust` このノードでOKLCH補正型の値を扱いますパレット`Palette` このノードでパレット型の値を扱いますリスト`List` このノードでリスト型の値を扱いますマップ`Map` このノードでマップ型の値を扱います文字レイアウト`TextLayout` このノードで文字レイアウト型の値を扱いますピクセルパッチ`PixelPatch` このノードでピクセルパッチ型の値を扱います記録レイヤー`RecordedLayer` このノードで記録レイヤー型の値を扱いますアニメーションクリップ`AnimationClip` このノードでアニメーションクリップ型の値を扱います Asepriteファイル`AsepriteFile` このノードでAsepriteファイル型の値を扱いますルールグリッド`RuleGridSpec` このノードでルールグリッド型の値を扱いますルールタイルセット`RuleTileSet` このノードでルールタイルセット型の値を扱いますルールタイル素材`RuleTileAsset` このノードでルールタイル素材型の値を扱いますルールセット`RuleSet` このノードでルールセット型の値を扱いますルールキャンバス`RuleCanvas` このノードでルールキャンバス型の値を扱います解決済みルール配置`RuleResolved` このノードで解決済みルール配置型の値を扱いますルールタイルアトラス`RuleTileAtlas` このノードでルールタイルアトラス型の値を扱います 9スライス`NineSlice` このノードで9スライス型の値を扱います 2D FX 状態`FxState2D` このノードで2D FX 状態型の値を扱いますスプライトシート`SpriteSheet` このノードでスプライトシート型の値を扱いますバリアントスナップショット`VariantSnapshot` このノードでバリアントスナップショット型の値を扱いますバリアントレシピ`VariantRecipe` このノードでバリアントレシピ型の値を扱いますバリアントレコード`VariantRecord` このノードでバリアントレコード型の値を扱います IsoItem`IsoItem` このノードでIsoItem型の値を扱います IsoScene`IsoScene` このノードでIsoScene型の値を扱います IsoWorld`IsoWorld` このノードでIsoWorld型の値を扱いますタイル素材`TileAsset` このノードでタイル素材型の値を扱いますタイルパレット`TilePalette` このノードでタイルパレット型の値を扱いますタイルマップ`TileCanvas` このノードでタイルマップ型の値を扱います解決済みタイル配置`TileResolved` このノードで解決済みタイル配置型の値を扱います Any（上級者向け）`Any` 上級者向けです。どの値型でも扱えますが、下流ノードの期待と合わないと実行時エラーになります。
候補数 count	Int	4	1–16	入力候補スロットの数です
選択番号 index	Int	0	0–15	次へ流す候補番号です。入力ピン化して外部から動かせます。範囲外は先頭/末尾に丸めます。

候補の型

value_type

Enum

Number

—

このノードで選ぶ候補の型を指定します。全候補は同じ型で接続してください。

数値（汎用）Number
このノードで数値（汎用）型の値を扱います
小数Float
このノードで小数型の値を扱います
整数Int
このノードで整数型の値を扱います
ON/OFFBool
このノードでON/OFF型の値を扱います
色Color
このノードで色型の値を扱います
文字Text
このノードで文字型の値を扱います
画像Image
このノードで画像型の値を扱います
パスPath
このノードでパス型の値を扱います
ピクセル線PixelLine
このノードでピクセル線型の値を扱います
Vec2Vec2
このノードでVec2型の値を扱います
Vec3Vec3
このノードでVec3型の値を扱います
OKLCH補正OklchAdjust
このノードでOKLCH補正型の値を扱います
パレットPalette
このノードでパレット型の値を扱います
リストList
このノードでリスト型の値を扱います
マップMap
このノードでマップ型の値を扱います
文字レイアウトTextLayout
このノードで文字レイアウト型の値を扱います
ピクセルパッチPixelPatch
このノードでピクセルパッチ型の値を扱います
記録レイヤーRecordedLayer
このノードで記録レイヤー型の値を扱います
アニメーションクリップAnimationClip
このノードでアニメーションクリップ型の値を扱います
AsepriteファイルAsepriteFile
このノードでAsepriteファイル型の値を扱います
ルールグリッドRuleGridSpec
このノードでルールグリッド型の値を扱います
ルールタイルセットRuleTileSet
このノードでルールタイルセット型の値を扱います
ルールタイル素材RuleTileAsset
このノードでルールタイル素材型の値を扱います
ルールセットRuleSet
このノードでルールセット型の値を扱います
ルールキャンバスRuleCanvas
このノードでルールキャンバス型の値を扱います
解決済みルール配置RuleResolved
このノードで解決済みルール配置型の値を扱います
ルールタイルアトラスRuleTileAtlas
このノードでルールタイルアトラス型の値を扱います
9スライスNineSlice
このノードで9スライス型の値を扱います
2D FX 状態FxState2D
このノードで2D FX 状態型の値を扱います
スプライトシートSpriteSheet
このノードでスプライトシート型の値を扱います
バリアントスナップショットVariantSnapshot
このノードでバリアントスナップショット型の値を扱います
バリアントレシピVariantRecipe
このノードでバリアントレシピ型の値を扱います
バリアントレコードVariantRecord
このノードでバリアントレコード型の値を扱います
IsoItemIsoItem
このノードでIsoItem型の値を扱います
IsoSceneIsoScene
このノードでIsoScene型の値を扱います
IsoWorldIsoWorld
このノードでIsoWorld型の値を扱います
タイル素材TileAsset
このノードでタイル素材型の値を扱います
タイルパレットTilePalette
このノードでタイルパレット型の値を扱います
タイルマップTileCanvas
このノードでタイルマップ型の値を扱います
解決済みタイル配置TileResolved
このノードで解決済みタイル配置型の値を扱います
Any（上級者向け）Any
上級者向けです。どの値型でも扱えますが、下流ノードの期待と合わないと実行時エラーになります。

候補数

count

Int

1–16

入力候補スロットの数です

選択番号

index

Int

0–15

次へ流す候補番号です。入力ピン化して外部から動かせます。範囲外は先頭/末尾に丸めます。

まず何に使う？

作った画像バリエーションから 1 つを選んで後段へ流したい時
色、数値、パレットなどの候補を index で切り替えたい時
index を入力ピン化して、時間や数値ノードからアニメーション的に候補を切り替えたい時

概要

複数の候補から番号で1つ選ぶ「N択スイッチ」です。二択の switch を拡張した形で、画像バリエーションの選択やコマ送り式の切り替えに使います。

使い方のポイント

手動選択が基本形: 候補を並べて index で見比べる(色案・形案の比較検討)
index を📌入力ピン化して整数の波形・カウンタをつなぐと「候補を順番に切り替えるアニメーション」になる。小数が来る場合は math_func(Floor) で整数化してから
候補が動的・多数になるならリスト(list_create + list_get)の方がスケールする。value_select は「手で並べる少数の候補」向き

注意

index は 0 始まりです。index = 2 なら item_2 を選びます。
index が範囲外の場合は、先頭または末尾にクランプされます。
選ばれた入力が未接続の場合は、まず item_0 にフォールバックします。item_0 も未接続なら、接続済みの最初の候補を使います。
接続済み候補が 1 つもない場合だけ、value は空出力になります。
value_type を変えると、候補入力と value 出力の型も一緒に変わります。
通常は全候補に同じ型を接続してください。
このノードは通常の評価ノードです。接続済みの候補枝はグラフ上の依存関係に入ります。未変更の候補はキャッシュされますが、未選択枝を完全に評価対象から外す Lazy Select ではありません。
Any は上級者向けです。接続自体は通っても、実際に選ばれた値の型が下流ノードの期待と合わないと、評価時に警告やノードエラーが出ます。

使用例

4 枚の画像候補から 1 枚を選ぶ
- value_type = Image
- item_0..item_3 に画像候補を接続
- index で採用候補を切り替えます
時間で画像を切り替える
- Time Source や数値ノードから index を入力ピン化して接続します
複数の色候補を切り替える
- value_type = Color
- 選ばれた色を後段のカラー入力へ渡します
パレット候補を切り替える
- value_type = Palette
- パレット違いの見た目比較に使えます