C# 开源SDK 工业相机库 调用海康相机 大恒相机

介绍

c# 相机库，含海康、大恒品牌2D相机的常用功能。
底层采用回调+信号量模式封装 ，最大程度减小线程资源，提高采图效率。

开源地址：https://gitee.com/laomaogu/mgcamctrl
功能持续完善中。。。

工厂模式创建实例

ICamera myCamera;
myCamera= CamFactory.CreatCamera(CameraBrand.HIK);//CameraBrand.DaHeng
1
2

选取对应SN号的相机，初始化

 //获取相机枚举
var devicelist = myCamera.GetListEnum();
//or
//var devicelist = CamFactory.GetDeviceEnum(CameraBrand.HIK); 

//选对应SN,初始化相机 
myCamera.InitDevice(devicelist.First());
1
2
3
4
5
6
7

启动相机

启动相机有以下几种方式：

• 常规硬触发
• 常规软触发
• 硬触发 + 回调
• 软触发 + 回调

 //硬触发模式  启动相机
myCamera.StartWith_HardTriggerModel(HardTriggerModel.Line0); 

//软触发模式  启动相机
//myCamera.StartWith_SoftTriggerModel(); 

//硬触发 + 回调模式  启动相机
// myCamera.StartWith_HardTriggerModel_SetCallback(HardTriggerModel.Line0, CameraCallBack); 

//软触发 + 回调模式  启动相机
//myCamera.StartWith_SoftTriggerModel_SetCallback(CameraCallBack); 
1
2
3
4
5
6
7
8
9
10
11

回调函数：

/// 

/// 回调函数
/// 
/// 
private void CameraCallBack(Bitmap bmp)
{

	//执行取图后的操作
	bmp.Save("./test.bmp");
}
1
2
3
4
5
6
7
8
9
10

取图

//等待硬触发 获取图片, 设定超时：5000ms
myCamera.GetImage(out Bitmap CaptureImage,5000);
//or 使用默认超时时间
//myCamera.GetImage(out Bitmap CaptureImage);

//软触发获取图像
//myCamera.GetImageWithSoftTrigger(out Bitmap CaptureImage);



/// 

/// 回调函数
/// 
/// 
private void CameraCallBack(Bitmap bmp)
{

	//执行取图后的操作
	bmp.Save("./test.bmp");
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

注销相机

//注销当前实例
myCamera.CloseDevice();
or
//CamFactory.DestroyCamera(myCamera);
or
//CamFactory.DestroyAll();   
 
1
2
3
4
5
6
7

参数设置/获取

含常用参数设置和获取
如曝光值、延时、硬触发方式等
详细见接口小节

接口

namespace MG.CamCtrl
{
    public interface ICamera : IDisposable
    {

        #region  operate
        /// 

        /// 获取相机SN枚举
        /// 
        /// 
        List<string> GetListEnum();

        /// 

        /// 初始化相机
        /// 
        /// 
        /// 
        bool InitDevice(string CamSN);

        /// 

        /// 注销相机
        /// 
        void CloseDevice();

        /// 

        /// 回调 + 循环采图 启动相机
        /// 
        /// 
        /// 
        bool StartWith_Continue_SetCallback(Action<Bitmap> callbackfunc);

        /// 

        /// 软触发模式 启动相机
        /// 
        /// 
        bool StartWith_SoftTriggerModel();

        /// 

        /// 硬触发模式 启动相机
        /// 
        /// 
        /// 
        bool StartWith_HardTriggerModel(TriggerSource hardtriggeritem);

        /// 

        /// 硬触发 + 回调 启动相机
        /// 
        /// 
        /// 
        /// 
        bool StartWith_HardTriggerModel_SetCallback(TriggerSource hardtriggeritem, Action<Bitmap> callbackfunc);

        /// 

        /// 软触发 + 回调 启动相机
        /// 
        /// 
        /// 
        bool StartWith_SoftTriggerModel_SetCallback(Action<Bitmap> callbackfunc);

        /// 

        /// 等待硬触发获取图像
        /// 
        /// 
        /// 
        /// 
        bool GetImage(out Bitmap bitmap, int outtime = 3000);

        /// 

        /// 软触发获取图像
        /// 
        /// 
        /// 
        /// 
        bool GetImageWithSoftTrigger(out Bitmap bitmap, int outtime = 3000);

        /// 

        /// 软触发
        /// 
        /// 
        bool SoftTrigger();

        #endregion


        #region SettingConfig
        /// 

        /// 设置相机参数
        /// 
        /// 
        void SetCamConfig(CamConfig config);
        /// 

        /// 获取相机参数
        /// 
        /// 
        void GetCamConfig(out CamConfig config);

        /// 

        /// 设置触发模式及触发源
        /// 
        /// 
        /// 
        /// 
        bool SetTriggerMode(TriggerMode mode, TriggerSource triggerEnum = TriggerSource.Line0);

        /// 

        /// 获取触发模式及触发源
        /// 
        /// 
        /// 
        /// 
        bool GetTriggerMode(out TriggerMode mode, out TriggerSource hardTriggerModel);

        /// 

        /// 设置曝光时长
        /// 
        /// 
        /// 
        bool SetExpouseTime(ushort value);

        /// 

        /// 获取曝光时长
        /// 
        /// 
        /// 
        bool GetExpouseTime(out ushort value);

        /// 

        /// 设置硬触发极性
        /// 
        /// 
        /// 
        bool SetTriggerPolarity(TriggerPolarity polarity);

        /// 

        /// 获取硬触发极性
        /// 
        /// 
        /// 
        bool GetTriggerPolarity(out TriggerPolarity polarity);

        /// 

        /// 设置触发滤波时间 （us）
        /// 
        /// 
        /// 
        bool SetTriggerFliter(ushort flitertime);

        /// 

        /// 获取触发滤波时间 （us）
        /// 
        /// 
        /// 
        bool GetTriggerFliter(out ushort flitertime);

        /// 

        /// 设置触发延时
        /// 
        /// 
        /// 
        bool SetTriggerDelay(ushort delay);

        /// 

        /// 获取触发延时
        /// 
        /// 
        /// 
        bool GetTriggerDelay(out ushort delay);

        /// 

        /// 设置增益
        /// 
        /// 
        /// 
        bool SetGain(short gain);

        /// 

        /// 获取增益值
        /// 
        /// 
        /// 
        bool GetGain(out short gain);

        /// 

        /// 设置信号线模式
        /// 
        /// 
        /// 
        /// 
        bool SetLineMode(IOLines line, LineMode mode);

        /// 

        /// 设置信号线电平状态
        /// 
        /// 
        /// 
        /// 
        bool SetLineStatus(IOLines line, LineStatus linestatus);

        /// 

        /// 获取信号线电平状态
        /// 
        /// 
        /// 
        /// 
        bool GetLineStatus(IOLines line, out LineStatus lineStatus);

        /// 

        /// 自动白平衡
        /// 
        /// 
        bool AutoBalanceWhite();

        #endregion

    }
}

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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217