c#连接海康工业相机，基础功能示例_c#连接海康相机

开发工具：VS2022

第一步去海康官网下载工业相机的SDK Runtime组件包

https://www.hikrobotics.com/cn/machinevision/service/download?module=0
链接如果失效去百度搜索海康机器人官网

如果在测试时出现问题，有连接不上相机，或者出现找不到XXX.dll的问题，去官网安装MVS的客户端，然后在进行软件调试

机器视觉>服务支持>下载中心>选择Runtime组件包

选择下载解压后安装

打开相机设备

 private void bnOpen_Click(object sender, EventArgs e)
 {
     if (m_ltDeviceList.Count == 0 || cbDeviceList.SelectedIndex == -1)
     {
         ShowErrorMsg("No device, please select", 0);
         return;
     }

     // ch:获取选择的设备信息 | en:Get selected device information
     CCameraInfo device = m_ltDeviceList[cbDeviceList.SelectedIndex];

     // ch:打开设备 | en:Open device
     if (null == m_MyCamera)
     {
         m_MyCamera = new CCamera();
         if (null == m_MyCamera)
         {
             return;
         }
     }

     int nRet = m_MyCamera.CreateHandle(ref device);
     if (CErrorDefine.MV_OK != nRet)
     {
         return;
     }

     nRet = m_MyCamera.OpenDevice();
     if (CErrorDefine.MV_OK != nRet)
     {
         m_MyCamera.DestroyHandle();
         ShowErrorMsg("Device open fail!", nRet);
         return;
     }

     // ch:探测网络最佳包大小(只对GigE相机有效) | en:Detection network optimal package size(It only works for the GigE camera)
     if (device.nTLayerType == CSystem.MV_GIGE_DEVICE)
     {
         int nPacketSize = m_MyCamera.GIGE_GetOptimalPacketSize();
         if (nPacketSize > 0)
         {
             nRet = m_MyCamera.SetIntValue("GevSCPSPacketSize", (uint)nPacketSize);
             if (nRet != CErrorDefine.MV_OK)
             {
                 ShowErrorMsg("Set Packet Size failed!", nRet);
             }
         }
         else
         {
             ShowErrorMsg("Get Packet Size failed!", nPacketSize);
         }
     }

     // ch:设置采集连续模式 | en:Set Continues Aquisition Mode
     m_MyCamera.SetEnumValue("AcquisitionMode", (uint)MV_CAM_ACQUISITION_MODE.MV_ACQ_MODE_CONTINUOUS);
     m_MyCamera.SetEnumValue("TriggerMode", (uint)MV_CAM_TRIGGER_MODE.MV_TRIGGER_MODE_OFF);

     bnGetParam_Click(null, null);// ch:获取参数 | en:Get parameters

     // ch:控件操作 | en:Control operation
     SetCtrlWhenOpen();
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

关闭相机

private void bnClose_Click(object sender, EventArgs e)
{
    // ch:取流标志位清零 | en:Reset flow flag bit
    if (m_bGrabbing == true)
    {
        m_bGrabbing = false;
        m_hReceiveThread.Join();
    }

    // ch:关闭设备 | en:Close Device
    m_MyCamera.CloseDevice();
    m_MyCamera.DestroyHandle();

    // ch:控件操作 | en:Control Operation
    SetCtrlWhenClose();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

连续模式

  private void bnContinuesMode_CheckedChanged(object sender, EventArgs e)
  {
      if (bnContinuesMode.Checked)
      {
          m_MyCamera.SetEnumValue("TriggerMode", (uint)MV_CAM_TRIGGER_MODE.MV_TRIGGER_MODE_OFF);
          cbSoftTrigger.Enabled = false;
          bnTriggerExec.Enabled = false;
      }
  }
1
2
3
4
5
6
7
8
9

触发模式 软触发

private void bnTriggerMode_CheckedChanged(object sender, EventArgs e)
{
    // ch:打开触发模式 | en:Open Trigger Mode
    if (bnTriggerMode.Checked)
    {
        m_MyCamera.SetEnumValue("TriggerMode", (uint)MV_CAM_TRIGGER_MODE.MV_TRIGGER_MODE_ON);

        // ch:触发源选择:0 - Line0; | en:Trigger source select:0 - Line0;
        //           1 - Line1;
        //           2 - Line2;
        //           3 - Line3;
        //           4 - Counter;
        //           7 - Software;
        if (cbSoftTrigger.Checked)
        {
            m_MyCamera.SetEnumValue("TriggerSource", (uint)MV_CAM_TRIGGER_SOURCE.MV_TRIGGER_SOURCE_SOFTWARE);
            if (m_bGrabbing)
            {
                bnTriggerExec.Enabled = true;
            }
        }
        else
        {
            m_MyCamera.SetEnumValue("TriggerSource", (uint)MV_CAM_TRIGGER_SOURCE.MV_TRIGGER_SOURCE_LINE0);
        }
        cbSoftTrigger.Enabled = true;
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

开始采集

 private void bnStartGrab_Click(object sender, EventArgs e)
 {
     // ch:前置配置 | en:pre-operation
     int nRet = NecessaryOperBeforeGrab();
     if (CErrorDefine.MV_OK != nRet)
     {
         return;
     }

     // ch:标志位置位true | en:Set position bit true
     m_bGrabbing = true;

     m_hReceiveThread = new Thread(ReceiveThreadProcess);
     m_hReceiveThread.Start();

     // ch:开始采集 | en:Start Grabbing
     nRet = m_MyCamera.StartGrabbing();
     if (CErrorDefine.MV_OK != nRet)
     {
         m_bGrabbing = false;
         m_hReceiveThread.Join();
         ShowErrorMsg("Start Grabbing Fail!", nRet);
         return;
     }

     // ch:控件操作 | en:Control Operation
     SetCtrlWhenStartGrab();
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

停止采集

private void bnStopGrab_Click(object sender, EventArgs e)
{
    // ch:标志位设为false | en:Set flag bit false
    m_bGrabbing = false;
    m_hReceiveThread.Join();

    // ch:停止采集 | en:Stop Grabbing
    int nRet = m_MyCamera.StopGrabbing();
    if (nRet != CErrorDefine.MV_OK)
    {
        ShowErrorMsg("Stop Grabbing Fail!", nRet);
    }

    // ch:控件操作 | en:Control Operation
    SetCtrlWhenStopGrab();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

软触发

private void cbSoftTrigger_CheckedChanged(object sender, EventArgs e)
{
    if (cbSoftTrigger.Checked)
    {
        // ch:触发源设为软触发 | en:Set trigger source as Software
        m_MyCamera.SetEnumValue("TriggerSource", (uint)MV_CAM_TRIGGER_SOURCE.MV_TRIGGER_SOURCE_SOFTWARE);
        if (m_bGrabbing)
        {
            bnTriggerExec.Enabled = true;
        }
    }
    else
    {
        m_MyCamera.SetEnumValue("TriggerSource", (uint)MV_CAM_TRIGGER_SOURCE.MV_TRIGGER_SOURCE_LINE0);
        bnTriggerExec.Enabled = false;
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

相机白平衡

private void button1_whitebalance_Click(object sender, EventArgs e)
{
    try
    {
        if (m_ltDeviceList.Count > 0)
        {
            CCameraInfo cameraInfo = m_ltDeviceList[0]; // 假设获取第一个相机信息
                                                        // 设置自动白平衡为 "Once"
            m_MyCamera.SetEnumValue("BalanceWhiteAuto", (uint)MV_CAM_BALANCEWHITE_AUTO.MV_BALANCEWHITE_AUTO_ONCE);
        }
        else
        {
            MessageBox.Show("没有找到相机设备。");
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show("操作出现错误：" + ex.Message);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20