图片¶
用途¶
把图像或视频画面作为蓝图数据源,预览素材,并分别输出 RGB 与 Alpha 通道。节点也可以公开为蓝图变量。
添加路径¶
Shift+A > 变量 > 图片
执行行为¶
执行流从“执行输入”进入后直接从“执行输出”继续。图像数据在下游读取时解析:静态图像应用当前映射;视频素材按图像时间线的当前源帧取出一帧后再输出。
“映射”输入会叠加到节点属性中的偏移,而不是替换原偏移。节点没有主动播放视频的行为。
输入端口¶
| 端口 | 类型 | 说明 |
|---|---|---|
| 映射 | 二维数 | 把输入的 X、Y 作为额外位置偏移叠加到节点映射。 |
| 执行输入 | 执行 | 让执行流经过此节点。 |
输出端口¶
| 端口 | 类型 | 说明 |
|---|---|---|
| RGB | 三维数 / RGB 图像通道 | 输出应用当前帧与映射后的 RGB 图像数据。 |
| A | 数值 / Alpha 图像通道 | 从同一画面提取透明度通道。 |
| 执行输出 | 执行 | 继续执行后续节点。 |
公开为变量后,节点上的 RGB 与 A 直接输出会停用;请从左侧变量条插入对应变量节点读取。
属性¶
| 属性 | 默认值 | 说明 |
|---|---|---|
| 状态 | 私有 | 开启公开后建立蓝图变量。 |
| 图像 | 空 | 显示当前素材预览;可删除已选素材。 |
| 偏移 X、Y | 0.0, 0.0 | 设置图像自身的位置偏移。 |
| 平铺模式 | 裁剪 | 可选“裁剪”“平铺”“镜像”或“扩展”,决定映射越出素材边界时如何取样。 |
| 导入文件 | — | 选择图像或视频素材。支持 PNG、JPG、JPEG、BMP、WebP、HEIC、HEIF、MP4、MOV、MKV、WebM、AVI 和 M4V。 |
| 截图 | — | 从屏幕截图流程取得一张图像。 |
| 名称 | 空 | 编辑节点标题可设置变量名称。 |
还可以把受支持的图像或视频文件直接拖到节点预览区域。
最小示例¶
点击“导入文件”选择一张 PNG,把 RGB 输出连接到需要图像的下游节点。若要平移画面,把二维数连接到“映射”,或直接编辑偏移 X、Y。
常见错误¶
- 只连接执行线却期待图像被显示到外部:节点只提供数据,必须连接到使用图像的节点。
- 同时设置偏移并连接“映射”却得到更大位移:两者会相加;不需要叠加时将其中一处归零。
- 导入视频后期待节点自行播放:视频帧由图像时间线位置决定。
- 素材没有 Alpha 通道时期待透明区域:A 输出只能提取源画面实际存在的透明度信息。
- 开启公开后直接输出停用:从变量条读取该图片变量。