在工业视觉检测与自动化领域，康耐视（Cognex）的 VisionPro 是一款功能强大的视觉开发工具，而 C# 凭借其简洁性与高效性，成为许多开发者的首选编程语言。本文将详细介绍如何通过 C# 与 VisionPro 联合编程实现相机连接，为后续的视觉检测应用开发奠定基础。
一、环境准备
1.1 安装 VisionPro
首先确保已安装康耐视 VisionPro 软件。安装过程中，注意勾选相关的开发工具包（如 Cognex.VisionPro.ToolBlock 等），这些工具包将为后续编程提供关键支持。
1.1 创建vpp项目连接相机
搜索Cognex Gige
更改本机和相机ip配置
修改子网掩码为255.255.255.0
配置驱动程序
更新驱动（如果能够选择9014Bytes，跳过此步骤）
更新更改
相机ip配置：注意Host IP 和IP address 第四位不能相同
打开visionPro
选择照相机，生成vpp文件并保存
1.3新建 C# 项目
打开 Visual Studio，创建一个新的 Windows 桌面应用程序（.NET Framework） 项目（也可根据需求选择其他类型，如 WPF，但本文以 WinForms 为例）。打开项目工具箱
然后打开VisionPro的ReferencedAssemblies文件夹
Ctrl+A全选，并将其直接拖入vp选项卡下
搜索cogAcqFifoEdit，将其加入From1窗体
同理，并加入三个按钮
右键单击项目点击属性
选择x64
点击重新生成解决方案
二、代码部分
接下来详细解析代码中各个方法的实现及其作用：
引入Cognex头文件
using Cognex.VisionPro;
using Cognex.VisionPro.ImageFile;
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.IO;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;
加载相机配置
private void Form1_Load(object sender, EventArgs e)
{
// 加载相机配置
string path = @"C:\Users\15783\Desktop\VisionPro\连接相机\连接相机\bin\相机连接.vpp";
// 必须要保证vpp中有CogAcqFifoTool才可以
cogAcqFifoTool = CogSerializer.LoadObjectFromFile(path) as CogAcqFifoTool;
cogAcqFifoEditV21.Subject = cogAcqFifoTool;
}
在窗体加载时，此方法从指定路径加载 VisionPro 的配置文件（.vpp）。通过 CogSerializer.LoadObjectFromFile 方法将文件内容加载并转换为 CogAcqFifoTool 对象。确保 .vpp 文件中包含 CogAcqFifoTool，否则转换会失败。最后将加载的 cogAcqFifoTool 设置为 cogAcqFifoEditV21 控件的 Subject，以便通过该控件对相机采集工具进行配置和监控。
执行拍照操作
private void button1_Click(object sender, EventArgs e)
{
// 拍照
if (cogAcqFifoTool == null)
{
cogAcqFifoTool = new CogAcqFifoTool();
}
if (cogAcqFifoTool.Operator == null)
{
MessageBox.Show("相机连接有问题");
return;
}
cogAcqFifoTool.Run();
cogDisplay1.Image = cogAcqFifoTool.OutputImage;
cogDisplay1.Fit();
}
当点击拍照按钮时，首先检查 cogAcqFifoTool 是否为空，若为空则创建一个新的 CogAcqFifoTool 实例。接着验证 cogAcqFifoTool.Operator 是否存在，若不存在则弹出提示 “相机连接有问题” 并返回。若连接正常，调用 cogAcqFifoTool.Run() 执行拍照。拍照完成后，将获取的图像 cogAcqFifoTool.OutputImage 显示在 cogDisplay1 控件上，并通过 cogDisplay1.Fit() 方法让图像适配显示区域。
释放相机资源
private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
// 获取当前的所有相机资源
CogFrameGrabbers cogFrame = new CogFrameGrabbers();
foreach (ICogFrameGrabber item in cogFrame)
{
item.Disconnect(false);
}
}
在窗体关闭时，此方法用于释放所有与相机相关的资源。首先创建 CogFrameGrabbers 对象来获取当前所有的相机帧采集器，然后通过循环遍历每个 ICogFrameGrabber 项，调用 Disconnect 方法断开与相机的连接，参数 false 表示在断开连接时不等待正在进行的操作完成。
切换实时显示
private void button2_Click(object sender, EventArgs e)
{
if (button2.Text == "实时显示")
{
button2.Text = "停止实时显示";
cogDisplay1.StartLiveDisplay(cogAcqFifoTool.Operator, false);
}
else
{
button2.Text = "实时显示";
cogDisplay1.StopLiveDisplay();
}
}
该方法实现了实时显示的切换功能。当按钮文本为 “实时显示” 时，点击按钮将文本改为 “停止实时显示”，并调用 cogDisplay1.StartLiveDisplay 方法启动实时显示，传入 cogAcqFifoTool.Operator 作为相机操作对象，参数 false 表示不使用缓存。反之，当按钮文本为 “停止实时显示” 时，点击按钮将文本改回 “实时显示”，并调用 cogDisplay1.StopLiveDisplay 方法停止实时显示。
存储拍摄的图片
private void button3_Click(object sender, EventArgs e)
{
// 存储图片
string path = Directory.GetCurrentDirectory() + @"\ImageDir";
if (!Directory.Exists(path))
{
Directory.CreateDirectory(path);
}
// 定义文件路径
string imageName = $"{DateTime.Now.ToString("HHmmss")}.bmp";
// 保存图片
ICogImage image = cogAcqFifoTool.OutputImage;
// 文件存储工具(读写)
CogImageFileTool fileTool = new CogImageFileTool();
fileTool.InputImage = image;
fileTool.Operator.Open($"{path}\\{imageName}", CogImageFileModeConstants.Write);
fileTool.Run();
}
点击存储图片按钮时，首先确定存储目录 path，通过 Directory.GetCurrentDirectory() 获取当前应用程序目录并拼接上 \ImageDir 作为存储路径。检查该目录是否存在，若不存在则使用 Directory.CreateDirectory(path) 创建目录。然后生成文件名 imageName，以当前时间（格式为 HHmmss）命名并加上 .bmp 后缀。接着获取当前拍摄的图像 cogAcqFifoTool.OutputImage，创建 CogImageFileTool 对象 fileTool，将获取的图像设置为 fileTool 的 InputImage。再通过 fileTool.Operator.Open 方法打开指定路径和文件名的文件，设置为写入模式（CogImageFileModeConstants.Write），最后调用 fileTool.Run() 执行存储操作，将图像保存到指定位置。
通过以上代码，实现了相机配置加载、拍照、实时显示控制以及图片存储等功能，为基于 VisionPro 和 C# 的工业视觉应用开发提供了基础的相机操作支持。在实际应用中，还可以根据需求进一步扩展和优化，例如添加更丰富的相机参数设置界面、完善图像预处理逻辑或实现与其他业务系统的数据交互等。
完整代码
using Cognex.VisionPro;
using Cognex.VisionPro.ImageFile;
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.IO;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;namespace 连接相机
{public partial class Form1 : Form
{
CogAcqFifoTool cogAcqFifoTool = null;
public Form1()
{
InitializeComponent();
}private void Form1_Load(object sender, EventArgs e)
{
//加载相机配置
string path = @"C:\Users\15783\Desktop\VisionPro\连接相机\连接相机\bin\相机连接.vpp";
//必须要保证vpp中有CogAcqFifoTool才可以
cogAcqFifoTool = CogSerializer.LoadObjectFromFile(path) as CogAcqFifoTool;
cogAcqFifoEditV21.Subject = cogAcqFifoTool;
}private void button1_Click(object sender, EventArgs e)
{
//拍照
if (cogAcqFifoTool == null)
{
cogAcqFifoTool = new CogAcqFifoTool();
}
if(cogAcqFifoTool.Operator== null)
{
MessageBox.Show("相机连接有问题");
return;
}
cogAcqFifoTool.Run();
cogDisplay1.Image = cogAcqFifoTool.OutputImage;
cogDisplay1.Fit();
}private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
//获取当前的所有相机资源
CogFrameGrabbers cogFrame = new CogFrameGrabbers();
foreach(ICogFrameGrabber item in cogFrame)
{
item.Disconnect(false);
}
}private void button2_Click(object sender, EventArgs e)
{
if (button2.Text == "实时显示")
{
button2.Text = "停止实时显示";
cogDisplay1.StartLiveDisplay(cogAcqFifoTool.Operator,false);}
else
{
button2.Text = "实时显示";
cogDisplay1.StopLiveDisplay();
}
}private void button3_Click(object sender, EventArgs e)
{
//存储图片
string path = Directory.GetCurrentDirectory() + @"\ImageDir";
if (!Directory.Exists(path))
{
Directory.CreateDirectory(path);
}
//定义文件路径
string imageName = $"{DateTime.Now.ToString("HHmmss")}.bmp";
//保存图片
ICogImage image =cogAcqFifoTool.OutputImage;
//文件存储工具(读写)
CogImageFileTool fileTool = new CogImageFileTool();
fileTool.InputImage = image;
fileTool.Operator.Open($"{path}\\{imageName}", CogImageFileModeConstants.Write);
fileTool.Run();
}
}
}
![QT软件开发环境及简单图形的绘制-图形学(实验一)-[成信]](https://i-blog.csdnimg.cn/direct/27a173713d3843f69cb818e63e0ca36a.png)
