图像处理

图像修正

以首帧灰度图为基准，用相位相关估计帧间平移并做旋转平移仿射校正，输出与输入同尺寸
ImageCorrect · v1.0 · by system

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待校正的图像帧序列，逐帧处理；第一张有效帧会被记为灰度基准，空帧原样透传且不参与基准更新
基准X	`referenceX`	double	0	否	水平平移量初值，默认 0.0；autoDetect 关闭时直接叠加到仿射矩阵 X 平移，开启且有基准帧后被相位相关结果覆盖
基准Y	`referenceY`	double	0	否	垂直平移量初值，默认 0.0；与 referenceX 一起写入仿射矩阵平移项，自动检测时由相位相关的 Y 位移覆盖
基准角度	`referenceAngle`	double	0	否	绕图像中心的旋转角度初值，默认 0.0 度；getRotationMatrix2D 据此生成旋转矩阵，相位相关不改动它
填充值	`fillValue`	int	0	否	warpAffine 常量边界填充灰度，默认 0；旋转或平移露出的图像外区域按该标量填充到所有通道
自动检测	`autoDetect`	bool	true	否	是否用相位相关自动估计帧间平移，默认开启；首帧无基准时仍用 referenceX/Y，之后用检测位移覆盖

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功，输出逐帧校正图像；-1=输入帧容器缺失或 warpAffine/相位相关抛错（内存不足），此时不产出图像
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时为具体原因（输入图像为空、OpenCV 处理异常或处理失败），用于定位连线与参数
图像	`images`	vec_img	—	否	逐帧输出与输入同尺寸的仿射校正图，采用 INTER_LINEAR 插值与 BORDER_CONSTANT 边界；帧数与输入一致，空帧原样透传
偏移X	`offsetX`	double	—	否	本帧实际应用的 X 方向平移量；autoDetect 且有基准帧时为 phaseCorrelate 检测值，否则取 referenceX
偏移Y	`offsetY`	double	—	否	本帧实际应用的 Y 方向平移量；自动检测时来自相位相关结果，未开启或无基准时取 referenceY
偏移角度	`offsetAngle`	double	—	否	本帧实际应用的旋转角度，始终等于 referenceAngle；相位相关只估计平移，不会改写角度

在 FlowDesigner 中将「图像修正」节点加入流程画布，把上游图像或数据连接至「图像」，并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见使用文档；安装与使用问题可通过联系页反馈。

联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。

微信扫码 · 安装包与问题反馈