Framegrabber SDK 5.10.0 中的更改和修复的问题#
常规#
- 产品名称已从 Basler Runtime 更改为 Basler Framegrabber SDK。
- Framegrabber SDK 现在支持 Windows 11 (64 位) 和 Linux Ubuntu 22.04 (64 位)。（工单编号：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 参考实现库已移至主安装文件夹中。（票证 ID：236467）
- 在 Linux 上，所有 GUI 和命令行工具（例如 microDisplay X、FirmwareUpdater 等）都应通过位于 /bin 下的相关脚本启动。（票单编号：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
- microEnable 5 ironman
有关所有停用产品的详细信息，请参阅 Basler 停用产品页面
第三方接口#
以下第三方接口已停用：
- LabView（另请参见 API 示例）
- 专有的 Cognex VisionPro Adapter
- 专有的 MVTec HALCON adapter
- CVB
Cognex VisionPro Adapter 和 MVTec HALCON adapter 可以由 GenTL 界面替换。（票证 ID：231588、212114、212120、255221）
Framegrabber API#
- 改进了未找到任何 Applet 时的日志消息措辞。（工单编号：225003）
工具 microDiagnostics 和 microDisplay X#
-
microDisplay X 中 Help 菜单的位置已更改。Help 菜单现在位于此处：
（工单编号：230984）
-
以前，在使用未烧录固件的情况下关闭 microDiagnostics 时，退出对话框询问的是是否烧录“applets”而不是“firmware”。退出对话框中的措辞已得到纠正。（工单 ID：212124）
API 示例#
- 现在可以使用现代的 Microsoft Visual Studio 版本（例如 Visual Studio 2019 或更新版本）构建 C/C++ SDK 示例。（工单编号：226757、249321、227119）
- National Instruments LabView 示例程序已从 Framegrabber SDK 发行版中移除。如有必要，请联系 Basler 技术支持以获取用于 NI LabView 的示例程序。（工单 ID：231588 和 227110）
驱动程序#
- imaWorx CXP-12 Quad frame grabber 的驱动程序已在其自动停止行为方面进行了改进。现在，当相机交付了请求的帧数时，采集即会停止。此外，最终进入虚拟缓冲区（dummy buffer）的帧现在也会被考虑在内。在此之前，采集是在用户在其用户缓冲区中收到请求的帧数时停止的。（工单 ID：235859）
- 用于 microEnable 5 frame grabbers 的驱动程序现在包含用于获取帧编号的 API。（工单 ID：227072）
- microEnable 5 驱动程序的缓冲区处理已得到改进。（工单 ID：235850 和 236981）
- 相机与图像采集卡之间通过 ClSerColWrapper2 的通信速度已提高。（工单 ID：236732）
- 与 microEnable 5 采集卡的通信已扩展，以支持硬件的不同变体。（工单编号：231003、232694）
- 改进了设备发现功能。（工单 ID：238309）
- CXP 和 Camera Link 相机的发现功能得到了改进（工单编号：229754、226742、230948、240393）。
修复的问题#
- 在此之前，GenTL
BUFFER_INFO_FRAME_ID，可通过以下方式进行查询：DSGetBufferInfo未包含来自 CXP 图像标头的源标签。相反，它包含传输到计算机的所有帧的 Counter。此问题已修复。（工单 ID：197430） - 此前，在读取 CXP 相机 XML 的 URL 时，Framegrabber SDK 默认寄存器大小为 256 字节。然而，在读取相机 XML 的 URL 时假设特定的寄存器大小违反了 CXP 标准。该问题现已修复。现在不再假设寄存器大小，并且 Framegrabber SDK 严格遵循 CXP 标准。（工单编号：228438）
- 在此之前，读取 CXP 相机 XML 的 URL 时，Framegrabber SDK 假定 XML 根元素是首字母大写的“Local”。然而，CXP 标准规定 URL 不区分大小写。此问题已修复。现在，URL 的解析已更改为支持任意大小写。（工单 ID：228439）
- 此前，GenICam GenTL Producer 未针对所有节点提供“Selecting”的值。该问题现已修复。（工单编号：212118）
- 在此之前，GenICam GenTL Producer 未在 Property 中提供正确的供应商名称和接口 ID。此问题已修复。（工单 ID：225073）
- 修复了可能出现的 GenICam GenTL 死锁问题。（工单编号：238352）
- 在此之前，在 microDisplay X 中更改 microEnable 5 采集卡的 Applet 并不总是成功。此问题已修复。（工单 ID：229736）
- 优化了 ROI 功能的行为。（工单编号：229952）
- 以前，通过 -h 打开命令行工具 gpioTool 的 Help 功能时，显示的示例不正确且无法使用。此问题已修复。（工单 ID：221628）
- 以前，FirmwareUpdate 工具的一些错误消息具有误导性或拼写错误。因此，错误消息的措辞已得到改进。（工单 ID：223690、223689）
- 在此之前，在 Linux 20.04 上启动 microDisplay X 和 microDiagnostics 时，这些工具会报错关闭。此问题已修复。（工单 ID：233534）
- 此前，microDisplay X 在加载然后卸载 Applet 时会返回错误。该问题现已修复。（工单编号：212132）
- 在此之前，更改 Applet 时 microDisplay X 不会停止图像采集。此问题已修复。（工单 ID：220077）
- 以前，microDisplay X 中的 Save Parameters 和 Load Parameters 按钮无法正常工作。此问题已修复。（工单 ID：238752）
- 在此之前，PC 重启后在 microDisplay X 中加载 Applet 会导致错误。此问题已修复。（工单 ID：236228）
- 此前，microDisplay X 在加载一系列图像时崩溃。该问题现已修复。（工单编号：212616）
- 在此之前，microDisplay X 中未正确显示转换循环参数。此问题已修复。（工单 ID：234064）
- 此前，microDisplay X 无法识别 Basler 双通道 CXP-12 相机。该问题现已修复。（工单编号：235720）
- 在此之前，如果在图像采集过程中滚动窗口，microDisplay X 会崩溃。此问题已修复。（工单 ID：238904）
- 此前，microDisplay X 在 imaWorx CXP-12 Quad 上加载 HAP 文件时崩溃。该问题现已修复。（工单编号：235946）
- 在此之前，microDisplay X 不显示参数 Property 的描述。此问题已修复。（工单 ID：242207）
- 此前，microDisplay 无法正确显示大图像（例如 10500 x 43500 像素）。该问题现已修复。（工单编号：246410）
- 在此之前，在 microEnable 5 采集卡上的 microDiagnostics X 中加载 HDR0 并不总是能正常工作。此问题已修复。（工单 ID：234254）
- 此前，在 Linux Ubuntu 系统上的 imaWorx CXP-12 Quad 上初始化 Applet 时
Fg_init失败。此问题已修复。（工单 ID：234499） - 此前，在 LookupTable 中为 imaWorx CXP-12 Quad 的 Applet 设置或选择值无法正常工作。该问题现已修复。（工单编号：221621）
- 在此之前，增加某些 imaWorx CXP-12 Quad Applet 的 ROI 宽度会导致错误。此问题已修复。（工单 ID：249177）
- 此前，在调用
Fg_AllocMemHead在 imaWorx CXP-12 Quad 上，每次调用此函数后执行时间都会增加。此问题已修复。（工单 ID：247416） - 此前，调用
Sgc_(re)storeLowLevelLinkProfile()在 imaWorx CXP-12 Quad 上发生了错误。此问题已修复。（工单 ID：246768） - 采集卡库事件现已具备线程安全性。（工单编号：236809）
- 在此之前，在 microDisplay X 中加载每个相机拥有多个 DMA 的 Applet 会导致错误。此问题已修复（工单 ID：237342）
- 此前，由于 HAP 文件加载失败，导致采集卡初始化失败。该问题现已修复。（工单编号：237013）
- 开启/关闭关联参数时的可见性
AutomaticROIControl参数现在可以正常工作。（工单编号：217774） Fg_getSWVersion()现在会返回已安装的 Framegrabber SDK 的正确版本号。（工单 ID：202240）- 针对 MVTec HALCON 的早期专有适配器已更新至最新版本 13.0.11，改进了对高达 4 GBytes 传输的支持。该适配器随 Framegrabber SDK 5.10.0 一起停用，Basler 建议改用 GenICam GenTL 接口。（工单编号：231049、231326、218503）
- 此前，使用针对 MVTec HALCON 的早期专有适配器时，图像采集会意外停止。该问题现已修复。该适配器随 Framegrabber SDK 5.10.0 一起停用，Basler 建议改用 GenICam GenTL 接口。（工单编号：229938）