Baumer工业相机堡盟工业相机如何通过BGAPI SDK在相机图像中绑定元数据和块数据（Chunk功能）（C#）

Baumer工业相机

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

Baumer的万兆网相机拥有出色的图像处理性能，可以实时传输高分辨率图像。此外，该相机还具有快速数据传输、低功耗、易于集成以及高度可扩展性等特点。
​
Baumer工业相机由于其性能和质量的优越和稳定，常用于高速同步采集领域，通常使用各种图像算法来提高其捕获的图像的质量。

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

Baumer工业相机NEOAPI SDK是用于Baumer工业相机的一款传统的软件开发工具包（SDK）。它为开发人员提供了一系列API和工具，用于与Baumer工业相机进行通信和控制。​

通过结合 Baumer 工业相机的BGAPI SDK 在相机图像中绑定元数据及块数据，可以极大增强图像数据的功能性和应用范围。

Baumer工业相机BGAPI SDK和元数据和块数据的技术背景

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

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

BGAPI SDK可以通过图像获取额外的元数据。如果这些数据是由工业相机生成的，那么在 GenICam 的世界中就称为块数据。默认情况下，工业相机提供的所有块数据都会被禁用，以节省经常受到限制的接口（千兆以太网或 USB3）的带宽。

本文这里介绍通过BGAPI SDK在相机图像中绑定元数据和块数据的方法。

Baumer工业相机通过BGAPI SDK在相机图像中绑定元数据和块数据功能

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

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 BGAPI2;

2.通过BGAPI SDK在相机图像中绑定元数据和块数据

BGAPI 提供了多种方法来帮助配置块数据设置。

下面是用设置Chunk块数据的示例代码。

SystemList 
Open a System 
Get the InterfaceList and fill it Open an Interface 
Open a device
// 设置 Chunk
if (mDevice.RemoteNodeList["ChunkSelector"].EnumNodeList.Count > 2)
{
   bIsAvailableChunkExtendedMode = true;
   // ACTIVATE CHUNK
   mDevice.RemoteNodeList["ChunkModeActive"].Value = true;
   System.Console.Write("ChunkModeActive:{0}\r\n", (bool)mDevice.RemoteNodeList["ChunkModeActive"].Value);

  for (ulong i = 0; i < mDevice.RemoteNodeList["ChunkSelector"].EnumNodeList.Count; i++)
  {
      mDevice.RemoteNodeList["ChunkSelector"].Value = (string)mDevice.RemoteNodeList["ChunkSelector"].EnumNodeList[i].Value;
      System.Console.Write("ChunkSelector:{0}\r\n", (string)mDevice.RemoteNodeList["ChunkSelector"].Value);
     if (mDevice.RemoteNodeList["ChunkEnable"].IsWriteable)
     {
         mDevice.RemoteNodeList["ChunkEnable"].Value = true;
     }
     System.Console.Write("ChunkEnable:{0}\r\n", (bool)mDevice.RemoteNodeList["ChunkEnable"].Value);
   }
   System.Console.Write("\r\n");
 }
   

下面是用Chunk功能获取块数据的示例代码。

if (bIsAvaliableFreeformatHeader2 == true)
 {
      System.Console.Write("   Buffer.PixelFormat:       {0}\r\n", mBufferFilled.PixelFormat);
      System.Console.Write("   Buffer.Width:                  {0}\r\n", mBufferFilled.Width);
      System.Console.Write("   Buffer.Height:                 {0}\r\n", mBufferFilled.Height);

      img_offset = (ulong)mBufferFilled.ImageOffset;
      System.Console.Write("   Buffer.ImageOffset:            {0}\r\n", img_offset);

      //COPY UNMANAGED IMAGEHEADERBUFFER TO A MANAGED BYTE ARRAY
      mageHeaderBufferCopy = new int[img_offset / 4];//8-Bit byte img_offset converted to 32-Bit int offset
      Marshal.Copy(mBufferFilled.MemPtr, imageHeaderBufferCopy, 0, (int)(img_offset / 4));

  	  if (imageHeaderBufferCopy[0] == 0x1A2A3A4A) // 00 Start pattern of BGAPI Image Header V2
      {
          System.Console.Write("Chunk.ExposureTime:{0}\r\n", imageHeaderBufferCopy[8]);                                 // 08 exposure value
          System.Console.Write("Chunk.Gain: {0}\r\n", imageHeaderBufferCopy[10]);                                // 10 analog gain
                System.Console.Write("    Chunk.BlackLevelOffset:       {0}\r\n", imageHeaderBufferCopy[11]);                                // 11 analog offset
                System.Console.Write("    Chunk.OffsetX:                {0}\r\n", (ushort)((imageHeaderBufferCopy[21] & 0x0000fffff)));      // 21_0 start position x of current frame
                System.Console.Write("    Chunk.OffsetY:                {0}\r\n", (ushort)((imageHeaderBufferCopy[21] & 0xffff0000) >> 16)); // 21_1 start position y of current frame
                System.Console.Write("    Chunk.Width:                  {0}\r\n", (ushort)((imageHeaderBufferCopy[22] & 0x0000fffff)));      // 22_0 extension in x direction of current frame
                System.Console.Write("    Chunk.Height:                 {0}\r\n", (ushort)((imageHeaderBufferCopy[22] & 0xffff0000) >> 16)); // 22_1 extension in y direction of current frame
                System.Console.Write("    Chunk.FrameCounter:           {0}\r\n", imageHeaderBufferCopy[25]);                                // 25 framecounter
                System.Console.Write("    Chunk.PixelFormatHex:         0x{0:x}\r\n", imageHeaderBufferCopy[29]);                            // 29 dataformat Rawbayer, RGB, YUV
                sPixelFormat = "";
                switch (imageHeaderBufferCopy[29]) // 29 dataformat Rawbayer, RGB, YUV
                {
                  case 0x01080001: sPixelFormat = "Mono8"; break;
                  case 0x01100003: sPixelFormat = "Mono10"; break;
                  case 0x010C0004: sPixelFormat = "Mono10Packed"; break;
                  case 0x01100005: sPixelFormat = "Mono12"; break;
                  case 0x010C0006: sPixelFormat = "Mono12Packed"; break;
                  case 0x0108000A: sPixelFormat = "BayerGB8"; break;
                  case 0x0110000E: sPixelFormat = "BayerGB10"; break;
                  case 0x01100012: sPixelFormat = "BayerGB12"; break;
                  case 0x01080009: sPixelFormat = "BayerRG8"; break;
                  case 0x0110000D: sPixelFormat = "BayerRG10"; break;
                  case 0x01100011: sPixelFormat = "BayerRG12"; break;
                  case 0x02180015: sPixelFormat = "BGR8Packed"; break;
                  case 0x02180014: sPixelFormat = "RGB8Packed"; break;
                  case 0x020C001E: sPixelFormat = "YUV411Packed"; break;
                  case 0x0210001F: sPixelFormat = "YUV422Packed"; break;
                  case 0x02180020: sPixelFormat = "YUV444Packed"; break;
                  //default: sPixelFormat = "unknown";
                }
                System.Console.Write("    Chunk.PixelFormat:            {0}\r\n", sPixelFormat); // 29 dataformat Rawbayer, RGB, YUV
}
else
{
       System.Console.Write("   FreeformatHeader2 is not available \r\n");
}

某些图像信息无需启用 Chunk 即可获取。您可以直接从 BGAPI2.Buffer对象中直接获取。

下面是直接从图像Buffer中获取元数据的示例代码

//IF CHUNK IS NOT USED
if ((bIsAvaliableBaumerImageHeader3 == false) && (bIsAvaliableFreeFormatHeader3 == false) && (bIsAvaliableFreeformatHeader2 == false) && (bIsAvailableChunkExtendedMode == false) )
{
     System.Console.Write("   Buffer.PixelFormat:     {0}\r\n", mBufferFilled.PixelFormat);
     System.Console.Write("   Buffer.Width:                  {0}\r\n", mBufferFilled.Width);
     System.Console.Write("   Buffer.Height:                 {0}\r\n", mBufferFilled.Height);
}

Baumer工业相机通过SDK在相机图像中绑定元数据和块数据的优势

利用SDK在工业相机图像中绑定元数据和块数据的优势

工业相机的效能不仅仅局限于图像捕捉能力，包括如何处理和传输图像数据也同等重要。通过使用软件开发包（SDK）在相机图像中绑定元数据及块数据，可以极大增强图像数据的功能性和应用范围。以下详细讨论这种方法的优势：

1. 增强的数据整合

• 全面的信息绑定：元数据可以包括时间戳、相机设置、序列号等关键信息，而块数据则可能是关于图像所在区块的详细信息。通过绑定这些数据到图像文件中，可以为后续处理提供一体化的数据解决方案。
• 便于追踪与分析：带有完整元数据和块数据的图像，使得数据处理和图像分析更加精准，并简化了问题诊断流程，如在生产线中追踪特定产品的质量问题。

2. 提升数据传输效率

• 减少数据丢失风险：在图像数据传输过程中，元数据和块数据的整合确保所有相关信息同步传输，减少了因多个数据流而导致的数据不一致或丢失的风险。
• 优化网络使用：通过有效的数据打包，减少了网络带宽的需求，对于需要远程实时监控和数据分析的应用尤为重要。

3. 优化数据存储

• 压缩存储需求：通过智能化的数据整合，可以优化存储空间的使用。例如，原本可能需要额外存储空间的元数据和块数据可以直接绑定至图像文件中。
• 增强检索能力：带有丰富元数据的图像文件使得数据检索变得更加快速和简便，特别是在大规模数据集中查找特定图像或事件时。

4. 扩展应用可能性

• 多场景适应性：不同行业和应用可能需要不同的数据分析方式和流程。通过绑定必要的元数据和块数据，可以根据具体应用需求定制图像处理和分析算法。
• 支持高级分析工具：许多高级图像处理和分析工具可以直接利用元数据进行高效分析，如使用时间戳数据进行时间序列分析。

5. 保障法规遵守

• 满足记录保持要求：在某些行业，如医疗或安全关键行业，相关法规可能要求详细记录图像捕获的环境和条件。通过绑定元数据和块数据，可以保证满足这些法规要求。

** 结论**

使用SDK在工业相机的图像中绑定元数据和块数据，为企业提供了一种强大的工具，以实现数据的完整性、提升处理效率并开启新的应用可能性。这种技术的实施不仅优化了数据管理，还增强了整个视觉系统的价值。在竞争激烈的工业市场中，这种技术能够帮助企业维持技术优势。

Baumer工业相机通过SDK在相机图像中绑定元数据和块数据的行业应用

工业相机的高级功能，如通过软件开发包（SDK）在相机图像中绑定元数据和块数据，可以极大地提升多个行业的操作效率和数据管理能力。以下是几个关键行业中此技术应用的实例：

1. 制造业

• 质量控制：工业相机可以捕捉产品在制造线上的图像，并将检测时间、机器参数和检测结果作为元数据绑定。这样不仅可以实时监控产品质量，还可以追溯问题产品的生产条件。
• 自动化装配：相机可以监控装配过程，并记录每一步的详细块数据，如部件位置和装配速度，确保所有组件精确无误地装配。

2. 交通与汽车

• 车辆检测：在交通监控系统中，相机捕捉的图像可以绑定车辆的速度、类型和违法行为等数据，并用于交通流量分析和执法。
• 自动驾驶测试：测试期间，相机不仅捕捉道路与交通条件的图像，同时记录如速度、位置、天气条件的元数据，对开发和改进自动驾驶算法至关重要。

3. 医疗与生命科学

• 医学成像：在医学成像中，元数据可以包括患者信息、扫描参数以及诊断细节，这些信息至关重要以确保高质量的诊疗和数据保护。
• 实验室自动化：在自动化实验流程中，相机所提供的图像及其绑定的数据（如样本编号和测试结果）可以自动记录实验数据，提高实验精确度和效率。

4. 安全监控

• 事件记录：安全相机不仅录制入侵等事件的视频，同时将事件发生的时间、地点和其他环境数据作为元数据记录，便于事后分析和法律用途。
• 人流统计：在公共场所，通过图像捕捉并结合时间和位置数据，可以有效地进行人流量统计和分析，优化场所管理和安全措施。

5. 食品与农业

• 食品检测：食品加工过程中，相机检测的图像会记录食品大小、色泽及存在的缺陷，并将此类信息作为元数据附加，确保食品符合质量标准。
• 农业监控：使用相机监控作物生长状况，并绑定时间序列数据和环境条件数据，帮助农场管理者调整养护策略以优化产量。

总结
通过SDK在工业相机图像中绑定元数据和块数据，不仅提高了数据的可用性和整合性，而且在各个行业中开辟了先进分析和自动化的新可能性。这些技术的应用使企业能够更有效地处理和分析大量图像数据，提升操作效率及决策质量。