变更和已修复的问题Framegrabber SDK 5.10.0

本节提供有关 Basler Framegrabber SDK 5.10.0 版本的功能更改和修复问题的信息。

常规

• 产品名称已从Basler Runtime更改为Basler Framegrabber SDK 。
• Framegrabber SDK 现在支持 Windows 11 (64-bit) 和 Linux Ubuntu 22.04 (64-bit)。（工单编号：231590 和 244875）
• The Framegrabber SDK installer for Windows has been updated. Among others, installation paths (e.g. <Basler>), environment variables (e.g. BASLER_FG_SDK_DIR），并且名称已更改。详情请参见 重命名环境变量和头文件（工单编号：218027 和 227082）
• Windows 32 位库现已集成在 Windows 64 位安装程序中。（工单编号：253234）
• Framegrabber SDK 的 GenICam 参考实现库已移至主安装文件夹中。（工单编号：236467）
• 在Linux所有图形用户界面和命令行工具，例如microDisplay X 、 FirmwareUpdater等，都应该通过位于 /bin 目录下的相关脚本启动。（工单 ID：250971 和 253097）

重命名环境变量和头文件

安装期间设置的环境变量已重命名：

SISODIR5 已更改为 BASLER_FG_SDK_DIR.

以下头文件已重命名：

旧名称	新名称	包含在
fgrab_define.h	fg_define.h和fg_error_codes.h	basler_fg.h
fgrab_struct.h	fg_struct.h	basler_fg.h
fgrab_prototyp.h	basler_fg.h

以下头文件已重新结构化：

文件名	改变
fgrab_define.h	fgrab_define.h的主要部分现在已重命名为fg_define.h文件。
fgrab_define.h	以前在fgrab_define.h中的错误定义现在位于新的头文件fg_error_define.h中。

以下头文件已被移除：

• fgrab_triangultion.h
• fgrab_blob.h

fgrab_define.h 、 fgrab_struct.h和fgrab_prototyp.h这三个文件仍然作为最小头文件存在。如果您包含其中一个已弃用的头文件，则会发生以下情况：

• 您将收到一条“deprecated”警告。
• 新的对应fg_文件会自动包含在内，以取代已停用的fgrab_文件。

截至Framegrabber SDK 版本 5.10 中，只能使用basler_fg.h 。

停产产品

Windows 32 位

Framegrabber SDK 不再支持 Windows 32 位和 Linux 32 位操作系统。（工单编号：231590）

图像采集卡

以下采集卡已停止支持：

• microEnable IV
• microEnable 5 marathon CLHS
• 微启用 5 ironman

有关所有停产产品的详细信息，请参阅Basler 的停产产品页面。

第三方接口

以下第三方接口已停用：

• LabView（另请参阅API 示例）
• 专有的 Cognex VisionPro Adapter
• 专有的 MVTec HALCON adapter
• CVB

Cognex VisionPro Adapter 和 MVTec HALCON adapter 可以由 GenTL 接口替代。（工单编号：231588、212114、212120、255221）

Framegrabber API

• 改进了未找到任何小程序时的日志消息措辞。（工单编号：225003）

工具microDiagnostics 和microDisplay X

• microDisplay X中的“帮助”菜单位置已更改。 “帮助”菜单现在位于此处：

  

  (Ticket ID: 230984)

• 之前，在未刷写固件的情况下关闭microDiagnostics时，退出对话框会询问是否要刷写“小程序”而不是“固件”。退出对话框中的措辞已更正。（工单 ID：212124）

API 示例

• C/C++ SDK 示例现在可以使用较新的 Microsoft Visual Studio 版本（例如 Visual Studio 2019 或更新版本）进行构建。(Ticket IDs: 226757, 249321, 227119)
• National Instruments LabView 示例程序已从以下位置移除： Framegrabber SDK 交付。如有需要，请联系Basler 技术支持获取 NI LabView 的示例程序。（工单编号：231588 和 227110）

驱动程序

• imaWorx CXP-12 Quad图像采集卡的驱动程序已针对其自动停止功能进行了改进。现在，当相机采集到所需帧数后，采集就会停止。此外，即使帧数最终进入了虚拟缓冲区，也会被纳入考虑范围。此前，采集会在用户缓冲区中接收到所需帧数后才停止。（工单号：235859）
• microEnable 5 帧采集卡的驱动程序现在包含一个用于获取帧号的 API。（工单 ID：227072）
• microEnable 5驱动程序的缓冲区处理已得到改进。（工单 ID：235850 和 236981）
• 通过ClSerComWrapper2实现的相机与图像采集卡之间的通信速度已提升。（工单编号：236732）
• 与 microEnable 5 采集卡的通信已扩展，以支持该硬件的不同变体。(Ticket IDs: 231003, 232694)
• 设备发现功能已得到改进。(Ticket ID: 238309)
• CXP 和 Camera Link 相机的发现功能已得到改进 (Ticket IDs: 229754, 226742, 230948, 240393)。

已修复问题

• 此前，GenTL BUFFER_INFO_FRAME_ID（可通过 DSGetBufferInfo进行查询）不包含来自 CXP 图像头部的源标签。相反，它包含传输到计算机的所有帧的计数器。此问题现已修复。(Ticket ID: 197430)
• 此前，在读取 CXP 相机 XML 的 URL 时，Framegrabber SDK 假定寄存器大小为 256 字节。然而，在读取相机 XML 的 URL 时假定特定的寄存器大小违反了 CXP 标准。此问题现已修复。现在不再假定寄存器大小，且 Framegrabber SDK 严格遵循 CXP 标准。(Ticket ID: 228438)
• 此前，在读取 CXP 相机 XML 的 URL 时，Framegrabber SDK 假定 XML 根元素是带有大写“L”的“Local”。但是，CXP 标准规定 URL 对大小写不敏感。此问题现已修复。现在，URL 的解析已更改为支持任意大小写。(Ticket ID: 228439)
• 此前，GenICam GenTL Producer 未为所有节点提供“Selecting”的值。此问题现已修复。(Ticket ID: 212118)
• 此前，GenICam GenTL Producer 未在属性中提供正确的供应商名称和接口 ID。此问题现已修复。(Ticket ID: 225073)
• 修复了可能出现的 GenICam GenTL 死锁问题。(Ticket ID: 238352)
• 此前，在 microDisplay X 中更改 microEnable 5 采集卡的 applet 并不总是成功。此问题现已修复。(Ticket ID: 229736)
• ROI 功能的行为已得到优化。(Ticket ID: 229952)
• 之前，通过-h参数打开命令行工具gpioTool的帮助功能时，显示的示例不正确且无法运行。此问题已修复。（工单编号：221628）
• 之前，固件更新工具的部分错误信息存在误导性或拼写错误。因此，我们改进了错误信息的措辞。（工单编号：223690、223689）
• 此前，在 Linux 20.04 上启动 microDisplay X 和 microDiagnostics 时，这些工具会因错误而关闭。此问题现已修复。(Ticket ID: 233534)
• 此前，microDisplay X 在加载然后卸载 applet 时返回了错误。此问题现已修复。(Ticket ID: 212132)
• 此前，microDisplay X 在更改小程序（applet）时未停止图像采集。该问题现已修复。（工单 ID：220077）
• 之前， “保存参数”和“加载参数”按钮位于microDisplay X 之前运行不正常，现已修复。（工单编号：238752）
• 此前，PC 重启后在 microDisplay X 中加载小程序会导致错误。该问题现已修复。（工单 ID：236228）
• 此前，加载图像序列时 microDisplay X 会崩溃。该问题现已修复。（工单 ID：212616）
• 此前，microDisplay X 中未正确显示转换循环参数。该问题现已修复。（工单 ID：234064）
• 此前，microDisplay X 无法识别 Basler 双通道 CXP-12 相机。该问题现已修复。（工单 ID：235720）
• 此前，如果在图像采集过程中滚动窗口，microDisplay X 会崩溃。该问题现已修复。（工单 ID：238904）
• 此前，在 imaWorx CXP-12 Quad 上加载 HAP 文件时，microDisplay X 会崩溃。该问题现已修复。（工单 ID：235946）
• 此前，microDisplay X 未显示参数 Property 的描述。该问题现已修复。（工单 ID：242207）
• 此前，microDisplay 无法正确显示大尺寸图像（例如 10500 x 43500 像素）。该问题现已修复。（工单 ID：246410）
• 此前，在 microEnable 5采集卡上的 microDiagnostics X 中加载 HDR0 并非总是能正常工作。该问题现已修复。（工单 ID：234254）
• 此前，在 Linux Ubuntu 系统上初始化 imaWorx CXP-12 Quad 上的小程序时，使用 Fg_init 失败。该问题现已修复。（工单 ID：234499）
• 此前，在 LookupTable 中为 imaWorx CXP-12 Quad 的小程序设置或选择值时无法生效。该问题现已修复。（工单 ID：221621）
• 此前，增加某些 imaWorx CXP-12 Quad 小程序的 ROI 宽度会导致错误。该问题现已修复。（工单 ID：249177）
• 此前，当在 imaWorx CXP-12 Quad 上多次调用 Fg_AllocMemHead 时，每次调用此函数后执行时间都会增加。该问题现已修复。（工单 ID：247416）
• 此前，在 imaWorx CXP-12 Quad 上调用 Sgc_(re)storeLowLevelLinkProfile() 时发生错误。该问题现已修复。（工单 ID：246768）
• 采集卡库事件现已具备线程安全性。（工单 ID：236809）
• 此前，在 microDisplay X 中加载每个相机拥有多个 DMA 的小程序会导致错误。该问题现已修复。（工单 ID：237342）
• 此前，由于 HAP 文件加载失败导致采集卡初始化失败。该问题现已修复。（工单 ID：237013）
• 开启/关闭 AutomaticROIControl 参数时，相关参数的可见性现在可以正常显示了。（工单 ID：217774）
• Fg_getSWVersion() 现在可以返回已安装的 Framegrabber SDK 的正确版本号。（工单 ID：202240）
• 前专有 MVTec HALCON 适配器的最新版本 13.0.11 已得到改进，支持高达 4 GBytes 的传输。该适配器随 Framegrabber SDK 5.10.0 一起停用，Basler 建议改用 GenICam GenTL 接口。（工单 ID：231049、231326、218503）
• 此前，在使用前专有 MVTec HALCON 适配器时，图像采集会意外停止。该问题已修复。该适配器随 Framegrabber SDK 5.10.0 一起停用，Basler 建议改用 GenICam GenTL 接口。（工单 ID：229938）