pylon Software Suite 26.03 发行说明#

发布日期：2026-03-20

二进制兼容性#

Data Processing = 4.1.2
使用 4.1.x 或更早 4.x.x 版本 Data Processing 构建的应用程序保持兼容。
pylon C++ SDK = 11.4.0
使用 11.4.x 或更早 11.x.x 版本 pylon C++ SDK 构建的应用程序保持兼容。
pylon C SDK = 10.1.0
使用 10.1.x 或早期 10.x.x 版本 pylon C SDK 构建的应用保持兼容。
pylon .NET SDK = 9.0.0
使用早期版本 pylon .NET SDK 构建的应用不兼容。

新功能 / 变更#

pylon Viewer：[349641] 为支持的相机添加了基于区块的 Flat-Field Correction 功能。
pylon C++ SDK：[242242] 删除了已弃用的 Basler Performance Driver。
pylon C++ SDK：[344267] 改进了 GUI_QtMultiCam 示例中使用的示例 GUI 布局。
pylon C++ SDK：[333934] 为 Image Format Converter 添加了 RGBA8 输出格式。
GigE：[356880] 改进了具有多个网络接口的系统上的 GigE 设备发现。pylon 现在可以正确枚举在多个 NIC 上可用的相机。
GigE：[353458] 添加了 Intel(R) Network Connections Software，Release 30.5
vTools：[338476] AI vTools 可以并行运行多个推理作业，以提高吞吐量。此功能面向高级用户；具体行为和性能取决于您的硬件和模型架构。
CXP12-IC-1C：[none] 用于将 IC1C 升级到 Static 1.2 P0 的固件文件
vTools：[356573] 为 Data Synchronizer vTool 添加了 Complete Input Set 同步模式。例如，这使您能够同步同时触发的相机的输出。您还可以指定超时以应对输入丢失的情况。此外，还添加了 Trigger 和 Discard Input Data 命令。前者允许您随时触发同步，而后者允许丢弃当前持有的所有输入数据。
vTools：[355384] MiniScript vTool 现在在保存配方时会存储“Filename”。如果使用相对路径，将根据配方文件的位置进行解析。
vTools：[351356] 添加了 Region Inverter vTool。该 vTool 可反转输入区域，这意味着输出区域包含不属于输入区域的所有像素。

修正#

pylon Viewer：[354832] 修复了拍摄单帧后 Save Image 功能保持禁用状态的问题。
pylon Viewer：[352230] 修复了使用线扫描相机时 Recording 功能无法工作的问题。
Workbench：[354844] 修复了加载配方后连接在输入和G引脚上显示为未连接的问题。
Workbench：[353962] 改进了 Terminal Pin Information 区域中的相机分配消息。
GenTL/CXP：[347266] 修复了平台库中 LC_ALL 区域设置环境变量的恢复。
GenTL/CXP：[353004] 修复了无效的 GenApi 节点名称导致生成的 GenTL Interface XML 无法被 GenApi 加载的问题。现在，即使小程序文件名包含空格或非字母数字字符，生成的 XML 也可以在 GenApi 中加载。
GenTL/CXP：[352489] 修复了 microDisplayX 中的链接配置视图，并且 CXP 相机属性更改事件现在可以正确发送到 microDisplayX。
GenTL/CXP：[351348] 增强了 CXP 发现的稳定性，特别是对于多链接相机。修复了某些系统配置中一个或多个从链接的发现可能比主链接稍晚的时序问题。
GenTL/CXP：[350617] 修复了端口索引资源中存在间隙的 HAP 文件中的 CXP 发现，以便现在可以正确处理具有未分配中间端口索引的文件。
pylon C++ SDK：[353965] 修复了 flat-field correction 示例中平均像素值的计算。
GigE： [352234] 将 FrameRetention 默认值更改为 500 毫秒，以支持最大帧率为 2 fps 的相机。
GenTL/GigE：[267556] 修复了一个问题：当没有可用的 chunk 数据时，DsGetBufferChunkData 的返回代码不是 GEV_ERR_NO_DATA。
Data Processing：[355946] 修复了一个问题：使用大图像作为示教参数会导致性能下降。
vTools：[356573] Data Synchronizer vTool 现在可以正确处理包含错误的数据。在此之前，带有错误状态的输入数据会被忽略。

限制#

pylon Viewer：Stereo ace 2 相机抓取的图像暂无法显示。
pylon Viewer：在配有 Intel HD 显卡的计算机上，可能需要将显卡驱动程序更新到当前版本。
pylon Viewer：在某些情况下（例如计算机非常慢或繁忙），如果相机已经在 pylon Viewer 中打开，Color Calibrator 可能无法工作。为防止出现这种情况，请在使用 Color Calibrator 之前关闭相机。
pylon Viewer：Color Calibrator 不支持所有 Basler 彩色相机。由于相机功能集不同，不支持 Basler dart 和 boost V 相机。
pylon Viewer：pylon Viewer 中实现了一种新的图像限流器 (image throttle)，以提高整体稳定性和性能。这引入了一项新限制，会影响 pylon Viewer 的视频录制功能。成像管道中每秒仅允许每个相机传输 250 张图像，当超出此限制时，将无法录制每一帧。
Workbench：Workbench 的 Statistics 功能可测量 vTools 的执行时间。Statistics 功能中测量的可能会根据您的系统配置和整体 CPU 负载而有所不同。这是因为 CPU 可能会根据当前负载以不同的频率运行（例如由于动态频率 Scaling）。
Workbench：在 Workbench 中使用多个主动显示数据的引脚数据视图可能会导致 CPU 负载增加以及整体性能下降。Basler 建议尽可能少使用引脚数据视图。
pylon C++ SDK：如果使用 GenICam File Access 功能从 GigE 相机下载文件，且文件大小不能被 4 整除，则当前下载的文件大小为 0 字节。这可能会导致问题，特别是对于包含 user data 的校准和配置文件（例如 Vignetting Correction 数据的 vignetting correction data、Shading Correction 数据的 shading correction data、3D 数据）。
3D：使用 Stereo ace 3D 相机需要安装 pylon Supplementary Package for Stereo ace。pylon Supplementary Package for Stereo ace 可在 Basler 网站上下载。
3D：使用 Basler blaze 3D 相机需要安装 pylon Supplementary Package for blaze。pylon Supplementary Package for blaze 可在 Basler 网站上下载。
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 功能，然后开始录制。
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 链接电源管理”设置为“关闭”。
GenTL：对于 GenTL 1.4 及更低版本的 Producer，GenTL 支持有限。
GigE：为了以最佳状态使用 Basler 的 ace 2 5GigE 和 1GigE 相机，Basler 建议使用双通道 DDR4-3600 RAM 或更高规格的内存。使用较慢的 RAM 可能会导致缓冲区欠载和图像丢失。此外，Basler 建议使用 pylon GigE Configurator 工具来优化整个设置。
pylon C++ SDK：InstantCameraArray 类最多可以从 21 台相机采集图像。
GigE：IP Configurator 工具并不完全支持单个网络接口上的多个 IP 配置。
GigE：如果报告了错误消息“Failed to allocate resources.”，Basler 建议使用 pylon GigE Configurator 工具来优化网卡和相机的 IP 配置。
pylon C++ SDK：某些 ace 2 相机可能会使用布尔参数代替常规枚举来进行 Event Notification。可以使用以下代码片段来规避此问题。对于 C++，除了 camera.EventNotification.TrySetValue(EventNotification_On); 之外，您还可以使用：CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);
pylon C++ SDK：使用 Visual Studio 2017 时，您可能会收到 MSB4211 警告。要消除该警告，请在 Release 和 Debug 项目属性中指定 Windows SDK 的版本（Configuration Properties -> General -> Windows SDK Version）。
pylon C++ SDK： 在使用 CMake 构建示例时，您可能会遇到操作系统的路径长度限制。您可能会收到构建错误，提示路径超过了 260 个字符的最大路径长度。如果您的 CMake 构建目录的绝对路径超过 80 个字符，则可能会发生这种情况。构建目录是当前工作目录，或者是调用 cmake 时由 '-B' 选项指定的目录。如果您遇到此错误，请使用路径较短且不超过 80 个字符的构建目录，例如直接放在用户配置文件 C:\Users\ 中\Samples。您可以在 Windows 10（版本 1607）及更高版本中启用长路径。有关详细信息，请参阅 Microsoft 文档。
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 .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)。
CXP12-IC-1C：对于线扫描 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：如果您的计算机上同时安装了 pylon 和 Framegrabber SDK，Basler 建议在 pylon 安装中取消选择 CXP 选项。为避免因竞争 CXP producer 而产生问题，应由 pylon 或 Framegrabber SDK 之一负责操作 Basler 帧抓取器和/或接口卡。
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（直接内存访问）或更高性能的主机接口。使用较慢的主机接口可能会降低相机的采集帧率并导致图像丢失。
CXP12-IC-1C：如果在某个端口上频繁更改 CXP 链路速度，可能会导致速度更改失效。在这种情况下，会记录错误消息“Failed to set bitrate of uplink transceivers”和“Failed to set bitrate of downlink transceivers”。由于相机发现会探测未连接的端口并因此改变其链路速度，因此当应用程序频繁尝试在未连接的端口上发现新相机时，可能会发生此问题。

下载#

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