pylon Software Suite 26.02 Release Notes#
二进制兼容性#
- Data Processing = 4.1.2
使用 4.1.x 或更早 4.x.x 版本 Data Processing 构建的应用程序保持兼容。 - pylon C++ SDK = 11.3.0
使用 11.3.x 或更早 11.x.x 版本 pylon C++ SDK 构建的应用程序保持兼容。 - pylon C SDK = 10.1.0
使用 10.1.x 或早期 10.x.x 版本 pylon C SDK 构建的应用保持兼容。 - pylon .NET SDK = 9.0.0
使用早期版本 pylon .NET SDK 构建的应用不兼容。
新功能 / 变更#
- vTools: [316181] 新增了 vTool 应用场景的资源,向您展示如何执行特定的机器视觉任务,例如保质期检查。这些资源包含方案(recipes)、样本图像以及基础文档。
- vTools:[338476] AI vTools 可以并行运行多个推理作业,以提高吞吐量。此功能面向高级用户;具体行为和性能取决于您的硬件和模型架构。
- vTools:[351356] 添加了 Region Inverter vTool。该 vTool 可反转输入区域,这意味着输出区域包含不属于输入区域的所有像素。
修正#
- Data Processing:[355946] 修复了一个问题:使用大图像作为示教参数会导致性能下降。
限制#
- pylon Viewer:Stereo ace 2 相机抓取的图像暂无法显示。
- pylon Viewer:在配有 Intel HD 显卡的计算机上,可能需要将显卡驱动程序更新到当前版本。
- pylon Viewer:在某些情况下(例如计算机非常慢或繁忙),如果相机已经在 pylon Viewer 中打开,Color Calibrator 可能无法工作。为防止出现这种情况,请在使用 Color Calibrator 之前关闭相机。
- pylon Viewer:Color Calibrator 不支持所有 Basler 彩色相机。由于相机功能集不同,不支持 Basler dart 和 boost V 相机。
- pylon Viewer:pylon Viewer 中实现了一种新的图像限流器 (image throttle),以提高整体稳定性和性能。这引入了一项新限制,会影响 pylon Viewer 的视频录制功能。成像管道中每秒仅允许每个相机传输 250 张图像,当超出此限制时,将无法录制每一帧。
- Workbench:Workbench 的 Statistics 功能可测量 vTools 的执行时间。Statistics 功能中测量的可能会根据您的系统配置和整体 CPU 负载而有所不同。这是因为 CPU 可能会根据当前负载以不同的频率运行(例如由于动态频率 Scaling)。
- Workbench:在 Workbench 中使用多个主动显示数据的引脚数据视图可能会导致 CPU 负载增加以及整体性能下降。Basler 建议尽可能少使用引脚数据视图。
- pylon C++ SDK:如果使用 GenICam File Access 功能从 GigE 相机下载文件,且文件大小不能被 4 整除,则当前下载的文件大小为 0 字节。这可能会导致问题,特别是对于包含 user data 的校准和配置文件(例如 Vignetting Correction 数据的 vignetting correction data、Shading Correction 数据的 shading correction data、3D 数据)。
- 3D:使用 Stereo ace 3D 相机需要安装 pylon Supplementary Package for Stereo ace。pylon Supplementary Package for Stereo ace 可在 Basler 网站上下载。
- 3D:使用 Basler blaze 3D 相机需要安装 pylon Supplementary Package for blaze。pylon Supplementary Package for blaze 可在 Basler 网站上下载。
- MP4:MP4 视频录制需要安装 pylon Supplementary Package for MPEG-4 才能正常工作。pylon Supplementary Package for MPEG-4 可从 Basler 网站下载。
- MP4:如果将 Quality 参数设置为 80% 或更高,使用分辨率为 20 MP 或更高的相机录制视频文件可能会失败。作为一种解决方法,请将 Quality 参数设为较低的值。
- MP4:Recording 功能不支持 ace 2 Pro 相机中的 Compression Beyond 功能。当开始录制且启用了 Compression Beyond 功能时,pylon Viewer 会先禁用相机中的 Compression Beyond 功能,然后开始录制。
- USB: 由于 Basler U3V 设备可能会去同步,因此必须关闭 Intel USB 主机使用的电源管理。如果出现这种情况,在某些情况下,系统启动后可能无法使用 Basler U3V 设备。通过以下步骤禁用 USB3 总线上的 LPM 软件包:
- 通过执行以下命令启用高级设置:
powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE - 更改电源选项中的 LPM 设置。
- 打开控制面板中的“电源选项”。
- 单击所选电源计划的“更改计划设置”。
- 单击“更改高级电源设置”。
- 在“电源选项”对话框的“高级设置”选项卡上,选择“USB 设置”。
- 将“USB 3 链接电源管理”设置为“关闭”。
- 通过执行以下命令启用高级设置:
- GenTL:对于 GenTL 1.4 及更低版本的 Producer,GenTL 支持有限。
- GigE:为了以最佳状态使用 Basler 的 ace 2 5GigE 和 1GigE 相机,Basler 建议使用双通道 DDR4-3600 RAM 或更高规格的内存。使用较慢的 RAM 可能会导致缓冲区欠载和图像丢失。此外,Basler 建议使用 pylon GigE Configurator 工具来优化整个设置。
- pylon C++ SDK:InstantCameraArray 类最多可以从 21 台相机采集图像。
- GigE:IP Configurator 工具并不完全支持单个网络接口上的多个 IP 配置。
- GigE:如果报告了错误消息“Failed to allocate resources.”,Basler 建议使用 pylon GigE Configurator 工具来优化网卡和相机的 IP 配置。
- pylon C++ SDK:某些 ace 2 相机可能会使用布尔参数代替常规枚举来进行 Event Notification。可以使用以下代码片段来规避此问题。对于 C++,除了 camera.EventNotification.TrySetValue(EventNotification_On); 之外,您还可以使用:CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);
- pylon C++ SDK:使用 Visual Studio 2017 时,您可能会收到 MSB4211 警告。要消除该警告,请在 Release 和 Debug 项目属性中指定 Windows SDK 的版本(Configuration Properties -> General -> Windows SDK Version)。
- pylon C++ SDK: 在使用 CMake 构建示例时,您可能会遇到操作系统的路径长度限制。您可能会收到构建错误,提示路径超过了 260 个字符的最大路径长度。如果您的 CMake 构建目录的绝对路径超过 80 个字符,则可能会发生这种情况。构建目录是当前工作目录,或者是调用 cmake 时由 '-B' 选项指定的目录。如果您遇到此错误,请使用路径较短且不超过 80 个字符的构建目录,例如直接放在用户配置文件 C:\Users\ 中
\Samples。您可以在 Windows 10(版本 1607)及更高版本中启用长路径。有关详细信息,请参阅 Microsoft 文档。 - GenTL/GigE:GigE Vision 的 GenTL producer 不支持动作命令 (action commands)。
- pylon C SDK:pylon C API 尚不提供用于使用 GenDC 和 Basler blaze 3D 相机的便捷函数。
- pylon C SDK:为了使用 GenTL Consumer(例如配合 CoaXPress),pylon C 中添加了附加功能,以便能够显式启动和停止流传输。此功能尚未记录在 pylon C 程序员指南中。请参阅 pylon C++ 程序员指南(参见“从以前的版本迁移 - IStreamGrabber API 中的更改”一章)或 pylonC OverlappedGrab 编程示例。
- pylon .NET SDK:更新到此版本的 .NET API 需要您更新 .NET 项目文件以引用新的程序集。这是由于 VB2015 兼容性修复所必需的(接口类 Basler.Pylon.IParameterListEnum 已更改为 ref 类 Basler.Pylon.ParameterListEnum)。
- pylon .NET SDK:如果为您的 .NET 项目启用了本地调试,且您的项目引用了 pylon 程序集,则在 Visual Studio 2012 或 Visual Studio 2013 调试器下运行应用程序时可能会崩溃。为避免此问题,请在 Visual Studio 调试器选项中启用托管兼容模式 (Managed Compatibility mode)。
下载#
您可以此处下载此版本的 pylon Software Suite。