跳转到内容
STAGING SERVER
DEVELOPMENT SERVER

pylon Software Suite 25.07 版本说明#

发布日期：2025-07-14

二进制兼容性#

  • pylon C++ SDK = 10.3.2
    使用 10.3.x 或更早 10.x.x 版本 pylon C++ SDK 构建的应用程序保持兼容。
  • pylon .NET SDK = 9.0.0
    使用早期版本 pylon .NET SDK 构建的应用不兼容。
  • pylon C SDK = 10.0.0
    使用 10.0.x 或更早 10.x.x 版本 pylon C SDK 构建的应用程序保持兼容。
  • Data Processing = 3.3.0
    使用 3.3.x 或更早 3.x.x 版本 Data Processing 构建的应用程序保持兼容。

新功能 / 变更#

  • vTools：[340937] 所有 Starter vTools 现在均可无需许可证直接使用。
  • PylonEventLogger：[337087] 滤镜导入现在会排除已存在的滤镜。
  • vTools：[338376] 添加了 Histogram Statistics vTool。该工具用于分析直方图，并提供最小值、最大值、中位数、平均值、标准差以及值的总数。
  • Data Processing：[336937] 更新了 Qt 软件包和 macOS 运行时。
  • Data Processing：[新功能] 添加了 Stamp Demo vTool，可在输入图像上应用随机数量的矩形印章。该工具旨在通过示例代码展示 pylon Data Processing API 的功能。
  • Data Processing：[316725] 添加了 CSmartInstantCamera 仅头文件（header-only）类。它通过将 recipe 作为附加处理阶段，为访问相机设备和 pylon 数据处理提供便利。
  • Data Processing：[335461] 为 CRecipe 类引入了 HasError 方法，允许用户判断 recipe 中的 vTool 是否处于错误状态。
  • Data Processing：[336695] 现在可以将图像以只读方式添加到 CVariant 类中。
  • Data Processing：[335474] 为 CRecipe 类添加了 IsVToolEnabled 和 SetVTool 方法，允许用户开启和关闭 vTools。
  • Data Processing：[341227] 在示例中添加了一个基于 JavaScript 的计时分析器，用于分析通过 pylon Viewer 记录的计时数据。有关更多详细信息，请参阅其 README 文件。
  • Data Processing：[341188] 添加了 GUI_QtMultiCam 示例的更新版本，该版本使用了 smart instant camera 类。此示例执行 recipe 并显示生成的数据处理输出。
  • Data Processing：[337669] 添加了演示如何使用 Smart Instant Camera 的示例。
  • vTools：[323845] OCR Basic vTool 现在可以通过 pylon API 进行参数化。

修正#

  • vTools：[335671] 将 Histogram Extractor vTool 的 Luminance 输出引脚名称更改为 Mono。
  • pylon C++ SDK：[340635] 将 Sample QtMultiCam Windows 项目中的环境变量从 PYLON_ROOT 更改为 PYLON_DEV_DIR。
  • vTools：[321008] 将 Camera vTool 的 ‘ChunkPinValue’ 参数名称更改为 ‘ChunkPinConfiguration’，以与文档保持一致。
  • Data Processing：[335446] 修正了某些方法的文档说明，这些方法在未声明抛出异常的情况下实际会抛出异常。
  • vTools：[322002] 仅当提供所有必需的输入时，Calibration vTool 的 ExecuteCalib 命令才可用。

限制#

  • 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 相机抓取的图像暂无法显示。
  • vTools：加载配方后，无法更改 Histogram Extractor vTools Area 引脚的连接类型。
  • GenTL/GigE：GigE Vision 的 GenTL producer 不支持动作命令 (action commands)。
  • GenTL/GigE：用于 GigE Vision 的 GenTL Producer 不支持多播配置。
  • 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：为了以最佳状态使用 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 链接电源管理”设置为“关闭”。
  • 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 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 编程示例。
  • 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 网站上下载。
  • 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（直接内存访问）或更高性能的主机接口。使用较慢的主机接口可能会降低相机的采集帧率并导致图像丢失。
  • vTools：如果在配方中保存了特定数据类型的连接，则备用数据类型将不再可用。重新加载配方并删除与输入引脚的原始连接时，该输入引脚将仅提供原始连接的数据类型。

下载#

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