图像输入输出
用于声明视觉流程的图像入口和结果出口。
图像输入
Input · 可执行
把调用方为本次视觉执行提供的源帧引入视觉图,并通过标准 image 输出端口传给后继节点。
签名
var input = Input();
参数
无参数。
输出
imageImage- 当前视觉执行的源图像;IDE 标准端口方向为 Output。
行为
- 标准图中 Input 没有上游连接;ResolveInput 因而使用 ExecuteAsync 调用方提供的源 Mat。
- INPUT 分派直接返回当前 Mat 引用,不复制像素;最终 Pipeline 边界才复制为 VisionPipelineExecutionResult.OutputPixels。
- X、Y 仅是作者画布坐标,由规范化视觉 SCL 输出量测:,但不属于 Runtime 参数合同 的控制参数,也不进入执行语义哈希。
- 相机、文件和内存帧的采集或解码由调用 Input 之前的执行入口负责;Input 本身不打开相机、文件或网络流。
- 要求几何回执时,Input 必须是唯一输出路径的起点且不得有上游连接。
错误与限制
VISION_PIPELINE_PARAMETERS_REQUIRED:节点的 Parameters 集合为 null。VISION_PIPELINE_PARAMETER_UNKNOWN:向 Input 提供任何 Runtime 参数合同 未声明的控制参数。
示例
OnFrame ACTION 中的最小图像边界:Input 把本次源帧经类型化 image 端口连接到 Output。
var input = Input(); output = Output(); PORT(Node: "input", Name: "image", Direction: "Output", DataType: "IMAGE", Required: TRUE); PORT(Node: "output", Name: "image", Direction: "Input", DataType: "IMAGE", Required: TRUE); CONNECT(FromNode: "input", FromPort: "image", ToNode: "output", ToPort: "image", DataType: "IMAGE");
结果输出
Output · 可执行
接收标准 image 输入端口的图像并把该节点标记为视觉 Pipeline 的结果边界;节点执行本身不修改图像。
签名
Image output = Output();
输入
imageImage- 作为 Pipeline 最终结果的图像;IDE 标准端口方向为 Input。
参数
无参数。
返回值
returnImage- Pipeline 的最终图像;执行边界将其复制到 VisionPipelineExecutionResult.OutputPixels,并返回宽、高、步幅和像素格式。
行为
- OUTPUT 分派直接返回解析出的输入 Mat 引用,不复制、不改变宽度、高度、通道数、位深或像素内容。
- 执行器在拓扑序中选择最后一个 Output 作为结果节点;若图中没有 Output,则兼容回退到拓扑序最后一个节点。
- 最终结果只支持 8-bit、1/3/4 通道,公开像素格式规范化为 GRAY8、BGR8 或 BGRA8。
- X、Y 仅是作者画布坐标,不属于 Runtime 参数合同 的控制参数,也不进入执行语义哈希。
- 要求几何回执的推理入口必须有且仅有一个 Output,并要求从无上游的 Input 到 Output 是单输入线性路径。
错误与限制
VISION_PIPELINE_PARAMETERS_REQUIRED:节点的 Parameters 集合为 null。VISION_PIPELINE_PARAMETER_UNKNOWN:向 Output 提供任何 Runtime 参数合同 未声明的控制参数。
示例
OnFrame ACTION 中把 Input 的 image 输出连接到唯一 Output 的 image 输入,形成最小可执行结果路径。
Image input = Input(); output = Output(); PORT(Node: "input", Name: "image", Direction: "Output", DataType: "IMAGE", Required: TRUE); PORT(Node: "output", Name: "image", Direction: "Input", DataType: "IMAGE", Required: TRUE); CONNECT(FromNode: "input", FromPort: "image", ToNode: "output", ToPort: "image", DataType: "IMAGE");