pylon Software Suite 26.04 版本说明#

发布日期：2026-04-22

二进制兼容性#

Data Processing = 4.1.2
使用 Data Processing 4.1.x 或更早的 4.x.x 版本构建的应用程序兼容。
pylon C++ SDK = 11.5.0
使用 pylon C++ SDK 11.5.x 或更早的 11.x.x 版本构建的应用程序兼容。
pylon C SDK = 10.1.0
使用 10.1.x 或早期 10.x.x 版本 pylon C SDK 构建的应用程序是兼容的。
pylon .NET SDK = 9.1.0
使用 pylon .NET SDK 9.1.x 或更早的 9.x.x 版本构建的应用程序不兼容。

新功能 / 变更#

常规： [345556] pylon 现已支持 Basler Stereo mini 相机型号。
pylon C++ SDK： [345556] 添加了 CPylonDataComponent::GetSourceId() 函数，以便能够针对支持多个源（传感器）的相机（如 Basler Stereo mini 相机）查询组件的源。
pylon .NET SDK： [345556] 通过 SourceId Property 扩展了 DataComponent 类，以便能够针对支持多个源（传感器）的相机（如 Basler Stereo mini 相机）查询组件的源。
pylon Viewer： [353958] 添加了对 Stereo mini 相机的支持。
pylon Viewer： [356546] 欢迎对话框已重新设计。
pylon Viewer： [355094] Features 窗格中的 vTool 根节点现在会自动展开。
Workbench： [349127] 在 Recipe Management 窗格中添加了 License 选项卡。它显示了有用的许可信息，在向 Basler 销售部门咨询 vTools 时可以分享这些信息。
vTools： [313321] 改善了用户体验，并为 Measurements Basic 和 Rectangle Measurements Pro vTools 添加了 Rectangle 输入 pin。
vTools： [356715] 为所有 Matching vTools 添加了 Alignment Transformation Output 功能。这允许您指定对齐转换数据是仅作为单个值输出给第一个匹配项，还是作为所有找到的匹配项的数组输出。在此功能存在之前创建的 recipe 默认分配了 Single Value 行为。这可以在以后更改。
vTools： [297188] 为示教 Geometric Pattern Matching vTool 添加了一个新的开发人员示例。
vTools： [300360] 为示教 Calibration vTool 添加了一个新的开发人员示例。
vTools： [356715] 为 Template Matching Starter vTool 添加了 Alignment Transformation Output 功能。这允许您指定对齐转换数据是仅作为单个值输出给第一个匹配项，还是作为所有找到的匹配项的数组输出。在此功能存在之前创建的 recipe 默认分配了 Single Value 行为。这可以在以后更改。
vTools： [358796] 添加了 Demultiplexer vTool。它允许您将来自一个输入源的传入数据项（更新）发送到一个或多个输出 pin。

修正#

Data Processing： [358028] 修复了当智能面阵相机达到其图像限制或采集线程因错误退出时应用程序挂起的问题。
pylon Viewer： [356481] 修复了在调整 vTool 的 Features - All 窗格中的列大小时，允许将 Feature 和 Value 列移动到可见区域之外的问题。
pylon Viewer： [356546] 修复了欢迎对话框中的链接无法正常工作的问题。
pylon Viewer： [359830] 修复了在 Firmware Updater 中打开相机时导致 pylon Viewer 崩溃的问题。
pylon Viewer ： [349493] 修复了某些高级摄像机的“功能”面板中未显示区块数据的问题。
Workbench： [356486] 修复了通用 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 功能可测量 vTool 的执行时间。Statistics 功能中测得的时间可能会因系统配置和整体 CPU 负载而异。这是因为 CPU 可能会根据当前负载以不同的频率运行（例如，由于动态 frequency scaling）。
Workbench: 在 Workbench 中使用多个引脚数据视图并动态显示数据可能会导致 CPU 负载增加以及整体性能下降。Basler 建议尽可能减少使用引脚数据视图。
pylon C++ SDK：如果您使用 GenICam File Access 功能从 GigE 相机下载文件，且文件大小不能被 4 整除，则当前下载的文件大小会为 0 字节。这可能会引发问题，尤其是对于包含用户数据（例如 Vignetting Correction 数据、Shading Correction 数据、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 网站上下载。
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： 必须关闭 Intel USB 主机使用的电源管理，否则 Basler U3V 设备可能会去同步。如果是这种情况，在某些情况下系统启动后 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 相机可能会使用布尔参数而不是通常的枚举来进行事件通知。可以使用以下代码片段来解决此问题。对于 C++，除了：camera.EventNotification.TrySetValue(EventNotification_On); 之外，您还可以使用：CBooleanParameter(camera.GetNodeMap(), "EventNotification").TrySetValue(true);。
pylon C++ SDK: 使用 Visual Studio 2017 时，您可能会收到 MSB4211 警告。要消除该警告，请在 Release 和 Debug 项目属性中指定 Windows SDK 的版本（配置属性 -> 常规 -> Windows SDK 版本）。
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 已更改为引用类 Basler.Pylon.ParameterListEnum）。
pylon .NET SDK: 如果为您的 .NET 项目启用了本机调试，并且您的项目引用了 pylon 程序集，则在 Visual Studio 2012 或 Visual Studio 2013 调试器下运行应用程序时，应用程序可能会崩溃。为避免此问题，请在 Visual Studio 调试器选项中启用托管兼容性模式。
CXP12-IC-1C: 对于线扫描 Applet，行周期和行曝光的范围未得到正确处理。最大值可能小于预期值
GenTL/CXP: 现在使用 Visual Studio 2022 进行编译，这使得必须安装 Visual Studio 2022 可再发行组件才能加载库。
GenTL/CXP: 实际缓冲区大小限制为 2 Gbit，因此对 Producer 中 Width 和 Height 的允许值施加了限制，并导致图像的最大大小为 2GB。
GenTL/CXP: 帧率限制从 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（直接内存访问）或更高规格的主机接口。使用较慢的主机接口可能会降低相机的 Acquisition Frame Rate 并导致图像丢失。
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。