跳转到内容
STAGING SERVER
DEVELOPMENT SERVER

pylon Software Suite 25.09 版本说明#

发布日期：2025-09-16

二进制兼容性#

  • pylon C++ SDK = 10.4.0
    使用 10.4.x 或更早的 10.x.x 版本 pylon C++ SDK 构建的应用程序完全兼容。
  • pylon .NET SDK = 9.0.0
    使用早期版本 pylon .NET SDK 构建的应用不兼容。
  • pylon C SDK = 10.1.0
    使用 10.1.x 或早期 10.x.x 版本 pylon C SDK 构建的应用保持兼容。
  • Data Processing = 3.4.0
    使用 3.4.x 或更早的 3.x.x 版本 Data Processing 构建的应用程序完全兼容。

新功能 / 变更#

  • Workbench：[346358] 通过改变输出引脚的外观，现在可以更容易地区分生成数据的 vTools 与使用数据的 vTools。
  • vTools：[343815] 在 Barcode Reader Pro vTool 中引入了检测模式，支持读取低分辨率条形码。
  • vTools：[343724] 为所有 Basic 和 Pro 代码读取器 vTools 添加了 OrientedBoxes_px 输出引脚。
  • vTools：[343811] 为以下代码读取器 vTools 添加了“最大检测”模式：Aztec Code Reader Pro、Data Matrix Code Reader Pro、PDF417 Code Reader Pro、QR Code Reader Pro。请注意，使用这些更新后的 vTools 创建的配方与旧版本的 pylon 不兼容。
  • pylon C++ SDK：[344329] 修复了在多线程场景下转换 10 位打包 Bayer 图像时导致图像损坏的问题。

修正#

  • GenTL：[346422] 修复了在 Windows 32 位系统上使用 GenTL Consumer 时可能导致程序异常终止的问题。
  • DirectShow：[343864] 修复了使用 DirectShow 时导致诸如 ace 2 等相机需要五秒或更长时间才能打开的问题。
  • pylon Viewer：[345748] 修复了即使在关闭设备后“保存图像”选项仍保持启用状态的问题。
  • pylon Viewer：[345758] 修复了“清晰度指示器”图标在高 DPI 显示器上看起来像素化的问题。

限制#

  • 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 网站上下载。
  • 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)。
  • GenTL/GigE：GigE Vision 的 GenTL producer 不支持动作命令 (action commands)。
  • GenTL/GigE：用于 GigE Vision 的 GenTL Producer 不支持多播配置。
  • 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 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 相机抓取的图像暂无法显示。
  • Workbench：在 Workbench 中使用多个主动显示数据的引脚数据视图可能会导致 CPU 负载增加以及整体性能下降。Basler 建议尽可能少使用引脚数据视图。
  • Workbench：Workbench 的 Statistics 功能可测量 vTools 的执行时间。Statistics 功能中测量的可能会根据您的系统配置和整体 CPU 负载而有所不同。这是因为 CPU 可能会根据当前负载以不同的频率运行（例如由于动态频率 Scaling）。

下载#

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