跳转到内容
STAGING SERVER
DEVELOPMENT SERVER

pylon Software Suite 25.10 发行说明#

发布日期：2025-10-23

二进制兼容性#

  • 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 构建的应用保持兼容。

新功能 / 变更#

  • Data Processing：[342495] 更新了 pylon Data Processing C++ API 示例，使其使用 pylon 和 pylonDataProcessing 软件包提供的 CMake 配置文件，而不是自定义查找器。
  • Data Processing：[342495] 添加了 CMake 配置文件，以简化将 pylon Data Processing C++ API 集成到基于 CMake 的项目中的过程。
  • Data Processing：[345966] 实现了针对 SPointF2D、SCircleF、SEllipseF、SLineF2D、SRectangleF 和 CTransformationData 类型的比较方法与运算符。
  • Data Processing：[317523] 为 CRecipe 类添加了耗时测量（CSV 格式），并为 CUpdate 类实现了检索执行时间的方法。
  • Data Processing：[346791] 实现了对直接将 CGrabResultPtr（带有图像或 GenCP 负载）放入 CVariant 的支持，从而提高了 CInstantCamera 与 recipe 之间的互操作性。
  • GenTL/GigE：[347265] 修复了 EventGetDataInfo 中 EVENT_DATA_ID 被错误地以非字符串格式返回的问题。此修复通过始终将 EVENT_DATA_ID 作为字符串返回，确保了事件标识的一致性。
  • GenTL/GigE：[348365] 修复了当负载类型不是 Image 时，BUFFER_INFO_DELIVERED_CHUNKPAYLOADSIZE 未被正确设置的问题。
  • GenTL/GigE：[344914] 针对 GigE Vision 的 GenTL Producer 现在可以为多播流配置相机设置。
  • GenTL/USB：[347265] 修复了 EventGetDataInfo 中 EVENT_DATA_ID 被错误地以非字符串格式返回的问题。此修复通过始终将 EVENT_DATA_ID 作为字符串返回，确保了事件标识的一致性。
  • GigE：[341766] Marvell AQtion 网络适配器 Windows 驱动程序已替换为新版本 3.1.10.0。
  • pylon C SDK：[348880] 在 include\pylonc 目录中添加了 PylonCVersion.h 头文件，以便在 pylon C 中查询版本号。
  • pylon C++ SDK：[345142] 宏 PYLON_6_0_NO_DEPRECATE 已替换为 PYLON_NO_DEPRECATE，以确保跨版本的一致性。头文件 api_autoconf.h 已被移除。所有先前包含 api_autoconf.h 的代码现在都应替换为 Platform.h。
  • pylon C++ SDK：[341515] 修复了 pylon 头文件的包含顺序不正确导致意外链接到调试库的问题。
  • pylon C++ SDK：[343776] 修复了视频写入器 (Video Writer) 类中的一个问题：当图像宽度不是 64 像素的倍数时，会在画面底部边缘显示视觉伪影。
  • pylon C++ SDK：[342031] 已更新 CBaslerUniversalInstantCamera 类。
  • pylon C++ SDK：[304977] 将 GenICam 更新至 3.5.0 版本。
  • Workbench：[345137] 如果 vTool 没有自己的设置对话框，双击它现在将在对话框中打开 Features Pane。

修正#

  • PylonVToolCreatorRuntime：[336505] 修复了使用 IArray 作为输入类型会触发异常的问题。
  • Data Processing：[345946] 修复了 SmartInstantCamera.h 和 PylonDataProcessingIncludes.h 之间的循环包含依赖关系。
  • vTools：[344949] 可以使用包含特征流的现有配方。请注意，使用这些更新的 vTools 创建的配方与旧版本的 pylon 不兼容。此项修正是由于升级到 GenICam 3.5 版本而触发的。
  • pylon Viewer：[345748] 修复了一个问题，即用户必须点击两次 Single Shot 按钮，Save Image 按钮才会变为可用状态。
  • pylon Viewer：[346268] 修复了使用 Recording 功能创建的图像在某些图像查看器中打开时，比在 pylon Viewer 中查看时显得更暗的问题。
  • pylon Viewer：[346656] 修复了 Sharpness Indicator 在打开后无法立即开始工作的问题。
  • pylon C++ SDK：[348540] 将 zlib 更新至 1.3.1 版本，使软件免受 CVE-2023-45853 漏洞的影响。

限制#

  • pylon C++ SDK：如果使用 GenICam File Access 功能从 GigE 相机下载文件，且文件大小不能被 4 整除，则当前下载的文件大小为 0 字节。这可能会导致问题，特别是对于包含 user data 的校准和配置文件（例如 Vignetting Correction 数据的 vignetting correction data、Shading Correction 数据的 shading correction data、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 的版本（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);
  • 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： 由于 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)。
  • 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）。
  • GenTL：对于 GenTL 1.4 及更低版本的 Producer，GenTL 支持有限。

下载#

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