C#之调用海康工业相机SDK采集图像并在Halcon窗口中显示
C#之调用海康工业相机SDK采集图像并在Halcon窗口中显示
最近做项目需要对海康相机进行二次开发，现将所学进行整理。
开发环境 VS2012+C#（32位） Halcon12
引用动态链接库
引用Halcon动态链接库（halcondotnet.dll）
引用海康相机动态链接库（MvCameraControl.Net.dll）这个文件在MVS安装目录下MVS\Development\DotNet中，如果你是32位的开发环境就选择win32文件夹下的，如果是64位就选择win64文件夹下的
创建相机类
先在创建的类中编写方法，之后实例化相机类，调用类中的方法。
鼠标右键单击工程项目–添加–类，选择“类”，输入类的名称，例如Hikvision，点击右下角的“添加”。
首先，要引入的命名空间：using HalconDotNet; using MvCamCtrl.NET;
其次，需要用到的全部变量：
private MyCamera m_pMyCamera;
MyCamera.MV_CC_DEVICE_INFO_LIST m_pDeviceList;//设备列表
private MyCamera.MVCC_INTVALUE stParam;//用于接收特定的参数
//为读取、保存图像创建的数组
UInt32 m_nBufSizeForDriver = 3072 * 2048 * 3;
byte[] m_pBufForDriver = new byte[3072 * 2048 * 3];
UInt32 m_nBufSizeForSaveImage = 3072 * 2048 * 3 * 3 + 2048;
byte[] m_pBufForSaveImage = new byte[3072 * 2048 * 3 * 3 + 2048];
//要转成的Halcon图像
HImage image = new HImage();(1) 查找设备列表
//查找设备
public void DeviceListAcq()
{
int nRet;
// ch:创建设备列表 en:Create Device List
System.GC.Collect();
cbDeviceList.Items.Clear();
nRet = MyCamera.MV_CC_EnumDevices_NET(MyCamera.MV_GIGE_DEVICE | MyCamera.MV_USB_DEVICE, ref m_pDeviceList);
if (0 != nRet)
{
MessageBox.Show("查找设备失败！");
return;
}
// ch:在窗体列表中显示设备名 | en:Display device name in the form list
for (int i = 0; i < m_pDeviceList.nDeviceNum; i++)
{
MyCamera.MV_CC_DEVICE_INFO device = (MyCamera.MV_CC_DEVICE_INFO)Marshal.PtrToStructure(m_pDeviceList.pDeviceInfo[i], typeof(MyCamera.MV_CC_DEVICE_INFO));
if (device.nTLayerType == MyCamera.MV_GIGE_DEVICE)
{
IntPtr buffer = Marshal.UnsafeAddrOfPinnedArrayElement(device.SpecialInfo.stGigEInfo, 0);
MyCamera.MV_GIGE_DEVICE_INFO gigeInfo = (MyCamera.MV_GIGE_DEVICE_INFO)Marshal.PtrToStructure(buffer, typeof(MyCamera.MV_GIGE_DEVICE_INFO));
if (gigeInfo.chUserDefinedName != "")
{
cbDeviceList.Items.Add("GigE: " + gigeInfo.chUserDefinedName + " (" + gigeInfo.chSerialNumber + ")");
}
else
{
cbDeviceList.Items.Add("GigE: " + gigeInfo.chManufacturerName + " " + gigeInfo.chModelName + " (" + gigeInfo.chSerialNumber + ")");
}
}
else if (device.nTLayerType == MyCamera.MV_USB_DEVICE)
{
IntPtr buffer = Marshal.UnsafeAddrOfPinnedArrayElement(device.SpecialInfo.stUsb3VInfo, 0);
MyCamera.MV_USB3_DEVICE_INFO usbInfo = (MyCamera.MV_USB3_DEVICE_INFO)Marshal.PtrToStructure(buffer, typeof(MyCamera.MV_USB3_DEVICE_INFO));
if (usbInfo.chUserDefinedName != "")
{
cbDeviceList.Items.Add("USB: " + usbInfo.chUserDefinedName + " (" + usbInfo.chSerialNumber + ")");
}
else
{
cbDeviceList.Items.Add("USB: " + usbInfo.chManufacturerName + " " + usbInfo.chModelName + " (" + usbInfo.chSerialNumber + ")");
}
}
}
// ch:选择第一项 | en:Select the first item
if (m_pDeviceList.nDeviceNum != 0)
{
cbDeviceList.SelectedIndex = 0;
}
}(2) 打开设备
//打开设备
public void OpenDevice()
{
if (m_pDeviceList.nDeviceNum == 0 || cbDeviceList.SelectedIndex == -1)
{
MessageBox.Show("未发现设备，请选择");
return;
}
int nRet = -1;
// ch:获取选择的设备信息 | en:Get selected device information
MyCamera.MV_CC_DEVICE_INFO device =
(MyCamera.MV_CC_DEVICE_INFO)Marshal.PtrToStructure(m_pDeviceList.pDeviceInfo[cbDeviceList.SelectedIndex],
typeof(MyCamera.MV_CC_DEVICE_INFO));
// ch:打开设备 | en:Open device
if (null == m_pMyCamera)
{
m_pMyCamera = new MyCamera();
if (null == m_pMyCamera)
{
return;
}
}
nRet = m_pMyCamera.MV_CC_CreateDevice_NET(ref device);
if (MyCamera.MV_OK != nRet)
{
return;
}
nRet = m_pMyCamera.MV_CC_OpenDevice_NET();
if (MyCamera.MV_OK != nRet)
{
m_pMyCamera.MV_CC_DestroyDevice_NET();
MessageBox.Show("设备打开失败");
//ShowErrorMsg("Device open fail!", nRet);
return;
}
// ch:探测网络最佳包大小(只对GigE相机有效) | en:Detection network optimal package size(It only works for the GigE camera)
if (device.nTLayerType == MyCamera.MV_GIGE_DEVICE)
{
int nPacketSize = m_pMyCamera.MV_CC_GetOptimalPacketSize_NET();
if (nPacketSize > 0)
{
nRet = m_pMyCamera.MV_CC_SetIntValue_NET("GevSCPSPacketSize", (uint)nPacketSize);
if (nRet != MyCamera.MV_OK)
{
Console.WriteLine("Warning: Set Packet Size failed {0:x8}", nRet);
}
}
else
{
Console.WriteLine("Warning: Get Packet Size failed {0:x8}", nPacketSize);
}
}
// ch:设置采集连续模式 | en:Set Continues Aquisition Mode
m_pMyCamera.MV_CC_SetEnumValue_NET("AcquisitionMode", 2);// ch:工作在连续模式 | en:Acquisition On Continuous Mode
m_pMyCamera.MV_CC_SetEnumValue_NET("TriggerMode", 0); // ch:连续模式 | en:Continuous
}(3) 连续采集
//连续采集（也就是实时显示）
public void ContinuesGrab(PictureBox picBox)
{
int nRet;
// ch:开始采集 | en:Start Grabbing
nRet = m_pMyCamera.MV_CC_StartGrabbing_NET();
if (MyCamera.MV_OK != nRet)
{
MessageBox.Show("采集失败！");
//ShowErrorMsg("Trigger Fail!", nRet);
return;
}
//实时采集
m_pMyCamera.MV_CC_SetEnumValue_NET("TriggerMode", 0);
// ch:显示 | en:Display 在PictureBox控件中显示
nRet = m_pMyCamera.MV_CC_Display_NET(picBox.Handle);
if (MyCamera.MV_OK != nRet)
{
MessageBox.Show("显示失败！");
}
}(4) 停止采集
//停止采集
public void StopGrab()
{
int nRet = -1;
// ch:停止采集 | en:Stop Grabbing
nRet = m_pMyCamera.MV_CC_StopGrabbing_NET();
if (nRet != MyCamera.MV_OK)
{
MessageBox.Show("停止采集失败！");
}
}(5) 关闭设备
//关闭设备
public void CloseDevice()
{
// ch:关闭设备 | en:Close Device
int nRet;
nRet = m_pMyCamera.MV_CC_CloseDevice_NET();
if (MyCamera.MV_OK != nRet)
{
return;
}
nRet = m_pMyCamera.MV_CC_DestroyDevice_NET();
if (MyCamera.MV_OK != nRet)
{
return;
}
}(6) 转成Halcon图像
//读取图片转换成Halcon图像
public HImage ReadImage()
{
int nRet;
//MyCamera.MVCC_INTVALUE stParam = new MyCamera.MVCC_INTVALUE();
UInt32 nPayloadSize = 0;
nRet = m_pMyCamera.MV_CC_GetIntValue_NET("PayloadSize", ref stParam);
if (MyCamera.MV_OK != nRet)
{
return null;
}
nPayloadSize = stParam.nCurValue;
if (nPayloadSize > m_nBufSizeForDriver)
{
m_nBufSizeForDriver = nPayloadSize;
m_pBufForDriver = new byte[m_nBufSizeForDriver];
m_nBufSizeForSaveImage = m_nBufSizeForDriver * 3 + 2048;
m_pBufForSaveImage = new byte[m_nBufSizeForSaveImage];
}
IntPtr pData = Marshal.UnsafeAddrOfPinnedArrayElement(m_pBufForDriver, 0);
MyCamera.MV_FRAME_OUT_INFO_EX stFrameInfo = new MyCamera.MV_FRAME_OUT_INFO_EX();
nRet = m_pMyCamera.MV_CC_GetOneFrameTimeout_NET(pData, m_nBufSizeForDriver, ref stFrameInfo, 1000);//获取一帧图像，超时时间设置为1000
if (MyCamera.MV_OK != nRet)
{
return null;
}
HImage image = new HImage();
//采集的是黑白图像，利用Halcon图像库中的GenImage1算子来构建图像
image.GenImage1("byte", (int)stFrameInfo.nWidth, (int)stFrameInfo.nHeight, pData);
return image;
}下面是我所做的一个窗体界面，显示设备序列号的下拉列表做成了一个用户控件，将上述的代码全部放在用户控件中，在主窗体里调用用户控件里的方法来实现相机的连接和采集，具体见示例代码。
示例代码：
//查找设备
private void btnEnum_Click(object sender, EventArgs e)
{
ucDeviceList1.DeviceListAcq();
}
//打开设备
private void btnOpen_Click(object sender, EventArgs e)
{
ucDeviceList1.OpenDevice();
btnOpen.Enabled = false;
btnClose.Enabled = true;
btnContinuesGrab.Enabled = true;
//btnSingleStep.Enabled = true;
btnStopGrab.Enabled = true;
}
//关闭设备
private void btnClose_Click(object sender, EventArgs e)
{
ucDeviceList1.CloseDevice();
btnOpen.Enabled = true;
btnClose.Enabled = false;
btnContinuesGrab.Enabled = false;
btnSingleStep.Enabled = false;
btnStopGrab.Enabled = false;
}
//实时显示
private void btnContinuesGrab_Click(object sender, EventArgs e)
{
ucDeviceList1.ContinuesGrab(picboxShowImg);
btnContinuesGrab.Enabled = false;
btnSingleStep.Enabled = true;
btnStopGrab.Enabled = true;
}
//单步采集
private void btnSingleStep_Click(object sender, EventArgs e)
{
// 将采集到的图像在Halcon窗口中显示
HTuple hWind = hWindowControl1.HalconWindow;
HTuple width, height;
HObject hv_image;
HOperatorSet.GenEmptyObj(out hv_image);
hv_image.Dispose();
hv_image = ucDeviceList1.ReadImage();
HOperatorSet.GetImageSize(hv_image, out width, out height);
HOperatorSet.SetPart(hWind, 0, 0, height - 1, width - 1);
HOperatorSet.DispObj(img, hWind);
btnStopGrab.Enabled = true;
}
//停止采集
private void btnStopGrab_Click(object sender, EventArgs e)
{
ucDeviceList1.StopGrab();
btnContinuesGrab.Enabled = true;
btnStopGrab.Enabled = false;
}
//关闭设备
private void btnClose_Click(object sender, EventArgs e)
{
ucDeviceList1.CloseDevice();
btnOpen.Enabled = true;
btnClose.Enabled = false;
btnContinuesGrab.Enabled = false;
btnSingleStep.Enabled = false;
btnStopGrab.Enabled = false;
}注：上述方法是不需要修改相机IP的，但是要提前用MVS软件修改相机的IP