大华相机C#学习之IStream类

获取方式

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属性False

---

resetStatisticsInfo()

重置码流统计信息。

---

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（）参数中添加要采图张数即可。

---