位置：首页-资讯-后端开发

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

2023-02-26 14:39

短信预约 -IT技能 免费直播动态提醒

调用海康工业相机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