画像の保存 (SaveImage)
概要 (What is it?)
SaveImage ノードは、画像をローカルファイルシステムに保存します。画像処理ワークフローの結果を永続化するための基本的かつ不可欠なノードであり、さまざまなファイル形式や品質設定で画像を書き出すことができます。
使用する場面 (When would I use it?)
以下のような場面でこのノードを使用します：
- 処理した画像をコンピュータのディスクに保存したい場合
- 特定の画像フォーマット（PNG、JPEG など）でエクスポートしたい場合
- 画質や圧縮レベルを指定して保存したい場合
- 画像処理パイプラインの成果物をファイルとして出力・共有したい場合
- 他の外部アプリケーションで使用するために画像を書き出したい場合
使い方 (How to use it)
基本セットアップ
- ワークフローに SaveImage ノードを追加します
- 保存したい画像ソースを "input_image" 入力に接続します
- 出力ファイルパスとフォーマットを設定します
- ノードが実行され、指定された場所に画像が保存されます
パラメータ一覧 (Parameters)
画像入力 (Image Input)
- input_image: 保存する対象の画像（任意の画像処理ノードから接続可能）
出力設定 (Output Settings)
-
output_path: 画像を保存するファイルパス
- 相対パス（例: "output/image.png"）または絶対パス（例: "C:/Users/username/Desktop/image.png"）を指定可能
- 拡張子とフォーマットを一致させます
-
image_format: 画像を保存するフォーマット
- PNG: 可逆圧縮、透過（アルファ）サポート
- JPEG: 非可逆圧縮、ファイルサイズがコンパクト
- BMP: 非圧縮ビットマップ
- TIFF: プロユース向け高品質フォーマット
品質設定 (Quality Settings - JPEG のみ)
- quality（1〜100、デフォルト: 95）: JPEG 圧縮品質
- 大きい値: 高画質、ファイルサイズ大
- 小さい値: 低画質、ファイルサイズ小
出力 (Outputs)
- saved_path: 画像が実際に保存された絶対パス
- file_size: 保存されたファイルのサイズ（バイト単位）
使用例 (Example)
一般的な画像保存ワークフローの例：
- AdjustImageEQ などの画像処理ノードで画像を補正します
- 補正後の画像を SaveImage ノードの "input_image" パラメータに接続します
- 出力設定を構成：
- output_path に "processed_image.png" を指定
- ロスレス品質を保つため image_format で "PNG" を選択
- 画像がローカルディスクに保存されます
- saved_path 出力で保存先パスを確認できます
重要な注意点 (Important Notes)
- 出力先ディレクトリ: 保存先フォルダが存在しない場合、自動的に作成されます
- 上書き動作: 同じファイル名が既に存在する場合、上書き保存されます
- 品質設定の対象: quality パラメータは JPEG フォーマットを選択した場合にのみ有効です
よくある問題 (Common Issues)
- 保存されない: 指定したパスが有効か、書き込み権限があるか確認してください
- 画質が落ちる: JPEG で保存する場合は quality を 95 以上に引き上げるか、PNG 形式を使用してください
技術的な詳細 (Technical Details)
このノードは PIL（Pillow）の保存機能を使用しています：
- PNG: アルファチャンネルを保持した可逆圧縮
- JPEG: 最適化された DCT 圧縮と品質スケーリング
- BMP: 生のピクセル配列を保持する非圧縮ビットマップ
- TIFF: 高度な印刷・業務用タグ付き画像フォーマット