ExtendCanvas 画布扩展与外扩留白补边节点

节点核心功能 (What is it?)

ExtendCanvas 节点允许创作者在绝对不裁剪、不挤压变形原图画面内容的前提下，向四周智能扩展物理画布（Canvas Extension）。无论是为了适配目标画幅比例（如 16:9 宽屏、1:1 正方形等）、补齐边框，还是为了给画面外扩重绘（Outpainting）预留透明留白工作区，该节点都能提供工业级的构图对齐支持。

典型适用场景 (When would I use it?)

在以下情况下使用该节点：

为画面添加留白衬底、保护边框或相框边缘；
在不破坏主体构图的前提下将任意画幅转换为标准比例（16:9、4:3、1:1、21:9 等）；
为社交媒体不同平台的封面与信息流规格准备合适画幅；
为海报排版中的大标题、广告文案或图形贴纸预留排版空白空间；
扩展透明图层边界作为扩散模型 Outpainting（外扩生成）的前置图层准备。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

在工作流画布中添加 ExtendCanvas 节点。
将源图像接入 input_image 输入插槽。
选择目标画幅比例（target_aspect_ratio）或自定义物理尺寸。
指定画面在拓展画布中的停靠锚点（extension_method）与背景色。
在 output 引脚即可提取扩展完成的全新大画布图像资产。

参数输入插槽 (Parameters)

画布规格与画幅 (Canvas Settings)

target_aspect_ratio：目标输出画幅规格：
- 16:9：现代高清宽屏画幅；
- 4:3：经典复古画幅；
- 1:1：正方形画幅；
- 3:2：经典全画幅单反摄影比例；
- 21:9：电影级超宽屏比例；
- Custom：自定义物理像素尺寸。
custom_width / custom_height（像素）：当选用 Custom 模式时输入的自定义长宽。

扩展方式与衬底 (Extension Settings)

extension_method：原图在新画布中的空间对齐锚点：
- center（默认）：居中停靠（向四周均匀留白）；
- top_left：左上角停靠（向右下延伸空白）；
- top_right：右上角停靠；
- bottom_left：左下角停靠；
- bottom_right：右下角停靠。
background_color（十六进制颜色代码，默认 #ffffff 纯白）：扩展留白区域的底色。
background_opacity（0.0–1.0，默认 1.0）：留白衬底的不透明度（设为 0.0 时即为纯透明留白）。

输出引脚 (Outputs)

output：扩展了物理尺寸后的全新图像资产（ImageArtifact）。

典型工作流示例 (Example)

正方形原图转换为 16:9 电影宽屏：

使用 LoadImage 导入一张 1024×1024 的正方形生图素材。
将其连入 ExtendCanvas 节点的 input_image 参数。
配置参数：
- 将 target_aspect_ratio 设为 16:9；
- 将 extension_method 设为 center；
- 将 background_color 设为 #000000（纯黑上下/左右遮幅遮挡）。
将 output 接入 DisplayImage，即可瞬时得到一张标准 16:9 居中电影宽屏图。

关键技术特性 (Important Notes)

绝对非破坏性构图 (Non-destructive)：原图的任何一个像素都绝不会被裁切、挤压或有损插值，原图以 1:1 像素精度精准居中或停靠在新画面的指定坐标系上。
透明度通道支持 (RGBA Support)：当 background_opacity 调整为 0.0 时，扩展出的空白区域将被赋予纯黑透明（Alpha 0）状态，为后续直接连接 PaintMask 或 Outpainting 重绘节点提供了天然的无缝衔接。

常见问题与排查 (Common Issues)

画面没有居中对齐：确认 extension_method 是否被误选为 top_left 等角落对齐模式。
背景没有呈现透明：检查 background_opacity 是否被拉到了 1.0，需将其调低至 0.0 以激活透明通道。