跳转至

图片

用途

把图像或视频画面作为蓝图数据源,预览素材,并分别输出 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 输出只能提取源画面实际存在的透明度信息。
  • 开启公开后直接输出停用:从变量条读取该图片变量。

相关节点