目录
- 调用海康工业相机SDK采集图像并在Halcon窗口中显示
- 引用动态链接库
- 创建相机类
- (1) 查找设备列表
- (2) 打开设备
- (3) 连续采集
- (4) 停止采集
- (5) 关闭设备
- (6) 转成Halcon图像
- 总结
调用海康工业相机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