FlipImage 图像镜像对称与翻转变换节点
节点核心功能 (What is it?)
FlipImage 节点负责对输入的图像资产执行水平轴（左右镜像）、垂直轴（上下颠倒）或双向联合几何翻转。它是纠正相机拍摄朝向偏差、构建对称美学构图以及无损扩充数据集样本的轻量级几何变换算子。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 制作倒影、水平镜面对称视效或双生变体；
- 纠正因前置摄像头镜像拍摄或传感器朝向错误导致的画面颠倒；
- 快速生成左右朝向相反的角色与场景概念图；
- 构建万花筒或中心对称排版图样；
- 在不引入生成模型重绘开销的前提下翻倍扩充图片变体。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 FlipImage 节点。
- 将图像数据源接入
input_image输入插槽。 - 从
direction下拉菜单中选择翻转轴向。 - 在
output引脚即可提取完成翻转后的全新图像资产。
参数输入插槽 (Parameters)
- input_image：待翻转的源图像资产（可接入任意图像输出引脚）。
- direction：翻转方向策略：
- horizontal（默认）：水平镜像翻转（左右对调，产生镜面反射效果）；
- vertical：垂直颠倒翻转（上下对调）；
- both：水平加垂直双重翻转（等效于将图像旋转 180 度）。
输出引脚 (Outputs)
- output：执行几何翻转后生成的全新图像工件（
ImageArtifact）。 - was_successful（布尔值）：标志翻转计算是否成功执行完毕。
- result_details：关于翻转操作的详细状态或诊断信息。
典型工作流示例 (Example)
水平镜面对称变体生成流水线：
- 使用
LoadImage导入一张角色肖像。 - 将其接入
FlipImage节点的input_image参数。 - 将
direction保持为horizontal。 - 将
output接入DisplayImage，即可瞬时得到一张朝向相反、原汁原味的水平镜像肖像。
关键技术特性 (Important Notes)
- 零画质损失 (Format Preservation)：翻转操作为纯粹的像素索引矩阵重排，不涉及任何插值重采样，因此原图的画质、色彩与元数据保持 100% 绝对无损。
- 透明通道完美适配 (RGBA Support)：针对 RGBA 图层，Alpha 遮罩通道与色彩三通道同步执行坐标映射，抠图边缘绝不发生错位或撕裂。
- 执行状态追踪：提供
was_successful与result_details状态字段，便于在自动化循环或条件分支中做状态防御。
底层技术原理 (Technical Details)
节点基于 PIL 底层原生图像算法库开发：
- Horizontal Flip：底层调用
ImageOps.mirror()实现左右轴对称交换； - Vertical Flip：底层调用
ImageOps.flip()实现上下轴对称翻转； - Both Directions：顺序串联执行上述两次矩阵置换，等价于原点中心对称。