LoadImage 图像载入与资源导入节点
节点核心功能 (What is it?)
LoadImage 节点是一个基础的核心构件，用于将图像资源引入并加载到您的工作流中。就像在实际工程中选取一张照片，以便在后续项目中直接使用它。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 导入并使用由其他生成节点（如
CreateImage）所创建的图像资产； - 将本地磁盘文件或网络 URL 中的图片载入工作流，并传递给其他图像处理算子；
- 在工作流画布中直观展示和预览特定图像。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 LoadImage 节点。
- 将其连接到图像数据源（例如
CreateImage节点的输出插槽），或直接在节点面板中通过文件选择器选取本地图片。
参数输入插槽 (Parameters)
- image：待载入的图像源（可接入上游其他节点的图像输出引脚，也可以通过本地文件浏览面板手动选取，或填入图片网络 URL / 绝对路径）。
输出引脚 (Outputs)
- image：加载成功并标准化封装后的图像工件，可直接供工作流中所有下游节点调用。
典型工作流示例 (Example)
假设您通过生图节点生成了一幅画作，并希望在后续链路中使用：
- 将
CreateImage节点的output引脚连接到LoadImage节点的image输入引脚。 LoadImage节点将该图像资源加载就绪，并供工作流后续管线顺畅消费。
关键技术特性 (Important Notes)
- 透明透传机制 (Pass-through)：
LoadImage仅负责资产载入与句柄传递，不对图像像素数据进行任何有损压缩或二次修改。 - 本地文件浏览器：点击参数栏的文件浏览器图标（Folder Icon），可直接从本机磁盘中选取文件。
- 画布内嵌预览：点击展开器图标（Expander Icon），可一键放大查看载入图像的高清细节。
常见问题与排查 (Common Issues)
- 无图像显示：请确认是否已正确连入上游图像节点，或本地文件路径是否有效存在。
- 图像类型不匹配：请确保接入的数据类型为
ImageUrlArtifact、ImageArtifact，或是合法的本地文件绝对路径 / Web URL 字符串。