pylon Software Suite 26.08 版本说明#

发布日期：2026-08-20

二进制兼容性#

Data Processing = 5.1.0
使用早期版本 Data Processing 构建的应用程序不兼容。
pylon C++ SDK = 12.0.0
使用 12.0.x 或更早 12.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 .NET SDK：[365532] .NET4 程序集已移动到新目录：/net4.0/。
GigE：[341243] 提高了同时使用多个 GigE 相机时的图像采集可靠性。减少了高网络负载下的丢包，从而减少了不完整帧或丢帧。
GigE：[365929] 全新的 pylon GigE Filter Driver 5.6.0.1300 版本包含性能改进。
GigE：[341243] 改进了从多个相机同时进行串流传输时的 GigE Vision 过滤驱动程序性能。驱动程序现在可以更高效地处理传入数据包，降低 CPU 开销，并提高高帧率下的可靠性。
USB：[365927] pylon USB3 Vision Driver 已更新至 11.4.0.1020 版本。
常规：[367333] 将 CodeMeter 运行时更新至 8.41a 版本。
pylon Viewer：[365978] 改进了用于图像显示的全屏模式。
pylon Viewer：[366868] 在 Line Profile 和 Histogram 功能中，将标准 UI 控件替换为更新后的按钮和复选框。
vTools：[364051] 扩展了 Geometric Pattern Matching Basic、Geometric Pattern Matching Pro 和 Template Matching Basic vTools。它们现在可以输出相对于参考点的匹配结果位置数据坐标。
vTools：[363491,365717] ROI Creator vTool 现在在加载或捕获新图像时会保留感兴趣区域。添加了一个用于恢复默认 ROI 的按钮，该 ROI 约占图像的 85% 且居中显示。

修正#

GigE：[366943] 修复了通过 GigE Basler TL 和 GigE GenTL 传输层并行打开相机时导致 pylon SDK 崩溃的问题。
USB：[360548] 修复了在安装 Basler USB3 Vision Driver 的同时安装 libusb 时导致蓝屏错误的问题。
pylon C++ SDK：[363501] 使用用于 MPEG-4 的 pylon 补充包录制 MP4 视频的最大高度和宽度已设置为编解码器支持的最大值 (8191)。
pylon Viewer：[365670] 修复了无论之前是否已启用，每次启动 pylon Viewer 时轮询新功能都被禁用的问题。
pylon Viewer：[348000] 停止图像采集后，状态栏中不再显示 fps 值。
pylon Viewer：[365669] 修复了在相机处于打开状态或正在打开且未执行设备刷新的情况下，在 AUX 和总线供电模式之间循环切换 USB 相机电源时，pylon Viewer 频繁崩溃的问题。

限制#

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 建议尽可能少使用引脚数据视图。
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 网站上下载。
3D：使用 Stereo mini 3D 相机需要安装 pylon Supplementary Package for Stereo mini。pylon Supplementary Package for Stereo mini 可以在 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，行周期和行曝光的范围无法得到正确处理。最大值可能会低于预期。
iF2D100：该 applet 仅支持最大 8192 字节的 CXP 数据包大小。
GenTL/CXP: 当 SDK 配置为连接到 pylon Event Logger，如果在初始化后立即关闭日志记录，则可能会发生死锁。常见场景包括 (1) 调用 Fg_FreeLibraries() 不久之后 Fg_InitLibraries()。(2) 调用 Fg_... 函数，且未使用 Fg_InitLibraries() 和 Fg_FreeLibraries()进行显式生命周期管理。(3) 调用 GCCloseLib() 不久之后 GCInitLib() 在 GenTL Producer 上。
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”。由于相机发现会探测未连接的端口并因此改变其链路速度，因此当应用程序频繁尝试在未连接的端口上发现新相机时，可能会发生此问题。
vTools：如果方案包含 Color Classifier vTool 以及一个或多个 Region vTools（Region Morphology、Region Selection、Region Feature Extraction），系统会列出 Blob Analysis Basic 许可证以及 Color Blob Analysis Basic 许可证供购买。
vTools：如果方案包含 Measurements Basic vTool 以及一个或多个 Measurements Pro vTools，系统会列出 Measurements Basic 许可证以及 Measurements Pro 许可证供购买。

下载#

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