Back to Node List

Batch Export

batch_export

Writes a list of images (or a single image) to PNG files using a name pattern

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

Input Ports

NameTypeDescription
画像リスト
images
List<Image>
書き出す画像リストです(Batch Render の frames など)
画像
image
Image
1枚だけ書き出す時の画像入力です(リスト未接続時に使用)
名前リスト
names
List<Text>
{name} トークンに使う名前リストです(Batch Render の names など)

Output Ports

NameTypeDescription
画像
image
Image
書き出した画像のパススルーです(リスト時は先頭)。最終結果をノード上のプレビューで確認できます
保存数
count
Int
今回の評価で保存したファイル数です

Parameters

NameTypeDefaultRangeDescription / Options
保存フォルダ
directory
Text

保存先フォルダのパスです。相対パスはプロジェクトのフォルダを基準に解決され、無ければ自動で作られます

名前パターン
name_pattern
Text
export_{index}

ファイル名のパターンです。{name}(名前リスト)、{index}(0始まり)、{index1}(1始まり)が使えます。.png は自動で付きます

保存モード
save_mode
Enum
Disabled

どの条件で実際に保存するかを切り替えます。誤書き込み防止のため既定は無効です

  • 無効Disabled
    ファイルへ書き込みません。
  • 新規のみCreateIfMissing
    無いファイルだけ保存します。
  • 上書きOverwrite
    既存ファイルも上書き保存します。
拡大率
scale
Int
11–16

保存前に適用する整数倍のニアレスト拡大です

概要

  • 副作用: あり(ファイル書き込み。並列評価から除外されます)

P15 の batch export 統合ノードです。バッチレンダーframes / names をつなぐと variant 一括出力になります。書き出しプロファイル(保存先・名前パターン・保存モード・拡大率)はこのノードのパラメータとして保持され、プロジェクトと一緒に保存されます。

技術詳細

  • save_mode: Disabled または directory 未設定の間は一切書き込みません
  • 名前リストの値はファイル名に使えない文字を _ に置換して使います
  • CreateIfMissing は既存ファイルをスキップします(差分だけ吐き足す運用向け)

使用例

Batch Render の一括出力

[Seed Range] → [Batch Render] ─ frames → [Batch Export]
                        └ names ─────────↑

name_pattern: {name} にすると variant 名がそのままファイル名になります。

完成画像の自動書き出し口

グラフ末端に image 入力でつなぎ、save_mode: Overwrite にすると評価のたびに最新PNGが保存されます。 ヘッドレス実行(--headless)の書き出し口としてもこのノードを使います。

Back to Node List
Batch Export — PixPipeline Node Reference