DisplayImage 图像可视化显示与尺寸解析节点
节点核心功能 (What is it?)
DisplayImage 节点专用于在工作流画布中可视化渲染并展示图像工件，同时自动提取其精确的物理像素尺寸（宽度与高度）。它是一个直观易用的监看兼测量工具，既方便创作者在画布上实时核对处理结果，又能为后续需要几何尺寸的节点提供物理数据引脚。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 在画布中直观监看图像，获取即时的视觉反馈；
- 动态获取图像的真实物理宽高像素值（Width / Height）；
- 作为透明中继节点，在不改变图像任何数据的前提下边看边传；
- 在复杂的多步图像处理管线中充当探针（Probe）排查中间状态。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 DisplayImage 节点。
- 将任意输出图像的上游节点连接至本节点的
image输入插槽。 - 图像将即刻在节点卡片内部渲染展开；在右侧属性面板中可开启其物理尺寸引脚。
参数输入插槽 (Parameters)
- image：待展示与测量的图像源（接收
ImageArtifact、ImageUrlArtifact等合法格式）。
输出引脚 (Outputs)
- image：未经任何修改、原样透传的原始图像资产（供下游节点继续使用）。
- width：图像的实际物理宽度（整型像素值，默认在 UI 上隐藏，可在右侧属性面板中勾选开启）。
- height：图像的实际物理高度（整型像素值，默认在 UI 上隐藏，可在右侧属性面板中勾选开启）。
典型工作流示例 (Example)
常见的图像检查与下游尺寸适配流程：
- 将上游生图节点（如
GenerateImage）或载入节点（如LoadImage）接入DisplayImage。 - 在该节点内实时预览图像，确认构图与画质符合预期。
- 在属性面板勾选开启
width与height输出插槽。 - 将提取出的尺寸引脚连入下游的
ExtendCanvas或数学计算节点，实现完全自适应的动态构图。
关键技术特性 (Important Notes)
- 绝对零开销透明透传 (Pass-through)：不对图像数据进行任何有损重编码或像素修改。
- 自动解析双模工件：
- 若接入的是内存对象
ImageArtifact，直接秒级读取元数据属性中的宽高； - 若接入的是远程网络对象
ImageUrlArtifact，节点会自动拉取图像头信息推导其真实几何尺寸。
- 若接入的是内存对象
- 界面整洁性保护：
width和height引脚默认隐藏以保持节点小巧简洁，创作者可随时在右侧面板勾选按需显示。
常见问题与排查 (Common Issues)
- 图像未正常显示：检查上游节点是否已经顺利跑通，连线是否牢固插入。
- 尺寸显示为 0：可能由于上游图像数据损坏或网络请求超时导致未能成功解析出尺寸信息。
- URL 图像响应稍慢：超大分辨率的外部远程 URL 图像在首次解析尺寸时需短暂网络加载。