C#调用海康工业相机SDK采集图像并在Halcon窗口中显示方式

.NET
729
0
0
2023-04-04
C#中如何连接海康威视
上一篇
C#实现不同窗体之间传递参数
下一篇
标签   C#
目录
  • 调用海康工业相机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

C#中如何连接海康威视
上一篇
C#实现不同窗体之间传递参数
下一篇