获取方式
IDevice.StreamGrabber
设备实例对象的StreamGrabber属性可以返回IStream对象。
常用属性
IsStart
判断是否开启捕获码流，是，返回true；否，返回false。
private void test_Click(object sender, EventArgs e)
{
List<IDeviceInfo> devices = Enumerator.EnumerateDevices();
IDevice device = Enumerator.GetDeviceByGigeIP("192.168.0.11");
device.Open();
IStream stream = device.StreamGrabber;
Console.WriteLine("执行start方法前，是否开启捕获码流："+stream.IsStart);
stream.Start();
Console.WriteLine("执行start方法后，是否开启捕获码流：" + stream.IsStart);
stream.Stop();
Console.WriteLine("执行stop方法后，是否开启捕获码流：" + stream.IsStart);
device.Close();
}
运行结果：
执行start方法前，是否开启捕获码流：False
执行start方法后，是否开启捕获码流：True
执行stop方法后，是否开启捕获码流：False常用方法
getStatisticsInfo()
获取码流的统计信息，可以获取带宽，频率，获取错误图像，接受图像数据，丢包数等数据。
private void button1_Click(object sender, EventArgs e)
{
List<IDeviceInfo> lst=Enumerator.EnumerateDevices();
IDevice device = Enumerator.GetDeviceByGigeIP("192.168.0.10");
device.Open();
IStream stream = device.StreamGrabber;
Console.WriteLine("打开相机后device的IsOpen属性" + device.IsOpen);
Console.WriteLine("打开相机后stream的IsStart属性" + stream.IsStart);
stream.ImageGrabbed += Stream_ImageGrabbed;
//stream.Start();
device.GrabUsingGrabLoopThread();
Console.WriteLine("stream使用GrabUsingGrabLoopThread()方法后stream的IsStart属性" + stream.IsStart);
Thread.Sleep(3000);
IStreamStatisticsInfo streamInfo = stream.getStatisticsInfo();
Console.WriteLine("stream的带宽：" + streamInfo.Bandwidth);
Console.WriteLine("stream的帧率：" + streamInfo.Fps);
Console.WriteLine("stream的错误图像：" + streamInfo.ImageError);
Console.WriteLine("stream获取图像" + streamInfo.ImageReceived);
Console.WriteLine("stream丢包帧数" + streamInfo.LostPacketBlock);
stream.Stop();
Console.WriteLine("stream使用stop（）方法后stream的IsStart属性" + stream.IsStart);
device.Close();
}
private void Stream_ImageGrabbed(object sender, GrabbedEventArgs e)
{
Console.WriteLine("触发抓图事件");
}
运行结果：
打开相机后device的IsOpen属性True
打开相机后stream的IsStart属性False
stream使用GrabUsingGrabLoopThread()方法后stream的IsStart属性True
触发抓图事件
触发抓图事件
触发抓图事件
...
省略一大段
...
触发抓图事件
触发抓图事件
触发抓图事件
stream的带宽：850.29892944
stream的帧率：20.02
stream的错误图像：0
stream获取图像60
stream丢包帧数0
线程 '[线程已销毁]' (23160) 已退出，返回值为 0 (0x0)。
stream使用stop（）方法后stream的IsStart属性FalseresetStatisticsInfo()
重置码流统计信息。
SetBufferCount(int nCount)
设置帧缓存大小。帧缓存大小的计算方式这里就不叙述了，有需要请自行百度。
setInterPacketTimeout(int nTimeout)
设置驱动包间隔超时时间（ms），仅支持GigE设备。
setMaxLostPacketNum(int nMaxLostPacketNum)
设置同一帧最大丢包的数量,仅对GigE设备有效。
setSingleResendMaxPacketNum(int nMaxPacketNum)
设置单次重传最大包个数,仅对GigE设备有效。
Start()
开始捕获码流，如果没有设置Trigger模式，那么码流一直在抓图，一直触发ImageGrabbed事件。
Start(long maxImages)
开始捕获码流，并且获取maxImages设置的帧数图像。
Stop()
停止码流。
常用事件
GrabStarted
当开始捕获码流时，触发该事件。
GrabStoped
当停止捕获码流时，触发该事件。
private void test_Click(object sender, EventArgs e)
{
List<IDeviceInfo> devices = Enumerator.EnumerateDevices();
IDevice device = Enumerator.GetDeviceByGigeIP("192.168.0.11");
device.Open();
IStream stream = device.StreamGrabber;
stream.GrabStarted += Stream_GrabStarted;
stream.GrabStoped += Stream_GrabStoped;
stream.Start();
stream.Stop();
device.Close();
}
private void Stream_GrabStoped(object sender, EventArgs e)
{
Console.WriteLine("发生码流停止事件");
}
private void Stream_GrabStarted(object sender, EventArgs e)
{
Console.WriteLine("发生码流开启事件");
}
运行结果：
发生码流开启事件
发生码流停止事件ImageGrabbed
当码流采集图像时，触发此事件。抓图可以分为连续抓图，单张抓图和多张抓图。
连续抓图
private void button1_Click(object sender, EventArgs e)
{
List<IDeviceInfo> devices=Enumerator.EnumerateDevices();
IDevice device = Enumerator.GetDeviceByGigeIP("192.168.0.10");
device.Open();
ITrigger trigger = device.TriggerSet;
trigger.Open(TriggerSourceEnum.Software);
trigger.Close();
Console.WriteLine("device.isTriggerOn"+device.IsTriggerOn);
IStream stream= device.StreamGrabber;
stream.GrabStarted += Stream_GrabStarted;
stream.GrabStoped += Stream_GrabStoped;
stream.ImageGrabbed += Stream_ImageGrabbed;
stream.Start();
Thread.Sleep(1000);
stream.Stop();
}
private void Stream_ImageGrabbed(object sender, GrabbedEventArgs e)
{
Console.WriteLine("抓图事件触发");
}
private void Stream_GrabStoped(object sender, EventArgs e)
{
Console.WriteLine("---------------------------------");
Console.WriteLine("码流停止事件触发");
}
private void Stream_GrabStarted(object sender, EventArgs e)
{
Console.WriteLine("---------------------------------");
Console.WriteLine("码流启动事件触发");
}
运行结果：
device.isTriggerOn:False
---------------------------------
码流启动事件触发
抓图事件触发
抓图事件触发
···
省略
...
抓图事件触发
抓图事件触发
抓图事件触发
线程 '[线程已销毁]' (1220) 已退出，返回值为 0 (0x0)。
---------------------------------
码流停止事件触发如上，如果希望stream调用start（）函数以后连续抓图，那么需要trigger调用close（）函数，把device的IsTriggerOn属性设为false即可。
单张抓图
private void button1_Click(object sender, EventArgs e)
{
List<IDeviceInfo> devices=Enumerator.EnumerateDevices();
IDevice device = Enumerator.GetDeviceByGigeIP("192.168.0.10");
device.Open();
ITrigger trigger = device.TriggerSet;
trigger.Open(TriggerSourceEnum.Software);
Console.WriteLine("device.isTriggerOn:"+device.IsTriggerOn);
IStream stream= device.StreamGrabber;
stream.GrabStarted += Stream_GrabStarted;
stream.GrabStoped += Stream_GrabStoped;
stream.ImageGrabbed += Stream_ImageGrabbed;
stream.Start();
trigger.ExecuteSoftwareTrigger();
Thread.Sleep(1000);
stream.Stop();
}
事件函数不变。
运行结果：
device.isTriggerOn:True
---------------------------------
码流启动事件触发
抓图事件触发
线程 '[线程已销毁]' (15084) 已退出，返回值为 0 (0x0)。
---------------------------------
码流停止事件触发如上，如果需要软件触发就采图一次的话，那么需要trigger调用Open（）方法，并把触发源，设为Software，设置好以后，在stream打开以后，trigger执行一次ExecuteSoftwareTrigger()，就会采一张图。如果需要信号线控制采图，那么只要在Open（）方法里面设置对应的通道，然后打开stream后，给对应通道的线信号既可以执行单张取图。
多张取图
private void button1_Click(object sender, EventArgs e)
{
List<IDeviceInfo> devices=Enumerator.EnumerateDevices();
IDevice device = Enumerator.GetDeviceByGigeIP("192.168.0.10");
device.Open();
ITrigger trigger = device.TriggerSet;
trigger.Open(TriggerSourceEnum.Software,5);
Console.WriteLine("device.isTriggerOn:"+device.IsTriggerOn);
IStream stream= device.StreamGrabber;
stream.GrabStarted += Stream_GrabStarted;
stream.GrabStoped += Stream_GrabStoped;
stream.ImageGrabbed += Stream_ImageGrabbed;
stream.Start();
trigger.ExecuteSoftwareTrigger();
Thread.Sleep(1000);
stream.Stop();
}
事件代码不变
运行结果：
device.isTriggerOn:True
---------------------------------
码流启动事件触发
抓图事件触发
抓图事件触发
抓图事件触发
抓图事件触发
抓图事件触发
线程 '[线程已销毁]' (3936) 已退出，返回值为 0 (0x0)。
---------------------------------
码流停止事件触发如上，只要在trigger的Open（）参数中添加要采图张数即可。
