Baumer工业相机堡盟工业相机如何通过NEOAPISDK查询和轮询相机设备事件函数（C#）

Baumer工业相机
Baumer工业相机NEOAPI SDK和相机设备事件的技术背景
Baumer工业相机通过NEOAPISDK在相机中查询和轮询相机设备事件函数功能
- 1.引用合适的类文件
- 2.通过NEOAPISDK在相机中查询和轮询相机设备事件函数
Baumer工业相机通过SDK在相机中查询和轮询相机设备事件函数的优势
Baumer工业相机通过SDK在相机中查询和轮询相机设备事件函数的行业应用

Baumer工业相机

Baumer工业相机堡盟相机是一种高性能、高质量的工业相机，可用于各种应用场景，如物体检测、计数和识别、运动分析和图像处理。

Baumer的万兆网相机拥有出色的图像处理性能，可以实时传输高分辨率图像。此外，该相机还具有快速数据传输、低功耗、易于集成以及高度可扩展性等特点。

Baumer工业相机由于其性能和质量的优越和稳定，常用于高速同步采集领域，通常使用各种图像算法来提高其捕获的图像的质量。

Baumer工业相机堡盟相机在SDK中的可以进行相机IO信号的输出，工业相机的 IO 信号输出功能使得相机能够与其他设备实现无缝连接和通信，提升工业自动化系统的效率和灵活性。

Baumer工业相机NEOAPI SDK是用于Baumer工业相机的一款最新的软件开发工具包（SDK）。它为开发人员提供了一系列API和工具，用于与Baumer工业相机进行通信和控制，控制方式极为便捷类似Halcon的相机助手类控制方式。

通过结合 Baumer 工业相机的NEOAPI SDK 在相机中查询和轮询相机设备事件函数，可以极大增强图像数据的功能性和应用范围。

Baumer工业相机NEOAPI SDK和相机设备事件的技术背景

Baumer工业相机的NEOAPI SDK是Baumer公司开发的针对其相机产品系列的一套软件开发工具包。该SDK提供了一组API，使开发人员可以编写专业应用程序，从而控制、捕获、处理和显示Baumer相机的图像和数据。BGAPI SDK支持多种编程语言，包括C++、C#、Visual Basic、LabVIEW、Matlab等，并提供了大量示例代码和文档，以帮助用户轻松上手，快速完成应用程序的开发。

NEOAPI SDK提供了丰富的功能，可以控制Baumer相机的所有参数，包括曝光时间、增益、白平衡、触发模式等，以及支持各种数据格式，例如Raw、BMP、JPG等，同时还提供了实时显示、数据采集、图像处理等功能，为开发人员提供了高度定制化的解决方案。此外，BGAPI SDK还支持多相机系统的开发，并可支持各种计算机操作系统，如Windows、Linux、Mac OS等。

设备事件由相机生成。典型的事件包括 ExposureStart/End、TriggerReady 或 Line[X]RisingEdge。可用事件取决于特定的相机。您可以使用这些事件来控制应用程序的流程。默认情况下，所有设备事件都是禁用的。您需要先在相机上启用它们。

请注意：

由于每次采集都会产生许多事件，因此启用许多事件会产生很大的负载。这可能会影响相机和应用程序的性能。

Baumer工业相机通过NEOAPISDK在相机中查询和轮询相机设备事件函数功能

下面介绍在C#里 Baumer工业相机如何通过NEOAPISDK在相机图像中绑定元数据和块数据的方式

1.引用合适的类文件

代码如下（示例）：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.InteropServices;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Data;
using System.Globalization;
using System.Diagnostics;
using System.IO;
using NeoAPI;

2.通过NEOAPISDK在相机中查询和轮询相机设备事件函数

下面的代码显示了如何找出工业相机支持的事件：

using System;
using System.IO;
using NeoAPI;

using co = System.Console;
NeoAPI.Cam camera = new NeoAPI.Cam();
camera.Connect();  // 连接到工业相机

foreach (var event_name in camera.AvailableEvents) 
{ 
	// 循环查看事件
	co.WriteLine("event name: " + event_name); // 打印事件名称
}
camera.Dispose();

下面的示例显示了使用软件触发器触发相机的情况。ExposureStart 事件用于确定图像采集的确切开始时间。这个时间与软件触发器的执行时间不同，因为向相机传输触发请求需要时间。

using System;
using System.IO;
using NeoAPI;

using co = System.Console;
NeoAPI.Cam camera = new NeoAPI.Cam();
camera.Connect();  // 连接到工业相机
camera.f.ExposureTime.Value= 40; // 设置曝光时间
camera.f.TriggerMode.Value = NeoAPI.TriggerMode.On;  // 配置工业相机为软件触发
camera.f.TriggerSource.Value = NeoAPI.TriggerSource.Software;
NeoAPI.NeoEventcam_event = new  NeoAPI.NeoEvent();
camera.ClearEvents();//清除任何可能排队的事件
camera.EnableEvent("ExposureStart"); // 启用 ExposureStart 事件
camera.f.TriggerSoftware.Execute(); // 发送软件触发器
cam_event = camera.GetEvent(); // 获取事件，等待默认超时

if  (!cam_event.IsEmpty) 
{ 
	// 检查是否有事件返回
	co.WriteLine("received event：" + cam_event.Name + " at：" +
	cam_event.Timestamp.ToString() + " id: 0x" + cam_event.Id)；
}

camera.DisableEvent("ExposureStart"); // 禁用事件
camera.Dispose();

NeoAPI::Cam::GetEvent()函数将等待 400 毫秒的默认超时后才返回。它将始终返回一个事件或一个空事件（如果超时期间没有事件到达）。您可能需要多次调用该函数，直到收到所有排队的事件。如果只想轮询某个事件，可以使用 NeoAPI::Cam::GetEvent()调用时可输入一个字符串，其中包含感兴趣的事件名称。

通过回调处理程序处理设备事件

设备事件也可以异步接收。您需要编写一个事件处理方法，对接收到的事件进行有用的处理。一旦编写了这个方法，就需要使用 NeoAPI::Cam::EnableEventCallback()方法启用事件回调，并使用 NeoAPI::Cam::DeviceEventCallback() 方法注册处理程序。

您可以以字符串形式提供事件名称，以便将处理程序限制在特定事件上。但是，每个事件名称只能注册一个处理程序。使用空字符串注册处理程序将接收所有事件。

请注意：

如果您选择将轮询和回调方法混合使用，已注册的回调将首先接收事件，而不能用于轮询。

using System;
using System.IO;
using NeoAPI;
using co = System.Console.NET

// 创建事件处理程序

public void test_device_event_handler(object obj、 NeoAPI.NeoEventEventArgsargs)
{
	co.WriteLine("received event：" + args.Event.Name + " at：" +
	args.Event.Timestamp + " id: 0x" + args.Event.Id)；
}

NeoAPI.Cam camera = new NeoAPI.Cam();
camera.Connect(); // 连接到工业相机
NeoAPI.NeoEventcam_event = new  NeoAPI.NeoEvent();
camera.f.ExposureTime.Value = 40；
camera.EnableEventCallback("ExposureStart"); // 仅为 ExposureStart 事件注册方法

camera.DeviceEventCallbacks["ExposureStart"].Handler += test_device_event_handler; // 注册处理程序

camera.ClearEvents();//清除任何可能排队的事件
camera.EnableEvent("ExposureStart"); // 启用事件
camera.EnableEvent("ExposureEnd")；
camera.f.TriggerSoftware.Execute()；
camera.DisableEventCallback()；
camera.DisableEvent("ExposureStart"); // 禁用事件
camera.DisableEvent("ExposureEnd")；
camera.Dispose();