Yotsuba Games
Back to Node List

Variant Value Get

variant_value_get

Gets one typed value by key from a variant record, snapshot, or map

Reviewed
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Input Ports

NameTypeDescription
取得元
source
Any
Required
値を読むVariantRecord、VariantSnapshot、またはMapです

Output Ports

NameTypeDescription
値
value
Number
キーに保存された型付きの値です

Parameters

NameTypeDefaultRangeDescription / Options
キー
key
Text
value—

snapshotまたはMapから読むキーです

値の型
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
    上級者向けです。どの値型でも扱えますが、下流ノードの期待と合わないと実行時エラーになります。

Overview

Extracts one snapshot or Map entry as a normal typed output. It bridges a candidate chosen by Variant Select back into a parameter input on an image or processing node.

Basic workflow

  1. Set VariantRange.key to the value name you want to apply, such as amount.
  2. Connect VariantRange.variants to VariantSelect.variants.
  3. Connect VariantSelect.snapshot to VariantValueGet.source.
  4. Set VariantValueGet.key = amount.
  5. Choose the value_type required downstream and connect value to that parameter.

You can also connect VariantSelect.values and read the same key from its Map.

Notes

  • The source wire is typed as Any, but runtime input is restricted to VariantRecord, VariantSnapshot, or Map.
  • A missing key or a value that does not match value_type is an explicit error.
  • Number preserves either Float or Int. Selecting Float converts an Int value to Float.
  • Changing value_type synchronizes the concrete type of the value output port.

Related nodes

  • variant_select — choose one candidate and expose the source data
  • variant_range / seed_range — generate candidates
  • batch_render — evaluate all candidates in a batch

Related Nodes

Variant Selectvariant_selectVariant Rangevariant_rangeBatch Renderbatch_render
Back to Node List
Variant Value Get — PixPipeline Node Reference