バッチレンダー

概要

「同じグラフからパラメータ違いを一括生成する」量産の中核ノードです。 variant_range などが作る候補リストを1件ずつグラフに適用して評価し、 色違い・シード違い・角度違いの画像群を1枚のスプライトシートにまとめます。 PixPipeline の強みであるバリエーション量産はこのノードで形になります。

まず大事なこと

• このノードは、items に入ってきた候補を 1 件ずつ適用して画像を作る ノードです
• 時間方向の反復をする AnimationRender とは違い、こちらは 候補方向の反復 です

何が起きるか

考え方はこうです。

1. items から 1 件選ぶ
2. その snapshot を graph に当てる
3. image 入力の結果を 1 枚レンダリングする
4. それを全件ぶん繰り返す
5. 全件が成功した時だけ frames と spritesheet を確定する

1件でも評価に失敗した場合は部分結果を返さず、バッチ全体が失敗します。

出力の見方

まずはこの例

たとえば次の graph を作ります。

• PixelCanvas
• Brightness
• VariantRange
• BatchRender

設定:

• VariantRange.key = strength
• VariantRange.start = 0
• VariantRange.end = 1
• VariantRange.count = 5
• Brightness の強度パラメータを変数 strength に bind
• PixelCanvas.image -> Brightness.image -> BatchRender.image
• VariantRange.variants -> BatchRender.items

このとき VariantRange 側の候補はこうです。

[
  { "snapshot": { "values": { "strength": 0.0 } } },
  { "snapshot": { "values": { "strength": 0.25 } } },
  { "snapshot": { "values": { "strength": 0.5 } } },
  { "snapshot": { "values": { "strength": 0.75 } } },
  { "snapshot": { "values": { "strength": 1.0 } } }
]

BatchRender はこれを 1 件ずつ graph に当てるので、明るさ違いの画像 5 枚が作られます。

records

[
  { "name": "strength=0.000", "snapshot": { "values": { "strength": 0.0 } } },
  { "name": "strength=0.250", "snapshot": { "values": { "strength": 0.25 } } },
  { "name": "strength=0.500", "snapshot": { "values": { "strength": 0.5 } } },
  { "name": "strength=0.750", "snapshot": { "values": { "strength": 0.75 } } },
  { "name": "strength=1.000", "snapshot": { "values": { "strength": 1.0 } } }
]

frames

[
  "<Image strength=0.0>",
  "<Image strength=0.25>",
  "<Image strength=0.5>",
  "<Image strength=0.75>",
  "<Image strength=1.0>"
]

count / frame_count

count = 5
frame_count = 5

2軸の組み合わせ例

CartesianProduct を前段に置くと、2軸の候補をそのまま batch できます。

例:

• VariantRange(key=strength, start=0, end=1, count=3)
• SeedRange(key=seed, start=10, count=2, step=1)
• CartesianProduct
• BatchRender

このとき組み合わせ数は 3 x 2 = 6 件です。

BatchRender は CartesianProduct の中に入っている snapshot をまとめて、実際にはこういう候補として扱います。

{
  "snapshot": {
    "values": {
      "strength": 0.0,
      "seed": 10
    }
  }
}

snapshot key の当て先

snapshot key は次の形式で graph へ当てます。

1. variable-bound param の変数IDまたは変数名
2. variable_ref ノードのID・変数ID・変数名
3. nodeId:paramId 形式の direct param

初心者向けには、まず 変数名に合わせる のが一番分かりやすいです。 direct param は、graph内に実在するフロントエンドのノードIDとパラメータIDを 大文字小文字も含めて正確に nodeId:paramId と書いた時だけ適用されます。

よくある失敗

• 全フレーム同じ画像になる: snapshot の key がグラフのどこにも当たっていない。 変数名(または nodeId:paramId)と VariantRange.key が一致しているか確認する
• animation_render と混同する: あちらは時間方向(同じ設定で全フレーム)、 こちらは候補方向(1候補=1枚)。歩きアニメの色違い量産のように両方必要な場合は 組み合わせて使う
• フレームサイズがバラつく: 上流に solid_render 等がある場合は frame_mode = FixedCanvas にして寸法を固定する(8方向素材の例を参照)
• 1件だけ失敗した: Batch Render はall-or-nothingです。成功分だけを返さず、 失敗した候補を直してから全件を再評価します

注意

• 各項目は VariantRecord に正規化されてから使われます
• ListZip / CartesianProduct が返す Map もそのまま渡せます
• index / a_index / b_index のような bookkeeping key は自動で無視します
• 異なる組み合わせ軸が同じsnapshot keyを書いた場合は、暗黙に上書きせず エラーになります。どちらを採用するか明示的に統合してください

Solid 8方向素材

Solid Render のカメラ方位角を45度刻みで量産する時は、VariantRange から direct param key を作るのが最短です。

設定例:

• Solid Render ノードID: render
• VariantRange.key = render:azimuth
• VariantRange.start = 0
• VariantRange.end = 315
• VariantRange.count = 8
• Solid Render.frame_mode = FixedCanvas
• Solid Render.camera_angle_snap = 45
• BatchRender.columns = 8

BatchRender は各 snapshot を1件ずつ graph に当てるため、8方向の画像を同じフレームサイズでまとめられます。

関連ノード

• variant_range / seed_range — 候補リストの生成元(このノードとほぼセット)
• cartesian_product — 2軸(色×シード等)の組み合わせ候補を作る
• batch_export — フレーム群をファイルとして書き出す
• animation_render — 時間方向の反復(アニメーション)はこちら