コンテンツにスキップ

キャンバスの拡張 (ExtendCanvas)

概要 (What is it?)

ExtendCanvas ノードは、画像周辺のキャンバスを拡張し、目標のアスペクト比や任意の寸法にフィットさせます。元画像を一切切り抜く（クロップする）ことなく、余白（パディング）を追加したり、特定のアスペクト比に整形したり、様々なメディア形式に合わせた画像準備を行うのに最適です。

使用する場面 (When would I use it?)

以下のような場面でこのノードを使用します：

  • 画像の周囲に余白（マージンやパディング）を追加したい場合
  • 特定のアスペクト比（16:9、4:3、1:1 正方形など）に拡張したい場合
  • 各種 SNS の投稿フォーマットに合わせた画像サイズを準備したい場合
  • テキストやグラフィックを配置するための余白スペースを確保したい場合
  • ワークフロー全体で画像サイズ・アスペクト比を統一したい場合
  • 印刷用レイアウトのフォーマットに合わせたい場合
  • 画像の周囲にボーダー（枠）やフレームを付加したい場合

使い方 (How to use it)

基本セットアップ

  1. ワークフローに ExtendCanvas ノードを追加します
  2. 画像ソースを "input_image" 入力に接続します
  3. 目標のアスペクト比またはカスタム寸法を設定します
  4. キャンバスが拡張された画像が "output" パラメータから出力されます

パラメータ一覧 (Parameters)

キャンバス設定 (Canvas Settings)

  • target_aspect_ratio: 出力画像の目標アスペクト比

    • 16:9: ワイドスクリーン形式
    • 4:3: スタンダード形式
    • 1:1: 正方形形式
    • 3:2: 写真標準形式
    • 21:9: ウルトラワイド形式
    • Custom: 任意のカスタム寸法を指定

  • custom_width（ピクセル単位）: "Custom" 選択時の幅

  • custom_height（ピクセル単位）: "Custom" 選択時の高さ

拡張配置設定 (Extension Settings)

  • extension_method: キャンバス上での元画像の配置方法

    • center: 新しいキャンバスの中央に配置
    • top_left: 左上に配置
    • top_right: 右上に配置
    • bottom_left: 左下に配置
    • bottom_right: 右下に配置

  • background_color（16進数カラーコード、デフォルト: #ffffff）: 拡張された余白領域の背景色

  • background_opacity（0.0〜1.0、デフォルト: 1.0）: 背景色の不透明度

出力 (Outputs)

  • output: キャンバスが拡張された画像

使用例 (Example)

典型的なキャンバス拡張ワークフローの例：

  1. LoadImage を使用して画像を読み込みます
  2. その画像を ExtendCanvas ノードの "input_image" パラメータに接続します
  3. キャンバス設定を構成：
    • ワイドスクリーン形式にするため target_aspect_ratio で "16:9" を選択
    • 中央に画像を配置するため extension_method で "center" を選択
    • 余白を黒にするため background_color を "#000000" に設定
  4. "output" を DisplayImage に接続して結果を確認します

重要な注意点 (Important Notes)

  • 非破壊的: 元画像の内容がトリミングされたり変形されたりすることは一切ありません
  • 柔軟な配置: 新しいキャンバス上のどこに元画像を置くか（中央、四隅）を自由に選べます
  • アスペクト比制御: プリセット形式だけでなく、完全なカスタムピクセル寸法での拡張も可能です
  • RGBA のサポート: RGBA 画像の透過チャンネルおよび余白の透明度をそのまま保持できます

よくある問題 (Common Issues)

  • 画像が中央に来ない: extension_method が "center" になっているか確認してください
  • 意図しないアスペクト比: target_aspect_ratio または custom_width/custom_height の設定を確認してください
  • 背景が見えない: background_opacity が 0 より大きくなっているか確認してください

技術的な詳細 (Technical Details)

このノードは以下の処理を実行します：

  1. キャンバス生成: 目標の寸法で新しい画像キャンバスを生成
  2. 背景色の塗りつぶし: 指定された背景色と不透明度でキャンバスを塗りつぶし
  3. 画像の配置: 指定されたアライメント（配置基準）に基づいて元画像をキャンバス上に合成
  4. 出力の生成: 拡張された最終画像を保存

元画像のコンテンツを一切損なうことなく、各種フォーマット要件に合わせたサイズ調整を簡単に行うことができます。