跳转到内容
STAGING SERVER
DEVELOPMENT SERVER

pylon Software Suite 25.11 发行说明#

发布日期：2025-11-17

二进制兼容性#

  • pylon C++ SDK = 11.2.0
    使用 11.2.x 或早期 11.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.5.2
    使用 3.5.x 或早期 3.x.x 版本 Data Processing 构建的应用程序保持兼容。

新功能 / 变更#

  • vTools: [340058] Camera vTool 现已支持 GenDC 采集结果。当存在单个类似图像的数据组件时，它将被直接传递至 Image 引脚。对于包含多个组件的图像容器，系统将优先选择 Intensity 组件。
  • vTools: [345795] Mini Script vTool 现已能够处理图像和区域，支持访问其元数据，并支持从输入引脚到输出引脚的路由。
  • vTools: [292218] 带来了显著的性能提升和扩展的功能。QR 码和 GS1 Data Matrix 码的解码功能得到了增强。QR Code Reader 已针对速度和效率进行了进一步优化。此外，基于形状的匹配算法也得到了改进，提供了更高的处理速度和更强的鲁棒性。

修正#

  • GenTL/GigE: [349506] 修复了通过 GenICam File Access 从 GigE 相机下载的文件在大小不能被 4 整除时被保存为 0 字节的问题。
  • pylon C++ SDK: [349506] 修复了通过 GenICam File Access 从 GigE 相机下载的文件在大小不能被 4 整除时被保存为 0 字节的问题。

限制#

  • pylon C++ SDK：如果您使用 GenICam File Access 功能从 GigE 相机下载文件，且文件大小不能被 4 整除，则当前下载的文件大小会为 0 字节。这可能会引发问题，尤其是对于包含用户数据（例如 Vignetting Correction 数据、Shading Correction 数据、3D 数据）的标定和配置文件。
  • 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 的版本（配置属性 -> 常规 -> Windows SDK 版本）。
  • pylon C++ SDK: 某些 ace 2 相机可能会使用布尔参数而不是通常的枚举来进行事件通知。可以使用以下代码片段来解决此问题。对于 C++，除了：camera.EventNotification.TrySetValue(EventNotification_On); 之外，您还可以使用：CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);。
  • pylon C++ SDK: InstantCameraArray 类最多可以采集来自 21 个相机的图像。
  • 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 工具来优化整个设置。
  • GigE: 如果报告了错误消息“Failed to allocate resources.”，Basler 建议使用 pylon GigE Configurator 工具来优化网卡和相机的 IP 配置。
  • GigE: IP Configurator 工具不完全支持单个网络接口上的多个 IP 配置。
  • GenTL: 对 GenTL 版本 1.4 及更低版本的 Producer 的 GenTL 支持有限。
  • USB： 必须关闭 Intel USB 主机使用的电源管理，否则 Basler U3V 设备可能会去同步。如果是这种情况，在某些情况下系统启动后 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 已更改为引用类 Basler.Pylon.ParameterListEnum）。
  • pylon .NET SDK: 如果为您的 .NET 项目启用了本机调试，并且您的项目引用了 pylon 程序集，则在 Visual Studio 2012 或 Visual Studio 2013 调试器下运行应用程序时，应用程序可能会崩溃。为避免此问题，请在 Visual Studio 调试器选项中启用托管兼容性模式。
  • 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 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 功能可测量 vTool 的执行时间。Statistics 功能中测得的时间可能会因系统配置和整体 CPU 负载而异。这是因为 CPU 可能会根据当前负载以不同的频率运行（例如，由于动态 frequency scaling）。
  • GenTL: 对 GenTL 版本 1.4 及更低版本的 Producer 的 GenTL 支持有限。

下载#

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