跳转到内容
STAGING SERVER
DEVELOPMENT SERVER

pylon Software Suite 25.06 Release Notes#

发布日期：2025-06-20

二进制兼容性#

  • pylon C++ SDK = 10.3.0
    使用 10.3.x 或更早 10.x.x 版本 pylon C++ SDK 构建的应用程序均保持兼容。

新功能 / 变更#

  • vTools：[322976] 新增了 Grid Creator vTool。
  • pylon Viewer：[336981] 提升了 3D 相机的使用体验。
  • pylon Viewer：[336090] 录制功能现已支持以 bmp、tif、png、jpeg 和 raw 格式保存静态图像序列。
  • pylon Viewer：[326399] 您现在可以以 bmp、tif、png、jpeg、dng 和 raw 格式保存当前图像。
  • pylon Viewer：[329111] 改善了 Histogram 和 Line Profile 功能的性能。
  • vTools：[335669, 335660, 337193, 334690] 新增了 Histogram Extractor vTool。该工具用于从图像中提取直方图，对于单色图像将其放入单通道中，对于彩色图像则放入相应的颜色通道中。
  • vTools：[321505] 新增了 Array Element Selector vTool。Array Element Selector vTool 允许您选择数组中的单个元素，并输出您指定的索引位置处的数据。

修正#

  • pylon Viewer：[338283] 修复了固件更新程序（Firmware Updater）中的 Scaling 问题。
  • pylon IP Configurator：[337978] 修复了字体系列未正确设置的问题。
  • pylon C++ SDK：[329360] 修复了在 boost V 相机上，如果将 TriggerSelector 设置为新值可能导致打开 InstantCamera 对象失败的问题。
  • 文档：[313977] 为具有特定 IP 地址的 GigE 相机创建设备对象的示例现在包含先前缺失的设备类。
  • vTools：[337959] 通过消除控制台消息，改进了 OPC UA Client vTool。
  • vTools：[334601] 将 OPC UA Client vTool 移动到了新的 Interface 组中。
  • vTools：[335779] 修复了如果方案没有任何输入引脚导致服务器地址未保存的问题。现在，服务器地址将始终被保存。
  • PylonVToolCreatorRuntime：[336519] 修复了区域元数据无法正确设置的问题。
  • vTools：[338632] 补充了 Image Stitcher vTool 的 PaddingValue 参数缺失的文档。
  • vTools：[338143] 确保了加载和保存设置时的线程安全性。

限制#

  • Workbench：在 Workbench 中使用多个主动显示数据的引脚数据视图可能会导致 CPU 负载增加以及整体性能下降。Basler 建议尽可能少使用引脚数据视图。
  • Workbench：Workbench 的 Statistics 功能可测量 vTools 的执行时间。Statistics 功能中测量的可能会根据您的系统配置和整体 CPU 负载而有所不同。这是因为 CPU 可能会根据当前负载以不同的频率运行（例如由于动态频率 Scaling）。
  • pylon Viewer：pylon Viewer 中实现了一种新的图像限流器 (image throttle)，以提高整体稳定性和性能。这引入了一项新限制，会影响 pylon Viewer 的视频录制功能。成像管道中每秒仅允许每个相机传输 250 张图像，当超出此限制时，将无法录制每一帧。
  • pylon Viewer：Color Calibrator 不支持所有 Basler 彩色相机。由于相机功能集不同，不支持 Basler dart 和 boost V 相机。
  • pylon Viewer：在某些情况下（例如计算机非常慢或繁忙），如果相机已经在 pylon Viewer 中打开，Color Calibrator 可能无法工作。为防止出现这种情况，请在使用 Color Calibrator 之前关闭相机。
  • pylon Viewer：在配有 Intel HD 显卡的计算机上，可能需要将显卡驱动程序更新到当前版本。
  • pylon Viewer：Stereo ace 2 相机抓取的图像暂无法显示。
  • pylon C++ SDK： 在使用 CMake 构建示例时，您可能会遇到操作系统的路径长度限制。您可能会收到构建错误，提示路径超过了 260 个字符的最大路径长度。如果您的 CMake 构建目录的绝对路径超过 80 个字符，则可能会发生这种情况。构建目录是当前工作目录，或者是调用 cmake 时由 '-B' 选项指定的目录。如果您遇到此错误，请使用路径较短且不超过 80 个字符的构建目录，例如直接放在用户配置文件 C:\Users\ 中\Samples。您可以在 Windows 10（版本 1607）及更高版本中启用长路径。有关详细信息，请参阅 Microsoft 文档。
  • pylon C++ SDK：使用 Visual Studio 2017 时，您可能会收到 MSB4211 警告。要消除该警告，请在 Release 和 Debug 项目属性中指定 Windows SDK 的版本（Configuration Properties -> General -> Windows SDK Version）。
  • pylon C++ SDK：某些 ace 2 相机可能会使用布尔参数代替常规枚举来进行 Event Notification。可以使用以下代码片段来规避此问题。对于 C++，除了 camera.EventNotification.TrySetValue(EventNotification_On); 之外，您还可以使用：CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);
  • GigE：如果报告了错误消息“Failed to allocate resources.”，Basler 建议使用 pylon GigE Configurator 工具来优化网卡和相机的 IP 配置。
  • GigE：IP Configurator 工具并不完全支持单个网络接口上的多个 IP 配置。
  • pylon C++ SDK：InstantCameraArray 类最多可以从 21 台相机采集图像。
  • GigE：为了以最佳状态使用 Basler 的 ace 2 5GigE 和 1GigE 相机，Basler 建议使用双通道 DDR4-3600 RAM 或更高规格的内存。使用较慢的 RAM 可能会导致缓冲区欠载和图像丢失。此外，Basler 建议使用 pylon GigE Configurator 工具来优化整个设置。
  • GenTL：对于 GenTL 1.4 及更低版本的 Producer，GenTL 支持有限。
  • USB： 由于 Basler U3V 设备可能会去同步，因此必须关闭 Intel USB 主机使用的电源管理。如果出现这种情况，在某些情况下，系统启动后可能无法使用 Basler U3V 设备。通过以下步骤禁用 USB3 总线上的 LPM 软件包：
    1. 通过执行以下命令启用高级设置：
      powercfg -attributes 2a737441-1930-4402-8d77-b2bebba308a3 d4e98f31-5ffe- 4ce1-be31-1b38b384c009 -ATTRIB_HIDE
    2. 更改电源选项中的 LPM 设置。
      1. 打开控制面板中的“电源选项”。
      2. 单击所选电源计划的“更改计划设置”。
      3. 单击“更改高级电源设置”。
      4. 在“电源选项”对话框的“高级设置”选项卡上，选择“USB 设置”。
      5. 将“USB 3 链接电源管理”设置为“关闭”。
  • 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 功能，然后开始录制。
  • 3D：使用 Basler blaze 3D 相机需要安装 pylon Supplementary Package for blaze。pylon Supplementary Package for blaze 可在 Basler 网站上下载。
  • 3D：使用 Stereo ace 3D 相机需要安装 pylon Supplementary Package for Stereo ace。pylon Supplementary Package for Stereo ace 可在 Basler 网站上下载。
  • vTools：如果在配方中保存了特定数据类型的连接，则备用数据类型将不再可用。重新加载配方并删除与输入引脚的原始连接时，该输入引脚将仅提供原始连接的数据类型。
  • GenTL/GigE：GigE Vision 的 GenTL producer 不支持动作命令 (action commands)。
  • GenTL/GigE：用于 GigE Vision 的 GenTL Producer 不支持多播配置。
  • 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)。
  • CXP IC：对于线扫描 Applet，行周期和行曝光的范围无法得到正确处理。最大值可能会低于预期。
  • GenTL/CXP：现在使用 Visual Studio 2022 进行编译，因此为了加载库，必须安装 Visual Studio 2022 可再发行组件。
  • GenTL/CXP：实际的缓冲区大小限制为 2 Gbit，这反过来对 producer 中 Width 和 Height 的允许值施加了限制，导致图像的最大大小为 2GB。
  • GenTL/CXP：fps 限制在 50.000 fps 到 90.000 fps 之间，具体取决于缓冲区数量和图像大小。更详细的近似值：10 个缓冲区且最小图像大小为 48x1 时，限制约为 50,000 FPS；50 个缓冲区且最小图像大小为 48x1 时，限制约为 90,000 FPS；50 个缓冲区且图像大小为 8192x1 时，限制约为 50,000 FPS。
  • GenTL/CXP：如果在图像采集过程中更改相机参数，该更改不会反映在帧抓取器中。这是因为 GenTL Producer 在开始采集之前会检索相关参数（宽度、高度、图像格式等）并将其与帧抓取器进行同步。
  • GenTL/CXP：根据 GenTL 标准，设备 ID 在两个会话之间应保持恒定。但是，当 applet 更改时，GenTL 设备 ID 会发生变化。因此，只有当 applet 的名称与生成设备 ID 时所用的 applet 名称相同时，才能重复使用设备 ID。
  • GenTL/CXP：如果您的计算机上安装了某个版本的 Basler Framegrabber SDK，在使用 CoaXPress 相机和采集卡时可能会遇到兼容性问题。因此，Basler 建议不要将 pylon 与 Framegrabber SDK 并行安装。
  • GenTL/CXP：在 Linux 下使用安全启动（UEFI 模式）需要使用受信任证书签名的驱动程序。由于驱动程序是以源代码形式提供的，因此无法使用受信任的 Basler 证书对其进行签名。要使用该驱动程序，可以禁用安全启动。或者，也可以按照此 Ubuntu 博客文章中的说明对驱动程序进行自签名：https://ubuntu.com/blog/how-to-sign-things-for- secure-boot
  • GenTL/CXP：在分配用于抓取的缓冲区时，缓冲区地址必须以 8 字节的增量对齐。如果使用堆内存，则会自动满足此条件。
  • GenTL/CXP：不支持使用 Basler CXP-12 Interface Card 1C 以超过 50000 fps 的极高帧率进行抓取。
  • GenTL/CXP：在少数情况下，计算机启动后找不到相机。对相机进行断电重启即可解决此问题。
  • GenTL/CXP：当更改相机的 DeviceUserID 时，需要重启 GenTL Producer 才能通过 GenTL API 反映该更改。当使用 GUI 通过 GenTL 与相机交互（即 pylon Viewer）时，需要重启该应用程序才能使更改可见。
  • GenTL/CXP：在更改 applet 期间，连接到接口卡的相机仍然会显示在设备列表中，即使它们已无法访问。在这种状态下尝试打开相机会导致错误消息。
  • GenTL/CXP：可通过 DSGetBufferInfo 查询的 GenTL BUFFER_INFO_FRAME_ID 不包含来自 CXP 图像标头的源标签。相反，它包含传输到计算机的所有帧的计数器。
  • GenTL/CXP：如果由于缓冲区溢出（例如当用户应用程序未能足够快地（重新）将缓冲区排队以交付图像）而导致图像在接口卡上丢失，则丢失的图像将由下一个交付的缓冲区指示。丢失的图像将标记为 INCOMPLETE，其文件大小为 0，并且自定义错误代码 BUFFER_INFO_BASLER_XAPI_ERROR_CODE 将设置为 42. 此外，流信息中会添加一个丢失帧。请注意，无论由于溢出丢失了多少帧，都只会添加整整一个丢失帧。
  • GenTL/CXP：Basler CXP-12 Interface Card 1C/2C/4C 和 imaWorx CXP-12 Quad 采集卡需要具有 PCIe Gen 3 x8（直接内存访问）或更高性能的主机接口。使用较慢的主机接口可能会降低相机的采集帧率并导致图像丢失。

下载#

您可以此处下载此版本的 pylon Software Suite。