pylon Software Suite 26.01 发行说明#

发布日期：2026-01-23

二进制兼容性#

Data Processing = 4.1.1
使用 4.1.x 或更早 4.x.x 版本 Data Processing 构建的应用程序保持兼容。
pylon C++ SDK = 11.3.0
使用 11.3.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：[351433] 改进了带宽管理器 (Bandwidth Manager) 中的消息。
pylon Viewer：[350780] 带宽管理器 (Bandwidth Manager) 现已更改为非模态对话框。这允许直接在 pylon Viewer 中配置相机，而无需关闭带宽管理器 (Bandwidth Manager)。因此，带宽管理器 (Bandwidth Manager) 中允许访问嵌入式特征树的“配置相机”按钮已被移除。
pylon Viewer：[349776] 从所有应用程序的标题栏中删除了“64-Bit”。
Data Processing：[346991] 引入了实用方法，以在使用 CVariant 和 CVariantContainer 类时简化数据的装箱和拆箱。
Data Processing：[319926] 为参数集合添加了对图像和区域参数的支持。
vTools：[319926] 为以下 vTools 的节点映射添加了新参数：Geometric Pattern Matching Basic、Geometric Pattern Matching Pro 和 Template Matching Basic。这允许用户通过 pylon Data Processing C++ API 提供示教数据并访问示教结果。
vTools：[343109] 改进了 Calibration Pro vTool 在高分辨率图像中对标定板的识别。
vTools：[292218] 显著提升了性能并扩展了功能。增强了对 QR 和 GS1 Data Matrix 码的解码能力。QR Code Reader 已针对速度和效率进行了进一步优化。此外，改进基于形状的匹配算法，可提供更高的处理速度和更强的鲁棒性。
Workbench：[349292] 现在可以将相机分配给输入端子上的引脚。这使您可以直接在配方 (recipe) 中使用相机图像，而无需使用 Camera vTool。
vTools：[353917] 更新了代码读取库。改进了所有代码阅读器 vTool 的 Starter 版本的检测和性能。
vTools：[353201] 添加了 Painter vTool 作为实验性功能。此 vTool 可能会发生更改，并在未来版本中进行重大修改。Painter vTool 可将输入数据绘制到图像上，例如区域、几何形状或文本。
vTools：[345795] Mini Script vTool 现在可以处理图像和区域，提供对其元数据的访问，并支持从输入引脚到输出引脚的路由。
vTools：[353199] 添加了 Data Writer vTool 作为实验性功能。此 vTools 可能会发生更改，并在未来版本中进行重大修改。Data Writer vTool 允许记录配方 (recipe) 中的过程。您可以将配方中的所有结果存储为文本、图像或视频等各种格式，以便进行存档或调试。此外，还提供多个可配置的触发器，用于指定何时捕获特定事件。
vTools：[340058] Camera vTool 现在支持 GenDC 抓取结果。当单个类似图像的数据组件可用时，它将直接传递到图像引脚。对于包含多个组件的图像容器，首选强度组件。
pylon C++ SDK：[336167] 在 GrabResult 中引入了 GetDataComponent 以检索给定类型的所有组件。当启用 GenDC 时，此功能可用。
pylon C++ SDK：[347316] 对于 GenDC 等基于容器的格式，GrabResult 缓冲区现在包含第一个强度图像，从而确保与现有 GrabResult 使用模式的兼容性。
GenTL/GigE：[352009] 添加了对 UseExtendedIdIfAvailable 特性的支持，以便在可用时启用扩展 ID 用途。
pylon C SDK：[352237] 更正了编程示例的 include.props 文件。在此修复之前，它列出了 pylonC 库的调试版本。

修正#

pylon Viewer：[349376] 修复了在“设备”(Devices) 窗格中移动到打开的相机上方时键盘导航停止工作的问题。
pylon Viewer：[347274] 修复了带宽管理器 (Bandwidth Manager) 可能会错误配置可用有“DeviceLinkThroughputLimit”参数的 GigE 相机的问题。
pylon Viewer：[349678] 修复了当存在“DeviceLinkThroughputLimit”特征时，带宽管理器 (Bandwidth Manager) 可能会错误配置 GigE 相机的问题。
Data Processing：[323172] 修复了使用相对路径加载库时定位 vTools 和签名文件的问题。
vTools：[345736] 改进了 Template Matching Starter vTool 的稳定性和 AlignmentTf 数据的准确性。为了确保持久可靠的性能，已移除对匹配旋转模板的支持。请注意，使用此 vTool 创建的配方与旧版 pylon 不兼容。同样，使用以前的 pylon 版本创建的配方与此 vTool 版本也不兼容。
vTools：[352227] 修复了双击 Histogram Extractor 和 Multiplexer vTools 时行为不正确的问题。现在不会打开空的对话框，而是会显示一条提示信息，指出该 vTool 没有可配置的设置。
pylon C++ SDK：[352735] 解决了 StreamGrabber 节点映射中的 UseExtendedIdIfAvailable 功能总是被覆盖的问题，从而避免了其在 pylon Viewer 等工具中无法使用的情况。现在可以设置该功能且不会被重置，从而确保了各应用程序之间的一致行为。
pylon C++ SDK：[349506] 修复了通过 GenICam File Access 从 GigE 相机下载的文件在大小不能被 4 整除时会被保存为 0 字节的问题。
GenTL/GigE：[350406] 修复了当缓冲区大小小于所需缓冲区大小时，EventGetData 函数未返回 GC_ERR_BUFFER_TOO_SMALL 的问题。
GenTL/GigE：[347257] 修复了未完整抓取的图像未设置抓取结果的 BlockID 的问题。
GenTL/GigE：[349506] 修复了通过 GenICam File Access 从 GigE 相机下载的文件在大小不能被 4 整除时会被保存为 0 字节的问题。

限制#

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)。

下载#

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