画像のリスケール (RescaleImage)
概要 (What is it?)
RescaleImage ノードは、寸法、スケーリング方式、およびリサンプリング品質を精密にコントロールして画像のサイズを変更（リサイズ）します。ピクセル単位の指定とパーセンテージ（比率）による拡大縮小の両方をサポートしており、特定の出力要件に合わせたサイズ調整や、サムネイルの生成に最適です。
使用する場面 (When would I use it?)
以下のような場面でこのノードを使用します：
- 画像を特定のピクセル寸法にリサイズしたい場合
- パーセンテージ（比率）で画像を拡大・縮小したい場合
- 各種プラットフォーム向けに出力サイズを最適化したい場合
- サムネイル画像やプレビュー用縮小版を作成したい場合
- Web 掲載用や印刷用に解像度を調整したい場合
- アスペクト比（縦横比）を維持したままスケーリングしたい場合
使い方 (How to use it)
基本セットアップ
- ワークフローに RescaleImage ノードを追加します
- 画像ソースを "input_image" 入力に接続します
- リサイズモードを選択し、目標サイズを設定します
- リサイズされた画像が "output" パラメータから出力されます
パラメータ一覧 (Parameters)
リサイズ設定 (Resize Settings)
-
resize_mode: 新しいサイズを決定する方法
- percentage: パーセンテージで拡大縮小（例: 50% で半分のサイズ）
- pixels: 正確なピクセル寸法で指定
-
target_size（ピクセル単位、デフォルト: 512）: ピクセルモード時の目標サイズ
- アスペクト比を維持しながら指定寸法に合わせてスケーリングされます
-
percentage_scale（1〜1000、デフォルト: 100）: パーセンテージモード時のスケーリング比率
- 50: 半分のサイズ（50%）
- 100: 元のサイズ（等倍）
- 200: 2 倍のサイズ（200%）
品質設定 (Quality Settings)
- resample_filter: リサンプリングに使用する補間アルゴリズム
- lanczos: 高品質・低速（ほとんどの用途で推奨）
- bicubic: 双三次補間。良好な品質・中速
- bilinear: 双線形補間。標準的な品質・高速
- nearest: 最近傍補間。ドット絵・ピクセルアート調・超高速
出力 (Outputs)
- output: リサイズされた画像
使用例 (Example)
一般的なリスケーリングワークフローの例：
- LoadImage を使用して画像を読み込みます
- その画像を RescaleImage ノードの "input_image" パラメータに接続します
- リサイズ設定を構成：
- resize_mode で "percentage" を選択
- 半分のサイズにするため percentage_scale を 50 に設定
- 高画質を維持するため resample_filter で "lanczos" を選択
- "output" を DisplayImage に接続して結果を確認します
重要な注意点 (Important Notes)
- リアルタイムプレビュー: パラメータの変更はリアルタイムに反映されます
- アスペクト比の維持: 元画像の縦横比を崩さずに拡大縮小します
- 高品質処理: Lanczos フィルタを使用することで、モアレやジャギーを抑えた高品質なリサイズが可能です
- RGBA のサポート: RGBA 画像の透過チャンネルはそのまま保持されます
よくある問題 (Common Issues)
- 画質が荒い: 縮小・拡大時のぼやけやジャギーを防ぐため、resample_filter で "lanczos" を選択してください
技術的な詳細 (Technical Details)
このノードは PIL（Pillow）の高性能リサンプリングアルゴリズムを使用しています：
- Lanczos: Lanczos 核（Sinc 関数ベース）を用いた高品質リサンプリング
- Bicubic: 3 次補間による滑らかなリサンプリング
- Bilinear: 線形補間による高速処理
- Nearest: ピクセル境界を保持するニアレストネイバー